כדי לפתח אפליקציה באמצעות ממשקי API של Google Play Services, עליכם לפעול לפי ההוראות המפורטות בדף הזה כדי להגדיר לפרויקט את ערכות ה-SDK הרלוונטיות, שזמינות במאגר Google maven.
כדי לבדוק את האפליקציה בזמן השימוש ב-Google Play Services, צריך להשתמש באחת מהדרכים הבאות:
- מכשיר Android תואם עם Android 5.0 (API ברמת 21) ומעלה, שבו מותקנת האפליקציה של חנות Google Play.
- אמולטור Android עם AVD שמפעיל את פלטפורמת Google APIs על סמך Android 5.0 (רמת API 21) ואילך.
הצהרה על יחסי תלות בשירותי Google Play
כדי לפתח תכונות שתלויות בממשקי ה-API של Google Play Services באפליקציה:
פותחים את הקובץ
build.gradle
בספריית המודול של האפליקציה.לכל SDK שהאפליקציה שלכם דורשת, יש לציין את התלות של ה-SDK הזה. בדף הזה מופיעה רשימה של תלות נפוצות ב-Google Play Services באפליקציות ל-Android. אפשר גם להוסיף לפרויקט יחסי תלות של Firebase.
שומרים את השינויים ומסנכרנים את הפרויקט.
קטע הקוד הבא מציג קובץ build.gradle
לדוגמה שמשתמש בספריית המיקומים:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.2.0'
}
גרסאות חדשות של ערכות ה-SDK של שירותי Google Play Services עם תיקוני באגים ותכונות חדשות מתפרסמות מדי פעם. העדכונים האלה מתפרסמים בנתוני הגרסה. אם האפליקציה משתמשת בתלות שעודכנו, צריך לשנות לגרסה האחרונה של יחסי התלות של האפליקציה כדי לנצל את התיקונים האלה.
איך לבדוק אם שירותי Google Play מותקנים
כפי שמתואר בסקירה הכללית של Google Play Services, אפליקציית Google Play Services מקבלת עדכונים אוטומטיים ב-Android 5.0 (רמת API 21) ואילך דרך האפליקציה של חנות Google Play. עם זאת, שירותי Google Play לא מותקנים במכשירי Android שלא כוללים את חנות Google Play. אם האפליקציה פועלת במכשירים ללא שירותי Google Play, כדאי לבדוק אם Google Play Services מותקנת במכשיר לפני שמנסים להשתמש ב-Google APIs. לחלופין, אפשר להפעיל באפליקציה תכונות שמחייבות את Google Play Services לפעול.
כדי לבדוק אם שירותי Google Play קיימים במכשיר, משתמשים בשיטה isGooglePlayServicesAvailable()
.
לאחר מכן, כדי להתחיל את החיבור אל Google Play Services או להבין איך לזהות אם הגרסה של Google Play Services שמותקנת תומכת ב-API ספציפי, תוכלו לקרוא את המדריך בנושא גישה ל-Google APIs.
יחסי תלות של Google Play Services
בטבלה הבאה מפורטות יחסי התלות של Google Play Services שאפשר לכלול באפליקציה ל-Android. אפשר לסנן את הרשימה לפי סוג מכשיר על ידי בחירה באחד מהלחצנים, ולחפש תרחיש ספציפי לדוגמה או שם של תלות, על ידי הזנת טקסט בתיבה שמופיעה אחרי הלחצנים.
שם התרחיש לדוגמה והתלות | מכשירים נתמכים |
---|---|
מודעות Google לניידcom.google.android.gms:play-services-ads:22.6.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:22.6.0 |
טלפון, טאבלט |
מודעות לרשת החיפוש בהתאמה אישית ב-AdSense לחיפוש (AFS)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.4 |
הוצא משימוש. במקום זאת, יש להשתמש ב-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:21.0.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS |
API לשליפה של SMScom.google.android.gms:play-services-auth-api-phone:18.0.2 |
טלפון, טאבלט, Android Go |
חסימת Store API (כולל אחסון של פרטי כניסה של משתמשים)com.google.android.gms:play-services-auth-blockstore:16.2.0 |
טלפון, טאבלט, Android Go, ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.0.1 |
טלפון, טאבלט, Auto, 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 Castcom.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 |
מקלטי Android TVcom.google.android.gms:play-services-cast-tv:21.0.1 |
ב-Android TV |
Google Code Scannercom.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 |
טלפון, טאבלט, Android Go |
אימות מהיר של IDentity Online (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 ל-Androidcom.google.android.gms:play-services-fitness:21.1.0 |
טלפון, טאבלט, Android Go, ChromeOS, Wear OS |
Google Play Games Services גרסה 2 ל-Androidcom.google.android.gms:play-services-games-v2:19.0.0 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
SDK מקורי של Google Play Games Services גרסה 2 ל-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) ומעלה. |
שירותי מיקום ל-Androidcom.google.android.gms:play-services-location:21.2.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK של מפות Google ל-Androidcom.google.android.gms:play-services-maps:18.2.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
סריקת ברקוד של ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0 |
טלפון, טאבלט, Android Go, ChromeOS |
סורק מסמכים של ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1 |
טלפון, טאבלט, Android Go, ChromeOS |
זיהוי פנים של ערכת ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
טלפון, טאבלט, Android Go, ChromeOS |
הוספת תוויות לתמונות ב-ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
טלפון, טאבלט, Android Go, ChromeOS |
התאמה אישית של הוספת תוויות לתמונות ב-ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
טלפון, טאבלט, Android Go, ChromeOS |
זיהוי שפה ב-ML Kitcom.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-subject-segmentation:16.0.0-beta1 |
טלפון, טאבלט, Android Go, ChromeOS |
זיהוי טקסט בערכת ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.0 |
טלפון, טאבלט, Android Go, ChromeOS |
זיהוי טקסט ב-ML Kit לסינית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 Kit ליפניתcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 |
טלפון, טאבלט, Android Go, ChromeOS |
זיהוי טקסט ב-ML Kit לקוריאנית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 לכרטיסים)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 APIs (כולל אימות (attestation) מכשירים, גלישה בטוחה, 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.4 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Tasks API ב-Androidcom.google.android.gms:play-services-tasks:18.1.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
שירות Boost ל-Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite GPU Delegate API עבור Google Play Servicescom.google.android.gms:play-services-tflite-gpu:16.2.0 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite Java API ל-Google Play Servicescom.google.android.gms:play-services-tflite-java:16.2.0-beta02 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite Support API ל-Google Play Servicescom.google.android.gms:play-services-tflite-support:16.1.0 |
טלפון, טאבלט, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.0 |
טלפון, טאבלט |
תצוגה לניידcom.google.android.gms:play-services-vision:20.1.3 |
טלפון, טאבלט, Android Go, ChromeOS |
Google Pay לתשלומים ב-Androidcom.google.android.gms:play-services-wallet:19.3.0 |
טלפון, טאבלט, Auto, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:18.1.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, ChromeOS, Wear OS |