Skonfiguruj Usługi Google Play

Aby utworzyć aplikację przy użyciu interfejsów API Usług Google Play, postępuj zgodnie z instrukcjami na tej stronie, aby skonfigurować projekt za pomocą odpowiednich pakietów SDK dostępnych w repozytorium Google Maven.

Aby przetestować aplikację korzystającą z Usług Google Play, musisz użyć jednej z tych usług:

  • Zgodne urządzenie z Androidem 4.4 (interfejs API na poziomie 19) lub nowszym i zainstalowana aplikacja Sklep Google Play.
  • Emulator Androida z AVD obsługującym platformę interfejsów API Google na Androidzie w wersji 4.4 (poziom interfejsu API 19) lub nowszym.

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łów aplikacji.

  2. Dla każdego pakietu SDK wymaganego przez Twoją aplikację dodaj zależność tego pakietu SDK. Ta strona zawiera sekcję zawierającą typowe zależności Usług Google Play dla aplikacji na Androida. Możesz też dodać zależności Firebase do swojego projektu.

  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 i nowymi funkcjami. Te zmiany są ogłaszane w informacjach o wersjach. Jeśli Twoja aplikacja używa zależności, która została zaktualizowana, zmień ją na najnowszą wersję tych zależności, aby skorzystać z tych poprawek.

Sprawdzanie, czy Usługi Google Play są zainstalowane

Zgodnie z omówieniem Usług Google Play Usługi Google Play otrzymują automatyczne aktualizacje na Androida 4.4 (poziom interfejsu API 19) lub nowszym przy użyciu aplikacji Sklep Google Play. Na urządzeniach z Androidem, na których nie ma Sklepu Google Play, Usługi Google Play nie są zainstalowane. Jeśli aplikacja działa na urządzeniach, na których nie działają Usługi Google Play, przed próbą korzystania z interfejsów API Google sprawdź, czy są na nich zainstalowane Usługi Google Play. Możesz też włączyć w niej funkcje, które wymagają Usług Google Play.

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

Aby rozpocząć połączenie z Usługami Google Play lub dowiedzieć się, jak sprawdzić, czy wersja zainstalowanych usług Google Play obsługuje konkretny interfejs API, przeczytaj przewodnik w sekcji 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, a także wyszukać konkretny przypadek użycia lub nazwę zależności, wpisując tekst w polach, które pojawiają się po przyciskach.

Tabela 1. Zależności Usług Google Play do uwzględnienia w aplikacjach na Androida
Przykład zastosowania i nazwa zależności Obsługiwane urządzenia
Reklamy mobilne Google
com.google.android.gms:play-services-ads:21.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, system operacyjny Chrome
Niewielka wersja reklam mobilnych Google
com.google.android.gms:play-services-ads-lite:21.5.0
Telefon, tablet
Reklamy AdSense w wyszukiwarce niestandardowej (CSA)
com.google.android.gms:play-services-afs-native:19.0.3
Telefon, tablet, Chrome OS
Pakiet SDK usług Google Analytics na Androida
com.google.android.gms:play-services-analytics:18.0.2
Wycofane. 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, system operacyjny Chrome
Logowanie przez Google na Androida
com.google.android.gms:play-services-auth:20.4.1
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
SMS Fetcher API
com.google.android.gms:play-services-auth-api-phone:18.0.1
Telefon, tablet, Android Go
Blokowanie interfejsu API sklepu (obejmuje miejsce na dane logowania użytkownika)
com.google.android.gms:play-services-auth-blockstore:16.1.0
Telefon, tablet, Android Go, Chrome OS
Interfejs Google Know 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
Fałszywe testowanie 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ędzi
com.google.android.gms:play-services-basement:18.1.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.2.0
Telefon, tablet, Android Go, Chrome OS
Platforma przesyłająca aplikację Google Cast
com.google.android.gms:play-services-cast-framework:21.2.0
Telefon, tablet, Android Go, Chrome OS
Odbiorniki Android TV
com.google.android.gms:play-services-cast-tv:20.0.0
Android TV
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.0.0-beta3
Telefon, tablet, Android Go, Chrome OS
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
Szybkie uwierzytelnianie IDEntity Online (FIDO)
com.google.android.gms:play-services-fido:19.0.1
Telefon, tablet, Android TV, Auto, Android Go, Chrome OS, Wear OS

Obsługiwane na urządzeniach z Androidem 7.0 (poziom interfejsu API 24) lub nowszym.
Interfejs Google Fit API na Androida
com.google.android.gms:play-services-fitness:21.1.0
Telefon, tablet, Android Go, Chrome OS, Wear OS
Usługi gier Google Play w wersji 2 na Androida
com.google.android.gms:play-services-games-v2:17.0.0
Telefon, tablet, Android TV, Android Go, Chrome OS
Pakiet SDK do 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, Chrome OS
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, Chrome OS
Interfejs 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.0.1
Telefon, tablet, Android TV, Android Go, Chrome OS

Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym.
Fuse Location Provider for Android (obejmuje 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.1.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Skanowanie kodów kreskowych ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0
Telefon, tablet, Android Go, Chrome OS
Wykrywanie twarzy w ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Telefon, tablet, Android Go, Chrome OS
Oznaczanie etykietami ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefon, tablet, Android Go, Chrome OS
Niestandardowe etykiety obrazów w ML Kit
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4
Telefon, tablet, Android Go, Chrome OS
Identyfikacja języków w ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Telefon, tablet, Android Go, Chrome OS
Inteligentna odpowiedź ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Telefon, tablet, Android Go, Chrome OS
Rozpoznawanie tekstu w ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:18.0.2
Telefon, tablet, Android Go, Chrome OS
Wykrywanie urządzeń w pobliżu i ich łączenie
com.google.android.gms:play-services-nearby:18.4.0
Telefon, tablet, Android TV, auto, Android Go
Pokaż licencje open source
com.google.android.gms:play-services-oss-licenses:17.0.0
Telefon, tablet, Android TV, Auto, Android Go, Chrome OS
Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym.
Kontrola jakości blokady ekranu
com.google.android.gms:play-services-password-complexity:18.0.1
Telefon, tablet, Android Go, Chrome OS, Wear OS

Obsługiwane na urządzeniach z Androidem 4.4 (poziom API 19) na Androida 9 (poziom API 28).
Google Pay for Passes
com.google.android.gms:play-services-pay:16.1.0
Telefon, tablet, Android Go, Chrome OS

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.0.1
Telefon, tablet, Android TV, Android Go, Chrome OS
Interfejsy API SafeNet (zawiera atest urządzenia, bezpieczne przeglądanie, reCAPTCHA i weryfikację 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.2
Telefon, tablet, Android TV, Android Go, Chrome OS
Lista zadań API na Androidzie
com.google.android.gms:play-services-tasks:18.0.2
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Przekazywanie dostępu do interfejsu GPU GPU TensorFlow Lite dla Usług Google Play
com.google.android.gms:play-services-tflite-gpu:16.1.0
Telefon, tablet, Android Go, Chrome OS
Interfejs API TensorFlow Lite w Usługach Google Play
com.google.android.gms:play-services-tflite-java:16.0.1
Telefon, tablet, Android Go, Chrome OS
Interfejs API pomocy TensorFlow Lite do Usług Google Play
com.google.android.gms:play-services-tflite-support:16.0.1
Telefon, tablet, Android Go, Chrome OS
Interfejs Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.0-beta02
Telefon, tablet
Widoczność dla urządzeń mobilnych
com.google.android.gms:play-services-vision:20.1.3
Telefon, tablet, Android Go, Chrome OS
Google Pay do płatności na Androidzie
com.google.android.gms:play-services-wallet:19.1.0
Telefon, tablet, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.0.0
Telefon, tablet, Wear OS

Wtyczki Gradle

Usługi Google Play zawierają też kilka wtyczek Gradle, co pokazujemy w tabeli poniżej. Pamiętaj, że przyciski wyświetlane przed poprzednią tabelą nie zmieniają informacji, które się w niej znajdują.

Tabela 2. Lista wtyczek Gradle dołączonych do Usług Google Play
Nazwa przypadku 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, Chrome OS
Ś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