סקירה כללית של ספריות הליבה של Google Play

בדף הזה מתוארות ספריות Google Play Core ואופן ההוספה שלהן לפרויקט.

ספריות Google Play Core הן ממשק זמן הריצה של האפליקציה עם חנות Google Play. בין היתר, תוכלו:

ספריות Play Core זמינות ב-Java, ב-native וב-Unity. מידע נוסף על הגרסאות האחרונות זמין בנתוני הגרסה.

מעבר מספריית Java ו-Kotlin של Play Core

ספריית Play Core Java ו-Kotlin חולקה למספר ספריות Android לפי תכונה. כך תוכלו להקטין את הגודל של הספריות של Play Core באפליקציה, ולשפר את תהליך הפיתוח של התכונות השונות.

ההתנהגות של כל תכונה נשארה עקבית במהלך ההעברה, והשינוי היחיד שצריך לשים לב אליו הוא שבגרסאות החדשות נעשה שימוש ב-Task API של Google Play Services.

הרשימה הבאה תעזור לכם לעבור לספריות החדשות וליהנות מתכונות חדשות ותיקוני באגים. אם אתם משתמשים בכמה תכונות של Play, תוכלו לייבא כמה ספריות בקובץ build.gradle בבת אחת.

שלבי העברה נפוצים

  1. מעדכנים את כל הצהרות הייבוא הקיימות של אובייקטי Task מ-import com.google.android.play.core.tasks.*; ל-import com.google.android.gms.tasks.*;. כל שמות הכיתות לא משתנים.
  2. מסירים את כל הייבוא של ספריות הליבה הישנות של Play בקובץ build.gradle.

שילוב ספריית Play Asset Delivery

Groovy

// In your app’s build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:asset-delivery:2.2.2'

    // For Kotlin users also add the Kotlin extensions library for Play Asset Delivery:
    implementation 'com.google.android.play:asset-delivery-ktx:2.2.2'
    ...
}

Kotlin

// In your app’s build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:asset-delivery:2.2.2")

    // For Kotlin users also import the Kotlin extensions library for Play Asset Delivery:
    implementation("com.google.android.play:asset-delivery-ktx:2.2.2")
    ...
}

שילוב של ספריית הפצת הפיצ'רים ב-Play

Groovy

// In your app’s build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:feature-delivery:2.1.0'

    // For Kotlin users, also add the Kotlin extensions library for Play Feature Delivery:
    implementation 'com.google.android.play:feature-delivery-ktx:2.1.0'
    ...
}

Kotlin

// In your app’s build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:feature-delivery:2.1.0")

    // For Kotlin users, also import the Kotlin extensions library for Play Feature Delivery:
    implementation("com.google.android.play:feature-delivery-ktx:2.1.0")
    ...
}

שילוב של ספריית Play In-App Review

Groovy

// In your app’s build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:review:2.0.2'

    // For Kotlin users, also add the Kotlin extensions library for Play In-App Review:
    implementation 'com.google.android.play:review-ktx:2.0.2'
    ...
}

Kotlin

// In your app’s build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:review:2.0.2")

    // For Kotlin users, also import the Kotlin extensions library for Play In-App Review:
    implementation("com.google.android.play:review-ktx:2.0.2")
    ...
}

שילוב של ספריית העדכונים מתוך האפליקציה של Play

Groovy

// In your app’s build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:app-update:2.1.0'

    // For Kotlin users, also add the Kotlin extensions library for Play In-App Update:
    implementation 'com.google.android.play:app-update-ktx:2.1.0'
    ...
}

Kotlin

// In your app’s build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:app-update:2.1.0")

    // For Kotlin users, also import the Kotlin extensions library for Play In-App Update:
    implementation("com.google.android.play:app-update-ktx:2.1.0")
    ...
}

התנאים וההגבלות של ערכת הכלים לפיתוח תוכנה (SDK) של Play Core

תאריך שינוי אחרון: 24 בספטמבר 2020
  1. השימוש ב-Play Core Software Development Kit מבטא את הסכמתך לתנאים האלה, בנוסף לתנאים ולהגבלות של Google APIs ("התנאים וההגבלות של ה-API"). במקרה של סתירה בין התנאים האלה לבין התנאים וההגבלות של ה-API, התנאים האלה הם הקובעים. חשוב לקרוא בעיון את התנאים האלה ואת התנאים וההגבלות של ה-API.
  2. במסגרת התנאים האלה, "ממשקי API" הם ממשקי ה-API של Google, שירותים אחרים למפתחים ותוכנות משויכות, כולל כל קוד שאפשר להפיץ מחדש.
  3. "קוד שאפשר להפיץ מחדש" פירושו קובצי כותרות או קוד אובייקט ש-Google מספקת, שמפעילים את ממשקי ה-API.
  4. בכפוף לתנאים האלה ולתנאים של התנאים וההגבלות של ה-API, מותר לך להעתיק ולהפיץ קוד שזמין להפצה חוזרת אך ורק לצורך הכללה כחלק מלקוח ה-API שלך. Google והמורשים מטעמה הם הבעלים של כל הזכויות, הבעלות והאינטרסים, כולל כל זכויות הקניין הרוחני וזכויות קנייניות אחרות, בקוד שאפשר להפיץ מחדש וביחס אליו. אסור לשנות, לתרגם או ליצור יצירות נגזרות של קוד שזמין להפצה חוזרת.
  5. Google רשאית לבצע שינויים בתנאים האלה בכל זמן, לאחר שליחת הודעה ומתן הזדמנות לסרב לשינויים ולהפסיק את השימוש ב-Play Core Software Development Kit. Google תפרסם הודעה לגבי שינויים בתנאים בכתובת https://developer.android.com/guide/playcore/license. השינויים לא יחולו באופן רטרואקטיבי.