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
Aby skonfigurować pakiet SDK dla użytkowników aplikacji na iOS, wykonaj te czynności:
- Sprawdź minimalne wymagania systemowe
- Pobierz pakiet Consumer SDK.
- Sprawdź plik manifestu prywatności Apple.
- Skonfiguruj projekt konsoli Google Cloud.
- Uzyskaj tokeny uwierzytelniania.
- Zainicjuj pakiet Consumer SDK.
Sprawdź minimalne wymagania systemowe
Minimalne wymagania dotyczące danej wersji znajdziesz w informacjach o wersji Pakiet SDK klienta, którego używasz. Zobacz informacje o wersji.
- Urządzenie mobilne musi mieć system iOS w wersji 14 lub nowszej.
- Apple Xcode wersji 15 lub nowszej.
Pobieranie pakietu Consumer SDK
Pakiet Consumer SDK instalujesz i konfigurujesz 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.
Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:
-
Otwórz Xcode
project
lubworkspace
i przejdź do File > (Plik >). Dodaj zależności pakietów. - Jako URL wpisz https://github.com/googlemaps/ios-consumer-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
-
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”. -
W oknie Wybieranie produktów pakietu sprawdź, czy
GoogleRidesharingConsumer
zostanie dodany do wybranego przez Ciebie celumain
. Gdy skończysz, kliknij „Dodaj pakiet”. -
Aby sprawdzić instalację, przejdź do panelu
General
środowiska docelowego. W sekcji Frameworki, biblioteki i osadzony zawartość 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:
- W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
- 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 SDK klienta ręcznie, wykonaj te czynności:
W ustawieniach konfiguracji projektu Xcode znajdź Frameworki, biblioteki i osadzone treści. Aby usunąć, użyj znaku minusa
(-)
. następujący schemat:GoogleRidesharingConsumer.xcframework
W katalogu najwyższego poziomu projektu Xcode usuń Pakiet
GoogleRidesharingConsumer
.
Używaj CocoaPods
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.
Utwórz plik Podfile dla pakietu Consumer SDK: służy on do instalowania interfejsu API i jego zależności.
Utwórz w katalogu projektu plik o nazwie
Podfile
. Ten plik definiuje zależności projektu.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
Zapisz plik Podfile: otwórz terminal i przejdź do folderu z plik Podfile:
cd <path-to-project>
Uruchom polecenie instalacji poda: to polecenie instaluje interfejsy API. określone w pliku Podfile wraz z wszelkimi zależnościami.
pod install
Otwórz projekt w Xcode: zamknij Xcode, a następnie otwórz (kliknij dwukrotnie) plik .xcworkspace projektu, aby uruchomić Xcode. Aby otworzyć projekt należy użyć pliku .xcworkspace.
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.
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
Pobierz plik binarny i zasoby pakietu SDK:
Rozpakuj skompresowane pliki, aby uzyskać dostęp do XCFramework i zasobów.
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.
Jeśli grupa projektu nie zawiera grupy Framework, utwórz ją.
Przeciągnij pobrany plik
gRPCCertificates.bundle
do najwyższego katalogu projektu Xcode. W razie potrzeby wybierz Kopiuj elementy.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 Kopiuj elementy.Przeciągnij pobrany plik
GoogleRidesharingConsumer.bundle
do katalogu najwyższego poziomu projektu Xcode. Jeśli pojawi się taka prośba, wybierz Kopiowanie elementów.W Nawigatorze projektów wybierz projekt, a potem element docelowy aplikacji.
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
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
Firma Apple wymaga, aby w App Store były dostępne informacje o ochronie prywatności w aplikacji. Aby uzyskać więcej informacji, odwiedź stronę 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.