Pakiet SDK sterownika na iOS

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK, dodając nowe funkcje, poprawki błędów i ulepszenia wydajności. Na tej stronie znajdziesz wskazówki dotyczące zarządzania zależnościami od pakietów SDK do aplikacji mobilnych.

  • W przypadku aplikacji o kluczowym znaczeniu utwórz link do najnowszej wersji podrzędnej używanej wersji głównej (X.*) i co roku uaktualniaj do nowej wersji głównej.

    W ciągu roku, gdy będziesz publikować nowe wersje aplikacji, możesz zacząć używać nowszych wersji pakietu Driver SDK na iOS. Nie będzie to wymagało aktualizacji aplikacji, ponieważ nowe wersje są zgodne wstecznie.

    Zalety:

    • Jeśli wykryjesz problemy w pakiecie Driver SDK na iOS, poprawki będą udostępniane w sposób zgodny wstecznie przez 12 miesięcy od początkowej wersji głównej, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK, aby korzystać z poprawek.
    • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy aplikacja jest już oparta na najnowszej wersji.
    • Coroczne aktualizacje przyrostowe do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy związanej z dostosowywaniem, przepisywaniem i testowaniem aplikacji niż obsługa zmian wprowadzonych w kilku wersjach głównych, które nie są zgodne wstecznie.

  • W przypadku aplikacji niekrytycznych podaj link do dowolnej wersji, w której problem został rozwiązany. Gdy otrzymasz powiadomienie o wycofaniu tej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje aplikacji będą dłużej obsługiwać urządzenia użytkowników z wcześniejszymi mobilnymi systemami operacyjnymi (do czasu, gdy trzeba będzie przejść na nową wersję pakietu SDK).

Właściciele projektów z monitorowanymi adresami e-mail otrzymują proaktywne powiadomienia o zmianach, które mają wpływ na ich projekty. Otrzymuj informacje o dużych aktualizacjach, wycofaniach i innych zmianach.

Instalacja

Zawsze podawaj numer wersji w zależnościach, zamiast używać operatora optymistycznego (~>), ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet Driver SDK na iOS jest zgodny z wersjonowaniem semantycznym, a nowe wersje główne zawierają zmiany powodujące błędy.

CocoaPods

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

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

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end

Swift Package Manager

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

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 https://github.com/googlemaps/ios-driver-sdk jako adres URL, 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 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 usługa GoogleRidesharingDriver 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ę „Package Dependencies” (Zależności pakietu) w „Project Navigator” (Nawigator 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ę.

Konserwacja i uaktualnianie

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj, czy są dostępne nowsze wersje, i aktualizuj specyfikacje wersji. Jeśli aktualizujesz do nowej wersji głównej, sprawdź w informacjach o wersji, czy nie ma zmian, które nie są zgodne wstecznie, i dowiedz się, jak zaktualizować kod.

Cocoapods

  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 Driver SDK na iOS.
  3. Jeśli znajdziesz nowszą wersję pakietu SDK, zaktualizuj Podfile do tej nowej wersji. Aby dowiedzieć się, jak ustawić konkretną wersję w pliku Podfile, zapoznaj się z artykułem Określanie wersji podów.
  4. Uruchom pod update.
  5. Wprowadź niezbędne zmiany wynikające z uaktualnienia. Listę zmian w poszczególnych wersjach znajdziesz w informacjach o wersji.
  6. Wyczyść i ponownie skompiluj projekt, wybierając Product > Clean (Produkt > Wyczyść), a następnie Product > Build (Produkt > Kompiluj).

Instalacja ręczna

Pobierz link do najnowszych plików źródłowych w sekcji Instalowanie pakietu SDK.

Oprócz sondowania w poszukiwaniu nowszych wersji, właściciele projektów Google Cloud otrzymują e-maile o zmianach, które powodują brak zgodności wstecznej i mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach, które nie są zgodne wstecznie, przypisz rolę właściciela z monitorowanym adresem e-mail do każdego ze swoich projektów.