To develop an app using Google Play services APIs , follow the instructions on this page to set up your project with the relevant SDKs, which are available from the Google maven repository .
To test your app when using Google Play services, you must use one of the following:
- A compatible Android device that runs Android 6.0 (API level 23) or higher and has the Google Play Store app installed.
- The Android emulator with an AVD that runs the Google APIs platform based on Android 6.0 (API level 23) or higher.
اعلان وابستگیها برای سرویسهای گوگل پلی
To develop features that depend on the Google Play services APIs in your app, complete the following steps:
Open the
build.gradlefile inside your app's module directory.For each SDK that your app requires, include the dependency for that SDK. This page includes a section that lists common Google Play services dependencies for Android apps. You might also want to add Firebase to your project .
Save the changes and sync your project .
The following snippet shows an example build.gradle file that uses the location library:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.3.0'
}
New versions of the Google Play services SDKs with bug fixes and new features are periodically released. These updates are announced in the release notes . If your app uses a dependency that has been updated, change to the latest version in your app's dependencies to take advantage of these fixes.
بررسی کنید که آیا سرویسهای گوگل پلی نصب شدهاند یا خیر.
همانطور که در بخش «مروری بر سرویسهای گوگل پلی» توضیح داده شد، سرویسهای گوگل پلی به طور خودکار در اندروید ۶.۰ (سطح API ۲۳) و بالاتر از طریق برنامه فروشگاه گوگل پلی بهروزرسانی میشوند. با این حال، دستگاههایی که فروشگاه گوگل پلی ندارند، سرویسهای گوگل پلی را نصب ندارند. اگر برنامه شما روی دستگاههایی بدون سرویسهای گوگل پلی اجرا میشود، قبل از تلاش برای استفاده از APIهای گوگل یا فعال کردن ویژگیهایی که به آن نیاز دارند، همیشه باید بررسی کنید که آیا سرویسهای گوگل پلی نصب شدهاند یا خیر.
To check for the presence of Google Play services on the device, use the isGooglePlayServicesAvailable() method.
To then begin a connection to Google Play services, or learn how to detect whether the version of Google Play services installed supports a specific API, read the guide on Accessing Google APIs .
وابستگیهای سرویسهای گوگل پلی
The following table lists the dependencies for Google Play services that you can include in your Android app. You can filter the list by device type by selecting one of the buttons, and you can search for a specific use case or dependency name by entering text into the box that appears after the buttons.
| مورد استفاده و نام وابستگی | دستگاههای پشتیبانیشده |
|---|---|
تبلیغات موبایلی گوگلcom.google.android.gms:play-services-ads:24.9.0 | گوشی، تبلت |
شناسه تبلیغاتی اندروید (AAID)com.google.android.gms:play-services-ads-identifier:18.2.0 | تلفن، تبلت، تلویزیون اندروید، سیستم عامل کروم |
نسخه سبک تبلیغات موبایلی گوگلcom.google.android.gms:play-services-ads-lite:24.6.0 | گوشی، تبلت |
ادسنس برای جستجو (AFS) تبلیغات جستجوی سفارشی (CSA)com.google.android.gms:play-services-afs-native:19.1.0 | گوشی، تبلت، سیستم عامل کروم |
کیت توسعه نرمافزاری خدمات گوگل آنالیتیکس برای اندرویدcom.google.android.gms:play-services-analytics:18.1.1 | Deprecated. Use Google Analytics for Firebase instead. |
فهرست برنامهcom.google.android.gms:play-services-appindex:16.2.0 | گوشی، تبلت، تلویزیون اندروید |
جستجوی برنامهcom.google.android.gms:play-services-appsearch:16.0.1 | گوشی، تبلت، تلویزیون اندروید |
شناسه مجموعه برنامههای اندرویدcom.google.android.gms:play-services-appset:16.1.0 | تلفن، تبلت، تلویزیون اندروید، سیستم عامل کروم |
ورود به سیستم گوگل برای اندرویدcom.google.android.gms:play-services-auth:21.5.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS |
رابط برنامهنویسی نرمافزار بازیابی پیامکcom.google.android.gms:play-services-auth-api-phone:18.3.0 | گوشی، تبلت، اندروید گو |
Block Store API (includes user credential storage)com.google.android.gms:play-services-auth-blockstore:16.4.0 | گوشی، تبلت، اندروید گو، کروم او اس |
API آگاهی گوگلcom.google.android.gms:play-services-awareness:19.1.0 | تلفن، تبلت، اتو، اندروید گو، کروم او اس |
کلاسهای کاربردیcom.google.android.gms:play-services-base:18.9.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
آزمایش تقلبیها برای کلاسهای کاربردیcom.google.android.gms:play-services-base-testing:16.2.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
More utility classescom.google.android.gms:play-services-basement:18.9.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
تقویت کننده دوربین در نور کمcom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta06 | گوشی، تبلت |
گوگل کستcom.google.android.gms:play-services-cast:22.2.0 | گوشی، تبلت، اندروید گو، کروم او اس |
چارچوب برنامه گوگل کست (CAF)com.google.android.gms:play-services-cast-framework:22.2.0 | گوشی، تبلت، اندروید گو، کروم او اس |
اسکنر کد گوگلcom.google.android.gms:play-services-code-scanner:16.1.0 | گوشی، تبلت، اندروید گو، کروم او اس |
پشته شبکه کرومیوم (Cronet)com.google.android.gms:play-services-cronet:18.1.1 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
تعاملات دستگاه به دستگاه (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 | گوشی، تبلت، اندروید گو |
احراز هویت سریع آنلاین (FIDO)com.google.android.gms:play-services-fido:21.2.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Supported on devices that run Android 7.0 (API level 24) or higher. |
Google Fit API for Android and Recording API on mobile (for user fitness data)com.google.android.gms:play-services-fitness:21.3.0 | گوشی، تبلت، اندروید گو، کروم او اس، ویر او اس |
خدمات بازیهای گوگل پلی نسخه ۲ برای اندرویدcom.google.android.gms:play-services-games-v2:21.0.0 | تلفن، تبلت، اندروید تیوی، اندروید گو، کروماواس |
Google Play Games Services v2 Native C SDK for Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 | تلفن، تبلت، اندروید تیوی، اندروید گو، کروماواس |
خدمات بازیهای گوگل پلی نسخه ۱ برای اندرویدcom.google.android.gms:play-services-games:24.0.0 | تلفن، تبلت، اندروید تیوی، اندروید گو، کروماواس |
API مادهcom.google.android.gms:play-services-home:16.0.0 | گوشی، تبلت |
گوگل پلی فوریcom.google.android.gms:play-services-instantapps:18.2.0 | Deprecated. See Google Play Instant for more information. |
سرویسهای موقعیت مکانی برای اندرویدcom.google.android.gms:play-services-location:21.3.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
کیت توسعه نرمافزاری نقشههای گوگل برای اندرویدcom.google.android.gms:play-services-maps:19.2.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
کیت توسعه نرمافزاری سهبعدی نقشههای گوگل برای اندرویدcom.google.android.gms:play-services-maps3d:0.1.0 | گوشی، تبلت |
اسکن بارکد کیت MLcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 | گوشی، تبلت، اندروید گو، کروم او اس |
اسکنر اسناد ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0 | گوشی، تبلت، اندروید گو، کروم او اس |
کیت تشخیص چهره MLcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 | گوشی، تبلت، اندروید گو، کروم او اس |
برچسبگذاری تصویر کیت MLcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 | گوشی، تبلت، اندروید گو، کروم او اس |
برچسبگذاری تصویر کیت ML به صورت سفارشیcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 | گوشی، تبلت، اندروید گو، کروم او اس |
شناسایی زبان کیت MLcom.google.android.gms:play-services-mlkit-language-id:17.0.0 | گوشی، تبلت، اندروید گو، کروم او اس |
پاسخ هوشمند کیت MLcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 | گوشی، تبلت، اندروید گو، کروم او اس |
تقسیمبندی موضوعی کیت MLcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 | گوشی، تبلت، اندروید گو، کروم او اس |
تشخیص متن کیت MLcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 | گوشی، تبلت، اندروید گو، کروم او اس |
تشخیص متن کیت ML برای زبان چینیcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 | گوشی، تبلت، اندروید گو، کروم او اس |
تشخیص متن کیت ML برای Devanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 | گوشی، تبلت، اندروید گو، کروم او اس |
تشخیص متن کیت ML برای زبان ژاپنیcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 | گوشی، تبلت، اندروید گو، کروم او اس |
تشخیص متن کیت ML برای زبان کرهایcom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1 | گوشی، تبلت، اندروید گو، کروم او اس |
کشف و اتصال دستگاه نزدیکcom.google.android.gms:play-services-nearby:19.3.0 | تلفن، تبلت، اندروید تیوی، اتو، اندروید گو |
نمایش مجوزهای متنبازcom.google.android.gms:play-services-oss-licenses:17.3.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS Supported on devices that run Android 5.0 (API level 21) or higher. |
کتابخانههای دسترسی برنامهریزیشده (PAL)com.google.android.gms:play-services-pal:23.0.0 | Phone, Tablet, Android TV Supported on devices that run Android 5.0 (API level 21) or higher. |
بررسی کیفیت قفل صفحهcom.google.android.gms:play-services-password-complexity:18.1.0 | گوشی، تبلت، اندروید گو، کروم او اس، ویر او اس Supported on devices that run Android 4.4 (API level 19) to Android 9 (API level 28). |
گوگل والت (قبلاً گوگل پی برای کارتهای اعتباری)com.google.android.gms:play-services-pay:16.5.0 | گوشی، تبلت، اندروید گو، کروم او اس Supported on devices that run Android 5.0 (API level 20) or higher. |
reCAPTCHA Enterprise برای ابزار دقیق برنامهcom.google.android.gms:play-services-recaptcha:17.1.0 | تلفن، تبلت، اندروید تیوی، اندروید گو، کروماواس |
SafetyNet APIs (includes safe browsing and verify apps)com.google.android.gms:play-services-safetynet:18.1.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS |
مدیریت برچسب گوگلcom.google.android.gms:play-services-tagmanager:18.3.0 | تلفن، تبلت، اندروید تیوی، اندروید گو، کروماواس |
API وظایف در اندرویدcom.google.android.gms:play-services-tasks:18.4.0 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
سرویس شتابدهنده برای اندرویدcom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 | گوشی، تبلت، اندروید گو، کروم او اس |
TensorFlow Lite GPU Delegate API for Google Play servicescom.google.android.gms:play-services-tflite-gpu:16.4.0 | گوشی، تبلت، اندروید گو، کروم او اس |
TensorFlow Lite Java API for Google Play servicescom.google.android.gms:play-services-tflite-java:16.4.0 | گوشی، تبلت، اندروید گو، کروم او اس |
TensorFlow Lite Support API for Google Play servicescom.google.android.gms:play-services-tflite-support:16.4.0 | گوشی، تبلت، اندروید گو، کروم او اس |
API شبکه Threadcom.google.android.gms:play-services-threadnetwork:16.3.0 | گوشی، تبلت |
API زمان قابل اعتمادcom.google.android.gms:play-services-time:16.0.1 | تلفن، تبلت، اتو، اندروید گو، Wear OS |
موبایل ویژنcom.google.android.gms:play-services-vision:20.1.3 | گوشی، تبلت، اندروید گو، کروم او اس |
پرداخت با گوگل پی در اندرویدcom.google.android.gms:play-services-wallet:19.5.0 | Phone, Tablet, Auto, Android Go, ChromeOS, Wear OS |
رابط برنامهنویسی کاربردی لایه داده پوشیدنیcom.google.android.gms:play-services-wearable:19.0.0 | گوشی، تبلت، سیستم عامل Wear OS |
Gradle plugins
Google Play services also includes several Gradle plugins, as shown in the following table. Note that the buttons that appear before the previous table don't change the information that appears in this table.
| مورد استفاده و نام افزونه Gradle | دستگاههای پشتیبانیشده |
|---|---|
نمایش مجوزهای متنبازcom.google.android.gms:oss-licenses-plugin:0.10.10 | گوشی، تبلت، سیستم عامل کروم |
بررسی دقیق نسخهcom.google.android.gms:strict-version-matcher-plugin:1.2.4 | Phone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |