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 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 Places SDK dla 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 Miejsc na iOS, poprawki zostaną udostępnione w sposób zgodny wstecznie przez 12 miesięcy od pierwszej wersji głównej, zgodnie z zasadami dotyczącymi pomocy na urządzeniach 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

Menedżer pakietów Swift

Pakiet Places SDK na iOS możesz zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie istniejące pakiety SDK Miejsc na potrzeby zależności iOS.

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 URL https://github.com/googlemaps/ios-places-sdk, naciśnij Enter, by 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 GooglePlaces 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 Places SDK na iOS 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

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 Miejsc na iOS jest zgodny z obsługą wersji semantycznej, a nowe wersje główne zawierają zmiany powodujące niezgodność.

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

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

platform :ios, '14.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '8.3.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.

Menedżer pakietów Swift

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ę.

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 Places 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.