Aby opracować aplikację przy użyciu 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 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 opartej na Androidzie 6.0 (poziom interfejsu API 23) lub nowszym;
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:
- Otwórz plik - build.gradlew katalogu modułu aplikacji.
- 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 też dodać Firebase do projektu. 
- Zapisz zmiany i zsynchronizuj projekt. 
Poniższy 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.3.0'
}
Okresowo publikowane są nowe wersje pakietów SDK usług Google Play z poprawkami błędów i nowymi funkcjami. 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 6.0 (poziom interfejsu API 23) 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ć, czy na urządzeniu są dostępne Usługi Google Play, 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
W tabeli poniżej znajdziesz 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 wyszukiwać konkretne przypadki użycia lub nazwy zależności, wpisując tekst w polu, które pojawi się po kliknięciu przycisków.
| Przypadek użycia i nazwa zależności | Obsługiwane urządzenia | 
|---|---|
| Google Mobile Ads com.google.android.gms:play-services-ads:24.7.0 | Telefon, tablet | 
| Identyfikator wyświetlania reklam na urządzeniach z Androidem (AAID) com.google.android.gms:play-services-ads-identifier:18.2.0 | Telefon, tablet, Android TV, ChromeOS | 
| Lekka wersja mobilnych reklam Google com.google.android.gms:play-services-ads-lite:24.6.0 | Telefon, tablet | 
| Reklamy AdSense dla wyszukiwania (AFS) 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 | Wycofano. Zamiast tego używaj Google Analytics dla Firebase. | 
| Indeks aplikacji com.google.android.gms:play-services-appindex:16.2.0 | Telefony, tablety, Android TV | 
| AppSearch com.google.android.gms:play-services-appsearch:16.0.1 | Telefony, tablety, 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.4.0 | Telefony, tablety, Android TV, Auto, Android Go, ChromeOS | 
| SMS Retriever API com.google.android.gms:play-services-auth-api-phone:18.3.0 | Telefony, tablety, Android Go | 
| Block Store API (obejmuje przechowywanie danych logowania użytkownika) com.google.android.gms:play-services-auth-blockstore:16.4.0 | Telefony, tablety, Android Go, ChromeOS | 
| Google Awareness API com.google.android.gms:play-services-awareness:19.1.0 | Telefony, tablety, samochody, Android Go, ChromeOS | 
| Klasy narzędziowe com.google.android.gms:play-services-base:18.9.0 | Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS | 
| Testowanie atrap klas narzędziowych com.google.android.gms:play-services-base-testing:16.2.0 | Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS | 
| Więcej klas narzędziowych com.google.android.gms:play-services-basement:18.9.0 | Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS | 
| Doświetlanie w słabym oświetleniu com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta06 | Telefon, tablet | 
| Google Cast com.google.android.gms:play-services-cast:22.2.0 | Telefony, tablety, Android Go, ChromeOS | 
| Platforma aplikacji Google Cast (CAF) com.google.android.gms:play-services-cast-framework:22.2.0 | Telefony, tablety, Android Go, ChromeOS | 
| Skaner kodów Google com.google.android.gms:play-services-code-scanner:16.1.0 | Telefony, tablety, Android Go, ChromeOS | 
| Stos sieciowy Chromium (Cronet) com.google.android.gms:play-services-cronet:18.1.1 | Telefony, tablety, 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 | Telefony, tablety, Android Go | 
| Uwierzytelnianie Fast IDentity Online (FIDO) com.google.android.gms:play-services-fido:21.2.0 | Telefony, tablety, 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 Androida i Recording API na urządzeniach mobilnych (w przypadku danych użytkownika dotyczących aktywności fizycznej) com.google.android.gms:play-services-fitness:21.3.0 | Telefony, tablety, 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 | Telefony, tablety, Android TV, Android Go, ChromeOS | 
| Natywny pakiet SDK w języku C usług gier Google Play w wersji 2 na Androida com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 | Telefony, tablety, 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 | Telefony, tablety, Android TV, Android Go, ChromeOS | 
| Matter API com.google.android.gms:play-services-home:16.0.0 | Telefon, tablet | 
| Aplikacje błyskawiczne z Google Play com.google.android.gms:play-services-instantapps:18.2.0 | Wycofano. Więcej informacji znajdziesz w artykule Aplikacje błyskawiczne w Google Play. | 
| Usługi lokalizacyjne na Androidzie com.google.android.gms:play-services-location:21.3.0 | Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS | 
| Google Maps SDK na Androida com.google.android.gms:play-services-maps:19.2.0 | Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS | 
| Pakiet SDK Map 3D na Androida com.google.android.gms:play-services-maps3d:0.1.0 | Telefon, tablet | 
| Skanowanie kodów kreskowych za pomocą ML Kit com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 | Telefony, tablety, Android Go, ChromeOS | 
| Skaner dokumentów ML Kit com.google.android.gms:play-services-mlkit-document-scanner:16.0.0 | Telefony, tablety, Android Go, ChromeOS | 
| Wykrywanie twarzy w ML Kit com.google.android.gms:play-services-mlkit-face-detection:17.1.0 | Telefony, tablety, Android Go, ChromeOS | 
| Oznaczanie obrazów etykietami w ML Kit com.google.android.gms:play-services-mlkit-image-labeling:16.0.8 | Telefony, tablety, Android Go, ChromeOS | 
| Niestandardowe oznaczanie obrazów w 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 | Telefony, tablety, Android Go, ChromeOS | 
| Inteligentna odpowiedź w ML Kit com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 | Telefony, tablety, Android Go, ChromeOS | 
| Segmentacja tematu 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 ML Kit com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 | Telefony, tablety, Android Go, ChromeOS | 
| Rozpoznawanie tekstu w ML Kit w przypadku pisma dewanagari com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 | Telefony, tablety, Android Go, ChromeOS | 
| Rozpoznawanie tekstu w języku japońskim w ML Kit com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 | Telefony, tablety, 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 | 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.3.0 | Telefony, tablety, Android TV, Auto, Android Go | 
| Pokaż licencje open source com.google.android.gms:play-services-oss-licenses:17.3.0 | Telefony, tablety, 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:22.1.0 | Telefony, tablety, 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 | Telefony, tablety, Android Go, ChromeOS, Wear OS Obsługiwane na urządzeniach z Androidem w wersji od 4.4 (API na poziomie 19) do 9 (API na poziomie 28). | 
| Portfel Google (wcześniej Google Pay na karty) com.google.android.gms:play-services-pay:16.5.0 | Telefony, tablety, 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 | Telefony, tablety, Android TV, Android Go, ChromeOS | 
| Interfejsy SafetyNet API (w tym bezpieczne przeglądanie i weryfikacja aplikacji) com.google.android.gms:play-services-safetynet:18.1.0 | Telefony, tablety, 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.0 | Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS | 
| Usługa przyspieszania na Androidzie com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 | Telefony, tablety, Android Go, ChromeOS | 
| Interfejs TensorFlow Lite GPU Delegate API dla usług Google Play com.google.android.gms:play-services-tflite-gpu:16.4.0 | Telefony, tablety, Android Go, ChromeOS | 
| Interfejs API TensorFlow Lite Java dla usług Google Play com.google.android.gms:play-services-tflite-java:16.4.0 | Telefony, tablety, Android Go, ChromeOS | 
| Interfejs TensorFlow Lite Support API dla usług Google Play com.google.android.gms:play-services-tflite-support:16.4.0 | Telefony, tablety, 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 | 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:19.5.0 | Telefony, tablety, Android Auto, Android Go, ChromeOS, Wear OS | 
| Wearable Data Layer API com.google.android.gms:play-services-wearable:19.0.0 | Telefony, tablety, Wear OS | 
Wtyczki Gradle
Usługi Google Play zawierają 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.
| Przypadek użycia i nazwa wtyczki Gradle | Obsługiwane urządzenia | 
|---|---|
| Pokaż licencje open source com.google.android.gms:oss-licenses-plugin:0.10.9 | 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 |