Pobierz pakiet SDK sterowników

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:

1. Utwórz grupę Workspace. Więcej informacji znajdziesz w artykule Grupa Workspace.

   Sprawdzoną metodą jest na przykład nazwanie grupy [e-mail] podczas wprowadzenia.

2. Podaj nazwę grupy Google Workspace, aby dodać ją do listy dozwolonych przyznaje dostęp do prawidłowych repozytoriów CocoaPods.

3. 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.

Uwaga: grupy Workspace to nie to samo co Grupy dyskusyjne Google, które kończą się na @googlegroups.com. Obsługiwane są tylko Grupy dyskusyjne Workspace.

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

1. 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.

2. Utwórz plik Podfile dla pakietu Driver SDK: użyj pliku Podfile, aby go zainstalować. API i jego zależności.

   1. Utwórz w katalogu projektu plik o nazwie Podfile. Ten plik definiuje zależności projektu.

   2. 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
      

   3. Zapisz plik Podfile: otwórz terminal i przejdź do folderu z Plik Pod:

      cd <path-to-project>
      

3. 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
   

4. 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.

   Uwaga: co jakiś czas uruchamiaj pod outdated, aby wykryć, kiedy jest nowsza wersja SDK. Więcej informacji można znaleźć w sekcji Pakiet SDK sterownika dla wersji iOS

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.

Ważne: w tych instrukcjach przyjęto założenie, że używany jest Xcode 15 lub nowszy, ale powinno to być podobne. w poprzednich wersjach Xcode.

Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:

1. Otwórz Xcode project lub workspace i przejdź do File > (Plik >). Dodaj zależności pakietów.
2. Jako URL wpisz https://github.com/googlemaps/ios-driver-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
3. 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”.
4. W oknie Wybierz produkty w pakiecie sprawdź, czy GoogleRidesharingDriver zostanie dodany do wyznaczonej wartości docelowej main. Gdy skończysz, kliknij „Dodaj pakiet”.
5. 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:

1. W przypadku uaktualnienia z wersji wcześniejszej niż 9.0.0 musisz usunąć te zależności: GoogleMapsBase, GoogleMapsCore oraz GoogleMapsM4B po uaktualnieniu. Nie usuwaj zależności dla GoogleMaps Więcej informacji: Informacje o wersji 9.0.0

   W 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)
2. W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
3. Aby sprawdzić poprawność instalacji, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator. aby zweryfikować pakiet i jego wersję.

Ważne: czasami nie da się usunąć artefaktów lub mogą wystąpić błędy. W tym przypadku wybierz „Plik > Pakiety > Zresetuj pamięć podręczną pakietów”.

Aby usunąć istniejące zależności Driver SDK dodane za pomocą CocoaPods, wykonaj te czynności:

1. Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj to polecenie:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Usuń Podfile, Podfile.resolved i Kod Xcode workspace, 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:

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Biblioteki i umieszczone treści. Aby usunąć, użyj znaku minusa(-). następujący schemat:

   • GoogleRidesharingDriver.xcframework

2. 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.

Uwaga: zgodnie ze sprawdzoną metodą zainstaluj pakiet Driver SDK, gdy tylko jest to możliwe, za pomocą Cocoapods.

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:

1. Pobierz plik binarny i zasoby pakietu SDK:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. Rozpakuj skompresowane pliki, aby uzyskać dostęp do XCFramework i zasobów.

3. 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.

4. Jeśli grupa projektów nie zawiera grupy platform, utwórz ją.

5. 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.

6. Przeciągnij pobrany plik GoogleRidesharingDriver.bundle do najwyższego poziomu w Twoim projekcie Xcode. W razie potrzeby wybierz Kopiuj elementy.

7. Wybierz projekt w narzędziu Project Navigator, a następnie jako cel aplikacji.

8. 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

9. 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. Aktualizacje i inne 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.

Co dalej?

Konfigurowanie projektu w konsoli Google Cloud