W tej sekcji opisano, jak sprawdzić, czy system spełnia minimalne wymagania, skonfigurować grupę Workspace i pobrać pakiet SDK dla kierowców.
Zanim zaczniesz
Pakiet Driver SDK na iOS wymaga, aby aplikacja spełniała te kryteria:
- mieć pakiet Navigation SDK,
- Włącz pakiet Maps SDK na iOS w konsoli Google Cloud i pobierz klucz interfejsu API.
Sprawdzanie minimalnych wymagań systemowych
Sprawdź w informacjach o wersji minimalne wymagania dotyczące wersji pakietu Driver SDK, której używasz. Zobacz informacje o wersji.
- Na urządzeniu mobilnym musi być zainstalowany system iOS 16 lub nowszy.
- Apple Xcode w wersji 26 lub nowszej.
Uzyskiwanie dostępu do Google Workspace
Jeśli jesteś klientem Google Workspace, wykonaj te czynności:
Utwórz grupę obszarów roboczych. Więcej informacji znajdziesz w artykule Grupa Workspace.
Na przykład sprawdzoną metodą jest nazwanie grupy
google-maps-platform-sdk-users@workspacedomain.compodczas wprowadzania.Podaj nazwę Google, aby dodać grupę Workspace do listy dozwolonych, która przyznaje dostęp do odpowiednich repozytoriów CocoaPods.
Sprawdź, czy na tej 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 kont użytkowników i kont usługi, 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 gcloud CLI.
Poniższe przykłady pokazują, jak zalogować się za pomocą pakietu SDK Cloud.
gcloud
gcloud auth login
Musisz użyć adresu e-mail, który jest członkiem grupy Workspace.
Konfigurowanie hostów automatyzacji
W przypadku systemów kompilacji lub trybu 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 konta usługi na stronie metod uwierzytelniania w 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 logowania.
W przeciwnym razie zapisz plik klucza konta usługi w bezpiecznej lokalizacji 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
Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom poniższe polecenie.
sudo gem install cocoapodsWięcej informacji znajdziesz w przewodniku dla początkujących CocoaPods.
Utwórz plik Podfile dla pakietu Driver SDK: użyj pliku Podfile, aby zainstalować interfejs API i jego zależności.
W katalogu projektu utwórz plik o nazwie
Podfile. Ten plik definiuje zależności projektu.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' endOto przykład, który zawiera pody alfa 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' endZapisz plik Podfile: otwórz terminal i przejdź do folderu z plikiem Podfile:
cd <path-to-project>
Uruchom polecenie instalacji poda: to polecenie zainstaluje interfejsy API określone w pliku Podfile wraz z ich zależnościami.
pod installOtwó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 SDK dla kierowców można zainstalować za pomocą Swift Package Manager. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie istniejące zależności pakietu Driver SDK.
Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:
-
Otwórz plik
projectlubworkspacew Xcode, a następnie kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu). - Wpisz https://github.com/googlemaps/ios-driver-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, i kliknij „Add Package” (Dodaj pakiet).
-
Aby zainstalować konkretną wersję
version, ustaw pole Reguła zależności na 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”. -
W oknie Wybierz produkty w pakiecie sprawdź, czy usługa
GoogleRidesharingDriverzostanie dodana do wyznaczonego celumain. Gdy skończysz, kliknij „Dodaj pakiet”. - Aby sprawdzić instalację, otwórz panel General (Ogólne) celu. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści umieszczone). Możesz też sprawdzić sekcję „Package Dependencies” (Zależności pakietu) w „Project Navigator” (Nawigator projektu), aby zweryfikować pakiet i jego wersję.
Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:
- W Xcode kliknij File (Plik) > Packages (Pakiety) > Update To Latest Package Versions (Zaktualizuj do najnowszych wersji pakietów).
- Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu i sprawdź pakiet oraz jego wersję.
Aby usunąć zainstalowany ręcznie pakiet Driver SDK, wykonaj te czynności:
W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i umieszczone treści). Użyj znaku minus
(-), aby usunąć tę platformę:GoogleRidesharingDriver.xcframework
Z katalogu najwyższego poziomu projektu Xcode usuń pakiet
GoogleRidesharingDriver.
Instalacja ręczna
Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu pakiet XCFramework zawierający pakiet Driver SDK i skonfigurować ustawienia kompilacji w Xcode.
Zanim skorzystasz z tego przewodnika, wykonaj te czynności:
Pobierz XCFramework, pakiet binarny, którego używasz do zainstalowania pakietu Driver SDK. Możesz używać tego pakietu na wielu platformach, w tym na komputerach z procesorami Apple.
Zainstaluj Navigation SDK.
Aby ręcznie zainstalować pakiet Driver SDK, wykonaj te czynności:
Pobierz plik binarny i zasoby pakietu SDK:
Rozpakuj pliki ZIP, 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 korzystać z iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS.
Jeśli grupa projektów nie zawiera grupy Frameworks, utwórz ją.
Aby zainstalować pakiet Driver SDK, przeciągnij plik
GoogleRidesharingDriver.xcframeworkdo projektu w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i umieszczone treści). Jeśli pojawi się taka prośba, wybierz Skopiuj elementy.Przeciągnij pobrany plik
GoogleRidesharingDriver.bundledo katalogu najwyższego poziomu projektu Xcode. Jeśli pojawi się prośba, wybierz Skopiuj elementy.Wybierz projekt w Nawigatorze projektów, a następnie wybierz cel aplikacji.
Otwórz kartę Build Phases (Etapy kompilacji) i w sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te platformy i biblioteki, jeśli jeszcze ich nie ma:
Accelerate.frameworkAudioToolbox.frameworkAVFoundation.frameworkCoreData.frameworkCoreGraphics.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibxml2.tbdlibz.tbdLocalAuthentication.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.frameworkWebKit.framework
Wybierz projekt, a nie konkretny cel, i otwórz kartę Build Settings (Ustawienia kompilacji). W sekcji Other Linker Flags (Inne flagi łączące) dodaj
-ObjCzarówno w przypadku debugowania, jak i wersji.Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.
Sprawdzanie pliku manifestu dotyczącego ochrony prywatności Apple
Apple wymaga podawania informacji o prywatności w przypadku aplikacji w App Store. Aby uzyskać aktualne i bardziej szczegółowe informacje, odwiedź stronę z informacjami o prywatności w sklepie z aplikacjami Apple.
Plik Apple Privacy Manifest jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został dołączony, i zapoznać się z jego zawartością, utwórz archiwum aplikacji i wygeneruj z niego raport dotyczący prywatności.
Co dalej?
Konfigurowanie projektu w konsoli Google Cloud