Pobierz pakiet iOS Consumer SDK

Menedżer pakietów Swift

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

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 podanie 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ę, otwórz sekcję Zależność pakietu w Nawigatorze projektu, aby zweryfikować pakiet i jego wersję.

Aby ręcznie usunąć zainstalowane wcześniej Consumer SDK, wykonaj te czynności:

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworki, biblioteki i osadzone treści. Aby usunąć te ramy, kliknij znak minusa(-):

   • GoogleRidesharingConsumer.xcframework

2. W najwyższym katalogu 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 Consumer SDK: używasz pliku Podfile do zainstalowania interfejsu API i jego zależności.

   1. W katalogu projektu utwórz 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 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 pod install: to polecenie instaluje interfejsy API określone w pliku Podfile wraz z 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.

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.

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 pakiet SDK Maps.

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 pracę z iOS, utwórz nowy projekt i wybierz szablon aplikacji na iOS.

4. Jeśli grupa projektu nie zawiera grupy Framework, 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 kod binarny z bibliotekami dodaj te frameworki 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 są niewidoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.