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. Pozwoli Ci to skonfigurować projekt z użyciem odpowiednich pakietów SDK, które znajdziesz 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 w wersji 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 na podstawie Androida 5.0 (poziom interfejsu API 21) lub nowszego.

Deklarowanie zależności 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. Dodaj zależność od każdego pakietu SDK, którego wymaga Twoja aplikacja. Ta strona zawiera sekcję zawierającą typowe 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 publikowane są nowe wersje pakietów SDK Usług Google Play z poprawkami błędów i nowymi funkcjami. Te zmiany są ogłaszane w informacjach o wersji. Jeśli Twoja aplikacja używa zależności, która została zaktualizowana, przejdź na najnowszą wersję w zależnościach aplikacji, aby korzystać z tych poprawek.

Sprawdzanie, czy Usługi Google Play są zainstalowane

Zgodnie z opisem w przeglądzie Usług Google Play Usługi Google Play otrzymują automatyczne aktualizacje na Androida 5.0 (poziom interfejsu API 21) i nowsze za pomocą aplikacji Sklep Google Play. Jednak na urządzeniach z Androidem bez 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 skorzystaniem z interfejsów API Google sprawdź, czy są na nich zainstalowane Usługi Google Play, lub włącz w aplikacji funkcje, które do ich działania wymagają Usług Google Play.

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

Aby następnie rozpocząć połączenie z Usługami Google Play lub dowiedzieć się, jak sprawdzić, czy wersja zainstalowanych 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

Poniższa tabela zawiera listę zależności Usług Google Play, które można uwzględnić w aplikacji na Androida. Możesz filtrować listę według typu urządzenia, wybierając jeden z przycisków, a także wyszukiwać 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.5.0
Telefon, tablet
Identyfikator wyświetlania reklam na urządzeniu z Androidem (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
Telefon, tablet, Android TV, ChromeOS
Uproszczona wersja reklam mobilnych Google
com.google.android.gms:play-services-ads-lite:22.5.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
Wycofane. Zamiast tego użyj 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 Androidzie
com.google.android.gms:play-services-auth:20.7.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
Interfejs API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.0.1
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.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 fałszywych treści pod kątem klas użyteczności
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.3.0
Telefon, tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:21.3.0
Telefon, tablet, Android Go, ChromeOS
Odbiorniki Android TV
com.google.android.gms:play-services-cast-tv:21.0.0
Android TV
Skaner 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.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
Uwierzytelnianie FIDO (Fast IDentity Online)
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, tablet, 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 Androida (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 za pomocą 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ź w 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 języku chińskim w ML Kit
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 4.4 (poziom interfejsu API 19) i Androidem 9 (poziom interfejsu API 28).
Google Pay for Cards
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 instrumentacji aplikacji
com.google.android.gms:play-services-recaptcha:17.0.1
Telefon, tablet, Android TV, Android Go, ChromeOS
Interfejsy API SafetyNet (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 Androidzie
com.google.android.gms:play-services-tasks:18.0.2
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Usługa akceleracji na Androida
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite GPU Debit API 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
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
Urządzenia mobilne 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
Wearable Data Layer API
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 wyświetlanych w tej tabeli.

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