Referencia sobre licencias

Clases e interfaces de la LVL

En la tabla 1, se enumeran todos los archivos de origen de la biblioteca de verificación de licencias (LVL) disponibles con el SDK de Android. Todos los archivos son parte del paquete com.android.vending.licensing.

Tabla 1: Resumen de las clases e interfaces de la biblioteca LVL

Respuesta del servidor

En la tabla 2, se enumeran todos los campos de respuesta de licencia que muestra el servidor de licencias.

Tabla 2: Resumen de los campos de respuesta de licencia que muestra el servidor de Google Play

Códigos de respuesta del servidor

En la tabla 3, se enumeran todos los códigos de respuesta de licencia admitidos por el servidor de licencias. En general, una aplicación debería manejar todos estos códigos de respuesta. De forma predeterminada, la clase LicenseValidator de la LVL proporciona todo el control necesario de estos códigos de respuesta.

Tabla 3: Resumen de los códigos de respuesta que devuelve el servidor de Google Play en una respuesta de licencia

Nota: Tal como se indica en Cómo configurar el entorno de prueba, el desarrollador de aplicaciones y cualquier usuario de prueba registrado pueden anular el código de respuesta manualmente con Google Play Console.

Nota: Antes, se podía probar el funcionamiento de una app subiendo una versión de "borrador" no publicada. Esta funcionalidad ya no se admite; en cambio, debes realizar la publicación en los canales de distribución Alfa y Beta. Para obtener más información, consulta Ya no se admiten apps de borrador.

Adicionales de respuesta del servidor

Para ayudar a que tu aplicación administre el acceso durante su período de reembolso y proporcionar otra información, el servidor de licencias incluye varios datos en las respuestas de la licencia. Específicamente, el servicio proporciona valores recomendados para el período de validez de la licencia de la aplicación, el período de gracia de los reintentos, el recuento de reintentos máximo permitido y otras opciones de configuración. Si tu aplicación usa archivos de expansión de APK, la respuesta también incluye los nombres de archivo, tamaños y URL. El servidor agrega la configuración como pares clave-valor en el campo "Adicionales" de la respuesta de licencia.

Cualquier implementación de Policy puede extraer la configuración adicional de la respuesta de licencia y usarla según sea necesario. La implementación predeterminada de Policy de la LVL, ServerManagedPolicy, sirve como una implementación funcional y una ilustración de cómo obtener, almacenar y usar la configuración.

Tabla 4: Resumen de la configuración de administración de licencias que proporciona el servidor de Google Play en una respuesta de licencia

Período de validez de la licencia

El servidor de licencias de Google Play establece un período de validez de licencia para todas las aplicaciones descargadas. El período expresa el intervalo de tiempo durante el cual el estado de la licencia de una aplicación debe considerarse como inmutable y almacenable en caché mediante una licencia de Policy en la aplicación. El servidor de licencias incluye el período de validez en su respuesta a todas las verificaciones de licencia y agrega una marca de tiempo de finalización a la respuesta como un extra con la clave VT. Un elemento Policy puede extraer el valor clave VT y usarlo para permitir el acceso condicional a la aplicación sin volver a verificar la licencia, hasta que venza el período de validez.

La validez de la licencia le indica al elemento Policy de una licencia cuándo debe volver a verificar el estado de la licencia con el servidor de licencias. No tiene como fin indicar si una aplicación está realmente autorizada para su uso. Es decir, cuando vence el período de validez de la licencia de una aplicación, no significa que la aplicación ya no tiene licencia para su uso, sino que solo indica que Policy debe volver a verificar el estado de la licencia con el servidor. De ello se desprende que, siempre que no haya vencido el período de validez de la licencia, es aceptable que el elemento Policy almacene en caché el estado de la licencia inicial de forma local y devuelva el estado de la licencia en caché en lugar de enviar una nueva verificación de licencia al servidor.

El servidor de licencias administra el período de validez como un medio para ayudar a la aplicación a aplicar correctamente las licencias durante el período de reembolso que ofrece Google Play para aplicaciones pagas. Establece el período de validez en función de si se compró la aplicación y, de ser así, hace cuánto tiempo. Específicamente, el servidor establece un período de validez de la siguiente manera:

• En el caso de una aplicación pagada, el servidor establece el período de validez de la licencia inicial para que la respuesta de la licencia siga siendo válida mientras la aplicación sea reembolsable. Una licencia de Policy de la aplicación puede almacenar en caché el resultado de la verificación inicial de la licencia y no necesita volver a verificar la licencia hasta que el período de validez haya vencido.
• Cuando una aplicación ya no es reembolsable, el servidor establece un período de validez más largo (generalmente, de varios días).
• En el caso de una aplicación gratuita, el servidor establece el período de validez en un valor muy alto (long.MAX_VALUE). Esto garantiza que, siempre que Policy haya almacenado localmente la marca de tiempo de validez, no será necesario volver a comprobar el estado de la licencia de la aplicación en el futuro.

La implementación de ServerManagedPolicy utiliza la marca de tiempo extraída (mValidityTimestamp) como condición principal para determinar si se debe volver a verificar el estado de la licencia con el servidor antes de permitir que el usuario acceda a la aplicación.

Período de reintento y recuento máximo de reintentos

En algunos casos, las condiciones del sistema o de la red pueden evitar que la verificación de licencia de una aplicación llegue al servidor de licencias o que la respuesta del servidor llegue a la aplicación cliente de Google Play. Por ejemplo, el usuario puede iniciar una aplicación cuando no hay una red móvil o conexión de datos disponible (como en un avión) o cuando la conexión de red es inestable o débil.

Si los problemas de red impiden o interrumpen una verificación de licencia, el cliente de Google Play notifica a la aplicación mediante un código de respuesta RETRY al método processServerResponse() de Policy. En el caso de que haya problemas en el sistema, como cuando la aplicación no puede vincularse con la implementación de ILicensingService de Google Play, la propia biblioteca de LicenseChecker llama al método processServerResponse() de la política con un código de respuesta RETRY.

En general, el código de respuesta de RETRY es una señal que se envía a la aplicación para indicar que se produjo un error que impidió que se complete una verificación de licencia.

El servidor de Google Play ayuda a una aplicación a administrar las licencias en condiciones de error al establecer un "período de gracia" de reintento y un recuento máximo de reintentos recomendado. El servidor incluye estos valores en todas las respuestas de verificación de licencia y los agrega como extras con las claves GT y GR.

La aplicación de Policy puede extraer los objetos GT y GR adicionales, y usarlos para permitir el acceso condicional a la aplicación, de la siguiente manera:

• Para una verificación de licencia que dé como resultado una respuesta de RETRY, Policy debe almacenar en caché el código de respuesta de RETRY e incrementar un recuento de respuestas de RETRY.
• El elemento Policy debe permitir que el usuario acceda a la aplicación, siempre que el período de gracia de reintentos continúe activo o que no se haya alcanzado el recuento máximo de reintentos.

ServerManagedPolicy utiliza los valores GT y GR que proporciona el servidor como se describió más arriba. En el siguiente ejemplo, se muestra el manejo condicional de las respuestas de reintento en el método allow(). Se mantiene el recuento de respuestas de RETRY en el método processServerResponse() (no se muestra).

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;
}