برای توسعه یک برنامه با استفاده از API های خدمات Google Play ، دستورالعمل های این صفحه را دنبال کنید تا پروژه خود را با SDK های مربوطه، که از مخزن Google maven در دسترس هستند، راه اندازی کنید.
برای آزمایش برنامه خود هنگام استفاده از خدمات Google Play، باید از یکی از موارد زیر استفاده کنید:
- یک دستگاه Android سازگار که دارای Android 6.0 (سطح API 23) یا بالاتر است و برنامه فروشگاه Google Play را نصب کرده است.
- شبیهساز اندروید با یک AVD که پلتفرم Google APIs را بر اساس Android 6.0 (سطح API 23) یا بالاتر اجرا میکند.
وابستگی خدمات Google Play را اعلام کنید
برای توسعه ویژگیهایی که به APIهای خدمات Google Play در برنامه شما بستگی دارد، مراحل زیر را کامل کنید:
فایل
build.gradle
را در دایرکتوری ماژول برنامه خود باز کنید.برای هر SDK که برنامه شما نیاز دارد، وابستگی آن SDK را درج کنید. این صفحه شامل بخشی است که وابستگی های متداول خدمات Google Play را برای برنامه های Android فهرست می کند. همچنین ممکن است بخواهید وابستگی های Firebase را به پروژه خود اضافه کنید .
تغییرات را ذخیره کنید و پروژه خود را همگام کنید .
قطعه زیر یک نمونه فایل build.gradle
را نشان می دهد که از کتابخانه مکان استفاده می کند:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.3.0'
}
نسخههای جدید SDK خدمات Google Play با رفع اشکال و ویژگیهای جدید به صورت دورهای منتشر میشوند. این به روز رسانی ها در یادداشت های انتشار اعلام شده است. اگر برنامه شما از وابستگی استفاده میکند که بهروزرسانی شده است، برای بهرهگیری از این اصلاحات، آن را به آخرین نسخه در وابستگیهای برنامه خود تغییر دهید.
بررسی کنید که آیا خدمات Google Play نصب شده است یا خیر
همانطور که در نمای کلی خدمات Google Play توضیح داده شد، خدمات Google Play بهروزرسانیهای خودکار را در Android نسخه 6.0 (سطح API 23) و بالاتر از طریق برنامه فروشگاه Google Play دریافت میکند. با این حال، دستگاههای اندرویدی بدون فروشگاه Google Play، سرویسهای Google Play را نصب نمیکنند. اگر برنامه شما روی دستگاههایی بدون خدمات Google Play اجرا میشود، ممکن است بخواهید قبل از اینکه بخواهید از Google API استفاده کنید، بررسی کنید که آیا خدمات Google Play روی دستگاه نصب شده است یا ویژگیهایی را در برنامه خود فعال کنید که برای عملکرد به خدمات Google Play نیاز دارند.
برای بررسی وجود سرویسهای Google Play در دستگاه، از روش isGooglePlayServicesAvailable()
استفاده کنید.
سپس برای شروع اتصال به سرویسهای Google Play یا یادگیری نحوه تشخیص اینکه آیا نسخه نصب شده سرویسهای Google Play از یک API خاص پشتیبانی میکند یا خیر، راهنمای دسترسی به Google APIs را بخوانید.
وابستگی به خدمات Google Play
جدول زیر وابستگیهای سرویسهای Google Play را که میتوانید در برنامه اندروید خود قرار دهید، فهرست میکند. میتوانید با انتخاب یکی از دکمهها، فهرست را بر اساس نوع دستگاه فیلتر کنید، و میتوانید با وارد کردن متن در کادری که بعد از دکمهها ظاهر میشود، یک مورد خاص یا نام وابستگی را جستجو کنید.
از نام مورد و وابستگی استفاده کنید | دستگاه های پشتیبانی شده |
---|---|
تبلیغات موبایل گوگلcom.google.android.gms:play-services-ads:23.5.0 | تلفن، تبلت |
شناسه تبلیغات اندروید (AAID)com.google.android.gms:play-services-ads-identifier:18.1.0 | تلفن، تبلت، Android TV، ChromeOS |
نسخه سبک تبلیغات موبایل گوگلcom.google.android.gms:play-services-ads-lite:23.5.0 | تلفن، تبلت |
AdSense for Search (AFS) تبلیغات جستجوی سفارشی (CSA)com.google.android.gms:play-services-afs-native:19.1.0 | تلفن، تبلت، ChromeOS |
Google Analytics Services SDK برای اندرویدcom.google.android.gms:play-services-analytics:18.1.1 | منسوخ شده است. به جای آن از Google Analytics برای Firebase استفاده کنید. |
فهرست برنامهcom.google.android.gms:play-services-appindex:16.2.0 | تلفن، تبلت، Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 | تلفن، تبلت، Android TV |
شناسه مجموعه برنامه Androidcom.google.android.gms:play-services-appset:16.1.0 | تلفن، تبلت، Android TV، ChromeOS |
ورود به سیستم گوگل برای اندرویدcom.google.android.gms:play-services-auth:21.2.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.1.0 | تلفن، تبلت، اندروید گو |
Block Store API (شامل فضای ذخیرهسازی اعتبار کاربر)com.google.android.gms:play-services-auth-blockstore:16.4.0 | تلفن، تبلت، Android Go، ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.1.0 | تلفن، رایانه لوحی، خودکار، Android Go، ChromeOS |
کلاس های کاربردیcom.google.android.gms:play-services-base:18.5.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS |
آزمایش تقلبی برای کلاس های ابزارcom.google.android.gms:play-services-base-testing:16.1.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS |
کلاس های کاربردی بیشترcom.google.android.gms:play-services-basement:18.4.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS |
Google Castcom.google.android.gms:play-services-cast:22.0.0 | تلفن، تبلت، Android Go، ChromeOS |
چارچوب برنامه Google Cast (CAF)com.google.android.gms:play-services-cast-framework:22.0.0 | تلفن، تبلت، Android Go، ChromeOS |
اسکنر کد گوگلcom.google.android.gms:play-services-code-scanner:16.1.0 | تلفن، تبلت، Android Go، ChromeOS |
پشته شبکه Chromium (Cronet)com.google.android.gms:play-services-cronet:18.1.0 | تلفن، رایانه لوحی، 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.1.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS در دستگاههایی که Android 7.0 (سطح API 24) یا بالاتر دارند، پشتیبانی میشود. |
Google Fit API برای Android و Recording API در تلفن همراه (برای داده های تناسب اندام کاربر)com.google.android.gms:play-services-fitness:21.2.0 | تلفن، تبلت، Android Go، ChromeOS، Wear OS |
Google Play Games Services v2 برای اندرویدcom.google.android.gms:play-services-games-v2:20.1.2 | تلفن، تبلت، Android TV، Android Go، ChromeOS |
Google Play Games Services v2 Native C SDK برای اندرویدcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 | تلفن، تبلت، Android TV، Android Go، ChromeOS |
Google Play Games Services v1 برای اندرویدcom.google.android.gms:play-services-games:23.2.0 | تلفن، تبلت، Android TV، Android Go، ChromeOS |
Matter APIcom.google.android.gms:play-services-home:16.0.0 | تلفن، تبلت |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.1.0 | تلفن، تبلت، Android TV، Android Go، ChromeOS در دستگاههایی که دارای Android نسخه 5.0 (سطح API 21) یا بالاتر هستند، پشتیبانی میشود. |
خدمات مکان برای اندرویدcom.google.android.gms:play-services-location:21.3.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS |
Google Maps SDK برای اندرویدcom.google.android.gms:play-services-maps:19.0.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS |
اسکن بارکد کیت MLcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 | تلفن، تبلت، Android Go، ChromeOS |
اسکنر اسناد کیت MLcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1 | تلفن، تبلت، Android Go، ChromeOS |
تشخیص چهره کیت MLcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 | تلفن، تبلت، Android Go، ChromeOS |
برچسب گذاری تصویر کیت MLcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 | تلفن، تبلت، Android Go، ChromeOS |
برچسب گذاری تصویر کیت ML سفارشیcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 | تلفن، تبلت، Android Go، ChromeOS |
شناسایی زبان کیت MLcom.google.android.gms:play-services-mlkit-language-id:17.0.0 | تلفن، تبلت، Android Go، ChromeOS |
پاسخ هوشمند ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 | تلفن، تبلت، Android Go، ChromeOS |
بخش بندی موضوع کیت MLcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 | تلفن، تبلت، Android Go، ChromeOS |
تشخیص متن کیت MLcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 | تلفن، تبلت، Android Go، ChromeOS |
تشخیص متن کیت ML برای چینیcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 | تلفن، تبلت، Android Go، ChromeOS |
تشخیص متن کیت ML برای دوانگاریcom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 | تلفن، تبلت، Android Go، ChromeOS |
تشخیص متن کیت ML برای ژاپنیcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 | تلفن، تبلت، Android Go، ChromeOS |
تشخیص متن کیت ML برای کره ایcom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1 | تلفن، تبلت، Android Go، ChromeOS |
کشف و اتصال دستگاه در نزدیکیcom.google.android.gms:play-services-nearby:19.3.0 | تلفن، تبلت، Android TV، Auto، Android Go |
نمایش مجوزهای منبع بازcom.google.android.gms:play-services-oss-licenses:17.1.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS در دستگاههایی که دارای Android نسخه 5.0 (سطح API 21) یا بالاتر هستند، پشتیبانی میشود. |
کتابخانههای دسترسی برنامهای (PAL)com.google.android.gms:play-services-pal:21.0.0 | تلفن، تبلت، Android TV در دستگاههایی که دارای Android نسخه 5.0 (سطح API 21) یا بالاتر هستند، پشتیبانی میشود. |
بررسی کیفیت قفل صفحهcom.google.android.gms:play-services-password-complexity:18.1.0 | تلفن، تبلت، Android Go، ChromeOS، Wear OS در دستگاههایی که Android 4.4 (سطح API 19) تا Android 9 (سطح API 28) را اجرا میکنند، پشتیبانی میشود. |
Google Wallet (Google Pay for Passes سابق)com.google.android.gms:play-services-pay:16.5.0 | تلفن، تبلت، Android Go، ChromeOS در دستگاههایی که دارای Android نسخه 5.0 (سطح API 20) یا بالاتر هستند، پشتیبانی میشود. |
reCAPTCHA Enterprise برای ابزار دقیق برنامهcom.google.android.gms:play-services-recaptcha:17.1.0 | تلفن، تبلت، Android TV، Android Go، ChromeOS |
SafetyNet API (شامل تأیید دستگاه، مرور ایمن، reCAPTCHA و تأیید برنامه)com.google.android.gms:play-services-safetynet:18.1.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS |
گوگل تگ منیجرcom.google.android.gms:play-services-tagmanager:18.1.1 | تلفن، تبلت، Android TV، Android Go، ChromeOS |
Tasks API در اندرویدcom.google.android.gms:play-services-tasks:18.2.0 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS |
سرویس شتاب برای اندرویدcom.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01 | تلفن، تبلت، Android Go، ChromeOS |
TensorFlow Lite GPU Delegate API برای خدمات Google Playcom.google.android.gms:play-services-tflite-gpu:16.3.0 | تلفن، تبلت، Android Go، ChromeOS |
TensorFlow Lite Java API برای خدمات Google Playcom.google.android.gms:play-services-tflite-java:16.3.0 | تلفن، تبلت، Android Go، ChromeOS |
API پشتیبانی TensorFlow Lite برای خدمات Google Playcom.google.android.gms:play-services-tflite-support:16.3.0 | تلفن، تبلت، Android Go، ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.2.1 | تلفن، تبلت |
موبایل ویژنcom.google.android.gms:play-services-vision:20.1.3 | تلفن، تبلت، Android Go، ChromeOS |
Google Pay for Payments در اندرویدcom.google.android.gms:play-services-wallet:19.4.0 | تلفن، رایانه لوحی، خودکار، Android Go، ChromeOS، Wear OS |
API لایه داده پوشیدنیcom.google.android.gms:play-services-wearable:19.0.0 | تلفن، تبلت، سیستم عامل Wear |
پلاگین های Gradle
خدمات گوگل پلی همچنین شامل چندین پلاگین Gradle است که در جدول زیر نشان داده شده است. توجه داشته باشید که دکمه هایی که قبل از جدول قبلی ظاهر می شوند اطلاعات ظاهر شده در این جدول را تغییر نمی دهند.
از نام Case و Gradle افزونه استفاده کنید | دستگاه های پشتیبانی شده |
---|---|
نمایش مجوزهای منبع بازcom.google.android.gms:oss-licenses-plugin:0.10.6 | تلفن، تبلت، ChromeOS |
بررسی دقیق نسخهcom.google.android.gms:strict-version-matcher-plugin:1.2.4 | تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS |