Pobierz pakiet iOS Consumer SDK

Swift Package Manager

Pakiet Consumer SDK można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie dotychczasowe zależności pakietu Consumer SDK.

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

1. Otwórz project lub workspace w Xcode, a następnie kliknij File > Add Package Dependencies.
2. Jako adres URL wpisz https://github.com/googlemaps/ios-consumer-sdk, naciśnij Enter aby pobrać pakiet, a następnie kliknij „Add Package” (Dodaj pakiet).
3. Aby zainstalować określoną version, ustaw w polu Dependency Rule jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Exact Version” (Dokładna wersja). Gdy skończysz, kliknij „Add Package” (Dodaj pakiet).

Aby zaktualizować package w istniejącym projekcie:

1. Aby sprawdzić instalację, otwórz sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu) i sprawdź pakiet oraz jego wersję.

Aby usunąć istniejący pakiet Consumer SDK zainstalowany ręcznie:

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

   • GoogleRidesharingConsumer.xcframework

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

Użyj 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 CocoaPods.

2. Utwórz plik Podfile dla pakietu Consumer SDK: użyj pliku Podfile, aby zainstalować interfejs 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, 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 plik XCFramework zawierający pakiet Consumer SDK i skonfigurować ustawienia kompilacji w Xcode.

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

• Pobierz plik XCFramework, czyli pakiet binarny, którego używasz do instalowania pakietu Consumer SDK. Tego pakietu możesz używać na wielu platformach, w tym na komputerach z chipsetem M1.

• Zainstaluj Maps SDK.

1. Pobierz plik binarny i zasoby pakietu SDK:

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

2. Rozpakuj pliki spakowane, aby uzyskać dostęp do pliku 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 Xcode. Jeśli pojawi się taka prośba, kliknij Copy items (Kopiuj elementy).

6. Aby zainstalować pakiet Consumer SDK, przeciągnij plik GoogleRidesharingConsumer.xcframework do projektu w sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone). Jeśli pojawi się taka prośba, kliknij Copy items (Kopiuj elementy).

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

8. W Nawigatorze projektu wybierz projekt, a następnie wybierz 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 frameworki 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ę Build Settings (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 Build Settings (Ustawienia kompilacji) z Basic (Podstawowe) na All (Wszystkie).