כדי לפתח אפליקציה באמצעות ממשקי API של Google Play Services, צריך לפעול לפי ההוראות בדף הזה כדי להגדיר את הפרויקט באמצעות ערכות ה-SDK הרלוונטיות, שזמינות במאגר Maven של Google.
כדי לבדוק את האפליקציה בעת השימוש בשירותי Google Play, צריך להשתמש באחת מהאפשרויות הבאות:
- מכשיר Android תואם עם Android מגרסה 4.4 (API ברמה 19) ואילך, שבו מותקנת האפליקציה של חנות Google Play.
- האמולטור של Android עם AVD שמבוסס על פלטפורמת Google APIs שמבוסס על Android 4.4 (רמת API 19) ואילך.
הצהרה על יחסי תלות של Google Play Services
כדי לפתח תכונות שתלויות בממשקי ה-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.0.1'
}
גרסאות חדשות של ערכות פיתוח התוכנה ל-Google Play Services מתפרסמות מדי פעם. העדכונים האלה מפורסמים בנתוני הגרסה. אם האפליקציה שלכם מסתמכת על תלות שעדכנתם, תצטרכו לשנות לגרסה החדשה ביותר של התלות באפליקציה כדי ליהנות מהתיקונים האלה.
בדיקה אם שירותי Google Play מותקנים
כפי שמתואר בסקירה הכללית של שירותי Google Play, Google Play Services מקבלת עדכונים אוטומטיים ב‐Android 4.4 (רמת API 19) ואילך באפליקציה של חנות Google Play. עם זאת, במכשירי Android ללא חנות Google Play, לא מותקנים שירותי Google Play. אם האפליקציה שלכם פועלת במכשירים ללא שירותי Google Play, מומלץ לבדוק אם שירותי Google Play מותקנים במכשיר לפני שאתם מנסים להשתמש בממשקי ה-API של Google. לחלופין, תוכלו להפעיל תכונות באפליקציה שמצריכות את שירותי Google Play.
כדי לבדוק אם מערכת Google Play Services מותקנת במכשיר, תוכלו להשתמש בשיטה isGooglePlayServicesAvailable().
לאחר מכן תוכלו לקרוא את המדריך בנושא גישה ל-Google APIs, כדי להבין איך לבדוק אם הגרסה של Google Play Services תומכת בממשק API ספציפי.
יחסי תלות של Google Play Services
בטבלה הבאה רשומים יחסי התלות בין שירותי Google Play שאתם יכולים לכלול באפליקציית Android. אפשר לסנן את הרשימה לפי סוג המכשיר על ידי בחירה באחד מהלחצנים, על ידי הזנת טקסט ספציפי או שם של תלות, על ידי הזנת טקסט בתיבה שמופיעה אחרי הלחצנים.
| תרחיש לדוגמה ושם תלות | מכשירים נתמכים |
|---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:21.5.0 |
טלפון, טאבלט |
מזהה הפרסום ב-Android (AAID)com.google.android.gms:play-services-ads-identifier:18.0.1 |
טלפון, טאבלט, Android TV, ChromeOS |
גרסה קלה של מודעות Google לניידcom.google.android.gms:play-services-ads-lite:21.5.0 |
טלפון, טאבלט |
מודעות לרשת החיפוש בהתאמה אישית (CSA) של AdSense לחיפוש (AFSA)com.google.android.gms:play-services-afs-native:19.0.3 |
טלפון, טאבלט, ChromeOS |
SDK של Google Analytics Services ל-Androidcom.google.android.gms:play-services-analytics:18.0.2 |
הוצאה משימוש. במקום זאת, יש להשתמש ב-Google Analytics for Firebase. |
אינדקס האפליקציהcom.google.android.gms:play-services-appindex:16.1.0 |
טלפון, טאבלט, Android TV |
מזהה קבוצת אפליקציות ל-Androidcom.google.android.gms:play-services-appset:16.0.2 |
טלפון, טאבלט, Android TV, ChromeOS |
כניסה באמצעות חשבון Google ל-Androidcom.google.android.gms:play-services-auth:20.4.1 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS |
SMS Fetchr APIcom.google.android.gms:play-services-auth-api-phone:18.0.1 |
טלפון, טאבלט, Android Go |
חסימת ה-API של החנות (כולל אחסון פרטי כניסה של משתמשים)com.google.android.gms:play-services-auth-blockstore:16.1.0 |
טלפון, טאבלט, Android Go, ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.0.1 |
טלפון, טאבלט, אוטומטי, Android Go, ChromeOS |
שיעור תשתיותcom.google.android.gms:play-services-base:18.1.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, Chrome OS, Wear OS |
זיוף מוצרים בשיעורי שירותcom.google.android.gms:play-services-base-testing:16.0.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, Chrome OS, Wear OS |
שיעורי עזר נוספיםcom.google.android.gms:play-services-basement:18.1.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, Chrome OS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.2.0 |
טלפון, טאבלט, Android Go, ChromeOS |
מסגרת של אפליקציית Google Cast (CAF)com.google.android.gms:play-services-cast-framework:21.2.0 |
טלפון, טאבלט, Android Go, ChromeOS |
מקלטי 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 |
טלפון, טאבלט, Android Go, ChromeOS |
ערימת רשת של Chromium (Cronet)com.google.android.gms:play-services-cronet:18.0.1 |
טלפון, טאבלט, Android TV, Auto, Android Go, Chrome OS, Wear OS |
אינטראקציות בין מכשירים (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
טלפון, טאבלט, Android Go |
אימות זהות מהיר (FIDO) באינטרנטcom.google.android.gms:play-services-fido:19.0.1 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS נתמך במכשירים עם Android 7.0 (רמת API 24) ומעלה. |
Google Fit API ל-Androidcom.google.android.gms:play-services-fitness:21.1.0 |
טלפון, טאבלט, Android Go, Chrome OS, Wear OS |
גרסה 2 של Google Play Games ל-Androidcom.google.android.gms:play-services-games-v2:17.0.0 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Google Play Games Services v2 Native C SDK ל-Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Google Play Games Services גרסה 1 ל-Androidcom.google.android.gms:play-services-games:23.1.0 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
טלפון, טאבלט |
Google Play ללא התקנהcom.google.android.gms:play-services-instantapps:18.0.1 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS נתמך במכשירים עם Android 5.0 (רמת API 21) ומעלה. |
שילוב של ספק מיקום ל-Android (כולל זיהוי פעילות וגידור גיאוגרפי)com.google.android.gms:play-services-location:21.0.1
| טלפון, טאבלט, Android TV, Auto, Android Go, Chrome OS, Wear OS |
SDK של מפות Google ל-Androidcom.google.android.gms:play-services-maps:18.1.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, Chrome OS, Wear OS |
סריקת ברקודים באמצעות ערכת MLcom.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0 |
טלפון, טאבלט, 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 |
תווית מותאמת אישית לתיוג תמונות בערכת למידת מכונהcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4 |
טלפון, טאבלט, 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 |
זיהוי טקסט ב-ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:18.0.2 |
טלפון, טאבלט, Android Go, ChromeOS |
חיפוש וחיבור של מכשירים בקרבת מקוםcom.google.android.gms:play-services-nearby:18.4.0 |
טלפון, טאבלט, Android TV, Auto, Android Go |
להצגת רישיונות של קוד פתוחcom.google.android.gms:play-services-oss-licenses:17.0.0 |
טלפון, טאבלט, 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 Pay לכרטיסיםcom.google.android.gms:play-services-pay:16.1.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 APIs (כולל אימות מכשירים, גלישה בטוחה, reCAPTCHA ואימות אפליקציות)com.google.android.gms:play-services-safetynet:18.0.1 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS |
Google Tag Managercom.google.android.gms:play-services-tagmanager:18.0.2 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Tasks API ב-Androidcom.google.android.gms:play-services-tasks:18.0.2 |
טלפון, טאבלט, Android TV, Auto, Android Go, Chrome OS, Wear OS |
ממשק API של TensorFlow Lite ל-GPU עבור שירותי Google Playcom.google.android.gms:play-services-tflite-gpu:16.1.0 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite Java API לשירותי Google Playcom.google.android.gms:play-services-tflite-java:16.0.1 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite Support API for Google Play Servicescom.google.android.gms:play-services-tflite-support:16.0.1 |
טלפון, טאבלט, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.0-beta02 |
טלפון, טאבלט |
חזון לניידcom.google.android.gms:play-services-vision:20.1.3 |
טלפון, טאבלט, Android Go, ChromeOS |
Google Pay לתשלומים ב-Androidcom.google.android.gms:play-services-wallet:19.1.0 |
טלפון, טאבלט, אוטומטי, Android Go, ChromeOS, Wear OS |
API של גאדג'ט לביש של נתוניםcom.google.android.gms:play-services-wearable:18.0.0 |
טלפון, טאבלט, Wear OS |
מפצלי Gradle
Google Play Services כוללת גם כמה יישומי פלאגין של Gradle, המוצגים בטבלה הבאה. שימו לב שהלחצנים שמופיעים לפני הטבלה הקודמת לא משנים את המידע שמופיע בטבלה הזו.
| תרחיש לדוגמה ושם פלאגין של 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, Chrome OS, Wear OS |