סימוכין לרישוי

מחלקות וממשקים של LVL

בטבלה 1 מפורטים כל קובצי המקור בתהליך אימות הרישיון ספרייה (LVL) זמינה דרך Android SDK. כל הקבצים הם חלק מ- החבילה com.android.vending.licensing.

טבלה 1. סיכום של ספריית LVL סיווגים וממשקים.

תגובת השרת

בטבלה 2 מפורטים כל שדות התגובה לרישיון שהוחזרו על ידי שרת רישוי.

טבלה 2. סיכום שדות התגובה לרישיונות שהוחזר על ידי שרת Google Play.

קודי תגובה של השרת

בטבלה 3 מפורטים כל קודי התגובה של הרישיונות שנתמכים על ידי שרת רישוי. באופן כללי, אפליקציה צריכה לטפל בכל התגובות האלה קודים. כברירת מחדל, המחלקה LicenseValidator ב-LVL מספקת את כל לטיפול הדרוש בקודי התגובה האלה.

טבלה 3. סיכום של קודי התגובה שהוחזר על ידי שרת Google Play בתגובה לרישיון.

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

הערה: בעבר אפשר היה לבדוק אפליקציה לפי העלאת "טיוטה" שלא פורסמה . הפונקציונליות הזו כבר לא בתוקף נתמך; במקום זאת, צריך לפרסם אותה בהפצת אלפא או בטא. . למידע נוסף, ראו טיוטות של אפליקציות התמיכה בהם הופסקה.

תוספות לתגובת השרת

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

כל הטמעה של Policy יכולה לחלץ את הגדרות התוספות מהרישיון ולהשתמש בהם לפי הצורך. הטמעת ברירת המחדל של Policy LVL, ServerManagedPolicy, משמשת כשכבת-על ואיור שבו מוסבר איך להשיג, לאחסן ולהשתמש הגדרות.

טבלה 4. סיכום של הגדרות ניהול הרישיונות שסופקו על ידי שרת Google Play ברישיון תשובה.

תוקף הרישיון

שרת הרישוי של Google Play מגדיר תקופת תוקף רישיון לכל המשתמשים אפליקציות שהורדתם. התקופה מציינת את מרווח הזמן שבו צריך להתייחס לסטטוס הרישיון של האפליקציה כסטטוס שלא ניתן לשינוי ואפשר לשמור אותו במטמון על ידי רישיון Policy בבקשה. שרת הרישוי כולל את תקופת התוקף בתגובה לכל בדיקות הרישיון, בתוספת חותמת זמן של סיום התוקף של התשובה כתוספת למפתח VT. א' Policy יכול לחלץ את הערך של מפתח VT ולהשתמש בו כדי לאפשר גישה באופן מותנה אל את הבקשה ללא בדיקה חוזרת של הרישיון, עד לתקופת התוקף בתוקף עד.

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

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

• עבור אפליקציה בתשלום, השרת מגדיר את תקופת התוקף הראשונית של הרישיון כך שתגובת הרישיון תישאר בתוקף כל עוד הבקשה עם החזר כספי. רישיון Policy באפליקציה עשוי לשמור במטמון את תוצאה של בדיקת הרישיון הראשונית ואין צורך לבדוק שוב את הרישיון עד לסיום תקופת התוקף.
• כאשר לא ניתן יותר לבצע החזר כספי על אפליקציה, השרת מגדירה תקופת תוקף ארוכה יותר – בדרך כלל מספר ימים.
• עבור אפליקציה חינמית, השרת מגדיר את תקופת התוקף לערך גבוה מאוד ערך (long.MAX_VALUE). כך אפשר להבטיח שבתנאי שה-Policy שמר במטמון את חותמת הזמן של התוקף באופן מקומי, לא יהיה צורך לבדוק שוב את סטטוס הרישיון של האפליקציה בעתיד.

ההטמעה של ServerManagedPolicy משתמשת בחותמת הזמן שחולצה (mValidityTimestamp) בתור תנאי ראשי כדי לקבוע אם כדי לבדוק שוב את סטטוס הרישיון מול השרת לפני שמאפשרים למשתמש גישה ל את האפליקציה.

תקופה של ניסיון חוזר ומספר מקסימלי של ניסיונות חוזרים

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

כאשר בעיות ברשת מונעות או מפריעות לבדיקת הרישיון, Google לקוח Play מודיע לאפליקציה על ידי החזרת קוד תגובה RETRY ל- באמצעות processServerResponse() של Policy. במקרה של המערכת למשל כאשר האפליקציה לא יכולה להיות מחויבת ILicensingService, הספרייה LicenseChecker עצמה קוראת ל שיטת processServerResponse() של המדיניות עם קוד תגובה RETRY.

באופן כללי, קוד התגובה RETRY הוא אות לאפליקציה אירעה שגיאה שמנעה את השלמת בדיקת הרישיון.

שרת Google Play עוזר לאפליקציה לנהל את הרישוי במסגרת תנאי שגיאה על ידי הגדרה של 'תקופת חסד' לניסיון חוזר וערך מקסימלי מומלץ היא מספר הניסיונות החוזרים. השרת כולל את הערכים האלה בכל התגובות לבדיקת רישיונות, להוסיף אותן כתוספות מתחת למפתחות GT ו-GR.

האפליקציה Policy יכולה לחלץ את התוספות GT ו-GR ולהשתמש בהן כדי תאפשר גישה לאפליקציה באופן מותנה, באופן הבא:

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

השדה ServerManagedPolicy משתמש בערכים GT ו-GR שסופקו על ידי השרת, שתוארו למעלה. הדוגמה הבאה מציגה את הטיפול המותנה של הניסיון החוזר תשובות בשיטה allow(). המספר של RETRY תגובות הוא נשמר בשיטה processServerResponse(), לא מוצג.

fun allowAccess(): Boolean {
    val ts = System.currentTimeMillis()
    return when(lastResponse) {
        LICENSED -> {
            // Check if the LICENSED response occurred within the validity timeout.
            ts <= validityTimestamp  // Cached LICENSED response is still valid.
        }
        RETRY -> {
            ts < lastResponseTime + MILLIS_PER_MINUTE &&
                    // Only allow access if we are within the retry period
                    // or we haven't used up our max retries.
                    (ts <= retryUntil || retryCount <= maxRetries)
        }
        else -> false
    }
}

public boolean allowAccess() {
    long ts = System.currentTimeMillis();
    if (lastResponse == LicenseResponse.LICENSED) {
        // Check if the LICENSED response occurred within the validity timeout.
        if (ts <= validityTimestamp) {
            // Cached LICENSED response is still valid.
            return true;
        }
    } else if (lastResponse == LicenseResponse.RETRY &&
                ts < lastResponseTime + MILLIS_PER_MINUTE) {
        // Only allow access if we are within the retry period
        // or we haven't used up our max retries.
        return (ts <= retryUntil || retryCount <= maxRetries);
    }
    return false;
}