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:
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.Podaj nazwę grupy Google Workspace, aby dodać ją do listy dozwolonych przyznaje dostęp do prawidłowych repozytoriów CocoaPods.
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
Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom to .
sudo gem install cocoapods
Więcej informacji znajdziesz w przewodniku CocoaPods.
Utwórz plik Podfile dla pakietu Driver SDK: za pomocą pliku Podfile zainstaluj interfejs API i jego zależności.
Utwórz w katalogu projektu plik o nazwie
Podfile
. Ten plik określa zależności projektu.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
Zapisz plik Podfile: otwórz terminal i przejdź do folderu z Plik Pod:
cd <path-to-project>
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
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:
-
Otwórz Xcode
project
lubworkspace
i przejdź do File > (Plik >). Dodaj zależności pakietów. - Jako URL wpisz https://github.com/googlemaps/ios-driver-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
-
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”. -
W oknie Wybierz produkty w pakiecie sprawdź, czy
GoogleRidesharingDriver
zostanie dodany do wyznaczonej wartości docelowejmain
. Gdy skończysz, kliknij „Dodaj pakiet”. -
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:
- W Xcode wybierz „Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów”.
- 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:
W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Biblioteki i umieszczone treści. Aby usunąć, użyj znaku minusa
(-)
. następujący schemat:GoogleRidesharingDriver.xcframework
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:
Pobierz plik binarny i zasoby pakietu SDK:
Rozpakuj skompresowane pliki, aby uzyskać dostęp do XCFramework i zasobów.
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.
Jeśli grupa projektów nie zawiera grupy platform, utwórz ją.
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.Przeciągnij pobrany plik
GoogleRidesharingDriver.bundle
do najwyższego poziomu w Twoim projekcie Xcode. Jeśli pojawi się taka prośba, wybierz Kopiuj elementy.Wybierz projekt w narzędziu Project Navigator, a następnie jako cel aplikacji.
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
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.