Pobierz pakiet iOS Consumer SDK

Wybierz platformę: Android iOS JavaScript

Aby śledzić podróże na żądanie w swoich aplikacjach na iOS, skorzystaj z pakietu Consumer SDK. Więcej informacji na temat następujących kwestii: podróży z wykorzystaniem udostępniania podróży, zobacz Śledź podróż na urządzeniu z iOS

Przykłady znajdziesz tutaj: przykładowe aplikacje na iOS lub próbki łączone.

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 prywatności Apple.
4. Skonfiguruj projekt konsoli Google Cloud.
5. Uzyskiwanie tokenów uwierzytelniania
6. Zainicjuj pakiet SDK dla klientów indywidualnych.

Sprawdź minimalne wymagania systemowe

Minimalne wymagania dotyczące danej wersji znajdziesz w informacjach o wersji Używany przez Ciebie pakiet SDK klienta. Zobacz informacje o wersji.

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

Pobierz pakiet SDK dla konsumentów

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

Menedżer pakietów Swift

Pakiet SDK klienta 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 pakietów SDK klienta.

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-consumer-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 GoogleRidesharingConsumer 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 pakietu SDK klienta 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 istniejący pakiet SDK klienta 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:

   • GoogleRidesharingConsumer.xcframework

2. W katalogu najwyższego poziomu projektu Xcode usuń Pakiet GoogleRidesharingConsumer.

Używaj CocoaPods

1. Zainstaluj narzędzie CocoaPods: otwórz okno terminala i uruchom następujące polecenie:

   sudo gem install cocoapods
   

   Aby dowiedzieć się więcej, zapoznaj się z Wprowadzenie do CocoaPods.

2. Utwórz plik Podfile dla pakietu SDK dla klientów indywidualnych: 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 zawierający 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 plik 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 i otwórz projekt (kliknij dwukrotnie). należy uruchomić plik .xcworkspace projektu, aby uruchomić Xcode. Aby otworzyć projekt należy użyć pliku .xcworkspace.

   Uwaga: co jakiś czas uruchamiaj pod outdated, aby wykryć, kiedy jest nowsza wersja SDK. Więcej informacji: Informacje o wersjach pakietów SDK dla klientów indywidualnych znajdziesz w informacjach o wersji pakietu SDK dla klientów indywidualnych.

Instalacja ręczna

W tym przewodniku pokazujemy, jak ręcznie dodać komponent XCFramework zawierający Consumer SDK do projektu i skonfiguruj ustawienia kompilacji w Xcode.

Uwaga: zgodnie ze sprawdzoną metodą używaj Cocoapods do instalowania pakietu Consumer SDK za każdym razem, jak to możliwe.

Zanim zaczniesz korzystać z tego przewodnika:

• Pobierz XCFramework – pakiet binarny służący do instalacji pakiet SDK dla klientów indywidualnych. Możesz korzystać z tego pakietu na wielu platformach, w tym z chipsetem M1.

• Zainstaluj Maps SDK

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 urządzenia z 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 folderu najwyższego poziomu w Twoim projekcie Xcode. W razie potrzeby wybierz Kopiuj elementy.

6. Aby zainstalować pakiet SDK dla klientów indywidualnych, przeciągnij GoogleRidesharingConsumer.xcframework plik do projektu w Ramki, biblioteki i umieszczone treści. Jeśli pojawi się taka prośba, wybierz Kopiowanie elementów.

7. Przeciągnij pobrany plik GoogleRidesharingConsumer.bundle do katalogu najwyższego poziomu projektu Xcode. Jeśli pojawi się taka prośba, wybierz Kopiowanie elementów.

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

9. Otwórz kartę Etapy kompilacji i w sekcji Połącz plik binarny z bibliotekami dodaj następujące platformy i biblioteki, jeśli jeszcze nie zostały dodane obecnie:

   • 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 zamiast konkretnego miejsca docelowego i otwórz Na karcie Build Settings (Ustawienia kompilacji). W sekcji Inne flagi łączące: dodaj -ObjC na potrzeby debugowania i wersji.

    Jeśli te ustawienia nie są widoczne, zmień filtr w Pasek Ustawienia kompilacji 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