Konfigurowanie projektu Xcode

Po włączeniu rozliczeń 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 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ą 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ę.

Aby usunąć pakiet Navigation SDK na iOS zainstalowany ręcznie, wykonaj następujące czynności:
  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:
  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”.

Krok 3. Dodaj do projektu klucz interfejsu API

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 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"];

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 przejrzeć jego zawartość, utwórz archiwum aplikacji i wygeneruj raport o ochronie prywatności na podstawie tego archiwum.

Jeśli jesteś klientem usług mobilnych

Jeśli jesteś klientem usług mobilnych, dowiedz się więcej o rozliczeniach w dokumentacji usług mobilnych. 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ł Łączenie wykorzystania usługi z transakcjami usług mobilnych.

Co dalej?

Teraz, gdy masz klucz interfejsu API i projekt Xcode, możesz tworzyć i uruchamiać aplikacje. Pakiet Navigation SDK na iOS zawiera samouczki, które pomogą Ci zacząć. Więcej informacji znajdziesz w tych artykułach: