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.

Informacje o wersji są dostępne dla każdej wersji.

Krok 1. Zainstaluj wymagane oprogramowanie

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

  • 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ą narzędzia Swift Package Manager. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie dotychczasowe zależności pakietu SDK Miejsc na iOS.

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

  1. Otwórz project lub workspace Xcode, a następnie kliknij File > Add Package Dependencies.
  2. Jako adres URL wpisz https://github.com/googlemaps/ios-places-sdk, naciśnij Enter , aby pobrać pakiet, a następnie kliknij „Add Package” (Dodaj pakiet).
  3. Aby zainstalować konkretną version, ustaw w polu Dependency Rule jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Exact Version” (Dokładna wersja). Gdy skończysz, kliknij „Add Package” (Dodaj pakiet).
  4. W oknie Choose Package Products (Wybierz produkty pakietu) sprawdź, czy do wyznaczonego głównego elementu docelowego zostaną dodane pakiety GooglePlaces, GooglePlacesSwift, lub oba. Gdy skończysz, kliknij Add Package (Dodaj pakiet).

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

    Ważne: od wersji 0.3.0 zmienił się adres URL GitHub, pod którym można uzyskać dostęp do Google Places Swift. Jeśli aktualizujesz wersję 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 w Xcode.

  5. Aby sprawdzić instalację, otwórz panel General (Ogólne) elementu docelowego. W sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści osadzone) powinny być widoczne zainstalowane pakiety. Aby sprawdzić pakiet i jego wersję, możesz też otworzyć sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu).

Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:

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

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

    Ważne: od wersji 0.3.0 zmienił się adres URL GitHub, pod którym można uzyskać dostęp do Google Places Swift. Jeśli aktualizujesz wersję 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 w Xcode.

  2. Aby sprawdzić instalację, otwórz sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu) i sprawdź pakiet oraz jego wersję.

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

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

Instalacja ręczna

Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu XCFrameworks zawierające pakiet SDK Miejsc na iOS i pakiet SDK Miejsc 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 komputerach z procesorami Apple. 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 SDK Miejsc Swift na iOS, zainstaluj te pliki:
  3. Rozpakuj pliki, aby uzyskać dostęp do XCFramework i zasobów.
  4. Uruchom Xcode i otwórz istniejący projekt lub utwórz nowy projekt. 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ę General (Ogólne). Przeciągnij ten XCFramework do projektu w sekcji Frameworks, Libraries, and Embedded Content. Pamiętaj, aby wybrać opcję Do Not Embed:
    • GooglePlaces.xcframework
    Jeśli instalujesz pakiet SDK Miejsc Swift, przeciągnij ten XCFramework do projektu w sekcji Frameworks, Libraries, and Embedded Content. Pamiętaj, aby wybrać opcję Do Not Embed:
    • GooglePlacesSwift.xcframework
  7. Skopiuj plik GooglePlaces.bundle z pobranego pakietu GooglePlacesResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się prośba, wybierz opcję Copy items into destination group's folder (Skopiuj elementy do folderu grupy docelowej).

    Jeśli instalujesz pakiet SDK Miejsc Swift, skopiuj plik GooglePlacesSwift.bundle z pobranego pakietu GooglePlacesSwiftResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się prośba, wybierz opcję Copy items into destination group's folder (Skopiuj elementy do folderu grupy docelowej).
  8. Wybierz projekt w nawigatorze projektu i wybierz element docelowy 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 element docelowy, i otwórz kartę Build Settings (Ustawienia kompilacji). W sekcji Linking - General -> Other Linker Flags (Łączenie – Ogólne – > Inne flagi konsolidatora) dodaj -ObjC do opcji „Debug” (Debugowanie) i „Release” (Wydanie). Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Build Settings (Ustawienia kompilacji) z Basic (Podstawowe) na All (Wszystkie).

Krok 3. Dodaj klucz interfejsu API do aplikacji

W tych przykładach zastąp YOUR_API_KEY swoim kluczem interfejsu API.

GooglePlacesSwift

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

  • Dodaj ten import: 
    import GooglePlacesSwift
  • Dodaj ten kod do metody application(_:didFinishLaunchingWithOptions:), 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 ten import: 
    import GooglePlaces
  • Dodaj ten kod do metody application(_:didFinishLaunchingWithOptions:), 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 ten import: 
    @import GooglePlaces;
  • Dodaj ten kod do metody application:didFinishLaunchingWithOptions:, zastępując YOUR_API_KEY swoim kluczem interfejsu API: 
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Krok 4 (opcjonalny). Sprawdź plik manifestu prywatności Apple

Firma Apple wymaga, aby aplikacje w App Store zawierały szczegółowe informacje o ochronie prywatności. Aktualne informacje i inne szczegóły znajdziesz na stronie Apple App Store Privacy Details.

Plik manifestu prywatności Apple jest zawarty w pakiecie zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został dołączony, i aby sprawdzić jego zawartość, utwórz archiwum aplikacji i wygeneruj raport o ochronie prywatności na podstawie tego archiwum.

Dalsze kroki