במסמך הזה מוסבר איך לעבור מספריית החיובים 5 או 6 של Google Play לספריית החיובים של Google Play בגרסה 7 ואיך לשלב אותה עם יכולות של מנויים.
רשימה מלאה של השינויים בגרסה 7.0.0 זמינה בגרסה הערות.
סקירה כללית
ספריית החיובים ב-Google Play 7 משפרת את הטיפול בתשלומים עבור בתכונות הקיימות של המינוי. השיפורים האופציונליים האלה להוסיף תמיכה בתשלום באמצעות תוכניות תשלומים וגם תמיכה ברכישות ממתינות למינויים בתשלום מראש.
שדרוג של ספריית החיובים ב-Play שמותאמת לאחור
כל ממשקי ה-API החדשים של ספריית החיובים ב-Google Play הם אופציונליים, מפתחים לא צריכים ליישם שינויים ב-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 שהוצא משימוש הוסר.
למידע נוסף, אפשר לעיין בקטע שינויים במחירים
guide.
טיפול בשינויים שקשורים למינויים ב-API
ממשקי ה-API setOldSkuPurchaseToken שהוצאו בעבר משימוש,
setReplaceProrationMode, setReplaceSkusProrationMode הוסרה.
- עדכון
setOldSkuPurchaseTokenל-setOldPurchaseToken. - יש לעדכן את
setReplaceProrationModeל-setSubscriptionReplacementMode. - יש לעדכן את
setReplaceSkusProrationModeל-setSubscriptionReplacementMode.
טיפול בשגיאות בספריית החיובים ב-Play
אם מופיע קוד NETWORK_ERROR חדש, סימן שיש בעיות בחיבור לרשת
בין המכשיר של המשתמש למערכת Google Play.
גם הקודים SERVICE_TIMEOUT ו-SERVICE_UNAVAILABLE עודכנו.
מידע נוסף זמין במאמר הבא: טיפול בקודי התגובה של Billing Results.
טיפול בעסקאות בהמתנה
ספריית החיובים ב-Play לא יוצרת יותר מזהה הזמנה לרכישות בהמתנה.
ברכישות האלה, מזהה ההזמנה יאוכלס לאחר העברת הרכישה
למצב PURCHASED. ודאו שההטמעה צפויה
מזהה הזמנה רק לאחר השלמת העסקה במלואה. עדיין אפשר להשתמש
את אסימון הרכישה ברשומות שלכם.
לקבלת מידע נוסף על טיפול ברכישות ממתינות, עבור אל מדריך ההטמעה של ספריית החיובים ב-Play המדריך לניהול מחזור החיים של הרכישה.
טיפול בממשקי API של מערכת חיוב חלופית שהוסרו
הסרת את BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener,
ו-AlternativeChoiceDetails.
מפתחים צריכים להשתמש ב-BillingClient.Builder.enableUserChoiceBilling() עם UserChoiceBillingListener
ו-UserChoiceDetails
בקריאה החוזרת (callback) של המאזינים.
העדכון הזה הוא שינוי השם של ממשקי ה-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 הוסרה.
- עדכון
setOldSkuPurchaseTokenל-setOldPurchaseToken. - יש לעדכן את
setReplaceProrationModeל-setSubscriptionReplacementMode. - יש לעדכן את
setReplaceSkusProrationModeל-setSubscriptionReplacementMode.
טיפול בממשקי API של מערכת חיוב חלופית שהוסרו
הסרת את BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener
ו-AlternativeChoiceDetails.
מפתחים צריכים להשתמש ב-BillingClient.Builder.enableUserChoiceBilling() עם UserChoiceBillingListener
ו-UserChoiceDetails
בקריאה החוזרת (callback) של המאזינים.
שינויים אופציונליים
בגרסה PBL 7 יש שני ממשקי API אופציונליים חדשים.
תמיכה ברכישות בהמתנה עבור מינויים בתשלום מראש
כדאי לעיין במדריך בנושא טיפול במינויים ובעסקאות בהמתנה.
מינויים לתשלומים וירטואליים
אפשר לעיין במדריך לשילוב מינויי תשלומים עבור מידע על שילוב השינויים האלה באפליקציה שלך.