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 SDK do nawigacji.
- 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ć system iOS w wersji 14 lub nowszej.
- Apple Xcode w wersji 15 lub nowszej.
Uzyskiwanie dostępu do Google Workspace
Jeśli jesteś klientem Google Workspace,wykonaj te czynności:
Utwórz grupę Workspace. Więcej informacji znajdziesz w artykule Grupa Google Workspace.
Na przykład sprawdzoną metodą jest nadanie nazwy grupie podczas wprowadzania.
google-maps-platform-sdk-users@workspacedomain.com
Podaj nazwę Google, aby dodać grupę Workspace do listy dozwolonych, która przyznaje dostęp do odpowiednich repozytoriów CocoaPods.
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 Workspace, wyślij do Google listę adresów e-mail użytkowników i kont usług, które potrzebują dostępu do tych elementów.
Logowanie się za pomocą pakietu SDK Cloud
Aby prowadzić rozwój lokalny, zaloguj się za pomocą Cloud SDK. Szczegółowe informacje 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 należącego 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 uwierzytelniania interfejsów API i usług Google za pomocą konta usługi. Szczegółowe informacje znajdziesz w sekcji dotyczącej konta 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 uwierzytelniających.
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 tymi poświadczeniami to użytkownik grupy Workspace.
Pobieranie pakietu Driver SDK
Zainstaluj i skonfiguruj pakiet SDK Kierowcy.
CocoaPods
Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom to polecenie.
sudo gem install cocoapods
Więcej informacji znajdziesz w przewodniku wdrożeniowym CocoaPods.
Utwórz plik Podfile dla pakietu Driver SDK: za pomocą pliku Podfile zainstaluj interfejs API i jego zależności.
W katalogu projektu utwórz plik o nazwie
Podfile
. Ten plik definiuje 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 zawiera moduły 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
Zapisz plik Podfile: otwórz terminal i przejdź do folderu z plikiem Podfile:
cd <path-to-project>
Uruchom polecenie pod install: to polecenie zainstaluje interfejsy API określone w pliku Podfile wraz z ich zależnościami.
pod install
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.
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:
-
Otwórz Xcode
project
lubworkspace
i kliknij Plik > Dodaj zależności pakietu. - Wpisz https://github.com/googlemaps/ios-driver-sdk jako adres URL, naciśnij Enter, aby zaimportować pakiet, i kliknij „Dodaj pakiet”.
-
Aby zainstalować określony pakiet
version
, ustaw pole Reguła zależności na jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy podanie najnowszej wersji i używanie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.
Aby zaktualizować package
w istniejącym projekcie:
- Aby sprawdzić instalację, otwórz sekcję Zależność pakietu w Nawigatorze projektu, aby zweryfikować pakiet i jego wersję.
Aby ręcznie usunąć zainstalowane wcześniej Driver SDK, wykonaj te czynności:
W ustawieniach konfiguracji projektu Xcode znajdź Frameworki, biblioteki i zawartość osadzona. Aby usunąć te ramy, kliknij znak minusa
(-)
:GoogleRidesharingDriver.xcframework
W katalogu najwyższego poziomu projektu Xcode usuń pakiet
GoogleRidesharingDriver
.
Instalacja ręczna
Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu XCFramework zawierający pakiet SDK Drivera i skonfigurować ustawienia kompilacji w Xcode.
Zanim zaczniesz korzystać z tego przewodnika:
Pobierz XCFramework, czyli pakiet binarny, za pomocą którego zainstalujesz pakiet SDK Driver. Możesz używać tego pakietu na wielu platformach, w tym na maszynach z procesorami Apple Silicon.
Zainstaluj pakiet SDK Navigation.
Aby ręcznie zainstalować pakiet Driver SDK:
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 nowy. Jeśli dopiero zaczynasz pracę z iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS.
Jeśli grupa projektu nie zawiera grupy Framework, 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, kliknij Kopiuj elementy.Przeciągnij pobrany plik
GoogleRidesharingDriver.bundle
do najwyższego katalogu projektu Xcode. Jeśli pojawi się taka prośba, wybierz Kopiuj elementy.W Nawigatorze projektów wybierz projekt, a potem element docelowy aplikacji.
Otwórz kartę Etapy kompilacji i w sekcji Połącz binarny z bibliotekami dodaj te frameworki i biblioteki, jeśli ich jeszcze 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 linkera dodaj
-ObjC
dla wersji debugowej i produkcyjnej.Jeśli te ustawienia są niewidoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.
Sprawdzanie pliku manifestu dotyczącego prywatności w Apple
Firma Apple wymaga, aby w App Store były dostępne informacje o ochronie prywatności w aplikacji. Aby uzyskać więcej informacji, odwiedź stronę 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ł uwzględniony, i przeanalizować jego zawartość, utwórz archiwum aplikacji i wygeneruj raport o prywatności na podstawie tego archiwum.