Konfigurowanie projektu Xcode

Swift Package Manager

Pakiet SDK do nawigacji można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie dotychczasowe zależności pakietu Navigation SDK.

Aby dodać pakiet SDK do nowego lub istniejącego projektu:

1. Otwórz Xcode project lub workspace, a potem 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, a potem kliknij „Add Package” (Dodaj pakiet).
3. Aby zainstalować konkretną version, ustaw w polu Reguła zależności 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 GoogleNavigation zostanie dodany do wybranego main miejsca docelowego. Gdy skończysz, kliknij „Dodaj pakiet”.
5. Aby sprawdzić instalację, otwórz panel Ogólne w przypadku wybranego urządzenia. W sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) powinny być widoczne zainstalowane pakiety. Możesz też sprawdzić pakiet i jego wersję w sekcji „Zależności pakietu” w „Nawigatorze projektu”.

Aby zaktualizować package w przypadku istniejącego projektu:

1. W Xcode kliknij File > Packages > Update To Latest Package Versions (Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów).
2. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries and Embedded Content (Frameworki, biblioteki i treści osadzone). Aby usunąć te ramy, użyj znaku minusa(-):
   • 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 pliki XCFrameworks zawierające pakiet Navigation SDK na iOS i Maps SDK na iOS oraz jak skonfigurować ustawienia kompilacji w Xcode. XCFramework to pakiet binarny, którego możesz używać na wielu platformach, w tym na urządzeniach z chipsetem M1.

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

1. Pobierz te pliki binarne i pliki zasobów pakietu SDK:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
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 istniejące odniesienia do Map, Nawigacji i Miejsc.
4. Przeciągnij te pliki XCFramework do projektu w sekcji Frameworks, Libraries, and Embedded Content, aby zainstalować pakiety Maps SDK i Navigation SDK (gdy pojawi się odpowiedni komunikat, wybierz Copy items if needed):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. Przeciągnij GoogleMaps.bundle z pobranego folderu GoogleMapsResources do katalogu najwyższego poziomu w projekcie Xcode. Gdy pojawi się odpowiedni komunikat, upewnij się, że zaznaczona jest opcja Copy items if needed (Skopiuj elementy w razie potrzeby).
6. Przeciągnij GoogleNavigation.bundle z pobranego folderu GoogleNavigationResources do katalogu najwyższego poziomu w projekcie Xcode. Gdy pojawi się odpowiedni komunikat, upewnij się, że zaznaczona jest opcja Kopiuj elementy do folderu grupy docelowej.
7. Wybierz projekt w Nawigatorze projektów i określ 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, włącz Background Modes i aktywuj te tryby:
   • Dźwięk, AirPlay i obraz w obrazie
   • Aktualizacje lokalizacji
10. Wybierz projekt, a nie konkretny cel, i otwórz kartę Ustawienia kompilacji. W sekcji Other Linker Flags (Inne flagi linkera) dodaj ‑ObjC zarówno w przypadku 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 Info.plist i dodaj te pary klucz-wartość:
    • Klucz: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Wartość: „Ta aplikacja potrzebuje uprawnień do korzystania z Twojej lokalizacji w celu nawigacji krok po kroku”.
    • Klucz: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      Wartość: „Ta aplikacja potrzebuje uprawnień do korzystania z Twojej lokalizacji w celu nawigacji krok po kroku”.

Swift

Dodaj klucz interfejsu API do 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 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"];