W tej sekcji opisujemy, jak sprawdzić, czy system spełnia minimalne wymagania, skonfigurować grupę Workspace i pobrać pakiet Driver SDK.
Zanim zaczniesz
Pakiet Driver SDK na iOS wymaga, aby aplikacja spełniała te kryteria:
- Musisz mieć pakiet Navigation SDK.
- Włącz pakiet Maps SDK na iOS w konsoli Google Cloud i uzyskaj klucz interfejsu API.
Sprawdź minimalne wymagania systemowe
Sprawdź informacje o wersji, aby poznać minimalne wymagania dotyczące używanej wersji pakietu Driver SDK. Zobacz Informacje o wersji.
- Na urządzeniu mobilnym musi być zainstalowany iOS 16 lub nowszy.
- Apple Xcode w wersji 26 lub nowszej.
Uzyskaj dostęp do Google Workspace
Jeśli jesteś klientem Google Workspace:
Utwórz grupę Workspace. Więcej informacji znajdziesz w artykule Grupa Workspace.
Podczas wprowadzania zalecamy, aby grupa miała nazwę np.
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 adresy e-mail użytkowników i kont usługi, które mają mieć dostęp, znajdują się 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 mają mieć dostęp do tych artefaktów.
Zaloguj się za pomocą pakietu SDK Cloud
W przypadku programowania lokalnego zaloguj się za pomocą pakietu SDK Cloud. Szczegółowe informacje 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.
Skonfiguruj hosty 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 Google i usługach Google. 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 Automatyczne wykrywanie 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.
Pobierz pakiet Driver SDK
Zainstaluj i skonfiguruj pakiet Driver SDK.
CocoaPods
Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom to polecenie.
sudo gem install cocoapodsWięcej informacji znajdziesz w przewodniku CocoaPods – pierwsze kroki.
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 określa 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 pod install: 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 później otworzyć projekt, użyj pliku .xcworkspace.
Swift Package Manager
Pakiet Driver SDK można zainstalować za pomocą narzędzia Swift Package Manager. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie dotychczasowe zależności pakietu Driver SDK.
Aby dodać pakiet SDK do nowego lub istniejącego projektu:
-
Otwórz
projectlubworkspaceXcode, a następnie kliknij File > Add Package Dependencies. - Wpisz https://github.com/googlemaps/ios-driver-sdk jako adres URL, naciśnij Enter , aby pobrać pakiet, a następnie kliknij „Add Package” (Dodaj pakiet).
-
Aby zainstalować określoną
version, ustaw pole Dependency Rule na jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Exact Version” (Dokładna wersja). Gdy skończysz, kliknij „Add Package” (Dodaj pakiet).
Aby zaktualizować package w istniejącym projekcie:
- Aby sprawdzić instalację, otwórz sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu) i sprawdź pakiet oraz jego wersję.
Aby usunąć istniejący pakiet Driver SDK zainstalowany ręcznie:
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
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 Driver SDK 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 komputerach z układem Apple silicon
Zainstaluj pakiet Navigation SDK.
Aby ręcznie zainstalować pakiet Driver SDK:
Pobierz pliki binarne 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 projektu 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 (Frameworki, biblioteki i treści osadzone). Jeśli pojawi się taka prośba, kliknij Copy items (Kopiuj elementy).Przeciągnij pobrany plik
GoogleRidesharingDriver.bundledo katalogu najwyższego poziomu projektu Xcode. Jeśli pojawi się taka prośba, kliknij Copy items (Kopiuj elementy).Wybierz projekt w nawigatorze projektu i wybierz cel aplikacji.
Otwórz kartę Build Phases (Fazy kompilacji) i w sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te frameworki i biblioteki, jeśli nie są jeszcze obecne:
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 linkera) dodaj
-ObjCzarówno w przypadku debugowania, jak i wersji.Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Build Settings (Ustawienia kompilacji) z Basic (Podstawowe) na All (Wszystkie).
Sprawdź plik manifestu prywatności Apple
Firma Apple wymaga, aby aplikacje w App Store zawierały szczegółowe informacje o ochronie prywatności. Aktualne informacje i inne szczegóły znajdziesz na stronie Apple App Store Privacy Details.
Plik manifestu prywatności Apple jest zawarty w pakiecie 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 na podstawie archiwum.
Co dalej?
Skonfiguruj projekt w konsoli Google Cloud