مرجع الترخيص

فئات وواجهات LVL

يسرد الجدول 1 جميع الملفات المصدر في عملية "التحقّق من الترخيص" المكتبة (LVL) المتاحة من خلال حزمة تطوير البرامج (SDK) لنظام التشغيل Android جميع الملفات جزء من حزمة com.android.vending.licensing.

الجدول 1. ملخص مكتبة LVL والفئات والواجهات.

استجابة الخادم

يسرد الجدول 2 جميع حقول استجابة الترخيص التي تم إرجاعها بواسطة خادم ترخيص.

الجدول 2. ملخّص حقول استجابة الترخيص يعرضها خادم Google Play.

رموز استجابة الخادم

يسرد الجدول 3 جميع رموز استجابة الترخيص المتوافقة مع خادم ترخيص. بشكل عام، يجب أن يتعامل التطبيق مع كل هذه الاستجابات الرموز. وبشكل افتراضي، توفر فئة LicenseValidator في LVL جميع من أجل معالجة رموز الاستجابة هذه.

الجدول 3. ملخّص رموز الاستجابة يعرضها خادم Google Play في استجابة الترخيص.

ملاحظة: كما هو موثّق في أثناء إعداد بيئة الاختبار، يمكن إدخال رمز الاستجابة يدويًا تم الإلغاء لمطوِّر التطبيق وأي مستخدمين اختباريين مسجَّلين من خلال Google Play Console

ملاحظة: كان بإمكانك في السابق اختبار أحد التطبيقات من خلال تحميل "مسودة" غير منشورة . لم تعُد هذه الوظيفة مدعوم؛ لكن يجب نشره في توزيع ألفا أو بيتا . لمزيد من المعلومات، يُرجى الاطّلاع على مسودة التطبيقات. لم تعُد متاحة.

الميزات الإضافية لاستجابة الخادم

لمساعدة تطبيقك في إدارة أذونات الوصول إلى التطبيق من خلال طلب استرداد الأموال ويقدمون معلومات أخرى، ويتضمن خادم الترخيص عدة أجزاء من المعلومات في ردود الترخيص. وعلى وجه التحديد، توفر الخدمة القيم الموصى بها فترة صلاحية ترخيص التطبيق، وفترة السماح لإعادة المحاولة، والحد الأقصى لعدد مرات إعادة المحاولة المسموح به، وغير ذلك الإعدادات. في حال كان تطبيقك يستخدم APK ملفات بيانات موسّعة، تتضمّن الاستجابة أيضًا أسماء الملفات وأحجامها وعناوين URL. يُلحق الخادم الإعدادات كأزواج المفتاح/القيمة في استجابة الترخيص "الإضافية" .

يمكن لأي تنفيذ 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;
}