Z tej sekcji dowiesz się, 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:
- Mieć pakiet SDK nawigacji.
- Włącz w konsoli Google Cloud pakiet SDK Maps na iOS i uzyskaj klucz interfejsu API.
Sprawdź minimalne wymagania systemowe
Minimalne wymagania dotyczące danej wersji znajdziesz w informacjach o wersji Pakiet SDK sterownika, którego używasz. 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. Aby dowiedzieć się więcej, zobacz Instalowanie gcloud CLI.
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 na temat automatycznego wykrywania danych logowania.
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 Driver SDK.
CocoaPods
Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom to .
sudo gem install cocoapods
Więcej informacji znajdziesz w przewodniku dla początkujących CocoaPods.
Utwórz plik Podfile dla pakietu Driver SDK: użyj pliku Podfile, aby go zainstalować. API i jego zależności.
Utwórz w katalogu projektu plik o nazwie
Podfile
. Ten plik definiuje zależności projektu.Edytuj plik Podfile i dodaj zależności. Oto przykład, który obejmuje 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 Driver SDK można zainstalować za pomocą programu Menedżer pakietów Swift. Aby dodać pakiet SDK, upewnij się, że masz usunięto wszystkie zależności od pakietu Driver SDK.
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 określenie najnowszej wersji i za pomocą 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. Możesz też wyświetlić „Zależności pakietów” w narzędziu „Project Navigator” aby zweryfikować pakiet i jego wersję.
Aby zaktualizować package
w istniejącym projekcie, wykonaj te czynności:
W przypadku uaktualnienia z wersji wcześniejszej niż 9.0.0 musisz usunąć te zależności:
GoogleMapsBase
,GoogleMapsCore
orazGoogleMapsM4B
po uaktualnieniu. Nie usuwaj zależności dlaGoogleMaps
Więcej informacji: Informacje o wersji 9.0.0W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, i Umieszczone treści. Aby usunąć strukturę, użyj znaku minusa(-):
GoogleMapsBase
(tylko w przypadku uaktualnień z wersji starszych niż 9.0.0)GoogleMapsCore
(tylko w przypadku uaktualnień z wersji starszych niż 9.0.0)GoogleMapsM4B
(tylko w przypadku uaktualnień z wersji starszych niż 9.0.0)
- W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
- 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ąć istniejące zależności Driver SDK dodane za pomocą
CocoaPods
, wykonaj te czynności:
- Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj to polecenie:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Usuń
Podfile
,Podfile.resolved
i Kod Xcodeworkspace
, jeśli nie używasz ich do żadnych innych celów niż CocoaPods.
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 korzystać z tego pakietu na wielu platformach, w tym na komputerach z technologią 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 jeśli nie masz doświadczenia w 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 Driver SDK, przeciągnij ikonę
GoogleRidesharingDriver.xcframework
plik do projektu w Ramki, biblioteki i umieszczone treści. 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. W razie potrzeby 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 zamiast konkretnego środowiska docelowego i otwórz kompilację . 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.
Sprawdź plik manifestu prywatności Apple
Apple wymaga podania informacji o ochronie prywatności w aplikacjach z App Store. Najnowsze informacje i dodatkowe informacje znajdziesz na stronie z informacjami o ochronie prywatności w Apple App Store.
Plik manifestu prywatności Apple jest zawarty w pakiecie zasobów 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.