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 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 listą typowych zależności 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 w aplikacji Sklep Google Play na urządzeniach z Androidem 6.0 (poziom interfejsu API 23) lub nowszym. 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ś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, 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:23.6.0 |
Telefon, tablet |
Identyfikator wyświetlania reklam na urządzeniach z Androidem (AAID)com.google.android.gms:play-services-ads-identifier:18.1.0 |
Telefon, tablet, Android TV, ChromeOS |
Lekka wersja Google Mobile Adscom.google.android.gms:play-services-ads-lite:23.6.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.2.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 zajęć z zakresu nauk ścisłychcom.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 Google Play Games w wersji 1 na Androidacom.google.android.gms:play-services-games:23.2.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Interfejs Matter APIcom.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.0.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 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 |
Rozpoznawanie tekstu w ML Kit w przypadku języka chińskiegocom.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:21.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ądzenia, 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.3.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.3.0 |
Telefon, tablet, Android Go, ChromeOS |
TensorFlow Lite – interfejs API w języku Java do usług Google Playcom.google.android.gms:play-services-tflite-java:16.3.0 |
Telefon, tablet, Android Go, ChromeOS |
Interfejs API obsługi TensorFlow Lite dla usług Google Playcom.google.android.gms:play-services-tflite-support:16.3.0 |
Telefon, tablet, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.2.1 |
Telefon, tablet |
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 |