Skonfiguruj Usługi Google Play

Aby utworzyć aplikację, korzystając z interfejsów API usług Google Play, postępuj zgodnie z instrukcjami podanymi na tej stronie, aby skonfigurować projekt z użyciem odpowiednich pakietów SDK dostępnych w repozytorium Google Maven.

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

  • 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 z Androidem 4.4 (poziom interfejsu API 19) lub nowszym.

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

Aby utworzyć funkcje zależne od interfejsów API Usług Google Play w swojej aplikacji, wykonaj te czynności:

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

  2. Dla każdego pakietu SDK, którego wymaga Twoja aplikacja, dodaj zależność. Ta strona zawiera sekcję z listą typowych 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 pokazuje 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 błędów i nowymi funkcjami. Informacje o tych zmianach znajdziesz w informacjach o wersji. Jeśli Twoja aplikacja używa zależności, która została zaktualizowana, przejdź na najnowszą wersję zależności aplikacji, 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 w wersji 4.4 (poziom interfejsu API 19) lub nowsze za pomocą aplikacji Sklep Google Play. Na urządzeniach z Androidem, które nie mają Sklepu Google Play, nie są zainstalowane Usługi Google Play. Jeśli aplikacja działa na urządzeniach bez Usług Google Play, przed próbą korzystania z interfejsów API Google możesz sprawdzić, czy Usługi Google Play są na nim zainstalowane. Możesz też sprawdzić, czy funkcje aplikacji wymagają Usług Google Play.

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

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

Zależności Usług Google Play

W tabeli poniżej znajdziesz zależności dotyczące 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ć konkretne przypadki użycia lub nazwy zależności, wpisując tekst w polu, które pojawi się po tych 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
Reklamy mobilne Google
com.google.android.gms:play-services-ads:22.1.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
Prostsza wersja reklam mobilnych Google
com.google.android.gms:play-services-ads-lite:22.1.0
Telefon, tablet
Reklamy AdSense w wyszukiwarce niestandardowej (CSA) w AdSense dla wyszukiwania
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.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, ChromeOS
Logowanie przez Google na Androida
com.google.android.gms:play-services-auth:20.5.0
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS
SMS SMS Recovery API
com.google.android.gms:play-services-auth-api-phone:18.0.1
Telefon, tablet, Android Go
Blokowanie interfejsu API sklepu (w tym przechowywanie danych logowania użytkowników)
com.google.android.gms:play-services-auth-blockstore:16.2.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, Chrome OS
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 narzędzi
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.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, Chrome OS
Platforma aplikacji Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.3.0
Telefon, tablet, Android Go, Chrome OS
Odbiorniki Android TV
com.google.android.gms:play-services-cast-tv:21.0.0
Android TV
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.0.0
Telefon, tablet, Android Go, Chrome OS
Stos sieciowy 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 za pomocą identyfikatora podmiotu online (FIDO)
com.google.android.gms:play-services-fido:20.0.1
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
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:17.0.0
Telefon, tablet, Android TV, Android Go, ChromeOS
Google Play Games Services v2 Native SDK SDK 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
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, 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.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.2.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
Etykiety obrazów w ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefon, tablet, Android Go, Chrome OS
Niestandardowe etykiety obrazu 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ęzyka 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:19.0.0
Telefon, tablet, Android Go, Chrome OS
Rozpoznawanie tekstu w języku chińskim
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
Telefon, tablet, Android Go, Chrome OS
Rozpoznawanie tekstu w ML Kit na Devanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
Telefon, tablet, Android Go, Chrome OS
Rozpoznawanie tekstu w języku ML Kit w języku japońskim
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
Telefon, tablet, Android Go, Chrome OS
Rozpoznawanie tekstu w języku ML Kit w języku koreańskim
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
Telefon, tablet, Android Go, Chrome OS
Wykrywanie i połączenie urządzeń w pobliżu
com.google.android.gms:play-services-nearby:18.5.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.
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) do Androida 9 (poziom API 28).
Google Pay for Passes
com.google.android.gms:play-services-pay:16.1.0
Telefon, tablet, Android Go, ChromeOS

Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 20) lub nowszym.
reCAPTCHA Enterprise do narzędzi aplikacji
com.google.android.gms:play-services-recaptcha:17.0.1
Telefon, tablet, Android TV, Android Go, ChromeOS
Interfejsy API SafeNetNet (w tym atestacja 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.2
Telefon, tablet, Android TV, Android Go, ChromeOS
Lista zadań API na Androida
com.google.android.gms:play-services-tasks:18.0.2
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service for Android
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Telefon, tablet, Android Go, Chrome OS
Interfejs TensorFlow Lite API dla usług Google Play
com.google.android.gms:play-services-tflite-gpu:16.2.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.1.0
Telefon, tablet, Android Go, Chrome OS
Interfejs API TensorFlow Lite dla Usług Google Play
com.google.android.gms:play-services-tflite-support:16.1.0
Telefon, tablet, Android Go, Chrome OS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.0
Telefon, tablet
Obraz mobilny
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.2.0-beta01
Telefon, tablet, Auto, Android Go, Chrome OS, 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 obejmują też kilka wtyczek Gradle, jak pokazano w tabeli poniżej. Pamiętaj, że przyciski widoczne przed poprzednią tabelą nie wpływają na informacje wyświetlane w tej tabeli.

Tabela 2. Lista wtyczek Gradle zawartych w Usługach 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, ChromeOS
Rygorystyczne sprawdzanie wersji
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS