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, i 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”.

Aby zaktualizować package w przypadku istniejącego projektu:

1. 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). Użyj znaku minusa(-), aby usunąć te ramy:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Z katalogu najwyższego poziomu projektu Xcode usuń pakiet GoogleMaps.

Instalacja ręczna

Ten przewodnik pokazuje, jak ręcznie dodać do projektu platformy XCFrameworks zawierające pakiet SDK do nawigacji 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 SDK do nawigacji na iOS i pakietu SDK Map 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 odwołania do Map, Nawigacji i Miejsc.
4. Przeciągnij te pliki XCFramework do projektu w sekcji Frameworks, Libraries, and Embedded Content, aby zainstalować pakiety SDK Map i Navigation (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 (Kopiuj elementy w razie potrzeby).
6. Przeciągnij GoogleNavigation.bundle z pobranego pakietu 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 projektu i wybierz 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
   • 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 sekcji docelowej 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, jak i release. 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”.

CocoaPods

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

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

sudo gem install cocoapods

Utwórz Podfile dla pakietu SDK do nawigacji 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 tworzyć aplikacje 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ć swój klucz interfejsu API poniżej.
      3. Ustaw Interfejs projektu na Storyboard.
      4. Ustaw Język na Swift lub Objective-C.
2. Utwórz w katalogu projektu plik o nazwie Podfile. Ten plik określa zależności projektu.
3. Edytuj plik Podfile i dodaj zależności wraz z ich wersjami. Oto przykład zależności wymaganej w przypadku pakietu Navigation SDK na iOS:

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

   Regularnie uruchamiaj polecenie pod outdated, aby wykrywać nowsze wersje. W razie potrzeby zaktualizuj 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 Podfile wraz z wszelkimi 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 przypadku istniejącego projektu:

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.

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