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

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

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

סקירה כללית

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

שדרוג ספריית החיובים ב-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 כמו שמתואר בקטעים הבאים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הוסרו BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener וגם AlternativeChoiceDetails. במקום זאת, צריך להשתמש ב-BillingClient.Builder.enableUserChoiceBilling() עם UserChoiceBillingListener ו-UserChoiceDetails בקריאה החוזרת (callback) של המאזין.

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

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

גרסה 7 של PBL כוללת שני ממשקי 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 בקריאה החוזרת (callback) של המאזין.

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

גרסה 7 של PBL כוללת שני ממשקי API אופציונליים חדשים.

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

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

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

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