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 Google Workspace.

    Sprawdzoną metodą jest na przykład nazwanie grupy google-maps-platform-sdk-users@workspacedomain.com podczas wprowadzenia.

  2. Podaj nazwę Google, aby dodać grupę Workspace do listy dozwolonych, która przyznaje dostęp do odpowiednich 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.

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 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 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. Zmodyfikuj 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 zawiera moduły 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
      
    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 z wszelkimi 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.

Menedżer pakietów Swift

Pakiet Driver SDK można zainstalować za pomocą programu Menedżer pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie istniejące zależności pakietu SDK kierowcy.

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 pakiet version, ustaw pole Reguła zależności na jedną z 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ę, otwórz panel General celu. W sekcji Frameworki, biblioteki i osadzony zawartość powinny być widoczne zainstalowane pakiety. Aby zweryfikować pakiet i jego wersję, możesz też przejść do sekcji „Zależności pakietu” w „Nawigatorze projektu”.

Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:

  1. W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
  2. 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ąć 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.

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:

  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 katalogu projektu 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

Firma Apple wymaga, aby w App Store były dostępne informacje o ochronie prywatności w aplikacji. 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