Konfigurowanie projektu Xcode

Po włączeniu płatności i utworzeniu klucza interfejsu API możesz skonfigurować projekt Xcode, którego używasz do tworzenia aplikacji.

Dla każdej wersji dostępne są informacje o wersji.

Krok 1. Zainstaluj wymagane oprogramowanie

Aby utworzyć projekt za pomocą pakietu SDK Miejsc na iOS, musisz mieć:

  • Xcode w wersji 26.0 lub nowszej.

Krok 2. Utwórz projekt Xcode i zainstaluj pakiet SDK Miejsc na iOS

Swift Package Manager

Pakiet SDK Miejsc na iOS można zainstalować za pomocą Swift Package Managera. Aby dodać pakiet SDK, usuń wszystkie dotychczasowe zależności pakietu Places SDK for iOS.

Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:

  1. Otwórz plik project lub workspace w Xcode, a następnie kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu).
  2. Wpisz https://github.com/googlemaps/ios-places-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, i kliknij „Add Package” (Dodaj pakiet).
  3. Aby zainstalować konkretną wersję version, ustaw pole Reguła zależności na jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy podanie najnowszej wersji i użycie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.
  4. W oknie Wybierz produkty w pakiecie sprawdź, czy do wyznaczonego głównego celu zostaną dodane GooglePlaces, GooglePlacesSwift lub oba te elementy. Gdy skończysz, kliknij Dodaj pakiet.

    Jeśli aktualizujesz Google Places Swift z wycofanego adresu URL GitHuba

    Ważne: adres URL GitHuba umożliwiający dostęp do Google Places Swift zmienił się od wersji 0.3.0. Jeśli aktualizujesz wersję pakietu GooglePlacesSwift, do której dostęp uzyskano za pomocą starego adresu URL (https://github.com/googlemaps/ios-places-swift-sdk), usuń ją z sekcji zależności pakietu Xcode.

  5. Aby sprawdzić instalację, otwórz panel General (Ogólne) celu. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści umieszczone). Możesz też wyświetlić sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

Aby zaktualizować package w przypadku istniejącego projektu, wykonaj te czynności:

  1. W Xcode kliknij File (Plik) > Packages (Pakiety) > Update To Latest Package Versions (Zaktualizuj do najnowszych wersji pakietów).

    Jeśli aktualizujesz Google Places Swift z wycofanego adresu URL GitHuba

    Ważne: adres URL GitHuba umożliwiający dostęp do Google Places Swift zmienił się od wersji 0.3.0. Jeśli aktualizujesz wersję pakietu GooglePlacesSwift, do której dostęp uzyskano za pomocą starego adresu URL (https://github.com/googlemaps/ios-places-swift-sdk), usuń ją z sekcji zależności pakietu Xcode.

  2. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu i sprawdź pakiet oraz jego wersję.

Aby usunąć zainstalowany ręcznie pakiet Places SDK for iOS, wykonaj te czynności:

  1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i umieszczone treści). Kliknij znak minusa (-), aby usunąć te platformy:
    • GooglePlaces.xcframework
    • GooglePlacesSwift.xcframework
  2. Z katalogu najwyższego poziomu projektu Xcode usuń pakiet GooglePlaces.

Instalacja ręczna

Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu biblioteki XCFrameworks zawierające pakiet SDK Miejsc na iOS i pakiet SDK Places Swift na iOS oraz jak skonfigurować ustawienia kompilacji w Xcode. XCFramework to pakiet binarny, którego można używać na wielu platformach, w tym na maszynach z Apple silicon. Możesz dodać pakiet SDK Miejsc na iOS, pakiet SDK Miejsc Swift na iOS lub oba te pakiety.

  1. Pobierz te pliki binarne i zasoby pakietu SDK:
  2. Jeśli instalujesz pakiet Places Swift SDK na iOS, zainstaluj te pliki:
  3. Wyodrębnij pliki, aby uzyskać dostęp do XCFramework i zasobów.
  4. Uruchom Xcode i otwórz istniejący projekt lub utwórz nowy. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS.
  5. Usuń z projektu wszystkie pakiety Map z poprzednich wersji.
  6. Otwórz kartę Ogólne. Przeciągnij do projektu ten plik XCFramework w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i umieszczone treści). Pamiętaj, aby wybrać opcję Do Not Embed (Nie osadzaj):
    • GooglePlaces.xcframework
    Jeśli instalujesz pakiet Places Swift SDK, przeciągnij do projektu następujący plik XCFramework w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i umieszczone treści). Pamiętaj, aby wybrać opcję Do Not Embed (Nie osadzaj):
    • GooglePlacesSwift.xcframework
  7. Skopiuj plik GooglePlaces.bundle z pobranego pakietu GooglePlacesResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się prośba, wybierz Kopiuj elementy do folderu grupy docelowej.

    Jeśli instalujesz pakiet Places Swift SDK, skopiuj plik GooglePlacesSwift.bundle z pobranego pakietu GooglePlacesSwiftResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się prośba, wybierz Skopiuj elementy do folderu grupy docelowej.
  8. Wybierz projekt w nawigatorze projektów i wybierz cel aplikacji.
  9. Otwórz kartę Build Phases (Fazy kompilacji). W sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te platformy i biblioteki:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. Wybierz projekt, a nie konkretny cel, i otwórz kartę Build Settings (Ustawienia kompilacji). W sekcji Linking - General -> Other Linker Flags (Konsolidacja – ogólne -> inne flagi konsolidatora) dodaj -ObjC do „Debug” (Debugowanie) i „Release” (Wydanie). Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.

Krok 3. Dodaj klucz interfejsu API do aplikacji

W poniższych przykładach zastąp YOUR_API_KEY swoim kluczem interfejsu API.

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

Dodaj klucz interfejsu API do pliku AppDelegate.swift w ten sposób:

  • Dodaj tę instrukcję importu:
    import GooglePlacesSwift
  • Dodaj do metody application(_:didFinishLaunchingWithOptions:) poniższy kod, zastępując YOUR_API_KEY swoim kluczem interfejsu API:
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

Dodaj klucz interfejsu API do pliku AppDelegate.swift w ten sposób:

  • Dodaj tę instrukcję importu:
    import GooglePlaces
  • Dodaj do metody application(_:didFinishLaunchingWithOptions:) poniższy kod, zastępując YOUR_API_KEY swoim kluczem interfejsu API:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Dodaj klucz interfejsu API do pliku AppDelegate.m w ten sposób:

  • Dodaj tę instrukcję importu:
    @import GooglePlaces;
  • Dodaj do metody application:didFinishLaunchingWithOptions: poniższy kod, zastępując YOUR_API_KEY swoim kluczem interfejsu API:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Krok 4 (opcjonalny). Sprawdź plik Apple Privacy Manifest

Apple wymaga podania informacji o prywatności w przypadku aplikacji w App Store. Aby uzyskać aktualne i bardziej szczegółowe informacje, odwiedź stronę z informacjami o prywatności w sklepie z aplikacjami Apple.

Plik Apple Privacy Manifest jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został dołączony, i zapoznać się z jego zawartością, utwórz archiwum aplikacji i wygeneruj z niego raport dotyczący prywatności.

Dalsze kroki