IntegrityErrorCode

public annotation IntegrityErrorCode


Integrity API 的错误代码。

摘要

常量

static final int

Integrity API 不可用。

static final int

未安装发起调用的应用。

static final int

发起调用的应用的 UID(用户 ID)与软件包管理系统中的 UID 不符。

static final int

未能绑定到 Play 商店中的服务。

static final int

客户端设备出现暂时性错误。

static final int

提供的云项目编号无效。

static final int

未知内部 Google 服务器错误。

static final int

未知内部错误。

static final int

未找到可用网络。

static final int

未将 Nonce 编码为 base64、网络安全且不换行的字符串。

static final int

Nonce 长度太长。

static final int

Nonce 长度太短。

static final int
static final int

Play 服务不可用或版本太低。

static final int

Play 服务需要更新。

static final int

在设备上未找到 Play 商店账号。

static final int

在设备上未找到 Play 商店应用或设备上安装的该应用并非官方版本。

static final int

Play 商店需要更新。

static final int

发起调用的应用向该 API 发出的请求太多,已经被限制,或者您的应用已超出每日请求次数限额。

常量

API_NOT_AVAILABLE

public static final int API_NOT_AVAILABLE = -1

Integrity API 不可用。

Integrity API 未启用,或者 Play 商店版本可能较低。

建议采取的措施:

  • 确保已在 Google Play 管理中心内启用 Integrity API。
  • 让用户更新 Play 商店。

APP_NOT_INSTALLED

public static final int APP_NOT_INSTALLED = -5

未安装发起调用的应用。

出了点问题(可能是攻击)。不可操作。

APP_UID_MISMATCH

public static final int APP_UID_MISMATCH = -7

发起调用的应用的 UID(用户 ID)与软件包管理系统中的 UID 不符。

出了点问题(可能是攻击)。不可操作。

CANNOT_BIND_TO_SERVICE

public static final int CANNOT_BIND_TO_SERVICE = -9

绑定到 Play 商店中的服务时失败。这可能是因为在设备上安装的 Play 商店版本太低。

让用户更新 Play 商店。

CLIENT_TRANSIENT_ERROR

public static final int CLIENT_TRANSIENT_ERROR = -17

客户端设备出现暂时性错误。

使用指数退避算法重试。

已在 Integrity Play Core 1.1.0 版中引入(先前版本返回的令牌具有空的设备完整性判定)。如果几次重试后仍然存在错误,您应假定设备未通过完整性检查,并采取相应的措施。

CLOUD_PROJECT_NUMBER_IS_INVALID

public static final int CLOUD_PROJECT_NUMBER_IS_INVALID = -16

提供的 Cloud 项目编号无效。

使用已启用 Play Integrity API 的 Cloud 项目的编号,您可以在 Google Cloud 控制台的“项目信息”中找到该编号。

GOOGLE_SERVER_UNAVAILABLE

public static final int GOOGLE_SERVER_UNAVAILABLE = -12

未知内部 Google 服务器错误。

使用指数退避算法重试。如果一直失败,请考虑提交 bug。

INTERNAL_ERROR

public static final int INTERNAL_ERROR = -100

未知内部错误。

使用指数退避算法重试。如果一直失败,请考虑提交 bug。

NETWORK_ERROR

public static final int NETWORK_ERROR = -3

未找到可用网络。

建议采取的措施:

  • 让用户检查并启用网络连接。
  • 如需提供引导式用户体验来帮助用户建立网络连接,您可以显示 GET_INTEGRITYGET_STRONG_INTEGRITY 对话框。

NONCE_IS_NOT_BASE64

public static final int NONCE_IS_NOT_BASE64 = -13

未将 Nonce 编码为 base64、网络安全且不换行的字符串。

使用正确的 Nonce 格式重试。

NONCE_TOO_LONG

public static final int NONCE_TOO_LONG = -11

Nonce 长度太长。Nonce 的长度必须小于 500 字节(在 base64 编码之前)。

使用更短的 Nonce 重试。

NONCE_TOO_SHORT

public static final int NONCE_TOO_SHORT = -10

Nonce 长度太短。为了提供更高的安全性,Nonce 的长度必须至少为 16 字节(在 base64 编码之前)。

使用更长的 Nonce 重试。

NO_ERROR

public static final int NO_ERROR = 0

PLAY_SERVICES_NOT_FOUND

public static final int PLAY_SERVICES_NOT_FOUND = -6

Play 服务不可用或版本太低。

建议采取的措施:

  • 让用户安装或更新 Play 服务。
  • 如需提供引导式用户体验,帮助用户启用、安装或更新 Play 服务,您可以显示 GET_INTEGRITYGET_STRONG_INTEGRITY 对话框。

PLAY_SERVICES_VERSION_OUTDATED

public static final int PLAY_SERVICES_VERSION_OUTDATED = -15

Play 服务需要更新。

建议采取的措施:

  • 让用户更新 Google Play 服务。
  • 为了提供引导式用户体验,帮助用户更新 Play 服务,您可以显示 GET_INTEGRITYGET_STRONG_INTEGRITY 对话框。

PLAY_STORE_ACCOUNT_NOT_FOUND

public static final int PLAY_STORE_ACCOUNT_NOT_FOUND = -4

在设备上未找到 Play 商店账号。请注意,Play Integrity API 现在支持未经身份验证的请求。此错误代码仅用于缺少支持的旧版 Play 商店。

让用户在 Play 商店中进行身份验证。

PLAY_STORE_NOT_FOUND

public static final int PLAY_STORE_NOT_FOUND = -2

在设备上未找到 Play 商店应用或设备上安装的该应用并非官方版本。

让用户安装最新官方版本的 Play 商店。

PLAY_STORE_VERSION_OUTDATED

public static final int PLAY_STORE_VERSION_OUTDATED = -14

Play 商店需要更新。

让用户更新 Google Play 商店。

TOO_MANY_REQUESTS

public static final int TOO_MANY_REQUESTS = -8

发起调用的应用向该 API 发出的请求太多,已经被限制,或者您的应用已超出每日请求次数限额。

使用指数退避算法重试。如果您已达到每日请求次数上限,请申请提高每日请求次数配额。