许可参考

LVL 类和接口

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

表 1. LVL 库类和接口汇总。

服务器响应

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

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

服务器响应代码

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

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

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

注意：以前可以通过上传未发布的“草稿”版本来测试应用。此功能不再受支持；相反，您必须将其发布到 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 库本身会调用 Policy 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;
}