Ta strona została przetłumaczona przez Cloud Translation API.

Pakiet SDK dla klientów indywidualnych do wersji iOS

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.

Którą wersję utworzyć jako link?

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 Consumer SDK 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 dla klientów indywidualnych 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

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 dla klientów indywidualnych na iOS jest zgodny z obsługą wersji semantycznych, a nowe wersje główne zawierają zmiany powodujące niezgodność.

Menedżer pakietów Swift

Pakiet SDK klienta można zainstalować za pomocą programu Menedżer pakietów Swift. Aby dodać pakiet SDK, upewnij się, że masz usunięto wszystkie zależności od pakietów SDK klienta.

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

Otwórz Xcode project lub workspace i przejdź do File > (Plik >). Dodaj zależności pakietów.
Jako URL wpisz https://github.com/googlemaps/ios-consumer-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
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”.
W oknie Wybierz produkty w pakiecie sprawdź, czy GoogleRidesharingConsumer zostanie dodany do wyznaczonej wartości docelowej main. Gdy skończysz, kliknij „Dodaj pakiet”.
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:

W przypadku uaktualnienia z wersji wcześniejszej niż 9.0.0 musisz usunąć te zależności: GoogleMapsBase, GoogleMapsCore oraz GoogleMapsM4B po uaktualnieniu. Nie usuwaj zależności dla GoogleMaps Więcej informacji: Informacje o wersji 9.0.0

W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, i Umieszczone treści. Aby usunąć strukturę, użyj znaku minusa(-):
- GoogleMapsBase (tylko w przypadku uaktualnień z wersji starszych niż 9.0.0)
- GoogleMapsCore (tylko w przypadku uaktualnień z wersji starszych niż 9.0.0)
- GoogleMapsM4B (tylko w przypadku uaktualnień z wersji starszych niż 9.0.0)
W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
Aby sprawdzić poprawność instalacji, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator. aby zweryfikować pakiet i jego wersję.

Aby usunąć istniejące zależności pakietu SDK klienta dodane za pomocą CocoaPods, wykonaj te czynności:

Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj to polecenie:

sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all

Usuń Podfile, Podfile.resolved i Kod Xcode workspace, jeśli nie używasz ich do żadnych innych celów niż CocoaPods.

CocoaPods

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

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

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', ' 2.2.0'
    end

Przykładowa zależność Podfile związana z używaniem pakietu SDK klienta w wersji beta:

    source "https://cpdc-eap.googlesource.com/ridesharing-consumer-sdk"
    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', '2.1.0-beta01.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 informacje o wersji .

Cocoapody

Otwórz terminal i przejdź do katalogu zawierającego Podfile:
```
cd <path-to-project>
```
Uruchom pod outdated, aby sprawdzić, czy jest dostępna nowsza wersja pakietu SDK dla klientów na iOS jest dostępna.
Jeśli znajdziemy nowszą wersję pakietu SDK, zaktualizuj ją w Podfile. Zobacz Określanie wersji podów. aby dowiedzieć się, jak ustawić konkretną wersję w: Podfile.
Uruchom pod update.
Wprowadź wszelkie niezbędne zmiany w wyniku uaktualnienia. Zobacz Informacje o wersji, w których znajdziesz listę zmian wprowadzonych w każdej wersji.
Wyczyść i odbuduj projekt, wybierając Produkt > Wyczyść, a potem Produkt > Kompilacja

Ręcznie

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.