Pakiet SDK Miejsc na iOS

Wybierz platformę: Android iOS JavaScript

Uwaga: funkcje pakietu Places SDK na iOS dostępne w Twojej aplikacji zależą od kombinacji numeru wersji pakietu SDK określonego w konfiguracji aplikacji i interfejsów API włączonych na kluczu interfejsu API. Więcej informacji znajdziesz w artykule Wybór wersji pakietu SDK.

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 od mobilnych pakietów SDK.

Z którą wersją chcesz utworzyć połączenie?

• W przypadku aplikacji o krytycznym znaczeniu utwórz link do najnowszej 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ąć używać nowszych wersji pakietu Places SDK na iOS. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje są wstecznie zgodne.

  Korzyści:

  • Jeśli w pakiecie SDK Miejsc na iOS wykryjesz problemy, poprawki będą udostępniane w sposób zapewniający zgodność wsteczną przez 12 miesięcy od pierwszej publikacji wersji głównej zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Aby korzystać z poprawek, nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK.
  • Gdy aplikacja jest już oparta na najnowszej wersji, łatwo jest wdrożyć najnowsze ulepszenia i funkcje.
  • Coroczne aktualizacje do najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż obsługa zmian, które nie są wstecznie zgodne i zostały wprowadzone w kilku głównych wersjach.

• W przypadku aplikacji o mniejszym znaczeniu połącz się z dowolną stałą wersją. Gdy otrzymasz powiadomienie o wycofaniu tej stałej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.

  Korzyści:

  • rzadsze prace konserwacyjne,
  • Nowe wersje aplikacji dłużej obsługują urządzenia użytkowników z starszymi mobilnymi systemami operacyjnymi (do momentu, gdy musisz 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 poszczególne projekty. Bądź na bieżąco z najważniejszymi aktualizacjami, wycofaniami i innymi zmianami.

Instalacja

Swift Package Manager

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

Ważne: te instrukcje zakładają użycie Xcode 15 lub nowszego, ale powinny być podobne w przypadku starszych wersji Xcode.

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

1. Otwórz Xcode project lub workspace, a potem kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu).
2. Wpisz https://github.com/googlemaps/ios-places-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, a następnie kliknij „Add Package” (Dodaj pakiet).
3. Aby zainstalować konkretną version, ustaw w polu Reguła zależności 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 do wybranego głównego celu zostaną dodane produkty GooglePlaces, GooglePlacesSwift lub oba. Gdy skończysz, kliknij Dodaj pakiet.

   Jeśli aktualizujesz Google Places Swift z wygasłego adresu URL GitHub

   Ważne: od wersji 0.3.0 zmienił się adres URL GitHub, za pomocą którego można uzyskać dostęp do Google Places Swift. Jeśli aktualizujesz wersję GooglePlacesSwift, do której dostęp uzyskano za pomocą starego adresu URL, https://github.com/googlemaps/ios-places-swift-sdk, usuń ją z sekcji zależności pakietów w Xcode.

5. Aby sprawdzić instalację, otwórz panel Ogólne w przypadku wybranego celu. W sekcji Frameworki, biblioteki i treści osadzone powinny być widoczne zainstalowane pakiety. Możesz też sprawdzić pakiet i jego wersję w sekcji Zależności pakietu w Nawigatorze projektu.

Aby zaktualizować package w przypadku istniejącego projektu:

1. W Xcode kliknij „File > Packages > Update To Latest Package Versions” (Plik > Pakiety> Zaktualizuj do najnowszych wersji pakietów).

   Jeśli aktualizujesz Google Places Swift z wygasłego adresu URL GitHub

   Ważne: od wersji 0.3.0 zmienił się adres URL GitHub, za pomocą którego można uzyskać dostęp do Google Places Swift. Jeśli aktualizujesz wersję GooglePlacesSwift, do której dostęp uzyskano za pomocą starego adresu URL, https://github.com/googlemaps/ios-places-swift-sdk, usuń ją z sekcji zależności pakietów w Xcode.

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

Ważne: czasami nie można rozwiązać problemów z artefaktami lub mogą wystąpić błędy. W takim przypadku wybierz „Plik > Pakiety > Zresetuj pamięć podręczną pakietów”.

CocoaPods

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

Przykładowa zależność Podfile z użyciem składni Podfile:

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

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.1.0'
  pod 'GooglePlacesSwift', '10.1.0'
end

Konserwacja i aktualizacja

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj, czy są dostępne nowsze wersje, i aktualizuj specyfikacje wersji. Jeśli aktualizujesz pakiet do nowej wersji głównej, zapoznaj się z informacjami o wersji, aby dowiedzieć się o zmianach powodujących niezgodność wsteczną i o tym, jak zaktualizować kod.

Swift Package Manager

Aby zaktualizować package w przypadku istniejącego projektu:

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

Ważne: czasami nie można rozwiązać problemów z artefaktami lub mogą wystąpić błędy. W takim przypadku wybierz „Plik > Pakiety > Zresetuj pamięć podręczną pakietów”.

Cocoapods

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

   cd <path-to-project>

2. Uruchom polecenie pod outdated, aby sprawdzić, czy jest dostępna nowsza wersja pakietu Places SDK na iOS.
3. Jeśli znajdziesz nowszą wersję pakietu SDK, zaktualizuj Podfile do tej nowej wersji. Więcej informacji o ustawianiu konkretnej wersji w pliku Podfile znajdziesz w sekcji Określanie wersji poda.
4. Uruchom pod update.
5. Wprowadź niezbędne zmiany w wyniku uaktualnienia. Listę zmian w poszczególnych wersjach znajdziesz w informacjach o wersji.
6. Wyczyść i ponownie skompiluj projekt, wybierając kolejno Product (Produkt) > Clean (Wyczyść) i Product (Produkt) > Build (Skompiluj).

Instalacja ręczna

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

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