Konfigurowanie Usług Google Play

Aby tworzyć aplikacje korzystające z interfejsów API usług Google Play, postępuj zgodnie z instrukcjami na tej stronie, aby skonfigurować projekt z odpowiednimi pakietami SDK, które są dostępne w repozytorium Maven Google.

Aby przetestować aplikację podczas korzystania z usług Google Play, musisz użyć jednej z tych opcji:

  • Zgodne urządzenie z Androidem w wersji 6.0 (poziom interfejsu API 23) lub nowszej z zainstalowaną aplikacją Sklep Google Play.
  • emulator Androida z AVD, który działa na platformie interfejsów API Google na podstawie Androida 6.0 (poziom interfejsu API 23) lub nowszego.

Deklarowanie zależności w Usługach Google Play

Aby w aplikacji opracowywać 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 Twoja aplikacja, dołącz odpowiednie zależności. 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ć do projektu zależności Firebase.

  3. Zapisz zmiany i zsynchronizuj projekt.

Poniższy 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'
}

Nowe wersje pakietów SDK Usług Google Play z poprawkami błędów i nowymi funkcjami są wydawane okresowo. Te aktualizacje są ogłaszane w informacjach o wersji. Jeśli Twoja aplikacja korzysta z aktualizowanej zależności, zmień ją na najnowszą wersję, aby skorzystać z tych poprawek.

Sprawdzanie, czy Usługi Google Play są zainstalowane

Jak opisano w omówieniu Usług Google Play, Usługi Google Play otrzymują automatyczne aktualizacje w aplikacji Sklep Google Play na urządzeniach z Androidem 6.0 (poziom interfejsu API 23) lub nowszym. Usługi Google Play nie są jednak instalowane na urządzeniach z Androidem bez Sklepu 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 w aplikacji, które wymagają Usług Google Play, sprawdź, czy są one zainstalowane na urządzeniu.

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

Aby nawiązać połączenie z usługami Google Play lub dowiedzieć się, czy zainstalowana wersja Usług Google Play obsługuje dany interfejs API, przeczytaj przewodnik Uzyskiwanie dostępu do interfejsów API Google.

zależności Usług Google Play;

W tabeli poniżej znajdziesz listę zależności usług Google Play, które możesz uwzględnić w aplikacji na Androida. Możesz filtrować listę według typu urządzenia, wybierając jeden z przycisków, oraz wyszukiwać konkretnego przypadku użycia lub nazwy zależności, wpisując tekst w polu, które pojawi się po przyciskach.

Tabela 1. zależności usług Google Play do uwzględnienia w aplikacji na Androida
Użyj nazwy przypadku użycia i zależności Obsługiwane urządzenia
Google Mobile Ads
com.google.android.gms:play-services-ads:23.5.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
Lekka wersja Google Mobile Ads
com.google.android.gms:play-services-ads-lite:23.5.0
Telefon, tablet
Reklamy w wyszukiwarce niestandardowej w AdSense dla wyszukiwania (AFS)
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 tego użyj 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.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.2.0
Telefon, tablet, Android TV, Android 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 (obejmujący przechowywanie 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:19.1.0
Telefon, tablet, samochód, Android Go, ChromeOS
Klasy usług
com.google.android.gms:play-services-base:18.5.0
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS
Testowanie fałszywych danych w klasach usługowych
com.google.android.gms:play-services-base-testing:16.1.0
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS
Więcej zajęć z zakresu nauk ścisłych
com.google.android.gms:play-services-basement:18.4.0
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:22.0.0
Telefon, tablet, Android Go, ChromeOS
Platforma Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:22.0.0
Telefon, tablet, Android Go, ChromeOS
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.1.0
Telefon, tablet, Android Go, ChromeOS
Sieć Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.1.0
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS
Interakcje między urządzeniami
com.google.android.gms:play-services-dtdi:16.0.0-beta02
Telefon, tablet, Android Go
Uwierzytelnianie Fast 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 Androidainterfejs Recording API na urządzeniach mobilnych (do zbierania danych o aktywności fizycznej użytkownika)
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.2
Telefon, tablet, Android TV, Android Go, ChromeOS
Natywna biblioteka C Google Play Games Services w wersji 2 do Androida
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Telefon, tablet, Android TV, Android Go, ChromeOS
Usługi Google Play Games w wersji 1 na Androida
com.google.android.gms:play-services-games:23.2.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Interfejs API Matter
com.google.android.gms:play-services-home:16.0.0
Telefon, tablet
Aplikacje błyskawiczne 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, Android Auto, Android Go, ChromeOS, Wear OS
Pakiet SDK Google Maps na Androida
com.google.android.gms:play-services-maps:19.0.0
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS
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-beta1
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
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 oznaczanie 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
ML Kit – identyfikacja języka
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
Segmentacja tematów w ML Kit
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Telefon, tablet, Android Go, ChromeOS
ML Kit – rozpoznawanie tekstu
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
Telefon, tablet, Android Go, ChromeOS
ML Kit – rozpoznawanie tekstu w języku chińskim
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
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.1
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w ML Kit w przypadku japońskiego
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
Telefon, tablet, Android Go, ChromeOS
Rozpoznawanie tekstu w ML Kit w przypadku języka koreańskiego
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 nawiązywanie z nimi połączenia
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.
Biblioteki dostępu zautomatyzowanego (PAL)
com.google.android.gms:play-services-pal:21.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 4.4 (poziom interfejsu API 19) do Androida 9 (poziom interfejsu API 28).
Portfel Google (dawniej Google Pay for Passes)
com.google.android.gms:play-services-pay:16.5.0
Telefon, tablet, Android Go, ChromeOS

Obsługiwane na urządzeniach z Androidem w wersji 5.0 (poziom interfejsu API 20) lub nowszej.
reCAPTCHA Enterprise do pomiaru aplikacji
com.google.android.gms:play-services-recaptcha:17.1.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Interfejsy API SafetyNet (obejmują atestację urządzenia, bezpieczne przeglądanie, reCAPTCHA i weryfikację aplikacji)
com.google.android.gms:play-services-safetynet:18.1.0
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS
Menedżer tagów Google
com.google.android.gms:play-services-tagmanager:18.1.1
Telefon, tablet, Android TV, Android Go, ChromeOS
Interfejs Tasks API na Androida
com.google.android.gms:play-services-tasks:18.2.0
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS
Usługa przyspieszania na Androida
com.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01
Telefon, tablet, Android Go, ChromeOS
Interfejs API delegowania GPU TensorFlow Lite do usług Google Play
com.google.android.gms:play-services-tflite-gpu:16.3.0
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite – interfejs API w języku Java do usług Google Play
com.google.android.gms:play-services-tflite-java:16.3.0
Telefon, tablet, Android Go, ChromeOS
Interfejs API obsługi TensorFlow Lite dla usług Google Play
com.google.android.gms:play-services-tflite-support:16.3.0
Telefon, tablet, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.2.1
Telefon, tablet
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
Telefon, tablet, Android Go, ChromeOS
Google Pay do dokonywania płatności na Androidzie
com.google.android.gms:play-services-wallet:19.4.0
Telefon, tablet, 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 widać w poniższej tabeli. Pamiętaj, że przyciski widoczne przed poprzednią tabelą nie zmieniają informacji w tej tabeli.

Tabela 2. Lista wtyczek Gradle dostępnych 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ła kontrola wersji
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS