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 Navigation SDK na iOS, musisz pobrać i zainstalować:

  • Xcode w wersji 15.0 lub nowszej

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

Menedżer pakietów Swift

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

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

  1. Otwórz Xcode project lub workspace i kliknij Plik > Dodaj zależności pakietu.
  2. Wpisz https://github.com/googlemaps/ios-navigation-sdk jako adres URL, naciśnij Enter, aby zaimportować pakiet, i kliknij „Dodaj pakiet”.
  3. Aby zainstalować określony pakiet version, ustaw pole Reguła zależności na jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy podanie najnowszej wersji i używanie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.

Aby zaktualizować package w istniejącym projekcie:

  1. Aby sprawdzić instalację, otwórz sekcję Zależność pakietu w Nawigatorze projektu, aby zweryfikować pakiet i jego wersję.

Aby usunąć istniejący pakiet SDK do nawigacji na iOS zainstalowany ręcznie:
  1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworki, biblioteki i zawartość osadzona. Użyj znaku minusa(-), aby usunąć te elementy:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. W najwyższym katalogu projektu Xcode usuń pakiet GoogleMaps.

Instalacja ręczna

W tym przewodniku dowiesz się, jak ręcznie dodać do projektu XCFrameworks zawierające pakiet SDK do nawigacji na iOS i Maps SDK na iOS oraz skonfigurować ustawienia kompilacji w Xcode. XCFramework to pakiet binarny, którego można używać na wielu platformach, w tym na maszynach z procesorem M1.

Aby zainstalować XCFramework dla pakietu SDK do nawigacji na iOS i pakietu SDK Map 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. Jeśli dopiero zaczynasz korzystać z iOS, utwórz nowy projekt i wybierz Szablon aplikacji na iOS.
  3. Usuń z projektu wszystkie istniejące odwołania do Map, Nawigacji i Miejsc.
  4. Aby zainstalować pakiety SDK Map i Nawigacji, przeciągnij te pakiety XCFramework do projektu w sekcji Frameworky, biblioteki i zawartość wbudowana (w razie potrzeby wybierz Skopiuj elementy):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Przeciągnij GoogleMaps.bundle z pobranej GoogleMapsResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się odpowiedni komunikat, sprawdź, czy wybrana jest opcja Skopiuj elementy w razie potrzeby.
  6. Przeciągnij plik GoogleNavigation.bundle z katalogu GoogleNavigationResources do katalogu najwyższego poziomu projektu Xcode. Gdy pojawi się odpowiedni komunikat, sprawdź, czy zaznaczona jest opcja Kopiowanie elementów do folderu grupy docelowej.
  7. W Nawigatorze projektów wybierz projekt, a potem element docelowy aplikacji.
  8. Otwórz kartę Etapy kompilacji i w sekcji Połącz plik binarny z bibliotekami dodaj te frameworki i biblioteki:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.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
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • UserNotifications.framework
    • WebKit.framework
  9. W docelowym urządzeniu aplikacji wybierz kartę Możliwości, włącz Tryby w tle i włącz 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 Inne flagi linkera dodaj ‑ObjC dla opcji debug i release. Jeśli te ustawienia są niewidoczne, zmień filtr na pasku Ustawienia tworzenia z Podstawowe na Wszystkie.
  11. Otwórz Info.plist i dodaj te pary klucz-wartość:
    • Klucz: NSLocationWhenInUseUsageDescription (Prywatność – opis sposobu korzystania z lokalizacji w trakcie korzystania z aplikacji)
      Wartość: „Ta aplikacja potrzebuje dostępu do Twojej lokalizacji, aby zapewnić nawigację krok po kroku”.
    • Klucz: NSLocationAlwaysAndWhenInUseUsageDescription (Prywatność – opis korzystania z lokalizacji – zawsze i w trakcie korzystania)
      Wartość: „Ta aplikacja potrzebuje dostępu do Twojej lokalizacji na potrzeby nawigacji krok po kroku”.

CocoaPods

Pakiet SDK do nawigacji na iOS jest dostępny jako pakiet CocoaPods. CocoaPods to menedżer zależności typu open source do projektów Cocoa w Swift i Objective-C.

Jeśli nie masz jeszcze zainstalowanego narzędzia CocoaPods, zainstaluj je w systemie macOS, wykonując w terminalu podane niżej polecenie. Więcej informacji znajdziesz w przewodniku CocoaPods Getting Started (w języku angielskim).

sudo gem install cocoapods

Utwórz Podfile dla pakietu Navigation SDK na iOS i użyj go do zainstalowania interfejsu API i jego zależności:

  1. Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz zajmować się programowaniem na iOS:
    1. Utwórz nowy projekt.
    2. Wybierz szablon iOS > Aplikacja.
    3. Na ekranie opcji projektu:
      1. Wpisz nazwę projektu.
      2. Zapisz wartość pola Identyfikator pakietu. Możesz użyć tej wartości, aby ograniczyć klucz interfejsu API.
      3. Ustaw Interfejs projektu na Storyboard.
      4. Ustaw Język na Swift lub Objective-C.
  2. W katalogu projektu utwórz plik o nazwie Podfile. Ten plik definiuje zależności projektu.
  3. Zmodyfikuj Podfile i dodaj zależności wraz z ich wersjami. Oto przykład, który zawiera zależność wymaganą przez pakiet SDK nawigacji na iOS: # Informacje o instalacji Cocoapods # 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '9.2.0'
end
    Regularnie uruchamiaj pod outdated, aby wykrywać nowsze wersje. W razie potrzeby zaktualizuj go do najnowszej wersji.
  4. Zapisz Podfile.

  5. Otwórz terminal i przejdź do katalogu zawierającego plik Podfile:

    cd <path-to-project>

  6. Uruchom polecenie pod install. Spowoduje to zainstalowanie interfejsów API określonych w pliku Podfile wraz z ich zależnościami.

    pod install

  7. Zamknij Xcode, a następnie otwórz (kliknij dwukrotnie) plik .xcworkspace projektu, aby uruchomić Xcode. Od tego momentu do otwierania projektu musisz używać pliku .xcworkspace.

Aby zaktualizować interfejs API w istniejącym projekcie:

  1. Otwórz terminal i przejdź do katalogu projektu zawierającego plik Podfile.
  2. Uruchom polecenie pod update. Spowoduje to zaktualizowanie wszystkich interfejsów API określonych w Podfile do najnowszej wersji.

Krok 3. Dodaj klucz interfejsu API do projektu

W tych przykładach pokazujemy, jak dodać klucz interfejsu API do projektu w Xcode:

Swift

Aby dodać klucz interfejsu API do AppDelegate.swift, wykonaj te czynności:

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

Objective-C

Aby dodać klucz interfejsu API do AppDelegate.m, wykonaj te czynności:

  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 manifestu prywatności Apple

Firma Apple wymaga, aby w App Store były dostępne informacje o ochronie prywatności w aplikacji. Aby uzyskać więcej informacji, odwiedź stronę z informacjami o ochronie prywatności w Apple App Store.

Plik manifestu dotyczący prywatności Apple jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został uwzględniony, i przeanalizować jego zawartość, utwórz archiwum aplikacji i wygeneruj raport o prywatności na podstawie tego archiwum.

Jeśli jesteś klientem Usług mobilnych

Jeśli korzystasz z usług mobilnych, dowiedz się więcej o fakturowaniu w dokumentacji Mobilności. Więcej informacji o rejestrowaniu transakcji znajdziesz w artykule Konfigurowanie płatności. Aby dowiedzieć się, jak dodać identyfikatory transakcji do implementacji pakietu SDK nawigacji, przeczytaj artykuł Powiązanie korzystania z usługi z transakcjami Mobility.

Co dalej?

Teraz, gdy masz klucz interfejsu API i projekt Xcode, możesz tworzyć i uruchamiać aplikacje. Pakiet SDK do nawigacji na iOS zawiera samouczki, które ułatwią Ci rozpoczęcie korzystania z usługi. Więcej informacji znajdziesz w tych artykułach: