Pobierz pakiet iOS Consumer SDK

Wybierz platformę: Android iOS JavaScript

Aby śledzić podróże na żądanie w aplikacjach dla klientów indywidualnych na iOS, użyj pakietu SDK dla klientów indywidualnych. Więcej informacji o kolejnych podróżach znajdziesz w artykule Śledzenie podróży na urządzeniu z iOS.

Przykłady znajdziesz w przykładowych aplikacjach na iOS lub w przykładach połączonych.

Aby skonfigurować pakiet SDK dla użytkowników aplikacji na iOS, wykonaj te czynności:

1. Sprawdź minimalne wymagania systemowe
2. Pobierz pakiet SDK dla klientów indywidualnych
3. Sprawdź plik manifestu Apple dotyczący ochrony prywatności.
4. Skonfiguruj projekt w Google Cloud Console.
5. Uzyskiwanie tokenów uwierzytelniania
6. Zainicjuj pakiet SDK dla klientów indywidualnych.

Sprawdź minimalne wymagania systemowe

Sprawdź w notatkach do wersji minimalne wymagania dotyczące wersji pakietu Consumer SDK, której używasz. Zobacz informacje o wersji.

• Urządzenie mobilne musi mieć system iOS w wersji 14 lub nowszej.
• Apple Xcode w wersji 15 lub nowszej.

Pobieranie pakietu Consumer SDK

Instalujesz i konfigurujesz pakiet SDK dla klientów indywidualnych za pomocą CocoaPods.

Menedżer pakietów Swift

Pakiet SDK dla konsumentów można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, musisz usunąć wszystkie zależności od pakietów SDK dla klientów indywidualnych.

Ważne: te instrukcje zakładają używanie Xcode 15 lub nowszej wersji, ale powinny być podobne w przypadku wcześniejszych wersji Xcode.

Aby dodać pakiet SDK do nowego lub istniejącego projektu:

1. Otwórz Xcode project lub workspace i kliknij Plik > Dodaj zależności pakietu.
2. Wpisz https://github.com/googlemaps/ios-consumer-sdk jako adres URL, naciśnij Enter, aby zaimportować pakiet, i 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 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 rozwiązać problemu z artefaktami lub mogą wystąpić błędy. W takim przypadku wybierz „Plik > Pakiety > Zresetuj pamięć podręczną pakietu”.

Aby ręcznie usunąć zainstalowany obecny pakiet SDK klienta, 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ę:

   • GoogleRidesharingConsumer.xcframework

2. Z katalogu najwyższego poziomu projektu Xcode usuń pakiet GoogleRidesharingConsumer.

Korzystanie z CocoaPods

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

   sudo gem install cocoapods
   

   Więcej informacji znajdziesz w przewodniku wdrożeniowym CocoaPods.

2. Utwórz plik Podfile dla pakietu SDK klienta: 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 'GoogleRidesharingConsumer'
      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 instaluje 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 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 sekcji Wersje pakietu SDK dla konsumentów w notatkach do wersji pakietu SDK dla konsumentów.

Instalacja ręczna

Z tego przewodnika dowiesz się, jak ręcznie dodać do projektu XCFramework zawierający pakiet SDK dla konsumentów i skonfigurować ustawienia kompilacji w Xcode.

Uwaga: zgodnie ze sprawdzoną metodą zainstaluj Cocoapods, gdy tylko jest to możliwe, do zainstalowania pakietu Consumer SDK.

Zanim zaczniesz korzystać z tego przewodnika:

• Pobierz XCFramework, czyli pakiet binarny, za pomocą którego zainstalujesz pakiet Consumer SDK. Możesz używać tego pakietu na wielu platformach, w tym na maszynach z procesorem M1.

• Zainstaluj SDK Map Google.

1. Pobierz plik binarny i zasoby pakietu SDK:

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

3. Uruchom Xcode i otwórz lub utwórz projekt. Jeśli dopiero zaczynasz korzystać z systemu 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. Przeciągnij pobrany plik gRPCCertificates.bundle do najwyższego katalogu projektu Xcode. Jeśli pojawi się taka prośba, wybierz Kopiuj elementy.

6. Aby zainstalować pakiet SDK dla konsumentów, przeciągnij plik GoogleRidesharingConsumer.xcframework do projektu w sekcji Frameworki, biblioteki i zawartość wbudowana. Jeśli pojawi się taka prośba, kliknij Kopiuj elementy.

7. Przeciągnij pobrany plik GoogleRidesharingConsumer.bundle do najwyższego katalogu projektu Xcode. Jeśli pojawi się taka prośba, kliknij Kopiuj elementy.

8. W Nawigatorze projektów wybierz projekt, a potem element docelowy aplikacji.

9. 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
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. Wybierz projekt, a nie konkretny element docelowy, i otwórz kartę Ustawienia kompilacji. W sekcji Inne flagi linkera dodaj -ObjC zarówno dla wersji debugowania, jak i wersji produkcyjnej.

    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

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ł 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