W tej sekcji opisujemy, jak sprawdzić, czy system spełnia minimalne wymagania, skonfigurować grupę Workspace i uzyskać pakiet Driver SDK.
Zanim zaczniesz
Pakiet Driver SDK na iOS wymaga, aby aplikacja spełniała te kryteria:
- mieć pakiet Navigation SDK;
- Włącz Maps SDK na iOS w konsoli Google Cloud i uzyskaj klucz interfejsu API.
Sprawdź minimalne wymagania systemowe
W informacjach o wersji znajdziesz minimalne wymagania dotyczące używanej wersji pakietu Driver SDK. Zobacz Informacje o wersji.
- Urządzenie mobilne musi mieć zainstalowany system iOS 14 lub nowszy.
- 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 Workspace.
Na przykład podczas wprowadzania nowych użytkowników do usługi warto nadać nazwę grupie.
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 w Workspace, wyślij do Google listę adresów e-mail użytkowników i kont usług, 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 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, 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 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 kont 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 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.
Pobieranie pakietu Driver SDK
Zainstaluj i skonfiguruj pakiet Driver SDK.
CocoaPods
Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom to polecenie.
sudo gem install cocoapods
Więcej informacji znajdziesz w przewodniku CocoaPods – pierwsze kroki.
Utwórz plik Podfile dla pakietu Driver SDK: plik Podfile służy do instalowania interfejsu API i jego zależności.
Utwórz w katalogu projektu 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' end
Oto przykład, który zawiera pody 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 instalacji poda: to polecenie zainstaluje interfejsy API określone w pliku Podfile wraz z wszelkimi zależnościami, jakie mogą mieć.
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.
Swift Package Manager
Pakiet Driver SDK można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie dotychczasowe zależności pakietu Driver SDK.
Aby dodać pakiet SDK do nowego lub istniejącego projektu:
-
Otwórz Xcode
project
lubworkspace
, a potem 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ą
version
, ustaw w polu Reguła zależności 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”.
Aby zaktualizować package
w przypadku istniejącego projektu:
- Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i 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 (Frameworki, biblioteki i treści osadzone). Użyj znaku minusa
(-)
, aby usunąć ten framework: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 platformę XCFramework zawierającą pakiet SDK Driver 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 urządzeniach z układem Apple Silicon.
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 projektu nie zawiera grupy Frameworks, utwórz ją.
Aby zainstalować Driver SDK, przeciągnij plik
GoogleRidesharingDriver.xcframework
do projektu w sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Jeśli pojawi się monit, wybierz Kopiuj elementy.Przeciągnij pobrany plik
GoogleRidesharingDriver.bundle
do katalogu najwyższego poziomu projektu Xcode. Jeśli pojawi się odpowiedni komunikat, kliknij 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 platformy i biblioteki, jeśli nie są jeszcze obecne:
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 Other Linker Flags (Inne flagi linkera) dodaj
-ObjC
zaró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 w Apple
Firma Apple wymaga podawania szczegółowych informacji o ochronie prywatności w przypadku aplikacji w App Store. Aktualne informacje znajdziesz na stronie Apple App Store poświęconej szczegółowym informacjom o ochronie prywatności.
Plik manifestu prywatności Apple jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został dołączony, i zbadać jego zawartość, utwórz archiwum aplikacji i wygeneruj z niego raport o prywatności.
Co dalej?
Konfigurowanie projektu w konsoli Google Cloud