Pobierz pakiet iOS Consumer SDK

Swift Package Manager

Pakiet SDK dla konsumentów można zainstalować za pomocą menedżera pakietów Swift. 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:

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, a następnie kliknij „Add Package” (Dodaj pakiet).
3. Aby zainstalować konkretną version, ustaw w polu Reguła zależności 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”.

Aby zaktualizować package w przypadku istniejącego projektu:

1. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

Aby ręcznie usunąć zainstalowany 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). Użyj znaku minusa(-), aby usunąć ten framework:

   • GoogleRidesharingConsumer.xcframework

2. Z katalogu najwyższego poziomu 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 CocoaPods – pierwsze kroki.

2. Utwórz plik Podfile dla pakietu Consumer SDK: za pomocą pliku Podfile zainstalujesz interfejs API i jego zależności.

   1. Utwórz w katalogu projektu 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 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 potem 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 pakiet 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, 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 Maps SDK.

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 Xcode. Jeśli pojawi się odpowiedni komunikat, kliknij 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ę monit, wybierz Kopiuj elementy.

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

8. Wybierz projekt w Nawigatorze projektu i 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 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.