Konfigurowanie Usług Google Play

Aby opracować aplikację za pomocą 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 Google Maven.

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

  • Zgodne urządzenie z Androidem 7.0 (poziom API 24) lub nowszym i zainstalowaną aplikacją Sklep Google Play.
  • Emulator Androida z AVD, który korzysta z interfejsów API Google na platformie Android 7.0 (poziom interfejsu API 24) lub nowszej.

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

Aby w aplikacji opracować 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, uwzględnij 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 również chcieć dodać Firebase do swojego projektu.

  3. Zapisz zmiany i zsynchronizuj projekt.

Poniższy fragment kodu przedstawia przykładowy plik build.gradle, który używa biblioteki lokalizacji:

apply plugin: 'com.android.application'

...

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

Nowe wersje pakietów SDK usług Google Play zawierają poprawki błędów i nowe funkcje. Informacje o tych aktualizacjach są podawane 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 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 są automatycznie aktualizowane na urządzeniach z Androidem 7.0 (poziom interfejsu API 24) lub 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ć obecność usług Google Play na urządzeniu, użyj metody isGooglePlayServicesAvailable().

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 Uzyskiwanie dostępu do interfejsów API Google.

Zależności od Usług Google Play

Poniższa tabela zawiera listę 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, a także wyszukać konkretny przypadek użycia lub nazwę zależności, wpisując tekst w polu wyświetlanym 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
Google Mobile Ads
com.google.android.gms:play-services-ads:25.4.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 Google Mobile Ads
com.google.android.gms:play-services-ads-lite:25.0.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 dla systemu Android
com.google.android.gms:play-services-analytics:18.1.1
Przestarzałe. 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 dla Androida
com.google.android.gms:play-services-auth:22.0.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.3.1
Telefony, tablety, Android Go
Interfejs API magazynu bloków (obejmuje przechowywanie danych uwierzytelniających użytkownika)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Telefon, tablet, Android Go, ChromeOS
Interfejs API Google Awareness
com.google.android.gms:play-services-awareness:20.0.0
Telefony, tablety, samochody, Android Go, ChromeOS
Klasy użytkowe
com.google.android.gms:play-services-base:18.10.1
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Testowanie fałszywych wyników dla klas użyteczności
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.11.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Wzmocnienie aparatu przy słabym oświetleniu
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09
Telefon, Tablet
Google Cast
com.google.android.gms:play-services-cast:22.3.1
Telefon, tablet, Android Go, ChromeOS
Struktura aplikacji Google Cast (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 urządzenie-urządzenie (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta02
Telefony, tablety, 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.3.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Obsługiwane na urządzeniach z systemem Android 7.0 (poziom API 24) lub nowszym.
Interfejs API Google Fit dla systemu Android i Interfejs API do nagrywania na urządzeniach mobilnych (dla danych o aktywności fizycznej użytkowników)
com.google.android.gms:play-services-fitness:21.3.0
Telefony, tablety, Android Go, ChromeOS, Wear OS
Fraud Protect
com.google.android.gms:play-services-fraudprotect:16.0.1
Telefony, tablety, Android Go
Usługi gier Google Play w wersji 2 dla Androida
com.google.android.gms:play-services-games-v2:22.1.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Natywny pakiet SDK usług Gier Google Play w wersji 2 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 dla Androida
com.google.android.gms:play-services-games:25.0.0
Przestarzałe. Zamiast tego używaj usług gier Google Play w wersji 2.
API Matter
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
Przestarzałe. Więcej informacji znajdziesz w Aplikacja błyskawiczna w Google Play.
Usługi lokalizacyjne na Androidzie
com.google.android.gms:play-services-location:21.4.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Maps SDK na Androida
com.google.android.gms:play-services-maps:20.0.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Zestaw SDK Map Google 3D dla Androida
com.google.android.gms:play-services-maps3d:0.2.2
Telefon, Tablet
Ulepszanie efektów multimedialnych
com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08
Telefon, tablet
Skanowanie kodów kreskowych za pomocą zestawu 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 w ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Telefon, tablet, Android Go, ChromeOS
Etykietowanie obrazu ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefony, tablety, Android Go, ChromeOS
Niestandardowe etykietowanie obrazów w zestawie ML Kit
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Telefony, tablety, 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
Telefony, tablety, Android Go, ChromeOS
Rozpoznawanie tekstu w ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
Telefony, tablety, Android Go, ChromeOS
Rozpoznawanie tekstu w języku chińskim w zestawie ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
Telefony, tablety, Android Go, ChromeOS
Rozpoznawanie tekstu w języku dewanagari za pomocą zestawu 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 w zestawie ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
Telefony, tablety, 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
Telefony, tablety, Android Go, ChromeOS
Wykrywanie urządzeń w pobliżu i nawiązywanie z nimi połączenia
com.google.android.gms:play-services-nearby:19.5.0
Telefon, tablet, Android TV, Auto, Android Go
Pokaż licencje open source
com.google.android.gms:play-services-oss-licenses:17.5.2
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
Obsługiwane na urządzeniach z systemem Android 5.0 (poziom 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 systemem Android 5.0 (poziom 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 systemem Android 4.4 (poziom API 19) do Android 9 (poziom 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 systemem Android 5.0 (poziom 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
API gestów zdalnych
com.google.android.gms:play-services-remotegestures:16.0.0
Telefon, Tablet
Bezpieczne przeglądanie v5
com.google.android.gms:play-services-safebrowsing:16.0.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
Interfejsy API SafetyNet (w tym bezpieczne przeglądanie 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.3.0
Telefony, tablety, Android TV, Android Go, ChromeOS
Tasks API na Androidzie
com.google.android.gms:play-services-tasks:18.4.1
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Usługa przyspieszania dla systemu Android
com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02
Telefon, tablet, Android Go, ChromeOS
Interfejs API delegata GPU TensorFlow Lite dla usług Google Play
com.google.android.gms:play-services-tflite-gpu:16.5.0
Telefon, tablet, Android Go, ChromeOS
TensorFlow Lite Java API dla usług Google Play
com.google.android.gms:play-services-tflite-java:16.5.0
Telefon, tablet, Android Go, ChromeOS
Interfejs TensorFlow Lite Support API dla usług Google Play
com.google.android.gms:play-services-tflite-support:16.5.0
Telefon, tablet, Android Go, ChromeOS
Interfejs API sieci wątków
com.google.android.gms:play-services-threadnetwork:16.3.0
Telefon, tablet
Zaufany interfejs API czasu
com.google.android.gms:play-services-time:16.0.1
Telefony, tablety, samochody, Android Go, Wear OS
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
Telefony, tablety, Android Go, ChromeOS
Google Pay do płatności na Androidzie
com.google.android.gms:play-services-wallet:20.0.0
Telefony, tablety, Android Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:20.0.1
Telefon, tablet, Wear OS

Wtyczki Gradle

Usługi Google Play obejmują również kilka wtyczek Gradle, jak pokazano w poniższej tabeli. Należy pamiętać, że przyciski znajdujące się przed poprzednią tabelą nie zmieniają informacji wyświetlanych 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.13.0
Telefon, tablet, ChromeOS
Ścisłe sprawdzanie wersji
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS