Konfigurowanie Usług Google Play

Jeśli chcesz utworzyć aplikację przy użyciu interfejsów API Usług Google Play, wykonaj instrukcje podane na tej stronie, aby skonfigurować projekt przy użyciu odpowiednich pakietów SDK, które są dostępne w repozytorium Google Maven.

Aby przetestować aplikację przy użyciu Usług Google Play, musisz użyć jednego z tych elementów:

  • Zgodne urządzenie z Androidem 5.0 (poziom interfejsu API 21) lub nowszym i zainstalowaną aplikacją Sklep Google Play.
  • Emulator Androida z interfejsem AVD, który uruchamia platformę interfejsów API Google w oparciu o Androida 5.0 (poziom API 21) lub nowszy.

Deklarowanie zależności w przypadku Usług Google Play

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

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

  2. Podaj zależność każdego pakietu SDK, którego wymaga Twoja aplikacja. Ta strona zawiera sekcję zawierającą listę typowych zależności Usług Google Play w przypadku aplikacji 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.0.1'
}

Co jakiś czas publikujemy nowe wersje pakietów SDK Usług Google Play z poprawkami błędów i nowymi funkcjami. Informacje o tych zmianach znajdziesz w informacjach o wersji. Jeśli aplikacja korzysta ze zaktualizowanej zależności, przejdź na najnowszą wersję w zależnościach aplikacji, aby skorzystać z tych poprawek.

Sprawdzanie, czy Usługi Google Play są zainstalowane

Jak opisano w sekcji Omówienie Usług Google Play, Usługi Google Play otrzymują automatyczne aktualizacje na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) i nowszym za pomocą aplikacji Sklep Google Play. Na urządzeniach z Androidem, które nie mają Sklepu Google Play, nie mają zainstalowanych Usług Google Play. Jeśli Twoja aplikacja działa na urządzeniach bez Usług Google Play, przed skorzystaniem z interfejsów API Google sprawdź, czy na urządzeniu są zainstalowane Usługi Google Play, lub włącz w aplikacji funkcje, które wymagają do działania Usług Google Play.

Aby sprawdzić, czy na urządzeniu są dostępne Usługi Google Play, użyj metody isGooglePlayServicesAvailable().

Aby później 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 na temat uzyskiwania dostępu do interfejsów API Google.

Zależności Usług Google Play

W tabeli poniżej znajdziesz zależności usług Google Play, które możesz uwzględnić w swojej aplikacji na Androida. Możesz filtrować listę według typu urządzenia, wybierają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 pojawi się za przyciskami.

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:22.6.0
Telefon, tablet
Identyfikator wyświetlania reklam na urządzeniach z Androidem (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
Telefon, tablet, Android TV, ChromeOS
Lekka wersja reklam mobilnych Google
com.google.android.gms:play-services-ads-lite:22.6.0
Telefon, tablet
Reklamy AdSense dla wyszukiwania w wyszukiwarce niestandardowej
com.google.android.gms:play-services-afs-native:19.0.3
Telefon, tablet, ChromeOS
Pakiet SDK usług Google Analytics na Androida
com.google.android.gms:play-services-analytics:18.0.4
Wycofano. Używaj Google Analytics dla Firebase.
Indeks aplikacji
com.google.android.gms:play-services-appindex:16.1.0
Telefon, tablet, Android TV
Identyfikator zestawu aplikacji na Androida
com.google.android.gms:play-services-appset:16.0.2
Telefon, tablet, Android TV, ChromeOS
Logowanie przez Google na urządzeniach z Androidem
com.google.android.gms:play-services-auth:20.7.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.0.1
Telefon, tablet, Android Go
Block Store API (w tym magazyn danych logowania użytkowników)
com.google.android.gms:play-services-auth-blockstore:16.2.0
Telefon, tablet, Android Go, ChromeOS
Interfejs Google Awareness API
com.google.android.gms:play-services-awareness:19.0.1
Telefon, tablet, Auto, Android Go, ChromeOS
Klasy narzędzi
com.google.android.gms:play-services-base:18.2.0
telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Testowanie podróbek pod kątem klas narzędzi
com.google.android.gms:play-services-base-testing:16.0.0
telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Więcej klas narzędziowych
com.google.android.gms:play-services-basement:18.2.0
telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.4.0
Telefon, tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:21.4.0
Telefon, tablet, Android Go, ChromeOS
Odbiorniki Android TV
com.google.android.gms:play-services-cast-tv:21.0.1
Android TV;
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.1.0
Telefon, tablet, Android Go, ChromeOS
Stos sieciowy Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.0.1
telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Interakcje między urządzeniami (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:20.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
com.google.android.gms:play-services-fitness:21.1.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:19.0.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Natywny pakiet SDK usług gier Google Play w wersji 2 na Androida
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.1.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.0.1
Telefon, tablety, Android TV, Android Go, ChromeOS

Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym.
Dostawca uśrednionej lokalizacji na urządzeniach z Androidem (w tym rozpoznawanie aktywności i geofencing)
com.google.android.gms:play-services-location:21.0.1
telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Pakiet SDK Map Google 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 w ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0
Telefon, tablet, Android Go, ChromeOS
Wykrywanie twarzy w ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Telefon, tablet, Android Go, ChromeOS
Oznaczanie obrazów etykietami w ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefon, tablet, Android Go, ChromeOS
Niestandardowe etykiety obrazów 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 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
Podział tematów na segmenty w ML Kit
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w ML Kit w języku chińskim
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w ML Kit dla języka dewanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w ML Kit w języku japońskim
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w ML Kit w języku koreańskim
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.0.0
Telefon, tablet, Android TV, Auto, Android Go
Pokaż licencje open source
com.google.android.gms:play-services-oss-licenses:17.0.1
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym.
Sprawdzanie jakości blokady ekranu
com.google.android.gms:play-services-password-complexity:18.0.1
Telefon, tablet, Android Go, ChromeOS, Wear OS

Obsługiwane na urządzeniach z Androidem od 4.4 (poziom interfejsu API 19) do 9 (poziom API 28).
Google Pay for Pass
com.google.android.gms:play-services-pay:16.4.0
Telefon, tablety, Android Go, ChromeOS

Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 20) lub nowszym.
ReCAPTCHA Enterprise na potrzeby narzędzi do obsługi aplikacji
com.google.android.gms:play-services-recaptcha:17.0.1
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.0.1
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
Menedżer tagów Google
com.google.android.gms:play-services-tagmanager:18.0.4
Telefon, tablet, Android TV, Android Go, ChromeOS
Tasks API na urządzeniu z Androidem
com.google.android.gms:play-services-tasks:18.0.2
telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Usługa Acceleration na Androida
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Telefon, tablet, Android Go, ChromeOS
Interfejs API TensorFlow Lite GPU dla usług Google Play
com.google.android.gms:play-services-tflite-gpu:16.2.0
Telefon, tablet, Android Go, ChromeOS
Interfejs API Java TensorFlow Lite dla Usług Google Play
com.google.android.gms:play-services-tflite-java:16.1.0
Telefon, tablet, Android Go, ChromeOS
Interfejs API 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.0
Telefon, tablet
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
Telefon, tablet, Android Go, ChromeOS
Google Pay na urządzeniach z Androidem
com.google.android.gms:play-services-wallet:19.2.1
Telefon, tablet, Auto, Android Go, ChromeOS, Wear OS
Interfejs API do noszenia na ciele
com.google.android.gms:play-services-wearable:18.1.0
Telefon, tablet, Wear OS

Wtyczki Gradle

Usługi Google Play zawierają też kilka wtyczek Gradle, jak pokazano w tej tabeli. Pamiętaj, że przyciski widoczne przed poprzednią tabelą nie zmieniają informacji zawartych w tej tabeli.

Tabela 2. Lista wtyczek Gradle 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
Rygorystyczne sprawdzanie wersji
com.google.android.gms:strict-version-matcher-plugin:1.2.4
telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS