Konfigurowanie Usług Google Play

Aby tworzyć aplikacje za pomocą interfejsów API Usług Google Play, postępuj zgodnie z instrukcjami na tej stronie, aby skonfigurować projekt za pomocą odpowiednich pakietów SDK, które są dostępne w repozytorium Google Maven.

Aby testować aplikację podczas korzystania z Usług Google Play, musisz użyć jednego z tych elementów:

  • zgodnego urządzenia z Androidem w wersji 6.0 (poziom interfejsu API 23) lub nowszej, na którym jest zainstalowana aplikacja Sklep Google Play;
  • emulatora Androida z AVD, który korzysta z platformy interfejsów API Google opartej na Androidzie 6.0 (poziom interfejsu API 23) lub nowszym.

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

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

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

  2. W przypadku każdego pakietu SDK, którego wymaga aplikacja, dodaj zależność od tego pakietu. Na tej stronie znajduje się sekcja z listą typowych zależności od Usług Google Play w przypadku aplikacji na Androida. Możesz też dodać Firebase do projektu.

  3. Zapisz zmiany i zsynchronizuj swój projekt.

Ten fragment kodu przedstawia 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'
}

Okresowo są udostępniane nowe wersje pakietów SDK Usług Google Play z poprawkami błędów i nowymi funkcjami. Informacje o tych aktualizacjach znajdziesz w informacjach o wersji. Jeśli Twoja aplikacja korzysta z zależności, która została zaktualizowana, zmień ją na najnowszą wersję w zależnościach aplikacji, aby korzystać z tych poprawek.

Sprawdzanie, czy Usługi Google Play są zainstalowane

Jak opisano w artykule Omówienie Usług Google Play , Usługi Google Play są automatycznie aktualizowane na Androidzie 6.0 (poziom interfejsu API 23) i nowszym za pomocą aplikacji Sklep Google Play. Jednak na urządzeniach 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 użyciem interfejsów API Google lub włączeniem funkcji, które ich wymagają, zawsze sprawdzaj, czy Usługi Google Play są zainstalowane.

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

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

Zależności od 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, a także wyszukiwać konkretny przypadek użycia lub nazwę zależności, wpisując tekst w polu, które pojawi się po kliknięciu przycisków.

Tabela 1. Zależności od Usług Google Play, które należy uwzględnić 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:25.1.0
Telefon, tablet
Identyfikator wyświetlania reklam na urządzeniach z Androidem (AAID)
com.google.android.gms:play-services-ads-identifier:18.3.0
Telefon, tablet, Android TV, ChromeOS
Lekka wersja reklam mobilnych Google
com.google.android.gms:play-services-ads-lite:24.8.0
Telefon, tablet
AdSense dla wyszukiwania (AFS) Reklamy w wyszukiwarce niestandardowej (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.1
Wycofany. Zamiast niego używaj Google Analytics dla Firebase.
Indeksowanie 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.1
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 Androida
com.google.android.gms:play-services-auth:21.5.1
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.3.0
Telefon, tablet, Android Go
Block Store API (obejmuje magazyn danych logowania użytkownika)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Telefon, tablet, Android Go, ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:20.0.0
Telefon, tablet, Auto, Android Go, ChromeOS
Klasy narzędziowe
com.google.android.gms:play-services-base:18.10.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Testowanie fałszywych klas narzędziowych
com.google.android.gms:play-services-base-testing:16.2.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Więcej klas narzędziowych
com.google.android.gms:play-services-basement:18.10.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Wzmocnienie obrazu w słabym oświetleniu
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta07
Telefon, tablet
Google Cast
com.google.android.gms:play-services-cast:22.3.1
Telefon, tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:22.3.1
Telefon, tablet, Android Go, ChromeOS
Skaner kodów Google
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.1.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-beta02
Telefon, tablet, Android Go
Pakiet SDK weryfikatora kluczy
com.google.android.gms:contactkeys:16.0.0
Telefon, tablet
Uwierzytelnianie Fast IDentity Online (FIDO)
com.google.android.gms:play-services-fido:21.2.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.
Interfejs Google Fit API na Androida i Recording API na urządzeniach mobilnych (do danych o aktywności fizycznej użytkownika)
com.google.android.gms:play-services-fitness:21.3.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:21.0.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Usługi gier Google Play w wersji 2 – natywny pakiet SDK w języku C 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:24.0.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.2.0
Wycofane. Więcej informacji znajdziesz w artykule Aplikacja błyskawiczna w Google Play.
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
Pakiet SDK Map Google na Androida
com.google.android.gms:play-services-maps:20.0.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Pakiet SDK Map Google 3D na Androida
com.google.android.gms:play-services-maps3d:0.2.0
Telefon, tablet
Wzmocnienie efektów multimedialnych
com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta03
Telefon, tablet
Skanowanie kodów kreskowych za pomocą ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
Telefon, tablet, Android Go, ChromeOS
Skaner dokumentów ML Kit
com.google.android.gms:play-services-mlkit-document-scanner:16.0.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
Etykietowanie obrazów za pomocą ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefon, tablet, Android Go, ChromeOS
Niestandardowe etykietowanie obrazów za pomocą ML Kit
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie języka za pomocą ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Telefon, tablet, Android Go, ChromeOS
Inteligentna odpowiedź za pomocą ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Telefon, tablet, Android Go, ChromeOS
Segmentacja obiektów za pomocą ML Kit
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu za pomocą ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
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.1
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.1
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.1
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.1
Telefon, tablet, Android Go, ChromeOS
Wykrywanie urządzeń w pobliżu i łączenie się z nimi
com.google.android.gms:play-services-nearby:19.3.0
Telefon, tablet, Android TV, Auto, Android Go
Wyświetlanie licencji open source
com.google.android.gms:play-services-oss-licenses:17.5.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym.
Biblioteki dostępu zautomatyzowanego (PAL)
com.google.android.gms:play-services-pal:23.0.0
Telefon, tablet, Android TV
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.1.0
Telefon, tablet, Android Go, ChromeOS, Wear OS

Obsługiwane na urządzeniach z Androidem 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 (obejmują bezpieczne przeglądanie i weryfikację 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.3.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Tasks API na Androida
com.google.android.gms:play-services-tasks:18.4.1
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service na Androida
com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite GPU Delegate API na Usługi Google Play
com.google.android.gms:play-services-tflite-gpu:16.4.0
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite Java API na Usługi Google Play
com.google.android.gms:play-services-tflite-java:16.4.0
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite Support API na Usługi Google Play
com.google.android.gms:play-services-tflite-support:16.4.0
Telefon, tablet, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.3.0
Telefon, tablet
Trusted Time API
com.google.android.gms:play-services-time:16.0.1
Telefon, tablet, Auto, Android Go, Wear OS
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
Telefon, tablet, Android Go, ChromeOS
Google Pay do płatności na Androida
com.google.android.gms:play-services-wallet:19.5.0
Telefon, tablet, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:19.0.0
Telefon, tablet, Wear OS

Wtyczki Gradle

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

Tabela 2. Lista wtyczek Gradle zawartych w Usługach Google Play
Przypadek użycia i nazwa wtyczki Gradle Obsługiwane urządzenia
Wyświetlanie licencji open source
com.google.android.gms:oss-licenses-plugin:0.11.0
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