سرویس های Google Play را راه اندازی کنید

برای توسعه یک برنامه با استفاده از API های خدمات Google Play ، دستورالعمل های این صفحه را دنبال کنید تا پروژه خود را با SDK های مربوطه، که از مخزن Google maven در دسترس هستند، راه اندازی کنید.

برای آزمایش برنامه خود هنگام استفاده از خدمات Google Play، باید از یکی از موارد زیر استفاده کنید:

  • یک دستگاه Android سازگار که دارای Android نسخه 5.0 (سطح API 21) یا بالاتر است و برنامه فروشگاه Google Play را نصب کرده است.
  • شبیه ساز اندروید با AVD که پلتفرم Google APIs را بر اساس اندروید 5.0 (سطح API 21) یا بالاتر اجرا می کند.

وابستگی خدمات Google Play را اعلام کنید

برای توسعه ویژگی‌هایی که به APIهای خدمات Google Play در برنامه شما بستگی دارد، مراحل زیر را کامل کنید:

  1. فایل build.gradle را در دایرکتوری ماژول برنامه خود باز کنید.

  2. برای هر SDK که برنامه شما نیاز دارد، وابستگی آن SDK را درج کنید. این صفحه شامل بخشی است که وابستگی های متداول خدمات Google Play را برای برنامه های Android فهرست می کند. همچنین ممکن است بخواهید وابستگی های Firebase را به پروژه خود اضافه کنید .

  3. تغییرات را ذخیره کنید و پروژه خود را همگام کنید .

قطعه زیر یک نمونه فایل build.gradle را نشان می دهد که از کتابخانه مکان استفاده می کند:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.1.0'
}

نسخه‌های جدید SDK خدمات Google Play با رفع اشکال و ویژگی‌های جدید به صورت دوره‌ای منتشر می‌شوند. این به روز رسانی ها در یادداشت های انتشار اعلام شده است. اگر برنامه شما از وابستگی استفاده می‌کند که به‌روزرسانی شده است، برای بهره‌گیری از این اصلاحات، آن را به آخرین نسخه در وابستگی‌های برنامه خود تغییر دهید.

بررسی کنید که آیا خدمات Google Play نصب شده است یا خیر

همانطور که در نمای کلی خدمات Google Play توضیح داده شد، خدمات Google Play به‌روزرسانی‌های خودکار را در Android نسخه 5.0 (سطح API 21) و بالاتر از طریق برنامه فروشگاه 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 را که می‌توانید در برنامه اندروید خود قرار دهید، فهرست می‌کند. می‌توانید با انتخاب یکی از دکمه‌ها، فهرست را بر اساس نوع دستگاه فیلتر کنید، و می‌توانید با وارد کردن متن در کادری که بعد از دکمه‌ها ظاهر می‌شود، یک مورد خاص یا نام وابستگی را جستجو کنید.

جدول 1. وابستگی‌های خدمات Google Play برای گنجاندن در برنامه‌های Android
از نام مورد و وابستگی استفاده کنید دستگاه های پشتیبانی شده
تبلیغات موبایل گوگل
com.google.android.gms:play-services-ads:22.6.0
تلفن، تبلت
شناسه تبلیغات اندروید (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
تلفن، تبلت، Android TV، ChromeOS
نسخه سبک تبلیغات موبایل گوگل
com.google.android.gms:play-services-ads-lite:22.6.0
تلفن، تبلت
AdSense for Search (AFS) تبلیغات جستجوی سفارشی (CSA)
com.google.android.gms:play-services-afs-native:19.0.3
تلفن، تبلت، ChromeOS
Google Analytics Services SDK برای اندروید
com.google.android.gms:play-services-analytics:18.0.4
منسوخ. به جای آن از Google Analytics برای Firebase استفاده کنید.
فهرست برنامه
com.google.android.gms:play-services-appindex:16.1.0
تلفن، تبلت، Android TV
شناسه مجموعه برنامه Android
com.google.android.gms:play-services-appset:16.0.2
تلفن، تبلت، Android TV، ChromeOS
ورود به سیستم گوگل برای اندروید
com.google.android.gms:play-services-auth:21.0.0
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.0.2
تلفن، تبلت، اندروید گو
Block Store API (شامل فضای ذخیره‌سازی اعتبار کاربر)
com.google.android.gms:play-services-auth-blockstore:16.2.0
تلفن، تبلت، Android Go، ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.0.1
تلفن، رایانه لوحی، خودکار، Android Go، ChromeOS
کلاس های کاربردی
com.google.android.gms:play-services-base:18.3.0
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS
آزمایش تقلبی برای کلاس های ابزار
com.google.android.gms:play-services-base-testing:16.0.0
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS
کلاس های کاربردی بیشتر
com.google.android.gms:play-services-basement:18.3.0
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.4.0
تلفن، تبلت، Android Go، ChromeOS
چارچوب برنامه Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.4.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.0.1
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS
تعاملات دستگاه به دستگاه (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
تلفن، تبلت، اندروید گو
احراز هویت سریع آنلاین (FIDO).
com.google.android.gms:play-services-fido:20.1.0
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS

در دستگاه‌هایی که Android 7.0 (سطح API 24) یا بالاتر دارند، پشتیبانی می‌شود.
Google Fit API برای اندروید
com.google.android.gms:play-services-fitness:21.1.0
تلفن، تبلت، Android Go، ChromeOS، Wear OS
Google Play Games Services v2 برای اندروید
com.google.android.gms:play-services-games-v2:19.0.0
تلفن، تبلت، 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.1.0
تلفن، تبلت، Android TV، Android Go، ChromeOS
Matter API
com.google.android.gms:play-services-home:16.0.0
تلفن، تبلت
Google Play Instant
com.google.android.gms:play-services-instantapps:18.0.1
تلفن، تبلت، Android TV، Android Go، ChromeOS

در دستگاه‌هایی که دارای Android نسخه 5.0 (سطح API 21) یا بالاتر هستند، پشتیبانی می‌شود.
Fused Location Provider برای Android (شامل تشخیص فعالیت و geofencing)
com.google.android.gms:play-services-location:21.1.0
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS
Google Maps SDK برای اندروید
com.google.android.gms:play-services-maps:18.2.0
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS
اسکن بارکد کیت ML
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0
تلفن، تبلت، Android Go، ChromeOS
اسکنر اسناد کیت ML
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
تلفن، تبلت، Android Go، ChromeOS
تشخیص چهره کیت ML
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
تلفن، تبلت، Android Go، ChromeOS
برچسب گذاری تصویر کیت ML
com.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
شناسایی زبان کیت ML
com.google.android.gms:play-services-mlkit-language-id:17.0.0
تلفن، تبلت، Android Go، ChromeOS
پاسخ هوشمند ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
تلفن، تبلت، Android Go، ChromeOS
بخش بندی موضوع کیت ML
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
تلفن، تبلت، Android Go، ChromeOS
تشخیص متن کیت ML
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
تلفن، تبلت، Android Go، ChromeOS
تشخیص متن کیت ML برای چینی
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
تلفن، تبلت، Android Go، ChromeOS
تشخیص متن کیت ML برای دوانگاری
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
تلفن، تبلت، Android Go، ChromeOS
تشخیص متن کیت ML برای ژاپنی
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
تلفن، تبلت، Android Go، ChromeOS
تشخیص متن کیت ML برای کره ای
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
تلفن، تبلت، Android Go، ChromeOS
کشف و اتصال دستگاه در نزدیکی
com.google.android.gms:play-services-nearby:19.1.0
تلفن، تبلت، Android TV، Auto، Android Go
نمایش مجوزهای منبع باز
com.google.android.gms:play-services-oss-licenses:17.0.1
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS
در دستگاه‌هایی که دارای Android نسخه 5.0 (سطح API 21) یا بالاتر هستند، پشتیبانی می‌شود.
بررسی کیفیت قفل صفحه
com.google.android.gms:play-services-password-complexity:18.0.1
تلفن، تبلت، 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.4.0
تلفن، تبلت، Android Go، ChromeOS

در دستگاه‌هایی که دارای Android نسخه 5.0 (سطح API 20) یا بالاتر هستند، پشتیبانی می‌شود.
reCAPTCHA Enterprise برای ابزار دقیق برنامه
com.google.android.gms:play-services-recaptcha:17.0.1
تلفن، تبلت، Android TV، Android Go، ChromeOS
SafetyNet API (شامل تأیید دستگاه، مرور ایمن، reCAPTCHA و تأیید برنامه)
com.google.android.gms:play-services-safetynet:18.0.1
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS
گوگل تگ منیجر
com.google.android.gms:play-services-tagmanager:18.0.4
تلفن، تبلت، Android TV، Android Go، ChromeOS
Tasks API در اندروید
com.google.android.gms:play-services-tasks:18.1.0
تلفن، رایانه لوحی، Android TV، Auto، Android Go، ChromeOS، Wear OS
سرویس شتاب برای اندروید
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
تلفن، تبلت، Android Go، ChromeOS
TensorFlow Lite GPU Delegate API برای خدمات Google Play
com.google.android.gms:play-services-tflite-gpu:16.2.0
تلفن، تبلت، Android Go، ChromeOS
TensorFlow Lite Java API برای خدمات Google Play
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
تلفن، تبلت، Android Go، ChromeOS
API پشتیبانی TensorFlow Lite برای خدمات Google Play
com.google.android.gms:play-services-tflite-support:16.1.0
تلفن، تبلت، Android Go، ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.0
تلفن، تبلت
موبایل ویژن
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.3.0-beta01
تلفن، رایانه لوحی، خودکار، Android Go، ChromeOS، Wear OS
API لایه داده پوشیدنی
com.google.android.gms:play-services-wearable:18.1.0
تلفن، تبلت، سیستم عامل Wear

پلاگین های Gradle

خدمات گوگل پلی همچنین شامل چندین پلاگین Gradle است که در جدول زیر نشان داده شده است. توجه داشته باشید که دکمه هایی که قبل از جدول قبلی ظاهر می شوند اطلاعات ظاهر شده در این جدول را تغییر نمی دهند.

جدول 2. فهرست پلاگین های Gradle موجود در خدمات Google Play
از نام 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