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:
Otwórz plik
build.gradlew katalogu modułów aplikacji.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.
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.
| Przykład zastosowania i nazwa zależności | Obsługiwane urządzenia |
|---|---|
Reklamy mobilne Googlecom.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 Googlecom.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 Androidacom.google.android.gms:play-services-analytics:18.0.2 |
Wycofane. Użyj Google Analytics dla Firebase. |
Indeks aplikacjicom.google.android.gms:play-services-appindex:16.1.0 |
Telefon, tablet, Android TV |
Identyfikator zestawu aplikacji na Androidacom.google.android.gms:play-services-appset:16.0.2 |
Telefon, tablet, Android TV, system operacyjny Chrome |
Logowanie przez Google na Androidacom.google.android.gms:play-services-auth:20.4.1 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS |
SMS Fetcher APIcom.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 APIcom.google.android.gms:play-services-awareness:19.0.1 |
Telefon, tablet, Auto, Android Go, ChromeOS |
Klasy narzędzicom.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ścicom.google.android.gms:play-services-base-testing:16.0.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Więcej klas narzędzicom.google.android.gms:play-services-basement:18.1.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.2.0 |
Telefon, tablet, Android Go, Chrome OS |
Platforma przesyłająca aplikację Google Castcom.google.android.gms:play-services-cast-framework:21.2.0 |
Telefon, tablet, Android Go, Chrome OS |
Odbiorniki Android TVcom.google.android.gms:play-services-cast-tv:20.0.0 |
Android TV |
Google Code Scannercom.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 Androidacom.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 Androidacom.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 Androidacom.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 Androidacom.google.android.gms:play-services-games:23.1.0 |
Telefon, tablet, Android TV, Android Go, Chrome OS |
Interfejs API Mattercom.google.android.gms:play-services-home:16.0.0 |
Telefon, tablet |
Aplikacja błyskawiczna w Google Playcom.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 Androidacom.google.android.gms:play-services-maps:18.1.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Skanowanie kodów kreskowych ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0 |
Telefon, tablet, Android Go, Chrome OS |
Wykrywanie twarzy w ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Telefon, tablet, Android Go, Chrome OS |
Oznaczanie etykietami ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefon, tablet, Android Go, Chrome OS |
Niestandardowe etykiety obrazów w ML Kitcom.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 Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Telefon, tablet, Android Go, Chrome OS |
Inteligentna odpowiedź ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Telefon, tablet, Android Go, Chrome OS |
Rozpoznawanie tekstu w ML Kitcom.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 łączeniecom.google.android.gms:play-services-nearby:18.4.0 |
Telefon, tablet, Android TV, auto, Android Go |
Pokaż licencje open sourcecom.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 Passescom.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 aplikacjicom.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 Googlecom.google.android.gms:play-services-tagmanager:18.0.2 |
Telefon, tablet, Android TV, Android Go, Chrome OS |
Lista zadań API na Androidziecom.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 Playcom.google.android.gms:play-services-tflite-gpu:16.1.0 |
Telefon, tablet, Android Go, Chrome OS |
Interfejs API TensorFlow Lite w Usługach Google Playcom.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 Playcom.google.android.gms:play-services-tflite-support:16.0.1 |
Telefon, tablet, Android Go, Chrome OS |
Interfejs Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.0-beta02 |
Telefon, tablet |
Widoczność dla urządzeń mobilnychcom.google.android.gms:play-services-vision:20.1.3 |
Telefon, tablet, Android Go, Chrome OS |
Google Pay do płatności na Androidziecom.google.android.gms:play-services-wallet:19.1.0 |
Telefon, tablet, Auto, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.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ą.
| Nazwa przypadku użycia i nazwa wtyczki Gradle | Obsługiwane urządzenia |
|---|---|
Pokaż licencje open sourcecom.google.android.gms:oss-licenses-plugin:0.10.6 |
Telefon, tablet, Chrome OS |
Ścisłe sprawdzanie wersjicom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |