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 korzysta z platformy interfejsów API Google opartej na Androidzie 6.0 (poziom interfejsu API 23) lub nowszym.
Deklarowanie zależności w Usługach Google Play
Aby w swojej aplikacji opracowywać 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, dołącz odpowiednie zależności. Na tej stronie znajduje się sekcja z informacjami o częstych zależnościach od usług Google Play w przypadku aplikacji na Androida. Możesz też dodać do projektu zależności Firebase.
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 na Androidzie 6.0 (poziom interfejsu API 23) lub nowszym za pomocą aplikacji Sklep Google Play. 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ść 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 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.
| Użyj nazwy przypadku użycia i zależności | Obsługiwane urządzenia |
|---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:24.0.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 Google Mobile Adscom.google.android.gms:play-services-ads-lite:24.0.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 Androidacom.google.android.gms:play-services-analytics:18.1.1 |
Wycofany. Zamiast tego użyj Google Analytics dla Firebase. |
Indeks aplikacjicom.google.android.gms:play-services-appindex:16.2.0 |
Telefon, tablet, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Telefon, tablet, Android TV |
Identyfikator zestawu aplikacji na Androidacom.google.android.gms:play-services-appset:16.1.0 |
Telefon, tablet, Android TV, ChromeOS |
Logowanie przez Google na Androidacom.google.android.gms:play-services-auth:21.3.0 |
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS |
SMS Retriever APIcom.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 APIcom.google.android.gms:play-services-awareness:19.1.0 |
Telefon, tablet, samochód, Android Go, ChromeOS |
Klasy usługcom.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ługowychcom.google.android.gms:play-services-base-testing:16.1.0 |
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Więcej klas usługcom.google.android.gms:play-services-basement:18.5.0 |
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.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 Scannercom.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ądzeniamicom.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 Androida i interfejs 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 Androidacom.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 Androidacom.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 Androidacom.google.android.gms:play-services-games:23.2.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Interfejs API Mattercom.google.android.gms:play-services-home:16.0.0 |
Telefon, tablet |
Aplikacje błyskawiczne w Google Playcom.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 Androidacom.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 Androidacom.google.android.gms:play-services-maps:19.1.0 |
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Skanowanie kodów kreskowych za pomocą ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Telefon, tablet, Android Go, ChromeOS |
Skaner dokumentów ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1 |
Telefon, tablet, Android Go, ChromeOS |
Wykrywanie twarzy w ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Telefon, tablet, Android Go, ChromeOS |
Etykietowanie obrazów za pomocą ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefon, tablet, Android Go, ChromeOS |
Niestandardowe oznaczanie obrazów za pomocą ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Telefon, tablet, Android Go, ChromeOS |
ML Kit – identyfikacja językacom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Inteligentna odpowiedź w ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Telefon, tablet, Android Go, ChromeOS |
Segmentacja tematów ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Telefon, tablet, Android Go, ChromeOS |
ML Kit – rozpoznawanie tekstucom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
Telefon, tablet, Android Go, ChromeOS |
ML Kit – rozpoznawanie tekstu w języku chińskimcom.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 dewanagaricom.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ńskiegocom.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ńskiegocom.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łączeniacom.google.android.gms:play-services-nearby:19.3.0 |
Telefon, tablet, Android TV, Auto, Android Go |
Pokaż licencje open sourcecom.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:22.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 aplikacjicom.google.android.gms:play-services-recaptcha:17.1.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Interfejsy API SafetyNet (obejmują atestację urządzeń, 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 Googlecom.google.android.gms:play-services-tagmanager:18.1.1 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Interfejs Tasks API na Androidacom.google.android.gms:play-services-tasks:18.2.0 |
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Usługa przyspieszania na Androidacom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 |
Telefon, tablet, Android Go, ChromeOS |
Interfejs API delegowania GPU TensorFlow Lite do usług Google Playcom.google.android.gms:play-services-tflite-gpu:16.4.0 |
Telefon, tablet, Android Go, ChromeOS |
TensorFlow Lite API w języku Java do usług Google Playcom.google.android.gms:play-services-tflite-java:16.4.0 |
Telefon, tablet, Android Go, ChromeOS |
Interfejs API TensorFlow Lite dla usług Google Playcom.google.android.gms:play-services-tflite-support:16.4.0 |
Telefon, tablet, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.2.1 |
Telefon, tablet |
Trusted Time APIcom.google.android.gms:play-services-time:16.0.1 |
Telefon, tablet, Auto, Android Go, Wear OS |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
Telefon, tablet, Android Go, ChromeOS |
Google Pay do dokonywania płatności na Androidziecom.google.android.gms:play-services-wallet:19.4.0 |
Telefon, tablet, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.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.
| Nazwa przypadku użycia i wtyczki Gradle | Obsługiwane urządzenia |
|---|---|
Pokaż licencje open sourcecom.google.android.gms:oss-licenses-plugin:0.10.6 |
Telefon, tablet, ChromeOS |
Ścisła kontrola wersjicom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Telefon, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |