Справочник по лицензированию,Справочник по лицензированию

LVL-классы и интерфейсы

В таблице 1 перечислены все исходные файлы в библиотеке проверки лицензий (LVL), доступной через Android SDK. Все файлы являются частью пакета com.android.vending.licensing .

Таблица 1. Сводная информация о классах и интерфейсах библиотеки LVL.

Ответ сервера

В таблице 2 перечислены все поля ответа о лицензии, возвращенные сервером лицензирования.

Таблица 2. Сводка полей ответа о лицензии, возвращаемых сервером Google Play.

Коды ответов сервера

В Таблице 3 перечислены все коды ответов лицензий, поддерживаемые сервером лицензирования. В общем, приложение должно обрабатывать все эти коды ответа. По умолчанию класс LicenseValidator в LVL обеспечивает всю необходимую обработку этих кодов ответов.

Таблица 3. Сводка кодов ответов, возвращаемых сервером Google Play в ответе на лицензию.

Примечание. Как описано в разделе «Настройка среды тестирования» , код ответа можно переопределить вручную для разработчика приложения и любых зарегистрированных тестовых пользователей через консоль Google Play.

Примечание. Раньше вы могли протестировать приложение, загрузив неопубликованную «черновую» версию. Эта функция больше не поддерживается; вместо этого вы должны опубликовать его в альфа- или бета-канале распространения. Дополнительную информацию см. в разделе Черновики приложений больше не поддерживаются .

Дополнительные сведения об ответах сервера

Чтобы помочь вашему приложению управлять доступом к приложению в течение периода возврата средств и предоставить другую информацию, сервер лицензирования включает в ответы о лицензии несколько фрагментов информации. В частности, служба предоставляет рекомендуемые значения для периода действия лицензии приложения, льготного периода повторных попыток, максимально допустимого количества повторных попыток и других параметров. Если ваше приложение использует файлы расширения 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 в метод Policy processServerResponse() . В случае системных проблем, например, когда приложение не может связаться с реализацией ILicensingService Google Play, сама библиотека LicenseChecker вызывает метод processServerResponse() с кодом ответа RETRY .

В общем случае код ответа RETRY является сигналом приложению о том, что произошла ошибка, не позволившая завершить проверку лицензии.

Сервер Google Play помогает приложению управлять лицензированием в случае ошибки, устанавливая «льготный период» повторных попыток и рекомендуемое максимальное количество повторных попыток. Сервер включает эти значения во все ответы на проверку лицензии, добавляя их в качестве дополнительных под ключами GT и GR .

Policy приложения может извлекать дополнительные элементы GT и GR и использовать их для условного разрешения доступа к приложению следующим образом:

• Для проверки лицензии, которая приводит к ответу RETRY , Policy должна кэшировать код ответа RETRY и увеличивать количество ответов RETRY .
• Policy должна разрешать пользователю доступ к приложению при условии, что либо льготный период повторных попыток все еще активен, либо максимальное количество повторных попыток не достигнуто.

ServerManagedPolicy использует значения GT и GR , предоставленные сервером, как описано выше. В примере ниже показана условная обработка ответов на повтор в методеallow allow() . Количество ответов RETRY поддерживается в методеprocessServerResponse 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;
}