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 poprawy wydajności. Na tej stronie znajdziesz wskazówki dotyczące zarządzania zależnościami w przypadku mobilnych pakietów SDK.

  • W przypadku aplikacji o kluczowym znaczeniu podaj najnowszą wersję z kropkami (X.*) i co roku uaktualniać ją do nowej wersji głównej.

    W miarę publikowania nowych wersji aplikacji w ciągu roku możesz zacząć korzystać z nowszych wersji pakietu SDK Places na iOS. Dzięki temu nie wymagają aktualizacji w aplikacji, ponieważ nowe wersje z kropkami są zgodne wstecznie.

    Zalety:

    • Jeśli wykryjesz problemy w pakiecie SDK Places na iOS, poprawki zostaną udostępnione w wstecznie przez 12 miesięcy od premiery wersji głównej zgodnie z dział pomocy ds. telefonów komórkowych . Nie musisz pilnie przejść na niezgodną wersję pakietu SDK na poprawki.
    • Wdrożenie najnowszych ulepszeń i funkcji jest proste, gdy aplikacja jest już utworzona najnowszą wersję.
    • Coroczne aktualizacje przyrostowe do najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy adaptacji, przeredagowania i testowania aplikacji, a nie w przypadku braku zgodności wstecznej. zmian wprowadzonych w wielu wersjach głównych.

  • W przypadku niekrytycznych aplikacji podaj link do dowolnej poprawionej wersji. Gdy otrzymujesz informacje o wycofaniu na powiadomienie o naprawionej wersji masz 12 miesięcy na udostępnienie użytkowników.

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje aplikacji w dalszym ciągu obsługują na urządzeniach ze starszymi systemami operacyjnymi mobilnymi systemów uczących się (dopóki nie trzeba będzie uaktualnić pakietu do nowej wersji pakietu SDK).

Właściciele projektu ze monitorowanymi adresami e-mail otrzymują aktywne powiadomienia o zmianach, które na każdy z ich projektów. Zostań aby były na bieżąco z najważniejszymi aktualizacjami, wycofywaniami i innymi zmianami.

Instalacja

Menedżer pakietów Swift

Pakiet Places SDK dla iOS można zainstalować za pomocą Menedżer pakietów Swift. Aby dodać pakiet SDK, upewnij się, że masz usunęliśmy wszystkie zależności istniejącego pakietu Places SDK dla iOS.

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

  1. Otwórz Xcode project lub workspace i przejdź do File > (Plik >). Dodaj zależności pakietów.
  2. Jako URL wpisz https://github.com/googlemaps/ios-places-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
  3. Aby zainstalować określony element version, w polu Reguła zależności ustaw jedną z z użyciem opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i za pomocą opcji „Dokładna wersja” . Gdy skończysz, kliknij „Dodaj pakiet”.
  4. W oknie Wybierz produkty w pakiecie sprawdź, czy GooglePlaces zostanie dodany do wyznaczonej wartości docelowej main. Gdy skończysz, kliknij „Dodaj pakiet”.
  5. Aby sprawdzić instalację, przejdź do panelu General środowiska docelowego. W obszarze Frameworks, biblioteki i umieszczona treść powinny być widoczne zainstalowane pakiety. Możesz też wyświetlić „Zależności pakietów” w narzędziu „Project Navigator” aby zweryfikować pakiet i jego wersję.

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

  1. W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
  2. Aby sprawdzić poprawność instalacji, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator. aby zweryfikować pakiet i jego wersję.
.

CocoaPods

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

Przykładowa zależność Podfile wykorzystująca Składnia Podfile:

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

platform :ios, '15.0'

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

Konserwacja i uaktualnienie

Aby kompilować z najnowszymi ulepszeniami, regularnie sprawdzaj dostępność nowszych wersji i aktualizuj je specyfikacji. W przypadku aktualizacji do nowej wersji głównej zapoznaj się z informacjami o wersji, w których znajdziesz informacje o zmianach niezgodnych wstecznie i sposobach aktualizowania kodu.

Menedżer pakietów Swift

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

  1. W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
  2. Aby sprawdzić poprawność instalacji, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator. aby zweryfikować pakiet i jego wersję.
.

Cocoapody

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

    cd <path-to-project>
  2. Uruchom pod outdated, by sprawdzić, czy jest dostępna nowsza wersja pakietu SDK Miejsc na iOS jest dostępna.
  3. Jeśli zostanie znaleziona nowsza wersja pakietu SDK, zaktualizuj do niej Podfile. Zobacz Określanie wersji podów. aby dowiedzieć się, jak ustawić konkretną wersję w: Podfile.
  4. Uruchom pod update.
  5. Wprowadź wszelkie niezbędne zmiany w wyniku uaktualnienia. Zobacz Informacje o wersji, w których znajdziesz listę zmian wprowadzonych w każdej wersji.
  6. Wyczyść i odbuduj projekt, wybierając Produkt > Wyczyść, a potem Produkt > Kompilacja

Instalacja ręczna

Uzyskiwanie linku do najnowszych plików źródłowych podczas instalowania pakietu SDK.

Oprócz odpytywania w poszukiwaniu nowszych wersji Google Cloud projekt właścicieli otrzymują e-maile o niekompatybilnych wstecznie zmianach, które mogą mieć wpływ na ich projekty. Do otrzymywać proaktywne powiadomienia o niekompatybilnych wstecznie zmianach, przypisz rolę właściciela z monitorowanym adresem e-mail każdego z Twoich projektów.