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

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

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

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

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

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

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

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

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

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

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

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

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

גרוב

// 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.3.0'

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

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.3.0")

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

שילוב של Play Feature Delivery Library

גרוב

// 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 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-App Update Library

גרוב

// 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. השינויים לא יחולו באופן רטרואקטיבי.