@capacitor-community/device-check

中文文档
8.0.0发布于 2025/12/26MITTypeScriptESM + CJS零依赖近 30 天下载 8679

设备检查 API 的电容插件

中文使用文档
文档目录7 节
  1. DEVICE 检查
  2. 安装
  3. 使用量
  4. 版本数
  5. API 密码
  6. 生成Token ()
  7. 错误


DEVICE 检查

@capacitor-community/device-check


设备检查 API 用于通过管理设备状态和坚持应用的完整性来减少对您的服务的欺诈性使用 .

此插件称为设备检查 API generateToken 返回您 App 服务器必须用 Apple 服务器校验的符号的方法 .

电话 generateToken 将返回 a token 用于验证。 见 苹果公司的文档。 。 。 .

token 是包含由 [] 返回的符号的编码字符串DCDevice.current.generateToken(https://developer.apple.com/documentation/devicecheck/dcdevice/generatetoken(完成汉德勒:)).

安装

npm install @capacitor-community/device-check
npx cap sync

使用量

import { DeviceCheck } from '@capacitor-community/device-check';
...
try {
      const result = await DeviceCheck.generateToken();
      console.log(`DeviceCheck token`, result.token);
    } catch (err) {
        // Recommendation: Report to backend and exit the application
    }

版本数

  • 如果您正在使用 Capacitor 5 使用版本 5.x
  • 如果使用Capacitor 6,则使用6.x版本

API 密码

生成Token ()

generateToken() => Promise<{ token: string; }>

回返情况: Promise<{ token: string; }>


错误

下列出错可以发生,应当处理.

在网络和Android上的结果 generateToken 将是一个空的符号 ""。 。 。 .

在iOS上,这些错误可以被夹入一个 catch数字 :

  • DeviceCheck is not supported on this device - iOS报告设备不支持设备检查API(例如iOS小于v11)
  • DeviceCheck token encoding failed - iOS 编码失败 .
  • DeviceCheck error: [some-error] - iOS 在本地化错误描述中报告了其他一些错误 [some-error]

版本与发布记录

@capacitor-community/device-check 共发布 5 个版本,首次发布于 2024/01/23;过去 12 个月发布了 1 个版本。

版本发布日期距今
8.0.0latest2025/12/2610 个月前
7.1.02025/06/201.4 年前
7.0.02025/02/171.7 年前
6.0.02024/04/162 年前
0.0.12024/01/232 年前

关于 @capacitor-community/device-check 的常见问题

@capacitor-community/device-check 是什么?

设备检查 API 的电容插件

如何安装 @capacitor-community/device-check?

在项目目录运行 npm install @capacitor-community/device-check,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capacitor-community/device-check 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capacitor-community/device-check 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capacitor-community/device-check 可以商用吗?

@capacitor-community/device-check 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@capacitor-community/device-check 的下载量有多少?

根据 npm 官方下载统计,@capacitor-community/device-check 在 2026/10/09 – 2026/11/07 这 30 天内被下载 8,679 次,日均约 289 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capacitor-community/device-check 还在维护吗?

最新版本 8.0.0 发布于 2025/12/26(10 个月前);至今共发布 5 个版本,其中过去 12 个月发布了 1 个;首次发布于 2024/01/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。