מעבר לספריית החיובים של Google Play מגרסה 7 מגרסאות 5 או 6

במאמר הזה נסביר איך לעבור מ-Google Play Billing Library 5 או 6 ל-Google Play Billing Library 7 ואיך לשלב את היכולות החדשות והאופציונליות של מינויים.

רשימה מלאה של השינויים בגרסה 7.0.0 מופיעה בנתוני הגרסה.

סקירה כללית

ב-Google Play Billing Library 7 יש שיפורים בטיפול בתשלומים של תכונות קיימות של מינויים. השיפורים האופציונליים האלה מוסיפים תמיכה בתשלומים בתשלומים, וגם תמיכה ברכישות בהמתנה למינויים בתשלום מראש.

שדרוג של ספריית החיוב ב-Play עם תאימות לאחור

כל ממשקי ה-API החדשים של ספריית החיובים ב-Google Play בגרסה 7 הם אופציונליים, ומפתחים לא צריכים להטמיע שינויים בממשקי ה-API כדי לבצע את העדכון.

כדי לבצע את ההעברה, צריך לעדכן את הפניות ה-API ולהסיר ממשקי API מסוימים מהאפליקציה, כפי שמתואר בהערות לגרסה ובחלק הבא במדריך הזה.

שדרוג מ-PBL 5 ל-PBL 7

בקטעים הבאים מוסבר איך לשדרג מ-PBL 5 ל-PBL 7.

עדכון ספריית החיובים ב-Google Play

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

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

לאחר מכן, מעדכנים את הפניות ה-API כפי שמתואר בקטעים הבאים.

שינוי רכישות של מינויים של משתמשים

בספריית החיובים ב-Play בגרסה 5 וגרסאות קודמות, השתמשו ב-ProrationMode כדי להחיל שינויים על רכישות המינויים של משתמשים, כמו שדרוגים או הורדות לרמה נמוכה יותר. ממשק ה-API הזה הוסר והוחלף ב-ReplacementMode.

טיפול בשינויים במחיר המינוי

ממשק ה-API ‏launchPriceConfirmationFlow שהוצא משימוש בעבר הוסר. אפשרויות חלופיות מפורטות במדריך בנושא שינויים במחירים.

טיפול בשינויים בממשקי API שקשורים למינוי

ממשקי ה-API setOldSkuPurchaseToken,‏ setReplaceProrationMode ו-setReplaceSkusProrationMode שהוצאו משימוש בעבר הוסרו.

טיפול בשגיאות בספריית החיוב ב-Play

קוד NETWORK_ERROR חדש מציין בעיות בחיבור לרשת בין המכשיר של המשתמש לבין מערכת Google Play.

גם הקודים SERVICE_TIMEOUT ו-SERVICE_UNAVAILABLE עודכנו.

למידע נוסף, ראו טיפול בקודי התגובה של BillingResult.

טיפול בעסקאות בהמתנה

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

מידע נוסף על טיפול ברכישות בהמתנה זמין במדריך השילוב של Play Billing Library ובמדריך לניהול מחזור החיים של רכישות.

טיפול בממשקי API של מערכת חיוב חלופית שהוסרו

הוסר BillingClient.Builder.enableAlternativeBilling,‏ AlternativeBillingListener ו-AlternativeChoiceDetails. במקום זאת, המפתחים צריכים להשתמש ב-BillingClient.Builder.enableUserChoiceBilling() עם UserChoiceBillingListener וב-UserChoiceDetails ב-call back של ה-listener.

העדכון הזה הוא שינוי השם של ממשקי ה-API שהוצאו משימוש, ללא שינויים בהתנהגות.

שינויים אופציונליים

PBL 7 כולל שני ממשקי API אופציונליים חדשים.

תמיכה ברכישות בהמתנה במינויים בתשלום מראש

עיינו במדריך טיפול בהרשמות ובעסקאות בהמתנה.

מינויים לתשלומים וירטואליים

אפשר לעיין במדריך שילוב מינויים בתשלומים.

שדרוג מ-PBL 6 ל-PBL 7

בקטעים הבאים מוסבר איך לשדרג מ-PBL 6 ל-PBL 7.

עדכון ספריית החיובים ב-Google Play

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

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

לאחר מכן, מעדכנים את הפניות ה-API כפי שמתואר בקטעים הבאים.

טיפול בשינויים בממשקי API שקשורים למינויים

ממשקי ה-API setOldSkuPurchaseToken,‏ setReplaceProrationMode ו-setReplaceSkusProrationMode שהוצאו משימוש בעבר הוסרו.

טיפול בממשקי API של מערכת חיוב חלופית שהוסרו

הוסר BillingClient.Builder.enableAlternativeBilling,‏ AlternativeBillingListener ו-AlternativeChoiceDetails. במקום זאת, המפתחים צריכים להשתמש ב-BillingClient.Builder.enableUserChoiceBilling() עם UserChoiceBillingListener וב-UserChoiceDetails ב-call back של ה-listener.

שינויים אופציונליים

PBL 7 כולל שני ממשקי API אופציונליים חדשים.

תמיכה ברכישות בהמתנה במינויים בתשלום מראש

עיינו במדריך טיפול בהרשמות ובעסקאות בהמתנה.

מינויים לתשלומים וירטואליים

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