Pobierz pakiet iOS Consumer SDK

Wybierz platformę: Android iOS JavaScript

Aby śledzić przejazdy na żądanie w aplikacjach konsumenckich na iOS, użyj pakietu Consumer SDK. Więcej informacji o obserwowaniu przejazdów znajdziesz w artykule Obserwowanie przejazdu na urządzeniu z iOS.

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

Aby skonfigurować pakiet Consumer SDK w aplikacji użytkownika na iOS:

1. Sprawdź minimalne wymagania systemowe
2. Pobierz pakiet Consumer SDK
3. Sprawdź plik manifestu dotyczący ochrony prywatności w Apple.
4. Skonfiguruj projekt w konsoli Google Cloud.
5. Uzyskaj tokeny uwierzytelniania.
6. Zainicjuj pakiet Consumer SDK.

Sprawdzanie minimalnych wymagań systemowych

W informacjach o wersji znajdziesz minimalne wymagania dotyczące używanej wersji pakietu SDK dla konsumentów. Zobacz Informacje o wersji.

• Urządzenie mobilne musi mieć system iOS 16 lub nowszy.
• Apple Xcode w wersji 26 lub nowszej.

Pobieranie pakietu Consumer SDK

Pakiet SDK dla konsumentów instaluje się i konfiguruje za pomocą CocoaPods.

Swift Package Manager

Pakiet SDK dla konsumentów można zainstalować za pomocą Swift Package Manager. Aby dodać pakiet SDK, usuń wszystkie dotychczasowe zależności pakietu SDK dla konsumentów.

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

1. Otwórz Xcode project lub workspace, a potem kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu).
2. Wpisz https://github.com/googlemaps/ios-consumer-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, i kliknij „Add Package” (Dodaj pakiet).
3. Aby zainstalować konkretną wersję version, w polu Reguła zależności wybierz 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”.
4. W oknie Wybierz produkty w pakiecie sprawdź, czy GoogleRidesharingConsumer zostanie dodany do wybranego main celu. Gdy skończysz, kliknij „Dodaj pakiet”.
5. Aby sprawdzić instalację, otwórz panel Ogólne w przypadku wybranego urządzenia. W sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) powinny być widoczne zainstalowane pakiety. Możesz też sprawdzić pakiet i jego wersję w sekcji „Zależności pakietu” w „Nawigatorze projektu”.

Aby zaktualizować package w przypadku istniejącego projektu:

1. W Xcode kliknij kolejno File > Packages > Update To Latest Package Versions (Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów).
2. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

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

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

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Aby usunąć ten framework, użyj znaku minusa(-):

   • GoogleRidesharingConsumer.xcframework

2. Usuń pakiet GoogleRidesharingConsumer z katalogu najwyższego poziomu projektu Xcode.

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 dla początkujących dotyczącym CocoaPods.

2. Utwórz plik Podfile dla pakietu SDK dla konsumentów: plik Podfile służy do instalowania interfejsu API i jego zależności.

   1. W katalogu projektu utwórz plik o nazwie Podfile. Ten plik określa zależności projektu.

   2. Edytuj plik Podfile i dodaj zależności. Oto przykład z uwzględnionymi zależnościami:

      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 z wszelkimi zależnościami, jakie mogą mieć.

   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 polecenie pod outdated, aby wykrywać nowsze wersje pakietu SDK. Więcej informacji znajdziesz w sekcji Wersje pakietu SDK dla konsumentów w informacjach o wersji pakietu SDK dla konsumentów.

Instalacja ręczna

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

Ostrzeżenie: w miarę możliwości używaj Cocoapods do instalowania pakietu SDK dla konsumentów.

Zanim zaczniesz korzystać z tego przewodnika, wykonaj te czynności:

• Pobierz XCFramework, czyli pakiet binarny, którego używasz do instalowania pakietu SDK dla konsumentów. Możesz używać tego pakietu na wielu platformach, w tym na urządzeniach z chipsetem M1.

• Zainstaluj pakiet SDK Map.

1. Pobierz plik binarny i zasoby pakietu SDK:

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

2. Rozpakuj pliki ZIP, 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 iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS.

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

5. Przeciągnij pobrany plik gRPCCertificates.bundle do katalogu najwyższego poziomu projektu w Xcode. Jeśli pojawi się monit, kliknij Skopiuj elementy.

6. Aby zainstalować pakiet SDK dla konsumentów, przeciągnij plik GoogleRidesharingConsumer.xcframework do projektu w sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Jeśli pojawi się monit, wybierz Skopiuj elementy.

7. Przeciągnij pobrany plik GoogleRidesharingConsumer.bundle do katalogu najwyższego poziomu w projekcie Xcode. Jeśli pojawi się monit, wybierz Skopiuj elementy.

8. Wybierz projekt w Nawigatorze projektów i określ cel aplikacji.

9. Otwórz kartę Build Phases (Fazy kompilacji) i w sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te platformy i biblioteki, jeśli nie są jeszcze obecne:

   • 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 cel, i otwórz kartę Ustawienia kompilacji. W sekcji Other Linker Flags (Inne flagi linkera) dodaj -ObjC zarówno w przypadku debugowania, jak i wersji.

    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

Firma Apple wymaga podawania szczegółowych informacji o prywatności aplikacji w App Store. Aktualne informacje znajdziesz na stronie z informacjami o prywatności w Apple App Store.

Plik manifestu prywatności Apple jest dołączony do pakietu zasobów pakietu SDK. Aby sprawdzić, czy plik manifestu prywatności został dołączony, i zbadać jego zawartość, utwórz archiwum aplikacji i wygeneruj z niego raport o prywatności.

Co dalej?

Konfigurowanie projektu w konsoli Google Cloud