Pobierz pakiet SDK sterowników

Z tej sekcji dowiesz się, jak sprawdzić, czy Twój system spełnia minimalne wymagania, skonfigurować grupę Workspace i pobrać pakiet SDK sterownika.

Zanim zaczniesz

Pakiet SDK Driver na iOS wymaga, aby aplikacja spełniała te kryteria:

• Mieć pakiet SDK nawigacji.
• Włącz Maps SDK na iOS w Google Cloud Console i uzyskaj klucz API.

Sprawdź minimalne wymagania systemowe

Zapoznaj się z informacjami o wersji, aby poznać minimalne wymagania obowiązujące w przypadku używanej przez Ciebie wersji pakietu Driver SDK. Zobacz informacje o wersji.

• Urządzenie mobilne musi mieć system iOS w wersji 14 lub nowszej.
• Apple Xcode w 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 Google Workspace.

   Na przykład sprawdzoną metodą jest nadanie nazwy grupie podczas [e-mail]

2. Podaj Google nazwę grupy Workspace, aby dodać ją do listy dozwolonych, która zapewnia dostęp do odpowiednich repozytoriów CocoaPods.

3. Potwierdź, że na tej liście znajdują się adresy e-mail użytkowników i adresów e-mail 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 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 Workspace.

Logowanie się za pomocą pakietu SDK Cloud

Aby prowadzić rozwój lokalny, zaloguj się za pomocą Cloud SDK. Szczegółowe informacje znajdziesz w artykule Instalowanie interfejsu wiersza poleceń gcloud.

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 należącego 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 uwierzytelniania interfejsów API i usług Google za pomocą konta usługi. 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 o automatycznym wykrywaniu danych uwierzytelniających.

• W przeciwnym razie zapisz plik klucza konta usługi w bezpiecznej lokalizacji w systemie plików hosta i ustaw odpowiednio 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 należeć do grupy Workspace.

Pobieranie pakietu Driver SDK

Zainstaluj i skonfiguruj pakiet Driver SDK.

CocoaPods

1. Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom to polecenie.

   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 zainstalować interfejs 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 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 obejmuje jako zależności pody alfa i beta dla pakietu Driver SDK:

      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 plikiem Podfile:

      cd <path-to-project>
      

3. Uruchom polecenie instalacji poda: to polecenie zainstaluje interfejsy API określone w pliku Podfile wraz ze wszystkimi ich zależnościami.

   pod install
   

4. Otwórz projekt w Xcode: zamknij Xcode, a następnie otwórz (kliknij dwukrotnie) plik .xcworkspace Twojego projektu, aby uruchomić Xcode. Aby otworzyć projekt później, użyj pliku .xcworkspace.

   Uwaga: okresowo uruchamiaj pod outdated, aby wykryć nowszą wersję pakietu SDK. Więcej informacji znajdziesz w artykule na temat pakietu Driver SDK do wersji iOS.

Menedżer pakietów Swift

Pakiet Driver SDK możesz zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie istniejące zależności 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 przypadku poprzednich wersji Xcode.

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

1. Otwórz project lub workspace Xcode, a następnie wybierz File > Add Package Dependencies (Plik > Dodaj zależności pakietu).
2. Wpisz https://github.com/googlemaps/ios-driver-sdk jako adres URL, naciśnij Enter, aby zaimportować pakiet, i kliknij „Dodaj pakiet”.
3. Aby zainstalować określony element version, w polu Reguła zależności ustaw jedną z opcji zależnych od wersji. W przypadku nowych projektów zalecamy podanie najnowszej wersji i użycie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.

Aby zaktualizować package w istniejącym projekcie:

1. Aby sprawdzić instalację, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator i sprawdź pakiet i jego wersję.

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

Aby ręcznie usunąć zainstalowany pakiet Driver SDK, wykonaj te czynności:

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworki, biblioteki i osadzone treści. Użyj znaku minusa(-), aby usunąć tę strukturę:

   • GoogleRidesharingDriver.xcframework

2. Z 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 SDK Drivera i skonfigurować 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 instalowania pakietu Driver SDK. Możesz używać tego pakietu na wielu platformach, w tym na maszynach z układem Apple Silicon.

• Zainstaluj Navigation SDK.

Aby ręcznie zainstalować pakiet Driver SDK:

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 dopiero zaczynasz korzystać z iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS.

4. Jeśli grupa projektu nie zawiera grupy Framework, utwórz ją.

5. Aby zainstalować pakiet Driver SDK, przeciągnij plik GoogleRidesharingDriver.xcframework do swojego projektu w sekcji Ramki, biblioteki i umieszczone treści. Jeśli pojawi się taka prośba, kliknij Kopiuj elementy.

6. Przeciągnij pobrany plik GoogleRidesharingDriver.bundle do najwyższego katalogu projektu Xcode. W razie potrzeby wybierz Kopiuj elementy.

7. Wybierz projekt w narzędziu Project Navigator, a potem wskaż miejsce docelowe aplikacji.

8. Otwórz kartę Etapy kompilacji i w sekcji Połącz plik binarny z bibliotekami dodaj te 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, a nie konkretny cel, i otwórz kartę Ustawienia kompilacji. W sekcji Inne flagi łączące dodaj -ObjC do debugowania i wersji.

   Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.

Sprawdzanie pliku manifestu dotyczącego prywatności w Apple

Apple wymaga podania informacji o ochronie prywatności w aplikacjach z App Store. Aby uzyskać więcej informacji, odwiedź stronę z informacjami o ochronie prywatności w Apple App Store.

Plik manifestu dotyczący prywatności Apple jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został uwzględniony, i przeanalizować jego zawartość, utwórz archiwum aplikacji i wygeneruj raport o prywatności na podstawie tego archiwum.

Co dalej?

Konfigurowanie projektu w konsoli Google Cloud