Zespół Google Maps Platform regularnie aktualizuje pakiety SDK, dodają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 pakietów SDK do aplikacji mobilnych.
Którą wersję połączyć?
-
W przypadku aplikacji o kluczowym znaczeniu utwórz link do najnowszej wersji podrzędnej używanej wersji głównej (X.*) i co roku uaktualniaj do nowej wersji głównej.
W ciągu roku, gdy będziesz publikować nowe wersje aplikacji, możesz zacząć używać nowszych wersji pakietu Places SDK for iOS. Nie będzie to wymagało aktualizacji aplikacji, ponieważ nowe wersje są zgodne wstecznie.
Zalety:
- Jeśli wykryjesz problemy z pakietem Places SDK for iOS, poprawki będą udostępniane w sposób zgodny wstecznie przez 12 miesięcy od początkowej premiery wersji głównej, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK, aby korzystać z poprawek.
- Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy aplikacja jest już oparta na najnowszej wersji.
- Coroczne aktualizacje przyrostowe do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy związanej z dostosowywaniem, przepisywaniem i testowaniem aplikacji niż obsługa zmian wprowadzonych w kilku wersjach głównych, które nie są zgodne wstecznie.
W przypadku aplikacji niekrytycznych podaj link do dowolnej wersji, w której problem został rozwiązany. Gdy otrzymasz powiadomienie o wycofaniu tej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.
Zalety:
- Rzadsze prace konserwacyjne.
- Nowe wersje aplikacji będą dłużej obsługiwać urządzenia użytkowników z wcześniejszymi mobilnymi systemami operacyjnymi (do czasu, gdy trzeba będzie 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 ich projekty. Bądź na bieżąco z dużymi aktualizacjami, wycofaniami i innymi zmianami.
Instalacja
Swift Package Manager
Pakiet SDK Miejsc na iOS można zainstalować za pomocą Swift Package Managera. Aby dodać pakiet SDK, usuń wszystkie dotychczasowe zależności pakietu SDK Miejsc na iOS.
Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:
-
Otwórz plik
projectlubworkspacew Xcode, a następnie kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu). - Wpisz https://github.com/googlemaps/ios-places-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, i kliknij „Add Package” (Dodaj pakiet).
-
Aby zainstalować konkretną wersję
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”. - W oknie Wybierz produkty w pakiecie sprawdź, czy do wyznaczonego głównego celu zostaną dodane
GooglePlaces,GooglePlacesSwiftlub obie te usługi. Gdy skończysz, kliknij Dodaj pakiet.Jeśli aktualizujesz pakiet Google Places Swift z wycofanego adresu URL na GitHubie
Ważne: adres URL GitHuba umożliwiający dostęp do Google Places Swift zmienił się od wersji 0.3.0. 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 pakietu Xcode. - Aby sprawdzić instalację, otwórz panel General (Ogólne) celu. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści umieszczone). Możesz też wyświetlić sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.
Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:
-
W Xcode kliknij File (Plik) > Packages (Pakiety) > Update To Latest Package Versions (Zaktualizuj do najnowszych wersji pakietów).
Jeśli aktualizujesz pakiet Google Places Swift z wycofanego adresu URL na GitHubie
Ważne: adres URL GitHuba umożliwiający dostęp do Google Places Swift zmienił się od wersji 0.3.0. 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 pakietu Xcode. - Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu i sprawdź pakiet oraz jego wersję.
Konserwacja i uaktualnianie
Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj dostępność nowszych wersji i aktualizuj specyfikacje wersji. Jeśli aktualizujesz do nowej wersji głównej, sprawdź w informacjach o wersji, czy nie ma zmian, które nie są zgodne wstecznie, i dowiedz się, jak zaktualizować kod.
Swift Package Manager
To update the package for an existing project, follow these steps:
-
To verify your installation, go to the Package Dependencies section of Project Navigator
to verify the package and its version.
Instalacja ręczna
Pobierz link do najnowszych plików źródłowych w sekcji Instalowanie pakietu SDK.
Oprócz sprawdzania, czy są dostępne nowsze wersje, właściciele projektów Google Cloud otrzymują e-maile o zmianach, które nie są zgodne wstecznie i mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach, które nie są zgodne wstecznie, przypisz rolę właściciela z monitorowanym adresem e-mail do każdego ze swoich projektów.