Pakiet SDK dla klientów indywidualnych do wersji iOS

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK o nowe funkcje, poprawki błędów i ulepszenia wydajności. Na tej stronie znajdziesz wskazówki, jak zarządzać zależnościami od mobilnych pakietów SDK.

  • W przypadku aplikacji o kluczowym znaczeniu podaj link do najnowszej wersji z kropką używanej wersji głównej (X.*) i aktualizuj ją co roku do nowej wersji głównej.

    W miarę publikowania nowych wersji aplikacji w ciągu roku możesz zacząć korzystać z nowszych wersji pakietu Consumer SDK na iOS. Nie będzie to wymagać aktualizacji w aplikacji, ponieważ nowe wersje z kropką są zgodne wstecznie.

    Zalety:

    • Jeśli zauważysz problemy w pakiecie SDK dla klientów indywidualnych na iOS, poprawki będą udostępniane w sposób zgodny wstecznie przez 12 miesięcy od pierwszej wersji głównej wersji, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Nie musisz pilnie przechodzić na incompatible wersję pakietu SDK, aby korzystać z poprawek.
    • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, jeśli Twoja aplikacja zawiera już najnowszą wersję.
    • Coroczne aktualizacje przyrostowe najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przeredagowaniu i testowaniu aplikacji niż w przypadku obsługi niekompatybilnych wstecznie zmian wprowadzonych w wielu wersjach głównych.

  • W przypadku niekrytycznych aplikacji podaj link do dowolnej poprawionej wersji. Gdy otrzymasz powiadomienie o wycofaniu poprawionej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje Twojej aplikacji przez dłuższy czas umożliwiają obsługę urządzeń ze starszymi systemami operacyjnymi na urządzenia mobilne (aż do momentu uaktualnienia pakietu SDK).

Właściciele projektów, którzy mają monitorowane adresy e-mail, otrzymują aktywne powiadomienia o zmianach, które wpływają na ich projekty. Bądź na bieżąco z głównymi aktualizacjami, wycofywaniami i innymi zmianami.

Instalacja

Zawsze określaj w zależnościach numer wersji, zamiast używać operatora optymistycznego (~>), ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet SDK dla klientów indywidualnych na iOS jest zgodny z semantyczną obsługą wersji, a nowe wersje główne zawierają zmiany powodujące niezgodność.

Menedżer pakietów Swift

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

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

  1. Otwórz plik Xcode project lub workspace i kliknij Plik > Dodaj zależności pakietów.
  2. Wpisz adres URL https://github.com/googlemaps/ios-consumer-sdk, naciśnij Enter, aby pobrać pakiet, a następnie kliknij „Dodaj pakiet”.
  3. Aby zainstalować określony version, w polu Reguła zależności ustaw 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”.
  4. W oknie Wybierz produkty w pakiecie sprawdź, czy pakiet GoogleRidesharingConsumer zostanie dodany do wyznaczonego miejsca docelowego main. Gdy skończysz, kliknij „Dodaj pakiet”.
  5. Aby sprawdzić instalację, przejdź do panelu General środowiska docelowego. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Biblioteki i Umieszczone treści. Możesz też wyświetlić sekcję „Zależności pakietów” w aplikacji „Project Navigator”, aby sprawdzić pakiet i jego wersję.

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

  1. W Xcode wybierz kolejno „File” (Plik) > Packages (Pakiety) > Update To Last Package Versions (Aktualizuj do najnowszych wersji pakietów).
  2. Aby sprawdzić instalację, przejdź do sekcji Zależności pakietów w Project Navigator i sprawdź pakiet i jego wersję.

Aby usunąć istniejące zależności pakietu SDK konsumentów dodane za pomocą CocoaPods, wykonaj te czynności:

  1. Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj to polecenie:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
  2. Usuń Podfile, Podfile.resolved i Xcode workspace, jeśli nie używasz ich do niczego innego niż CocoaPods.

CocoaPods

CocoaPods

Przykładowa zależność z plikiem Podfile ze składnią Podfile:

    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', ' 2.2.0'
    end
    

Przykładowa zależność z plikiem Podfile w przypadku korzystania z pakietu SDK klienta w wersji beta:

    source "https://cpdc-eap.googlesource.com/ridesharing-consumer-sdk"
    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', '2.1.0-beta01.0'
    end
    

Konserwacja i uaktualnianie

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj dostępność nowszych wersji i aktualizuj specyfikacje. Jeśli aktualizujesz nową wersję główną, sprawdź w informacjach o wersji, czy zmiany są niezgodne wstecznie, i jak zaktualizować kod.

Kocoapody

  1. Otwórz terminal i przejdź do katalogu zawierającego Podfile:

    cd <path-to-project>
  2. Uruchom pod outdated, aby sprawdzić, czy jest dostępna nowsza wersja pakietu Consumer SDK na iOS.
  3. Jeśli znajdziemy nowszą wersję pakietu SDK, zaktualizuj ją do Podfile. W sekcji Określanie wersji podów dowiesz się, jak ustawić konkretną wersję w Podfile.
  4. Uruchom pod update.
  5. Wprowadź niezbędne zmiany w związku z przejściem na nową wersję. Listę zmian wprowadzonych w poszczególnych wersjach znajdziesz w informacjach o wersji.
  6. Wyczyść i utwórz projekt ponownie. W tym celu wybierz Usługa > Wyczyść, a następnie Usługa > Kompilacja

Ręczne

Podczas instalowania pakietu SDK pobierz link do najnowszych plików źródłowych.

Oprócz sondowania pod kątem nowszych wersji właściciele projektów Google Cloud otrzymują e-maile o niezgodnych wstecznie zmian, które mogą mieć wpływ na ich projekty. Aby otrzymywać aktywne powiadomienia o niezgodnych wstecznie zmian, przypisz rolę właściciela z monitorowanym adresem e-mail na potrzeby każdego projektu.