Konfigurowanie projektu Xcode

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

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

Krok 1. Zainstaluj wymagane oprogramowanie

Aby utworzyć projekt za pomocą pakietu Navigation SDK na iOS, musisz pobrać i zainstalować:

  • Xcode w wersji 26.0 lub nowszej

Krok 2. Utwórz projekt Xcode i zainstaluj pakiet Navigation SDK

Swift Package Manager

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

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-navigation-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 określenie najnowszej wersji i użycie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.
  4. W oknie Wybierz produkty w pakiecie sprawdź, czy usługa GoogleNavigation zostanie dodana do wyznaczonego celu main. Gdy skończysz, kliknij „Dodaj pakiet”.
  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ż sprawdzić sekcję „Package Dependencies” (Zależności pakietu) w „Project Navigator” (Nawigator projektu), aby zweryfikować pakiet i jego wersję.

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

  1. W Xcode kliknij File (Plik) > Packages (Pakiety) > Update To Latest Package Versions (Zaktualizuj do najnowszych wersji pakietów).
  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 Navigation SDK na iOS, wykonaj te czynności:
  1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i umieszczone treści). Użyj znaku minus(-), aby usunąć ten framework:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. Z katalogu najwyższego poziomu projektu Xcode usuń pakiet GoogleMaps.

Instalacja ręczna

Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu pakiety XCFrameworks zawierające Navigation SDK na iOS i Maps SDK 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 chipsetem M1.

Aby zainstalować pakiety XCFrameworks dla pakietu SDK do nawigacji na iOS i pakietu Maps SDK na iOS, wykonaj te czynności:

  1. Pobierz te pliki binarne i pliki zasobów pakietu SDK:
  2. Uruchom Xcode i otwórz istniejący projekt lub utwórz nowy. Jeśli dopiero zaczynasz korzystać z iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS.
  3. Usuń z projektu wszystkie dotychczasowe odwołania do Map, nawigacji i miejsc.
  4. Przeciągnij te pliki XCFramework do projektu w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści umieszczone), aby zainstalować pakiety SDK Map i Nawigacji (gdy pojawi się odpowiedni komunikat, wybierz Copy items if needed (Skopiuj elementy, jeśli to konieczne)):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Przeciągnij plik GoogleMaps.bundle z pobranego folderu GoogleMapsResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się odpowiedni komunikat, upewnij się, że zaznaczona jest opcja Copy items if needed (Skopiuj elementy w razie potrzeby).
  6. Przeciągnij plik GoogleNavigation.bundle z pobranego folderu GoogleNavigationResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się prośba, upewnij się, że zaznaczona jest opcja Kopiuj elementy do folderu grupy docelowej.
  7. Wybierz projekt w nawigatorze projektów i wybierz cel aplikacji.
  8. Otwórz kartę Build Phases (Fazy kompilacji) i w sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te platformy i biblioteki:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CarPlay.framework
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • MapKit.framework
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • UserNotifications.framework
    • WebKit.framework
  9. W celu aplikacji wybierz kartę Capabilities (Możliwości), włącz Background Modes (Tryby działania w tle) i aktywuj te tryby:
    • Dźwięk, AirPlay i obraz w obrazie
    • Informacje o zmianie lokalizacji
  10. Wybierz projekt, a nie konkretny cel, i otwórz kartę Build Settings (Ustawienia kompilacji). W sekcji Other Linker Flags (Inne flagi łączące) dodaj ‑ObjC zarówno w przypadku opcji debug (debugowanie), jak i release (wersja). Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.
  11. Otwórz plik Info.plist i dodaj te pary klucz-wartość:
    • Klucz: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Wartość: „Ta aplikacja potrzebuje uprawnień do używania Twojej lokalizacji na potrzeby szczegółowych wskazówek dojazdu”.
    • Klucz: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      Wartość: „Ta aplikacja potrzebuje uprawnień do korzystania z Twojej lokalizacji, aby wyświetlać szczegółowe wskazówki dojazdu”.

Krok 3. Dodaj klucz interfejsu API do projektu

Poniższe przykłady pokazują, jak dodać klucz interfejsu API do projektu w Xcode:

Swift

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

  1. Dodaj te instrukcje importu: 
    import GoogleMaps
import GoogleNavigation
  2. Dodaj do metody application(_:didFinishLaunchingWithOptions:) te informacje: 
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

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

  1. Dodaj te instrukcje importu: 
    @import GoogleMaps;
@import GoogleNavigation;
  2. Dodaj do metody application:didFinishLaunchingWithOptions: te informacje: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

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

Apple wymaga podawania 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.

Jeśli jesteś klientem usług mobilności

Jeśli jesteś klientem Mobility Services, informacje o płatnościach znajdziesz w dokumentacji Mobility. Więcej informacji o rejestrowaniu transakcji znajdziesz w artykule Konfigurowanie rozliczeń. Aby dowiedzieć się, jak dodać identyfikatory transakcji do implementacji pakietu Navigation SDK, przeczytaj artykuł Powiązywanie korzystania z usługi z transakcjami Mobility.

Co dalej?

Gdy masz już klucz interfejsu API i projekt Xcode, możesz tworzyć i uruchamiać aplikacje. Pakiet SDK do nawigacji na iOS zawiera samouczki, które pomogą Ci rozpocząć pracę. Więcej informacji: