许可参考

LVL 类和接口

表 1 列出了通过 Android SDK 提供的许可证验证库 (LVL) 中的所有源文件。所有文件都是 com.android.vending.licensing 包的一部分。

表 1. LVL 库类和接口摘要。

服务器响应

表 2 列出了许可证服务器返回的所有许可证响应字段。

表 2. Google Play 服务器返回的许可证响应字段摘要。

服务器响应代码

表 3 列出了许可证服务器支持的所有许可证响应代码。通常，应用应处理所有这些响应代码。默认情况下，LVL 中的 LicenseValidator 类为您提供所有必要的这些响应代码处理。

表 3. 许可证响应中 Google Play 服务器返回的响应代码摘要。

注意：如 设置测试环境 中所述，可以通过 Google Play Console 手动覆盖应用程序开发者和任何已注册的测试用户的响应代码。

注意：以前可以通过上传未发布的“草稿”版本来测试应用。此功能不再受支持；您必须将其发布到 Alpha 或 Beta 分发渠道。有关更多信息，请参阅 不再支持草稿应用。

服务器响应额外信息

为了帮助您的应用程序在应用程序退款期间管理对应用程序的访问并提供其他信息，许可证服务器在许可证响应中包含了一些信息。具体来说，该服务为应用程序的许可证有效期、重试宽限期、最大允许重试次数和其他设置提供了推荐值。如果您的应用程序使用 APK 扩展文件，则响应还包括文件名、大小和 URL。服务器将设置作为键值对附加到许可证响应的“额外信息”字段中。

任何 Policy 实现都可以从许可证响应中提取额外信息设置，并根据需要使用它们。LVL 默认 Policy 实现，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() 方法来通知应用程序。在系统问题的情况下，例如当应用程序无法绑定到 Google Play 的 ILicensingService 实现时，LicenseChecker 库本身会使用 RETRY 响应代码调用 Policy processServerResponse() 方法。

通常，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;
}