Pobierz pakiet SDK sterowników

W tej sekcji opisujemy, jak sprawdzić, czy system spełnia minimalne wymagania, skonfigurować grupę Workspace i uzyskać pakiet Driver SDK.

Zanim zaczniesz

Pakiet Driver SDK na iOS wymaga, aby aplikacja spełniała te kryteria:

  • mieć pakiet Navigation SDK;
  • Włącz Maps SDK na iOS w konsoli Google Cloud i uzyskaj klucz interfejsu API.

Sprawdź minimalne wymagania systemowe

W informacjach o wersji znajdziesz minimalne wymagania dotyczące używanej wersji pakietu Driver SDK. Zobacz Informacje o wersji.

  • Urządzenie mobilne musi mieć zainstalowany system iOS 14 lub nowszy.
  • Apple Xcodewersji 15 lub nowszej.

Uzyskiwanie dostępu do Google Workspace

Jeśli jesteś klientem Google Workspace, wykonaj te czynności:

  1. Utwórz grupę Workspace. Więcej informacji znajdziesz w artykule Grupa Workspace.

    Na przykład podczas wprowadzania nowych użytkowników do usługi warto nadać nazwę grupie.google-maps-platform-sdk-users@workspacedomain.com

  2. Podaj nazwę Google, aby dodać grupę Workspace do listy dozwolonych, która przyznaje dostęp do odpowiednich repozytoriów CocoaPods.

  3. Sprawdź, czy na liście znajdują się adresy e-mail użytkowników i kont usługi, które potrzebują dostępu.

Jeśli Twoja organizacja nie może tworzyć grup w Workspace, wyślij do Google listę adresów e-mail użytkowników i kont usług, które potrzebują dostępu do tych artefaktów.

Logowanie się za pomocą pakietu SDK Cloud

W przypadku programowania lokalnego zaloguj się za pomocą pakietu Cloud SDK. Więcej informacji znajdziesz w artykule Instalowanie interfejsu wiersza poleceń gcloud.

Poniższe przykłady pokazują, jak zalogować się za pomocą Cloud SDK.

gcloud

gcloud auth login

Musisz użyć adresu e-mail, który należy do grupy Workspace.

Konfigurowanie hostów automatyzacji

W przypadku systemów kompilacji lub ciągłej integracji skonfiguruj hosty automatyzacji na podstawie podanej listy metod używania konta usługi do uwierzytelniania w interfejsach API i usługach Google. Szczegółowe informacje znajdziesz w sekcji dotyczącej kont usługi na stronie Metody uwierzytelniania w Google.

  • Jeśli proces jest uruchamiany w środowisku Google Cloud, użyj automatycznego wykrywania danych logowania. Więcej informacji znajdziesz w artykule o automatycznym wykrywaniu danych logowania.

  • W przeciwnym razie zapisz plik klucza konta usługi w bezpiecznym miejscu w systemie plików hosta i odpowiednio ustaw zmienną środowiskową GOOGLE_APPLICATION_CREDENTIALS. Więcej informacji znajdziesz w artykule GOOGLE_APPLICATION_CREDENTIALS.

Adres e-mail konta usługi powiązany z danymi logowania musi być członkiem grupy Workspace.

Pobieranie pakietu Driver SDK

Zainstaluj i skonfiguruj pakiet Driver SDK.

CocoaPods

  1. Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom to polecenie.

    sudo gem install cocoapods
    

    Więcej informacji znajdziesz w przewodniku CocoaPods – pierwsze kroki.

  2. Utwórz plik Podfile dla pakietu Driver SDK: plik Podfile służy do instalowania interfejsu API i jego zależności.

    1. Utwórz w katalogu projektu plik o nazwie Podfile. Ten plik określa zależności projektu.

    2. Edytuj plik Podfile i dodaj zależności. Oto przykład, który zawiera zależności:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      Oto przykład, który zawiera pody Alpha i Beta pakietu Driver SDK jako zależności:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      
    3. Zapisz plik Podfile: otwórz terminal i przejdź do folderu z plikiem Podfile:

      cd <path-to-project>
      
  3. Uruchom polecenie instalacji poda: to polecenie zainstaluje interfejsy API określone w pliku Podfile wraz z wszelkimi zależnościami, jakie mogą mieć.

    pod install
    
  4. Otwórz projekt w Xcode: zamknij Xcode, a następnie otwórz (kliknij dwukrotnie) plik .xcworkspace projektu, aby uruchomić Xcode. Aby otworzyć projekt później, użyj pliku .xcworkspace.

Swift Package Manager

Pakiet Driver SDK można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie dotychczasowe zależności pakietu Driver 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-driver-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 pakietuNawigatorze projektu, aby sprawdzić pakiet i jego wersję.

Aby usunąć zainstalowany ręcznie pakiet Driver SDK, wykonaj te 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ąć ten framework:

    • GoogleRidesharingDriver.xcframework
  2. Z katalogu najwyższego poziomu projektu Xcode usuń pakiet GoogleRidesharingDriver.

Instalacja ręczna

Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu platformę XCFramework zawierającą pakiet SDK Driver i skonfigurować ustawienia kompilacji w Xcode.

Zanim zaczniesz korzystać z tego przewodnika:

  • Pobierz XCFramework, czyli pakiet binarny, którego używasz do instalowania pakietu Driver SDK. Możesz używać tego pakietu na wielu platformach, w tym na urządzeniach z układem Apple Silicon.

  • Zainstaluj Navigation SDK.

Aby ręcznie zainstalować pakiet Driver SDK, wykonaj te czynności:

  1. Pobierz plik binarny i zasoby pakietu SDK:

  2. Rozpakuj pliki ZIP, aby uzyskać dostęp do XCFramework i zasobów.

  3. 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.

  4. Jeśli grupa projektu nie zawiera grupy Frameworks, utwórz ją.

  5. Aby zainstalować Driver SDK, przeciągnij plik GoogleRidesharingDriver.xcframework do projektu w sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Jeśli pojawi się monit, wybierz Kopiuj elementy.

  6. Przeciągnij pobrany plik GoogleRidesharingDriver.bundle do katalogu najwyższego poziomu projektu Xcode. Jeśli pojawi się odpowiedni komunikat, kliknij Kopiuj elementy.

  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, jeśli nie są jeszcze obecne:

    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • LocalAuthentication.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • WebKit.framework
  9. 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 debugowania, jak i wersji.

    Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacjiPodstawowe na Wszystkie.

Sprawdzanie pliku manifestu dotyczącego ochrony prywatności w Apple

Firma Apple wymaga podawania szczegółowych informacji o ochronie prywatności w przypadku aplikacji w App Store. Aktualne informacje znajdziesz na stronie Apple App Store poświęconej szczegółowym informacjom o ochronie prywatności.

Plik manifestu prywatności Apple jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został dołączony, i zbadać jego zawartość, utwórz archiwum aplikacji i wygeneruj z niego raport o prywatności.

Co dalej?

Konfigurowanie projektu w konsoli Google Cloud