Zespół Platformy Map Google 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 na urządzenia mobilne.
Którą wersję połączyć?
-
W przypadku aplikacji o krytycznym znaczeniu połącz się z najnowszą wersją główną, której używasz (X.*), i co roku aktualizuj ją do nowej wersji głównej.
W miarę publikowania nowych wersji aplikacji w ciągu roku możesz zacząć używać nowszych wersji pakietu SDK Miejsc na iOS. Nie będzie to wymagało aktualizacji w aplikacji, ponieważ nowe wersje są wstecznie zgodne.
Zalety:
- Jeśli wykryjesz problemy w pakiecie SDK Miejsc na iOS, poprawki będą udostępniane w sposób wstecznie zgodny przez 12 miesięcy od pierwszej wersji głównej zgodnie z zasadami pomocy na urządzeniach mobilnych. Aby korzystać z poprawek, nie musisz pilnie aktualizować do niezgodnej wersji pakietu SDK.
- Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy aplikacja jest już oparta na najnowszej wersji.
- Coroczne aktualizacje do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż konieczność radzenia sobie ze zmianami, które nie są wstecznie zgodne i zostały wprowadzone w kilku wersjach głównych.
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 wersjami mobilnych systemów operacyjnych (do momentu, gdy trzeba będzie przejść na nową wersję pakietu SDK).
Właściciele projektów, którzy mają monitorowane adresy e-mail, otrzymują proaktywne powiadomienia o zmianach wpływających na każdy z ich projektów. Bądź na bieżąco z ważnymi aktualizacjami, wycofywaniem funkcji i innymi zmianami.
Instalacja
Swift Package Manager
Pakiet SDK Miejsc na iOS można zainstalować za pomocą narzędzia Swift Package Manager. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie dotychczasowe zależności pakietu SDK Miejsc na iOS.
Aby dodać pakiet SDK do nowego lub istniejącego projektu:
-
Otwórz
projectlubworkspaceXcode, a następnie kliknij File > Add Package Dependencies. - 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).
-
Aby zainstalować określoną
version, ustaw pole Dependency Rule na jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Exact Version” (Dokładna wersja). Gdy skończysz, kliknij „Add Package” (Dodaj pakiet). - W oknie Choose Package Products (Wybierz produkty pakietu) sprawdź, czy do wybranego celu głównego zostaną dodane pakiety
GooglePlaces,GooglePlacesSwift, lub oba. Gdy skończysz, kliknij Add Package (Dodaj pakiet).Jeśli aktualizujesz Google Places Swift z wycofanego 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 pakietu w Xcode. - Aby sprawdzić instalację, otwórz panel General (Ogólne) w celu. W sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) powinny być widoczne zainstalowane pakiety. Aby sprawdzić pakiet i jego wersję, możesz też otworzyć sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu).
Aby zaktualizować package w istniejącym projekcie:
-
W Xcode kliknij File > Packages > Update To Latest Package Versions (Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietu).
Jeśli aktualizujesz Google Places Swift z wycofanego 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 pakietu w Xcode. - Aby sprawdzić instalację, otwórz sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu) i sprawdź pakiet oraz jego wersję.
Konserwacja i aktualizacja
Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj dostępność nowszych wersji i aktualizuj specyfikacje wersji. Jeśli aktualizujesz do nowej wersji głównej, zapoznaj się z informacjami o wersji, aby dowiedzieć się o zmianach, które nie są wstecznie zgodne, i o tym, jak zaktualizować kod.
Swift Package Manager
Aby zaktualizować package w istniejącym projekcie:
- Aby sprawdzić instalację, otwórz sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu) i sprawdź pakiet oraz jego wersję.
Instalacja ręczna
Link do najnowszych plików źródłowych znajdziesz w artykule Instalowanie pakietu SDK.
Oprócz sprawdzania dostępności nowszych wersji właściciele projektów Google Cloud projektu otrzymują e-maile o zmianach, które nie są wstecznie zgodne i mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach, które nie są wstecznie zgodne, przypisz rolę właściciela do monitorowanego adresu e-mail w każdym ze swoich projektów.