@capacitor-community/device

中文文档
8.0.0发布于 2026/02/09MITTypeScriptESM + CJS零依赖近 30 天下载 3.4万

此插件提供了已从 v7. 0 中的 @ capcor/ device 插件中移除的 API( getInfo () 不再返回磁盘Free, 磁盘Total, realDiskFree 和 realDiskTotal)

中文使用文档
文档目录12 节
  1. 电容设备插件
  2. 维护者
  3. 关于
  4. 插件版本
  5. 支持的平台
  6. 安装
  7. 苹果隐私声明要求
  8. 实例隐私Info.xcprivace
  9. 示例插件使用
  10. API 密码
  11. 获取信息 ()
  12. 接口


电容设备插件

@capacitor-community/device

电容社区插件以获取设备的内部信息(如磁盘空间等)


目录

维护者

维护者GitHub 图像活动
尼亚a尼亚a对

关于

此插件提供了已删除的 API @capacitor/device v7.0 中的插件( getInfo () 不再返回磁盘Free, 磁盘Total, real DiskFree和 real DiskTotal) 。 详情另见 https://capcorjs.com/docs/updateting/7-0#device (中文(简体) )

此插件包含源自或启发的代码 @ mictor/ 设备 插件 . 请注意,这是一个社区插件,不是由Capacitor团队维护的.

特征 :

  • 支持读取磁盘Free、磁盘Total、realDiskFree和realDiskTotal

页:1: 插件版本8. 0.0 与 Capacitor 8 兼容

插件版本

电容版本插件版本
8.x 电话8.x 电话
7.x 电话7.x 电话

支持的平台

  • iOS系统
  • 机器人

安装

npm install @capacitor-community/device
npx cap sync

苹果隐私声明要求

Apple授权应用程序开发者现在指定了API使用批准的原因,以加强用户隐私. 至2024年5月1日,在向App Store Connect提交应用程序时,需要包含这些理由.

当您在应用程序中使用此特定插件时, 您必须创建 PrivacyInfo.xcprivacy 文件输入 /ios/App 或使用 VS 代码扩展生成,指定使用原因.

关于如何做到这一点的详细步骤,请参见: 电容。 。 。 .

对于此插件,所需的词典密钥是 NSPRIVE 访问的磁盘空间 而建议的原因是 85F4.1 (中文(简体) )。 。 。 .

实例隐私Info.xcprivace

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
      <!-- Add this dict entry to the array if the PrivacyInfo file already exists -->
      <dict>
        <key>NSPrivacyAccessedAPIType</key>
        <string>NSPrivacyAccessedAPICategoryDiskSpace</string>
        <key>NSPrivacyAccessedAPITypeReasons</key>
        <array>
          <string>85F4.1</string>
        </array>
      </dict>
    </array>
  </dict>
</plist>

示例插件使用

import { CommunityDevice } from '@capacitor-community/device';

const logDeviceInfo = async () => {
  const info = await CommunityDevice.getInfo();

  console.log(info);
};

API 密码

获取信息 ()

getInfo() => Promise<CommunityDeviceInfo>

返回关于基本设备/os/平面的信息.

回返情况: Promise<CommunityDeviceInfo>

自: 7.0.0 (单位:千美元)


接口

社区维护信息

Prop类型说明自兹
diskFreenumber在 Os 的普通数据存储路径上,以字节表示,有多少自由磁盘空间。 在Android上,它返回了"系统"分区上持有核心Android OS的自由磁盘空间. 在iOS上,此值不准确.7.0.0 (单位:千美元)
diskTotalnumberOS普通数据存储路径的总大小,以字节表示. 在Android上,它返回"系统"分区上持有核心Android OS的磁盘空间.7.0.0 (单位:千美元)
realDiskFreenumber正常数据存储中有多少自由磁盘空间可用,以字节表示.7.0.0 (单位:千美元)
realDiskTotalnumber一般数据存储路径的总大小,以字节表示.7.0.0 (单位:千美元)

版本与发布记录

@capacitor-community/device 共发布 2 个版本,首次发布于 2025/05/27;过去 12 个月发布了 1 个版本。

版本发布日期距今
8.0.0latest2026/02/098 个月前
7.0.02025/05/271.5 年前

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

@capacitor-community/device 是什么?

此插件提供了已从 v7. 0 中的 @ capcor/ device 插件中移除的 API( getInfo () 不再返回磁盘Free, 磁盘Total, realDiskFree 和 realDiskTotal)

如何安装 @capacitor-community/device?

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

@capacitor-community/device 支持 TypeScript 吗?

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

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

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

@capacitor-community/device 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=16.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

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

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

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

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

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

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