@absolutejs/devices-capacitor

中文文档
0.8.1发布于 2026/10/28BSL-1.1TypeScriptES Module构建来源已验证近 30 天下载 3566

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

中文使用文档

@ 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。 。 。 .

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

const remove = installCapacitorDeviceAdapterIfNative();

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

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

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 共发布 15 个版本,首次发布于 2026/08/25;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.8.1latest2026/10/2811 天前
0.8.02026/08/272 个月前
0.7.12026/08/272 个月前
0.7.02026/08/272 个月前
0.6.12026/08/272 个月前
0.6.02026/08/272 个月前

关于 @absolutejs/devices-capacitor 的常见问题

@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 和提交记录判断。