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

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

חשוב: ספריית Google Play Core Java ו-Kotlin פוצלה למספר ספריות נפרדות, אחת לכל תכונה. כדאי לעדכן את הספריות החדשות כדי ליהנות מהוספות של מוצרים חדשים. מידע נוסף זמין במדריך להעברת נתונים.

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

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

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

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

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

ההתנהגות של כל תכונה נשארה עקבית במהלך ההעברה, והשינוי היחיד שצריך לשים לב אליו הוא שבגרסאות החדשות נעשה שימוש ב-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

מגניב

// 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

מגניב

// 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. Google תפרסם הודעה לגבי שינויים בתנאים בכתובת https://developer.android.com/guide/playcore/license. השינויים לא יחולו באופן רטרואקטיבי.