Pakiet SDK Miejsc na iOS

Wybierz platformę: Android iOS JavaScript

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK, wprowadzając nowe funkcje, poprawki błędów i ulepszenia wydajności. Na tej stronie znajdziesz wskazówki dotyczące zarządzania zależnościami w pakietach SDK na urządzenia mobilne.

  • W przypadku aplikacji o krytycznym znaczeniu linkuj do najnowszej wersji głównej (X.*) z dodatkiem ostatniej kropki, a co roku aktualizuj aplikację do nowej wersji głównej.

    W trakcie publikowania nowych wersji aplikacji w ciągu roku możesz zacząć używać nowszych wersji pakietu Places SDK na iOS. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje dot są wstecznie kompatybilne.

    Zalety:

    • Jeśli wykryjesz problemy z pakietem SDK Miejsc na iOS, w ciągu 12 miesięcy od opublikowania jego głównej wersji zostaną one naprawione w sposób zgodny z poprzednimi wersjami zgodnie z zasadami obsługi mobilnej. Aby skorzystać z poprawek, nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK.
    • Najnowsze ulepszenia i funkcje są łatwe do wdrożenia, gdy aplikacja jest już skompilowana w najnowszej wersji.
    • Coroczne cząstkowe aktualizacje najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy w zakresie dostosowania, przepisania i testowania aplikacji niż w przypadku obsługi zmian niezgodnych z poprzednimi wersjami wprowadzonych w wielu głównych wersjach.

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

    Zalety:

    • rzadsze prace konserwacyjne,
    • Nowe wersje aplikacji będą dłużej obsługiwać urządzenia użytkowników z starszymi mobilnymi systemami operacyjnymi (do momentu przejścia na nowszą wersję pakietu SDK).

Właściciele projektów, którzy mają monitorowane adresy e-mail, otrzymują aktywne powiadomienia o zmianach wpływających na ich projekty. Bądź na bieżąco z informacjami o najważniejszych aktualizacjach, wycofanych funkcjach i innych zmianach.

Instalacja

Menedżer pakietów Swift

Pakiet SDK Miejsc na iOS można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie dotychczasowe zależności pakietu SDK usługi Places na iOS.

Aby dodać pakiet SDK do nowego lub istniejącego projektu:

  1. Otwórz Xcode project lub workspace i kliknij Plik > Dodaj zależności pakietu.
  2. Wpisz https://github.com/googlemaps/ios-places-sdk jako adres URL, naciśnij Enter, aby zaimportować pakiet, i kliknij „Dodaj pakiet”.
  3. Aby zainstalować określony pakiet 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 Wybieranie produktów w pakiecie sprawdź, czy do głównego celu docelowego zostaną dodane elementy GooglePlaces, GooglePlacesSwift lub oba te elementy. Gdy skończysz, kliknij Dodaj pakiet.

    Jeśli aktualizujesz Google Places Swift

    Ważne: od wersji 0.3.0 adres URL GitHuba, który umożliwia dostęp do Google Places Swift, zmienił się. Jeśli aktualizujesz wersję GooglePlacesSwift, do której dostęp uzyskiwano za pomocą starego adresu URL, https://github.com/googlemaps/ios-places-swift-sdk, usuń ją z sekcji zależności pakietu Xcode.

  5. Aby sprawdzić instalację, otwórz panel Ogólne celu. W sekcji Frameworki, biblioteki i wbudowane treści powinny być widoczne zainstalowane pakiety. Aby sprawdzić pakiet i jego wersję, możesz też wyświetlić sekcję Zależności pakietu w Nawigatorze projektu. Xcode pokazuje wersję GitHuba, która jest zgodna z wersją GooglePlaces (np. 9.2.0), ale nie jest zgodna z wersją GooglePlacesSwift (np. 0.3.0).

Aby zaktualizować package w istniejącym projekcie:

  1. W Xcode wybierz „Plik > Pakiety > Zaktualizuj do najnowszej wersji pakietu”.

    Jeśli aktualizujesz Google Places Swift

    Ważne: od wersji 0.3.0 adres URL GitHuba, który umożliwia dostęp do Google Places Swift, zmienił się. Jeśli aktualizujesz wersję GooglePlacesSwift, do której dostęp uzyskiwano za pomocą starego adresu URL, https://github.com/googlemaps/ios-places-swift-sdk, usuń ją z sekcji zależności pakietu Xcode.

  2. Aby sprawdzić instalację, otwórz sekcję Zależność pakietu w Nawigatorze projektu, aby zweryfikować pakiet i jego wersję.

CocoaPods

Zamiast używać operatora optymistycznego (~>), zawsze podawaj numer wersji w zależnościach, ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet SDK Miejsc na iOS stosuje wersje semantyczne, a nowe wersje główne zawierają zmiany powodujące niezgodność.

Przykład zależności w pliku Podfile przy użyciu składni Podfile:

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.0'
end

Konserwacja i uaktualnienia

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj dostępność nowszych wersji i aktualizuj specyfikacje wersji. Jeśli przechodzisz na nową główną wersję, przeczytaj informacje o wersji, aby dowiedzieć się, jakie zmiany powodują niezgodność wsteczną i jak zaktualizować kod.

Menedżer pakietów Swift

Aby zaktualizować package w istniejącym projekcie:

  1. Aby sprawdzić instalację, otwórz sekcję Zależność pakietu w Nawigatorze projektu, aby zweryfikować pakiet i jego wersję.

Cocoapods

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

    cd <path-to-project>
  2. Uruchom pod outdated, aby sprawdzić, czy dostępna jest nowsza wersja pakietu Places SDK na iOS.
  3. Jeśli wykryjemy nowszą wersję pakietu SDK, zaktualizuj pakiet Podfile do tej wersji. Aby dowiedzieć się, jak ustawić konkretną wersję w Podfile, zapoznaj się z artykułem Określanie wersji podgrup.
  4. Uruchom pod update.
  5. Wprowadź wszelkie zmiany wymagane w związku z aktualizacją. Aby poznać listę zmian w każdej wersji, zapoznaj się z informacjami o wersji.
  6. Oczyść i ponownie skompiluj projekt, wybierając kolejno Produkt > Oczyść i Produkt > Kompiluj.

Instalacja ręczna

Link do najnowszych plików źródłowych znajdziesz w sekcji Instalowanie pakietu SDK.

Oprócz pobierania nowych wersji właściciele projektów Google Cloud otrzymują e-maile o zmianach niezgodnych ze starszymi wersjami, które mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach niezgodnych ze starszymi wersjami, przypisz rolę właściciela, używając monitorowanego adresu e-mail w każdym z projektów.