Konfigurowanie projektu Xcode

Swift Package Manager

Pakiet Navigation SDK 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 Navigation SDK.

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

1. Otwórz project lub workspace w Xcode, a następnie kliknij File > Add Package Dependencies.
2. Wpisz https://github.com/googlemaps/ios-navigation-sdk jako adres URL, 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 GoogleNavigation zostanie dodany do wyznaczonego elementu docelowego main. Gdy skończysz, kliknij „Add Package” (Dodaj pakiet).
5. Aby sprawdzić instalację, otwórz panel General (Ogólne) elementu docelowego. W sekcji Frameworks, Libraries, and Embedded Content (Frameworki, 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:

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ę Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu) i sprawdź pakiet oraz jego wersję.

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

Instalacja ręczna

Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu XCFrameworki 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żna używać na wielu platformach, w tym na komputerach z chipsetem M1.

Aby zainstalować XCFrameworki dla pakietu Navigation SDK na iOS, i Maps SDK na iOS:

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 projekt. 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. Aby zainstalować pakiety Maps SDK i Navigation SDK, przeciągnij te XCFrameworki do projektu w sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) (gdy pojawi się komunikat, wybierz Copy items if needed (Skopiuj elementy w razie potrzeby)):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. Przeciągnij GoogleMaps.bundle z pobranego folderu GoogleMapsResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się komunikat, upewnij się, że zaznaczona jest opcja Copy items if needed.
6. Przeciągnij GoogleNavigation.bundle z pobranego folderu GoogleNavigationResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się komunikat, upewnij się, że zaznaczona jest opcja Copy items into destination group's folder (Skopiuj elementy do folderu grupy docelowej).
7. W Nawigatorze projektu wybierz projekt, a następnie element docelowy aplikacji.
8. Otwórz kartę Build Phases (Fazy kompilacji) i w sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te frameworki 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 elemencie docelowym aplikacji otwórz kartę Capabilities (Możliwości), włącz Background Modes (Tryby działania w tle) i włącz te tryby:
   • Audio, AirPlay, and Picture in Picture (Dźwięk, AirPlay i obraz w obrazie)
   • Location updates (Aktualizacje lokalizacji)
10. Wybierz projekt, a nie konkretny element docelowy, i otwórz kartę Build Settings (Ustawienia kompilacji). W sekcji Other Linker Flags (Inne flagi linkera) dodaj ‑ObjC zarówno w przypadku debugowania , jak i wersji. Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Build Settings (Ustawienia kompilacji) z Basic (Podstawowe) na All (Wszystkie).
11. Otwórz Info.plist i dodaj te pary klucz-wartość:
    • Klucz: NSLocationWhenInUseUsageDescription (Privacy – Location When In Use Usage Description)
      Wartość: "Ta aplikacja wymaga 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 wymaga uprawnień do korzystania z Twojej lokalizacji w celu nawigacji krok po kroku”.

Swift

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

1. Dodaj te instrukcje importu:

   import GoogleMaps
   import GoogleNavigation

2. Dodaj te informacje do metody application(_:didFinishLaunchingWithOptions:) metody:

   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 te informacje do metody application:didFinishLaunchingWithOptions::

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];