Konfigurowanie projektu Xcode

Swift Package Manager

Pakiet Navigation SDK można zainstalować za pomocą menedżera pakietów Swift. 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 Xcode, a następnie kliknij File > Add Package Dependencies.
2. Wpisz adres URL https://github.com/googlemaps/ios-navigation-sdk, naciśnij Enter , aby pobrać pakiet, i 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).

Aby zaktualizować package w istniejącym projekcie:

1. 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 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, kliknij 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. Wybierz projekt w Nawigatorze projektu i wybierz 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 – Prywatność – opis użycia lokalizacji, gdy aplikacja jest używana)
      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 – Prywatność – opis użycia lokalizacji, gdy aplikacja jest używana i gdy nie jest używana)
      Wartość: "Ta aplikacja potrzebuje uprawnień do korzystania z Twojej lokalizacji w celu nawigacji krok po kroku".

CocoaPods

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

Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w macOS, wykonując to polecenie w terminalu. Więcej informacji znajdziesz w przewodniku dla początkujących CocoaPods.

sudo gem install cocoapods

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

1. Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS:
   1. Utwórz nowy projekt.
   2. Wybierz szablon iOS > App (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 określa zależności projektu.
3. Edytuj Podfile i dodaj zależności wraz z ich wersjami. Oto przykład, który zawiera zależność potrzebną do korzystania z pakietu Navigation SDK na iOS: # Cocoapods install reference #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '10.14.0'
   end
           

   Regularnie uruchamiaj polecenie pod outdated, aby wykrywać nowsze wersje. W razie potrzeby uaktualnij do najnowszej wersji.
4. Zapisz plik 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 tej pory musisz używać pliku .xcworkspace do otwierania projektu.

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 pliku Podfile do najnowszej wersji.

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