# @absolutejs/devices-capacitor 中文文档

规范地址：https://npmcn.com/package/%40absolutejs/devices-capacitor/

版本：0\.8\.1
npm 元数据更新时间：2026-10-27T17:05:19.467Z
中文译文更新时间：2026-11-06T09:38:18.147Z
软件包许可：BSL-1\.1

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40absolutejs/devices-capacitor
原文对照：https://npmcn.com/package/%40absolutejs/devices-capacitor/?lang=original
项目主页：https://github.com/absolutejs/devices
源码仓库：https://github.com/absolutejs/devices

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：114 kB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：@capacitor/core \>=8 \<9，@capacitor/share \>=8 \<9，@capacitor/camera \>=8\.1 \<9，@capacitor/haptics \>=8 \<9，@absolutejs/devices ^0\.7\.0，@capacitor/keyboard \>=8 \<9，@capacitor/clipboard \>=8 \<9，@capacitor/filesystem \>=8\.1 \<9，@capacitor/file-viewer \>=2 \<3，@capacitor/geolocation \>=8\.2 \<9，@capacitor/push-notifications \>=8\.1 \<9，@capacitor/local-notifications \>=8\.2 \<8\.3
- 首次发布：2026-08-24T22:04:19.887Z
- 最新版本发布：2026-10-27T17:05:19.075Z
- 近 30 天下载量：3566（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

@absolutejs/devices 的电容运行时间适配器

## 安装

```sh
npm install @absolutejs/devices-capacitor
```

也可以使用：`pnpm add @absolutejs/devices-capacitor`、`yarn add @absolutejs/devices-capacitor`、`bun add @absolutejs/devices-capacitor`

## README

# @ absolutejs/devices- 电容器

中立供应商的电容实施 `@absolutejs/devices` 合同。 绝对JS在生成的移动外壳中安装此适配器; 应用程序代码继续导入自 `@absolutejs/devices`。 。 。 .

发布-candidate适配器涵盖:

-   应用元数据和本地平台身份;
-   应用状态、原生状态和Android恢复操作;
-   推出URL,入站链接,以及经审计的HTTP(S)外部浏览器开通; 4;
-   本地网络状况和变化事件;
-   具有明确能力检查的Android硬件备份事件;以及
-   命名空格的普通首选项,它永远不会清除另一个软件包的密钥;以及
-   由 iOS Keychain 和 Android 支撑的绝对拥有本地证书金库 Keystore AES-256-GCM 加密; 附加
-   选入剪贴板、 共享、 Haptics、 相机、 和范围照相机供应商 切片;以及
-   带有近似/精确许可报告的选入前景定位, 一发读取,观看更新, 和决定性清理.
-   选择文档选择、本地共享/保存导出和本地预览 绑定了缓存中转和确定性清理.
-   获得明确许可的选入本地通知,一次性最佳 安排、取消、待检查和收/盘活动.
-   通过Capacitor 8.1.2推动通知,并附带供应商代号 仅限于产生的经认证的登记桥.
-   选入键盘 8.0.5能见度/高音事件与解职,外加 Capacitor 8核心SystemBars API用于现代边缘对接状态/导航UI.

`Preferences` 从未用于证书。 在土建的适配器上 选择 `AbsoluteSecureStorage` 当电容已注册时自动 捆绑插件 。 浏览器预览仍然无法使用/无法关闭 。 高级主机 仍可以通过 `secureStorage`。 。 。 .

```ts
import { installCapacitorDeviceAdapterIfNative } from "@absolutejs/devices-capacitor";

const remove = installCapacitorDeviceAdapterIfNative();
```

有条件的帮助返回 `null` 在浏览器预览中,保存核心 网络适配器. 绝对JS 拥有此拖网调用; 应用程序代码通常如此 不援引它.

可选能力是有意分开出口的:

```ts
import { createCapacitorClipboardCapability } from "@absolutejs/devices-capacitor/clipboard";
import {
  createCapacitorCameraCapability,
  createCapacitorPhotosCapability,
} from "@absolutejs/devices-capacitor/camera";
import { createCapacitorHapticsCapability } from "@absolutejs/devices-capacitor/haptics";
import { createCapacitorKeyboardCapability } from "@absolutejs/devices-capacitor/keyboard";
import { createCapacitorLocationCapability } from "@absolutejs/devices-capacitor/location";
import { createCapacitorLocalNotificationsCapability } from "@absolutejs/devices-capacitor/local-notifications";
import { createCapacitorPushNotificationsCapability } from "@absolutejs/devices-capacitor/push-notifications";
import { createCapacitorDocumentsCapability } from "@absolutejs/devices-capacitor/documents";
import { createCapacitorShareCapability } from "@absolutejs/devices-capacitor/share";
import { createCapacitorSystemBarsCapability } from "@absolutejs/devices-capacitor/system-bars";
```

这个 `absolutejs.devices` 此软件包中的字段 `package.json` 声明 工厂、经过精确测试的电容器依赖性以及用于 每个切片。 绝对JS CLI 消耗元数据,生成导入和iOS 使用说明和无不必要的相机/存储的Android 权限。 前景位置只增加粗糙/精细的Android权限和 iOS 用户串。 用户继续导入 仅提供中性外观 。 基础 条目不导入这些插件.

系统条使用 Capacitor 8 的核心边缘到前沿 API 而不是遗留 状态栏插件 。 公开 `light`编号 :`dark` 值名前景图标/文本颜色, 避免提供者的面向背景的措辞。 浏览器外观是 尽力通过 `color-scheme`;浏览器铬能见度明显失败.

文档使用WebView的系统支持文件输入进行范围选择,所以 选择的内容仍然为 Blob 支持且没有路径 。 导出和预览阶段 a 仅在 Capacitor 的缓存目录中绑定文件, 调用 official Share 或 文件查看器插件,然后去除已显示的文件 。 绝对 JS 生成和 目标文件系统插件所需的 Apple 隐私显示条目 (单位:千美元)`NSPrivacyAccessedAPICategoryFileTimestamp`,原因 `C617.1`从包 元数据; 用户不编辑 Xcode 或 `PrivacyInfo.xcprivacy`。 。 。 .

相机权限从未暗示过: 便携式应用程序代码调用 `camera.requestPermission()` 用户故意行为 `camera.takePhoto()`。 。 。 . `photos.pick()` 打开选定项目系统拾取器,并 不要求广泛的图片图书馆访问。 捕捉没有保存到 图片库和 EXIF 元数据不在此第一个切片返回 .

位置权限也明确. 适配器不启动监视器 鞋带,从不声称是背景交货,保持大约与准确 获取和绘制残疾服务、政策限制、超时和提供者地图 输入共享设备错误词汇失败 。 每一个成功的表返回 一种能清除本地供货商表的等效清理功能.

本地通知使用完整的官方Capacitor 8.2.1发布. 这个 适配器在每个调度前检查权限, 绝不允许提供者 即时隐去. 绝对JS 仅在应用程序代码时安装插件 进口 `localNotifications`; Android 的显示权限来自 提供者元数据。 这份第一份合同故意使用了不准确的最好方法 列表,因此它不要求精确的提醒权限,也不暗示重要 交货。 通知内容和数据不得含有秘密.

Push Notis使用官方Capacitor 8.1.2插件. 绝对JS android 13 显示权限、验证和复制 Firebase 的项目 `google-services.json` 对于配置的应用程序 ID, 添加 iOS APN 并安装 Capacitor 的 AppDelegate 注册转发。 原始内容 APN/FCM标志仅由适配器的内部注册槽接受; 2; `@absolutejs/devices` 应用程序代码无法读取 。 服务器返回一个 贝壳在Keychain/Keystore中保留的不透明安装身份 旋转和经认证的去除.

JavaScript 合同和本地来源在 CI 中测试; 释放接受 仍然需要真实的 iOS/ Android 模拟器核对表, 因为本地密钥链 而 Keystore 行为无法被浏览器测试跑取者验证 .

## 常见问题

### @absolutejs/devices-capacitor 是什么？

@absolutejs/devices 的电容运行时间适配器

### 如何安装 @absolutejs/devices-capacitor？

在项目目录运行 npm install @absolutejs/devices-capacitor，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8 \<9）、@absolutejs/devices（^0\.7\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @absolutejs/devices-capacitor 支持 TypeScript 吗？

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

### @absolutejs/devices-capacitor 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @absolutejs/devices-capacitor 可以商用吗？

@absolutejs/devices-capacitor 使用 BSL-1\.1 许可。声明的许可为 BSL-1\.1，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @absolutejs/devices-capacitor 的下载量有多少？

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

### @absolutejs/devices-capacitor 还在维护吗？

最新版本 0\.8\.1 发布于 2026/10/28（11 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/08/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。