Pakiet SDK Miejsc na iOS

Wybierz platformę: Android iOS JavaScript

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

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

    W miarę publikowania nowych wersji aplikacji przez cały rok możesz zacząć korzystać z nowszych wersji pakietu SDK Miejsc na iOS. Nie będzie to wymagać aktualizacji w Twojej aplikacji, ponieważ nowe wersje kropek są zgodne wstecznie.

    Zalety:

    • W przypadku wykrycia problemów w pakiecie Places SDK na iOS poprawki są udostępniane w sposób zgodny wstecznie przez 12 miesięcy od pierwszej wersji głównej (zgodnie z zasadami pomocy mobilnej). Aby korzystać z poprawek, nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK.
    • Najnowsze ulepszenia i funkcje są łatwe do wdrożenia, jeśli aplikacja jest już w najnowszej wersji.
    • Coroczne aktualizacje przyrostowe do najnowszej głównej wersji pakietu SDK wymagają mniej pracy w zakresie dostosowywania, przepisywania i testowania aplikacji niż wprowadzanie niezgodnych wstecznie zmian wprowadzonych w wielu głównych wersjach.

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

    Zalety:

    • Mniej prac konserwacyjnych.
    • Nowe wersje aplikacji nadal obsługują urządzenia użytkowników ze starszymi systemami operacyjnymi na urządzenia mobilne (dopóki nie przejdziesz na nową wersję pakietu SDK).

Właściciele projektów ze monitorowanymi adresami e-mail otrzymują powiadomienia o zmianach, które mają wpływ na każdy z ich projektów. Otrzymuj informacje o ważnych aktualizacjach, wycofanych funkcjach i innych zmianach.

Instalacja

Zawsze podawaj numer wersji w zależności, zamiast używać operatora optymistycznego (~>), ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet SDK Miejsc na iOS jest zgodny z wersją semantyczną, a nowe wersje główne obejmują zmiany powodujące niezgodność.

Korzystanie z CocoaPods

Przykładowa zależność podpliku za pomocą składni Podfile:

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

platform :ios, '14.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '8.0.0'
end

Korzystanie z Kartaginy

Przykładowa zależność Cartfile za pomocą składni Cartfile:

binary "https://dl.google.com/geosdk/GooglePlaces.json" == 6.2.1

Konserwacja i uaktualnienia

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj dostępność nowych wersji i aktualizuj ich specyfikacje. Jeśli aktualizujesz oprogramowanie do nowej wersji głównej, zapoznaj się z informacjami o wersji, aby sprawdzić, czy zmiany są niezgodne wstecznie, i dowiedzieć się, jak zaktualizować kod.

Korzystanie z Cocoapods

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

    cd <path-to-project>
  2. Uruchom plik pod outdated, by sprawdzić, czy jest dostępna nowsza wersja pakietu SDK Miejsc na iOS.
  3. Jeśli znaleziono nowszą wersję pakietu SDK, zaktualizuj Podfile do nowej wersji. Aby dowiedzieć się, jak ustawić konkretną wersję w Podfile, zapoznaj się z artykułem Określanie wersji podów.
  4. Uruchom plik pod update.
  5. Po wprowadzeniu zmian wprowadź niezbędne zmiany. Listę zmian wprowadzonych w danej wersji znajdziesz w informacjach o wersji.
  6. Wyczyść i odbuduj projekt, klikając Produkt > Wyczyść, a następnie Produkt > Kompilacja.

Korzystanie z Kartaginy

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

    cd <path-to-project>
  2. Uruchom plik carthage outdated, by sprawdzić, czy jest dostępna nowsza wersja pakietu SDK Miejsc na iOS.
  3. Jeśli znaleziono nowszą wersję pakietu SDK, zaktualizuj Cartfile do nowej wersji. Aby dowiedzieć się, jak ustawić konkretną wersję w: Cartfile, zapoznaj się z wymaganiami dotyczącymi wersji.
  4. Uruchom plik carthage update.
  5. Po wprowadzeniu zmian wprowadź niezbędne zmiany. Listę zmian wprowadzonych w danej wersji znajdziesz w informacjach o wersji.
  6. Wyczyść i odbuduj projekt, klikając Produkt > Wyczyść, a następnie Produkt > Kompilacja.

Ręcznie

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

Oprócz przeprowadzania ankiet dotyczących nowszych wersji właściciele projektów Google Cloud otrzymują e-maile dotyczące niezgodnych wstecznie zmian, które mogą mieć wpływ na ich projekty. Aby otrzymywać aktywne powiadomienia o zmianach niezgodnych wstecznie, przypisz rolę właściciela ze monitorowanym adresem e-mail dla każdego projektu.