Pobierz pakiet SDK sterowników

Z tej sekcji dowiesz się, jak sprawdzić, czy Twój system spełnia minimalne wymagania, skonfigurować grupę Workspace i pobrać pakiet SDK sterownika.

Zanim zaczniesz

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

  • Użyj pakietu Navigation SDK.
  • Włącz Maps SDK na iOS w Google Cloud Console i uzyskaj klucz API.

Sprawdź minimalne wymagania systemowe

Sprawdź w notatkach o wersji wymagania minimalne dla używanej wersji pakietu Driver SDK. Zobacz informacje o wersji.

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

Uzyskaj dostęp 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.

    Sprawdzoną metodą jest na przykład nazwanie grupy google-maps-platform-sdk-users@workspacedomain.com podczas wprowadzenia.

  2. Podaj nazwę grupy Google Workspace, aby dodać ją do listy dozwolonych przyznaje dostęp do prawidłowych repozytoriów CocoaPods.

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

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

Logowanie się za pomocą pakietu SDK Cloud

Aby programować lokalnie, zaloguj się za pomocą pakietu SDK Cloud. Szczegółowe informacje znajdziesz w artykule Instalowanie interfejsu wiersza poleceń gcloud.

Z przykładów poniżej dowiesz się, jak zalogować się za pomocą pakietu SDK Cloud.

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 podanej liście metod korzystania z konta usługi do uwierzytelniania Interfejsy API i usługi Google. Szczegółowe informacje znajdziesz w sekcji dotyczącej konta usługi. na stronie Metody uwierzytelniania na stronie Google.

  • Jeśli proces działa w środowisku Google Cloud, użyj automatycznego wykrywania danych logowania. Więcej informacji znajdziesz w artykule o automatycznym wykrywaniu danych uwierzytelniających.

  • W przeciwnym razie zapisz plik klucza konta usługi w bezpiecznej lokalizacji systemu plików hosta i ustawić GOOGLE_APPLICATION_CREDENTIALS odpowiednio zmiennej środowiskowej. Więcej informacji znajdziesz tutaj: GOOGLE_APPLICATION_CREDENTIALS.

Adres e-mail konta usługi powiązany z danymi logowania musi należeć do: grupę Workspace.

Pobierz pakiet Driver SDK

Zainstaluj i skonfiguruj pakiet SDK Kierowcy.

CocoaPods

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

    sudo gem install cocoapods
    

    Więcej informacji znajdziesz w przewodniku CocoaPods.

  2. Utwórz plik Podfile dla pakietu Driver SDK: za pomocą pliku Podfile zainstaluj interfejs 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. Zmodyfikuj 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 obejmuje pody alfa i beta dla Pakiet SDK sterownika 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 Plik Pod:

      cd <path-to-project>
      
  3. Uruchom polecenie instalacji poda: to polecenie spowoduje zainstalowanie interfejsów API. określone w pliku Podfile wraz ze wszystkimi ich zależnościami.

    pod install
    
  4. Otwórz projekt w Xcode: zamknij Xcode i otwórz projekt kliknij dwukrotnie plik .xcworkspace swojego projektu, aby uruchomić Xcode. Aby otworzyć do projektu, użyj pliku .xcworkspace.

Menedżer pakietów Swift

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

Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:

  1. Otwórz Xcode project lub workspace i przejdź do File > (Plik >). Dodaj zależności pakietów.
  2. Jako URL wpisz https://github.com/googlemaps/ios-driver-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
  3. Aby zainstalować określony element version, w polu Reguła zależności ustaw jedną z z użyciem opcji opartych na wersji. W przypadku nowych projektów zalecamy podanie najnowszej wersji i użycie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.
  4. W oknie Wybierz produkty w pakiecie sprawdź, czy GoogleRidesharingDriver zostanie dodany do wyznaczonej wartości docelowej main. Gdy skończysz, kliknij „Dodaj pakiet”.
  5. Aby sprawdzić instalację, przejdź do panelu General środowiska docelowego. W obszarze Frameworks, biblioteki i umieszczona treść powinny być widoczne zainstalowane pakiety. Aby zweryfikować pakiet i jego wersję, możesz też przejść do sekcji „Zależności pakietu” w „Nawigatorze projektu”.

Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:

  1. W Xcode wybierz „Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów”.
  2. Aby sprawdzić poprawność instalacji, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator. aby zweryfikować pakiet i jego wersję.

Aby usunąć zainstalowany pakiet Driver SDK ręcznie, wykonaj te czynności:

  1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Biblioteki i umieszczone treści. Aby usunąć, użyj znaku minusa(-). następujący schemat:

    • GoogleRidesharingDriver.xcframework
  2. W katalogu najwyższego poziomu projektu Xcode usuń Pakiet GoogleRidesharingDriver.

Instalacja ręczna

W tym przewodniku pokazujemy, jak ręcznie dodać komponent XCFramework zawierający Pakiet Driver SDK do projektu i skonfiguruj ustawienia kompilacji w Xcode.

Zanim zaczniesz korzystać z tego przewodnika:

  • Pobierz XCFramework – pakiet binarny służący do instalacji Pakiet SDK sterownika. Możesz używać tego pakietu na wielu platformach, w tym na maszynach z układem Apple Silicon.

  • Zainstaluj Navigation SDK.

Aby ręcznie zainstalować pakiet Driver SDK, wykonaj następujące czynności:

  1. Pobierz plik binarny i zasoby pakietu SDK:

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

  3. Uruchom Xcode i otwórz istniejący projekt lub utwórz projekt. Jeśli dopiero zaczynasz pracę z iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS.

  4. Jeśli grupa projektów nie zawiera grupy platform, utwórz ją.

  5. Aby zainstalować pakiet SDK Driver, przeciągnij plik GoogleRidesharingDriver.xcframework do projektu w sekcji Frameworki, biblioteki i osadzony zawartość. Jeśli pojawi się taka prośba, wybierz Kopiowanie elementów.

  6. Przeciągnij pobrany plik GoogleRidesharingDriver.bundle do najwyższego poziomu w Twoim projekcie Xcode. Jeśli pojawi się taka prośba, wybierz Kopiuj elementy.

  7. Wybierz projekt w narzędziu Project Navigator, a następnie jako cel aplikacji.

  8. Otwórz kartę Etapy kompilacji i w sekcji Połącz plik binarny z bibliotekami dodaj komponent następujące platformy i biblioteki, jeśli jeszcze ich nie ma:

    • 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 Inne flagi łączące dodaj -ObjC do: oraz funkcji debugowania.

    Jeśli te ustawienia nie są widoczne, zmień na pasku Ustawienia kompilacji wybierz z Podstawowe na Wszystkie.

Sprawdzanie pliku manifestu dotyczącego prywatności w Apple

Apple wymaga podania informacji o ochronie prywatności w aplikacjach z App Store. Aktualizacje i inne informacje znajdziesz na stronie 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ł dołączony, i sprawdzić jego zawartość, utwórz archiwum aplikacji i wygeneruj raport o ochronie prywatności z archiwum.

Co dalej?

Konfigurowanie projektu w konsoli Google Cloud