Konfigurowanie Usług Google Play

Jeśli chcesz utworzyć aplikację, korzystając z interfejsów API Usług Google Play, postępuj zgodnie z instrukcjami na tej stronie, aby skonfigurować w projekcie odpowiednie pakiety SDK, które są dostępne z repozytorium Google Maven.

Aby przetestować aplikację w Usługach Google Play, musisz skorzystać z jednej z tych funkcji:

  • zgodne urządzenie z Androidem 5.0 (poziom interfejsu API 21) lub nowszym i zainstalowaną aplikacją Sklep Google Play.
  • Emulator Androida z AVD, który obsługuje platformę interfejsów API Google w Androidzie 5.0 (poziom API 21) lub nowszym.

Deklarowanie zależności dla Usług Google Play

Aby tworzyć w aplikacji funkcje zależne od interfejsów API Usług Google Play, wykonaj te czynności:

  1. Otwórz plik build.gradle w katalogu modułów aplikacji.

  2. W przypadku każdego pakietu SDK, którego wymaga Twoja aplikacja, uwzględnij zależność z tym pakietem. Ta strona zawiera sekcję z listą typowych zależności od Usług Google Play w aplikacjach na Androida. Możesz też dodać do projektu zależności Firebase.

  3. Zapisz zmiany i zsynchronizuj projekt.

Ten fragment kodu zawiera przykładowy plik build.gradle, który korzysta z biblioteki lokalizacji:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.0'
}

Co jakiś czas publikowane są nowe wersje pakietów SDK Usług Google Play z poprawkami błędów i nowymi funkcjami. Te aktualizacje są ogłaszane w informacjach o wersjach. Jeśli aplikacja korzysta z zależności, która została zaktualizowana, przejdź do najnowszej wersji w zależności od aplikacji, aby skorzystać z tych poprawek.

Sprawdzanie, czy Usługi Google Play są zainstalowane

Zgodnie z opisem w omówieniu Usług Google Play Usługi Google Play otrzymują automatyczne aktualizacje na Androidzie 5.0 (poziom interfejsu API 21) i nowszym przez aplikację Sklep Google Play. Jednak na urządzeniach z Androidem, na których nie ma Sklepu Google Play, nie są zainstalowane usługi Google Play. Jeśli Twoja aplikacja działa na urządzeniach bez Usług Google Play, przed próbą użycia interfejsów API Google sprawdź, czy Usługi Google Play są zainstalowane na urządzeniu, lub włącz w aplikacji funkcje, które wymagają do działania Usług Google Play.

Aby sprawdzić dostępność Usług Google Play na urządzeniu, użyj metody isGooglePlayServicesAvailable().

Aby rozpocząć połączenie z Usługami Google Play lub dowiedzieć się, jak sprawdzić, czy zainstalowana wersja Usług Google Play obsługuje określony interfejs API, przeczytaj przewodnik Uzyskiwanie dostępu do interfejsów API Google.

Zależności Usług Google Play

W tabeli poniżej znajdziesz zależności od Usług Google Play, które możesz uwzględnić w aplikacji na Androida. Możesz filtrować listę według typu urządzenia, klikając jeden z przycisków. Możesz też wyszukać konkretny przypadek użycia lub nazwę zależności, wpisując tekst w polu, które pojawia się po przyciskach.

Tabela 1. Zależności Usług Google Play do uwzględnienia w aplikacjach na Androida
Przypadek użycia i nazwa zależności Obsługiwane urządzenia
Reklamy mobilne Google
com.google.android.gms:play-services-ads:23.1.0
Telefon, tablet
Identyfikator wyświetlania reklam na urządzeniach z Androidem (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
Telefon, tablet, Android TV, ChromeOS
Uproszczona wersja reklam mobilnych Google
com.google.android.gms:play-services-ads-lite:23.1.0
Telefon, tablet
Reklamy w wyszukiwarce niestandardowej AdSense dla wyszukiwania (CSA)
com.google.android.gms:play-services-afs-native:19.1.0
Telefon, tablet, ChromeOS
Pakiet SDK usług Google Analytics na Androida
com.google.android.gms:play-services-analytics:18.1.0
Wycofano. Zamiast tego używaj Google Analytics dla Firebase.
Indeks aplikacji
com.google.android.gms:play-services-appindex:16.2.0
Telefon, tablet, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.0
Telefon, tablet, Android TV
Identyfikator zestawu aplikacji na Androida
com.google.android.gms:play-services-appset:16.1.0
Telefon, tablet, Android TV, ChromeOS
Logowanie przez Google na Androidzie
com.google.android.gms:play-services-auth:21.2.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
SMS retriever API
com.google.android.gms:play-services-auth-api-phone:18.1.0
Telefon, tablet, Android Go
Block Store API (obejmuje magazyn danych logowania użytkowników)
com.google.android.gms:play-services-auth-blockstore:16.2.0
Telefon, tablet, Android Go, ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.1.0
Telefon, tablet, Auto, Android Go, ChromeOS
Klasy wykorzystania
com.google.android.gms:play-services-base:18.5.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Testowanie fałszywych informacji klasowych
com.google.android.gms:play-services-base-testing:16.1.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Więcej klas użytkowych
com.google.android.gms:play-services-basement:18.4.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.5.0
Telefon, tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:21.5.0
Telefon, tablet, Android Go, ChromeOS
Odbiorniki Android TV
com.google.android.gms:play-services-cast-tv:21.1.0
Android TV
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.1.0
Telefon, tablet, Android Go, ChromeOS
Stos sieci Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.1.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Interakcje między urządzeniem a urządzeniem (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
Telefon, tablet, Android Go
Szybkie uwierzytelnianie IDentity Online (FIDO)
com.google.android.gms:play-services-fido:21.1.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Obsługiwane na urządzeniach z Androidem 7.0 (poziom interfejsu API 24) lub nowszym.
Google Fit API na Androida i Recording API na urządzenia mobilne (w przypadku danych o kondycji użytkowników).
com.google.android.gms:play-services-fitness:21.2.0
Telefon, tablet, Android Go, ChromeOS, Wear OS
Usługi gier Google Play w wersji 2 na Androida
com.google.android.gms:play-services-games-v2:20.1.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Natywny pakiet SDK C na Androida w usługach gier Google Play w wersji 2
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Telefon, tablet, Android TV, Android Go, ChromeOS
Usługi gier Google Play w wersji 1 na Androida
com.google.android.gms:play-services-games:23.2.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Matter API
com.google.android.gms:play-services-home:16.0.0
Telefon, tablet
Aplikacja błyskawiczna w Google Play
com.google.android.gms:play-services-instantapps:18.1.0
Telefon, tablet, Android TV, Android Go, ChromeOS

Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym.
Usługi lokalizacyjne na Androida
com.google.android.gms:play-services-location:21.3.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Maps SDK na Androida
com.google.android.gms:play-services-maps:18.2.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Skanowanie kodów kreskowych ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0
Telefon, tablet, Android Go, ChromeOS
Skaner dokumentów ML Kit
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
Telefon, tablet, Android Go, ChromeOS
Wykrywanie twarzy przy użyciu ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Telefon, tablet, Android Go, ChromeOS
Oznaczanie obrazów etykietami ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefon, tablet, Android Go, ChromeOS
Niestandardowe etykiety obrazów ML Kit
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Telefon, tablet, Android Go, ChromeOS
Identyfikacja języka w ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Telefon, tablet, Android Go, ChromeOS
Inteligentna odpowiedź ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Telefon, tablet, Android Go, ChromeOS
Segmentacja tematów w ML Kit
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu przy użyciu ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w języku chińskim za pomocą ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w języku dewanagari za pomocą ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w języku japońskim za pomocą ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w języku koreańskim za pomocą ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
Telefon, tablet, Android Go, ChromeOS
Wykrywanie urządzeń w pobliżu i nawiązywanie połączeń
com.google.android.gms:play-services-nearby:19.3.0
Telefon, tablet, Android TV, Auto, Android Go
Pokaż licencje open source
com.google.android.gms:play-services-oss-licenses:17.1.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym.
Kontrola jakości blokady ekranu
com.google.android.gms:play-services-password-complexity:18.1.0
Telefon, tablet, Android Go, ChromeOS, Wear OS

Obsługiwane na urządzeniach z Androidem w wersji od 4.4 (poziom interfejsu API 19) do 9 (poziom interfejsu API 28).
Portfel Google (wcześniej Google Pay dla kart)
com.google.android.gms:play-services-pay:16.5.0
Telefon, tablet, Android Go, ChromeOS

Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 20) lub nowszym.
reCAPTCHA Enterprise do instrumentacji aplikacji
com.google.android.gms:play-services-recaptcha:17.1.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Interfejsy SafetyNet API (w tym atest urządzenia, bezpieczne przeglądanie, reCAPTCHA i weryfikacja aplikacji)
com.google.android.gms:play-services-safetynet:18.1.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
Menedżer tagów Google
com.google.android.gms:play-services-tagmanager:18.1.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Interfejs Tasks API na Androidzie
com.google.android.gms:play-services-tasks:18.2.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service na Androida
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite GPU Delegate API dla usług Google Play
com.google.android.gms:play-services-tflite-gpu:16.2.0
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite Java API dla usług Google Play
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite Support API dla usług Google Play
com.google.android.gms:play-services-tflite-support:16.1.0
Telefon, tablet, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.1
Telefon, tablet
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
Telefon, tablet, Android Go, ChromeOS
Google Pay w płatnościach na urządzeniach z Androidem
com.google.android.gms:play-services-wallet:19.4.0
Telefon, tablet, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.2.0
Telefon, tablet, Wear OS

Wtyczki Gradle

Usługi Google Play zawierają też kilka wtyczek Gradle, jak pokazano w poniższej tabeli. Pamiętaj, że przyciski, które pojawiają się przed poprzednią tabelą, nie zmieniają informacji, które są w niej widoczne.

Tabela 2. Lista wtyczek Gradle uwzględnionych w Usługach Google Play
Przypadek użycia i nazwa wtyczki Gradle Obsługiwane urządzenia
Pokaż licencje open source
com.google.android.gms:oss-licenses-plugin:0.10.6
Telefon, tablet, ChromeOS
Ścisłe sprawdzanie wersji
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS