Pobierz pakiet iOS Consumer SDK

Swift Package Manager

Pakiet SDK dla konsumenta można zainstalować za pomocą Swift Package Managera. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie istniejące zależności pakietu SDK dla konsumentów.

Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:

1. Otwórz plik project lub workspace w Xcode, a następnie kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu).
2. Wpisz adres URL https://github.com/googlemaps/ios-consumer-sdk, naciśnij Enter, aby pobrać pakiet, i kliknij „Add Package” (Dodaj pakiet).
3. Aby zainstalować konkretną wersję 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”.
4. W oknie Wybierz produkty w pakiecie sprawdź, czy usługa GoogleRidesharingConsumer zostanie dodana do wyznaczonego celu main. Gdy skończysz, kliknij „Dodaj pakiet”.
5. Aby sprawdzić instalację, otwórz panel General (Ogólne) celu. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści umieszczone). Możesz też sprawdzić sekcję „Zależności pakietu” w „Nawigatorze projektu”, aby zweryfikować pakiet i jego wersję.

Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:

1. W Xcode kliknij File (Plik) > Packages (Pakiety) > Update To Latest Package Versions (Zaktualizuj do najnowszych wersji pakietów).
2. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu i sprawdź pakiet oraz jego wersję.

Aby usunąć zainstalowany ręcznie pakiet Consumer SDK, wykonaj te czynności:

1. W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i umieszczone treści). Użyj znaku minus(-), aby usunąć tę platformę:

   • GoogleRidesharingConsumer.xcframework

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

Używanie 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 SDK dla konsumentów: za pomocą pliku Podfile zainstalujesz interfejs API i jego zależności.

   1. W katalogu projektu utwórz plik o nazwie Podfile. Ten plik definiuje 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 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 pakiet XCFramework zawierający pakiet Consumer SDK i skonfigurować ustawienia kompilacji w Xcode.

Zanim skorzystasz z tego przewodnika, wykonaj te czynności:

• Pobierz XCFramework, pakiet binarny, którego używasz do zainstalowania pakietu Consumer SDK. Możesz używać tego pakietu 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 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 projektów 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, wybierz Skopiuj elementy.

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

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

8. Wybierz projekt w Nawigatorze projektów, a następnie wybierz cel aplikacji.

9. Otwórz kartę Build Phases (Etapy kompilacji) i w sekcji Link Binary with Libraries (Połącz plik binarny z bibliotekami) dodaj te platformy 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 cel, i otwórz kartę Build Settings (Ustawienia kompilacji). W sekcji Other Linker Flags (Inne flagi tagu łączącego) dodaj -ObjC zarówno do debugowania, jak i do wersji.

    Jeśli te ustawienia nie są widoczne, zmień filtr na pasku Ustawienia kompilacji z Podstawowe na Wszystkie.