برای توسعه یک برنامه با استفاده از APIهای سرویس‌های گوگل پلی ، دستورالعمل‌های موجود در این صفحه را دنبال کنید تا پروژه خود را با SDKهای مربوطه که از مخزن Google maven در دسترس هستند، راه‌اندازی کنید.
برای تست برنامه خود هنگام استفاده از سرویس‌های گوگل پلی، باید از یکی از موارد زیر استفاده کنید:
- یک دستگاه اندروید سازگار که اندروید ۶.۰ (سطح API ۲۳) یا بالاتر را اجرا می‌کند و برنامه فروشگاه گوگل پلی روی آن نصب شده است.
- شبیه‌ساز اندروید با AVD که پلتفرم APIهای گوگل را بر اساس اندروید ۶.۰ (سطح API ۲۳) یا بالاتر اجرا می‌کند.
اعلان وابستگی‌ها برای سرویس‌های گوگل پلی
برای توسعه ویژگی‌هایی که به APIهای سرویس‌های گوگل پلی در برنامه شما وابسته هستند، مراحل زیر را انجام دهید:
فایل
build.gradleرا در داخل دایرکتوری ماژول برنامه خود باز کنید.برای هر SDK که برنامه شما نیاز دارد، وابستگی آن SDK را اضافه کنید. این صفحه شامل بخشی است که وابستگی‌های رایج سرویس‌های Google Play را برای برنامه‌های اندروید فهرست می‌کند. همچنین ممکن است بخواهید Firebase را به پروژه خود اضافه کنید .
تغییرات را ذخیره کنید و پروژه خود را همگام‌سازی کنید .
قطعه کد زیر نمونه‌ای از یک فایل build.gradle را نشان می‌دهد که از کتابخانه location استفاده می‌کند:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.3.0'
}
نسخه‌های جدید SDKهای سرویس‌های گوگل پلی با رفع اشکالات و ویژگی‌های جدید، به صورت دوره‌ای منتشر می‌شوند. این به‌روزرسانی‌ها در یادداشت‌های انتشار اعلام می‌شوند. اگر برنامه شما از وابستگی‌ای استفاده می‌کند که به‌روزرسانی شده است، برای بهره‌مندی از این اصلاحات، وابستگی‌های برنامه خود را به آخرین نسخه تغییر دهید.
بررسی کنید که آیا سرویس‌های گوگل پلی نصب شده‌اند یا خیر.
همانطور که در بخش «مروری بر سرویس‌های گوگل پلی» توضیح داده شد، سرویس‌های گوگل پلی به طور خودکار در اندروید ۶.۰ (سطح API ۲۳) و بالاتر از طریق برنامه فروشگاه گوگل پلی به‌روزرسانی می‌شوند. با این حال، دستگاه‌هایی که فروشگاه گوگل پلی ندارند، سرویس‌های گوگل پلی را نصب ندارند. اگر برنامه شما روی دستگاه‌هایی بدون سرویس‌های گوگل پلی اجرا می‌شود، قبل از تلاش برای استفاده از APIهای گوگل یا فعال کردن ویژگی‌هایی که به آن نیاز دارند، همیشه باید بررسی کنید که آیا سرویس‌های گوگل پلی نصب شده‌اند یا خیر.
برای بررسی وجود سرویس‌های گوگل پلی روی دستگاه، از متد isGooglePlayServicesAvailable() استفاده کنید.
برای شروع اتصال به سرویس‌های گوگل پلی یا یادگیری نحوه تشخیص اینکه آیا نسخه نصب شده سرویس‌های گوگل پلی از یک API خاص پشتیبانی می‌کند یا خیر، راهنمای دسترسی به APIهای گوگل را مطالعه کنید.
وابستگی‌های سرویس‌های گوگل پلی
جدول زیر وابستگی‌های سرویس‌های گوگل پلی را که می‌توانید در برنامه اندروید خود بگنجانید، فهرست می‌کند. می‌توانید با انتخاب یکی از دکمه‌ها، لیست را بر اساس نوع دستگاه فیلتر کنید و با وارد کردن متن در کادری که بعد از دکمه‌ها ظاهر می‌شود، می‌توانید یک مورد استفاده خاص یا نام وابستگی را جستجو کنید.
| مورد استفاده و نام وابستگی | دستگاه‌های پشتیبانی‌شده |
|---|---|
تبلیغات موبایلی گوگلcom.google.android.gms:play-services-ads:24.7.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 | منسوخ شده. به جای آن از گوگل آنالیتیکس برای فایربیس استفاده کنید. |
فهرست برنامه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.4.0 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس |
رابط برنامه‌نویسی نرم‌افزار بازیابی پیامکcom.google.android.gms:play-services-auth-api-phone:18.3.0 | گوشی، تبلت، اندروید گو |
API فروشگاه بلوک (شامل ذخیره‌سازی اعتبارنامه کاربر)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 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس |
آزمایش تقلبی‌ها برای کلاس‌های کاربردیcom.google.android.gms:play-services-base-testing:16.2.0 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس |
کلاس‌های کاربردی بیشترcom.google.android.gms:play-services-basement:18.9.0 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس |
تقویت کننده دوربین در نور کم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 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس |
تعاملات دستگاه به دستگاه (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 | گوشی، تبلت، اندروید گو |
احراز هویت سریع آنلاین (FIDO)com.google.android.gms:play-services-fido:21.2.0 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس در دستگاه‌هایی که اندروید ۷.۰ (سطح API ۲۴) یا بالاتر را اجرا می‌کنند، پشتیبانی می‌شود. |
API گوگل فیت برای اندروید و API ضبط در موبایل (برای داده‌های تناسب اندام کاربر)com.google.android.gms:play-services-fitness:21.3.0 | گوشی، تبلت، اندروید گو، کروم او اس، ویر او اس |
خدمات بازی‌های گوگل پلی نسخه ۲ برای اندرویدcom.google.android.gms:play-services-games-v2:21.0.0 | تلفن، تبلت، اندروید تی‌وی، اندروید گو، کروم‌او‌اس |
خدمات بازی‌های گوگل پلی نسخه ۲، کیت توسعه نرم‌افزار بومی C برای اندرویدcom.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 | منسوخ شده. برای اطلاعات بیشتر به Google Play Instant مراجعه کنید. |
سرویس‌های موقعیت مکانی برای اندرویدcom.google.android.gms:play-services-location:21.3.0 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس |
کیت توسعه نرم‌افزاری نقشه‌های گوگل برای اندرویدcom.google.android.gms:play-services-maps:19.2.0 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس |
کیت توسعه نرم‌افزاری سه‌بعدی نقشه‌های گوگل برای اندروید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 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس در دستگاه‌هایی که اندروید ۵.۰ (سطح API ۲۱) یا بالاتر را اجرا می‌کنند، پشتیبانی می‌شود. |
کتابخانه‌های دسترسی برنامه‌ریزی‌شده (PAL)com.google.android.gms:play-services-pal:22.1.0 | گوشی، تبلت، تلویزیون اندروید در دستگاه‌هایی که اندروید ۵.۰ (سطح API ۲۱) یا بالاتر را اجرا می‌کنند، پشتیبانی می‌شود. |
بررسی کیفیت قفل صفحهcom.google.android.gms:play-services-password-complexity:18.1.0 | گوشی، تبلت، اندروید گو، کروم او اس، ویر او اس پشتیبانی شده در دستگاه‌هایی که اندروید ۴.۴ (سطح API ۱۹) تا اندروید ۹ (سطح API ۲۸) را اجرا می‌کنند. |
گوگل والت (قبلاً گوگل پی برای کارت‌های اعتباری)com.google.android.gms:play-services-pay:16.5.0 | گوشی، تبلت، اندروید گو، کروم او اس در دستگاه‌هایی که اندروید ۵.۰ (سطح API 20) یا بالاتر را اجرا می‌کنند، پشتیبانی می‌شود. |
reCAPTCHA Enterprise برای ابزار دقیق برنامهcom.google.android.gms:play-services-recaptcha:17.1.0 | تلفن، تبلت، اندروید تی‌وی، اندروید گو، کروم‌او‌اس |
APIهای SafetyNet (شامل مرور ایمن و تأیید برنامه‌ها)com.google.android.gms:play-services-safetynet:18.1.0 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس |
مدیریت برچسب گوگلcom.google.android.gms:play-services-tagmanager:18.3.0 | تلفن، تبلت، اندروید تی‌وی، اندروید گو، کروم‌او‌اس |
API وظایف در اندرویدcom.google.android.gms:play-services-tasks:18.4.0 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس |
سرویس شتاب‌دهنده برای اندرویدcom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 | گوشی، تبلت، اندروید گو، کروم او اس |
API نماینده پردازنده گرافیکی TensorFlow Lite برای سرویس‌های گوگل پلیcom.google.android.gms:play-services-tflite-gpu:16.4.0 | گوشی، تبلت، اندروید گو، کروم او اس |
API جاوا TensorFlow Lite برای سرویس‌های گوگل پلیcom.google.android.gms:play-services-tflite-java:16.4.0 | گوشی، تبلت، اندروید گو، کروم او اس |
پشتیبانی از API تنسورفلو لایت برای سرویس‌های گوگل پلیcom.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 | تلفن، تبلت، اتو، اندروید گو، کروم او اس، ویر او اس |
رابط برنامه‌نویسی کاربردی لایه داده پوشیدنیcom.google.android.gms:play-services-wearable:19.0.0 | گوشی، تبلت، سیستم عامل Wear OS |
افزونه‌های گرادل
سرویس‌های گوگل پلی همچنین شامل چندین افزونه Gradle هستند، همانطور که در جدول زیر نشان داده شده است. توجه داشته باشید که دکمه‌هایی که قبل از جدول قبلی ظاهر می‌شوند، اطلاعاتی را که در این جدول ظاهر می‌شوند تغییر نمی‌دهند.
| مورد استفاده و نام افزونه Gradle | دستگاه‌های پشتیبانی‌شده |
|---|---|
نمایش مجوزهای متن‌بازcom.google.android.gms:oss-licenses-plugin:0.10.9 | گوشی، تبلت، سیستم عامل کروم |
بررسی دقیق نسخهcom.google.android.gms:strict-version-matcher-plugin:1.2.4 | تلفن، تبلت، اندروید تی‌وی، اتو، اندروید گو، کروم‌او‌اس، ویر او‌اس |