# @adapty/capacitor 中文文档 规范地址：https://npmcn.com/package/%40adapty/capacitor/ 版本：4\.1\.3 npm 元数据更新时间：2026-09-15T15:55:27.985Z 中文译文更新时间：2026-11-06T04:46:03.423Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40adapty/capacitor 原文对照：https://npmcn.com/package/%40adapty/capacitor/?lang=original 项目主页：https://adapty.io/docs/capacitor-sdk-overview 源码仓库：https://github.com/adaptyteam/AdaptySDK-Capacitor ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.6 MB，113 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：2 个 - peer 依赖：@capacitor/core \>=8\.0\.0 - 首次发布：2025-10-08T09:27:14.173Z - 最新版本发布：2026-09-15T15:55:27.630Z - 近 30 天下载量：5041（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：24（近 12 个月 19 个） ## 中文简介 用于控制器的官方适配 SDK ## 安装 ```sh npm install @adapty/capacitor ``` 也可以使用：`pnpm add @adapty/capacitor`、`yarn add @adapty/capacitor`、`bun add @adapty/capacitor` ## README # **[![](https://adapty-portal-media-production.s3.amazonaws.com/github/logo-adapty-new.svg)](https://adapty.io/?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor)** 简易内购集成 使您的 Capacitor App 具有实用性 [![](https://img.shields.io/badge/Adapty-discord-purple)](https://go.adapty.io/subhub-community-capacitor-rep) [![npm: downloads](https://img.shields.io/npm/dt/@adapty/capacitor?style=flat&labelColor=6322ee&color=7E41FF&logo=yarn)](https://www.npmjs.com/package/@adapty/capacitor) [![npm: latest version](https://img.shields.io/npm/v/@adapty/capacitor?style=flat&labelColor=6322ee&color=7E41FF&logo=npm)](https://www.npmjs.com/package/@adapty/capacitor) [**网站**](https://adapty.io/?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor) 二. 支助 [**跟着我们走**](https://x.com/AdaptyTeam) ![Adapty: CRM for mobile apps with subscriptions](https://adapty-portal-media-production.s3.amazonaws.com/github/adapty-schema.png) 适应性SDK是一个开源框架,它使Capacitor的应用订阅快速而易行. 百度开源和轻量级. ## 目录 - [为什么要适应?](https://npmcn.com/package/%40adapty/capacitor/#readme-why-adapty) - [开始](https://npmcn.com/package/%40adapty/capacitor/#readme-getting-started) - [在数小时内将 IAP 整合而无需服务器编码](https://npmcn.com/package/%40adapty/capacitor/#readme-integrate-iaps-within-a-few-hours-without-server-coding) - [无代码流程构建器中的设计流程](https://npmcn.com/package/%40adapty/capacitor/#readme-design-flows-in-the-no-code-flow-builder) - [在不发布应用程序的情况下测试电容电容的支付墙和价格](https://npmcn.com/package/%40adapty/capacitor/#readme-test-paywalls--prices-on-capacitor-without-app-releases) - [用于您的 Capacitor app 的实时分析](https://npmcn.com/package/%40adapty/capacitor/#readme-real-time-analytics-for-your-capacitor-app) - [移动应用货币化最大的社区](https://npmcn.com/package/%40adapty/capacitor/#readme-mobile-app-monetizations-largest-community) - [平台支持](https://npmcn.com/package/%40adapty/capacitor/#readme-platform-support) - [电容兼容性](https://npmcn.com/package/%40adapty/capacitor/#readme-capacitor-compatibility) - [iOS 依赖管理器](https://npmcn.com/package/%40adapty/capacitor/#readme-ios-dependency-manager) - [实例](https://npmcn.com/package/%40adapty/capacitor/#readme-examples) - [捐款](https://npmcn.com/package/%40adapty/capacitor/#readme-contributing) - [像适应性SDK?](https://npmcn.com/package/%40adapty/capacitor/#readme-like-adapty-sdk) - [许可证](https://npmcn.com/package/%40adapty/capacitor/#readme-license) ## 为什么要适应? - [没有服务器代码执行](https://adapty.io/docs/sdk-installation-capacitor?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor). 在几分钟内将应用程序内采购与服务器侧接收验证结合起来——在您自己的付费墙中或使用无码流量构建器. - [无代码流量构建器](https://adapty.io/docs/adapty-flow-builder?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor)。在无码编辑器中创建美丽的、本地制作的单屏幕或多屏幕流,并在您的应用程序中显示。 有了流动,你就可以立即开始领到报酬,或者在你的应用中执行登机操作. - [价格测试](https://adapty.io/docs/ab-tests?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor)测试不同的价格,期限,要约,消息和设计同时进行,所有这一切都没有新的应用发布. - [完全客户支付历史](https://adapty.io/docs/profiles-crm?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor). 探索用户从试运营起至订阅注销或计费问题的支付活动. - [三党合并](https://adapty.io/docs/events?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor). 发送订阅事件给第三方分析,归属,以及没有编码的广告服务,即使用户解禁了应用程序. - [高级分析](https://adapty.io/docs/charts?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor). 以高级过滤器分析您的应用程序实时度量, 如 Ad 网络、 Ad 活动、 国家、 A/ B 测试等. ### [和我们谈谈学习更多](https://adapty.io/schedule-demo?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Unity_schedule-demo) ## 开始 ```sh npm install @adapty/capacitor npx cap sync ``` 跟着我们 [快速启动指南](https://adapty.io/docs/sdk-installation-capacitor/?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor) 用于安装和配置适应性SDK。 在数小时内而不是数周内进行购买: 火箭: ## 在数小时内将 IAP 整合而无需服务器编码 **适应处理一切,从免费试验到退款,在一个简单,开发者友好的SDK中.** - 免费的试验,升级,降级,交叉分级,家庭共享,续约,促销报价,入门报价,促销代码,以及更多 – 适应SDK用一行代码做一切. - 网易订阅管理. - 支持一次性购买和终身订阅. - IOS、Android和Web同步订户状态. ## 无代码流程构建器中的设计流程 ![No-code Flow Builder](https://adapty-portal-media-production.s3.amazonaws.com/github/flow-cover.webp) 与 [适应性流程构建器](https://adapty.io/docs/adapty-flow-builder?utm_source=github&utm_medium=referral&utm_campaign=AdaptySDK-Capacitor),您可以视觉设计完整的用户体验——从单屏付费墙到多步登机,勘测,以及考核. - **弹性自定义流动**:构建出任何一种流:单屏活页,多步相接,勘测等,或介于两者之间. - **原生渲染**:Adapty SDK在本地进行流量而无需网页浏览,以确保用户体验无缝. - **不重新部署更新**:随时更改副本,设计,定价,或逻辑. 更新未发布应用程序即可到达您的用户 . 适应性会自动使您的流程并处理所有复杂的购买逻辑,接收验证,以及幕后订阅管理. ## 在不发布应用程序的情况下测试电容电容的支付墙和价格 ![Adapty: In-app subscriptions with paywall A/B testing](https://adapty-portal-media-production.s3.amazonaws.com/github/ab-test-new.png) - 通过付费墙A/B测试优化应用订阅. 转换,试验,收入,取消等等——一切都是为你计算的:每个付费墙和每个A/B测试. - 改变图像,颜色,布局, 和字面上的一切 使用无代码构建器或自定义的 JSON。 配置不同的价格,试用期,促销报价,更多在Adity中不发布应用软件. ## 用于您的 Capacitor app 的实时分析 ![Adapty: How Adapty works](https://adapty-portal-media-production.s3.amazonaws.com/github/analyticss.gif) - 管理订阅状态而不管理交易 . - 准确度99.5%. - 按属性查看和分析数据,如地位,渠道,运动等等. - Filter, Group,并按归属,平台,自定义用户的片段测量度量度,再多点击几下. ## 移动应用货币化最大的社区 提出问题,参与关于"适应"相关话题的讨论,成为我们社区应用开发者和营销者的一部分. 学习如何将你的应用程序货币化,问问题,张贴工作,阅读行业新闻和分析. 免费广告. [![](https://adapty-portal-media-production.s3.amazonaws.com/github/join-discord.svg)](https://discord.gg/subscriptions-hub) ## 平台支持 Capacitor 的适应性 SDK 已完全支持 **iOS系统** 财务报告和审定财务报表 **机器人** 平台。 不支持 Web 平台- 构建将会成功, 但 SDK 方法会抛出 `CapacitorException` 而不是进行实际操作. ### 电容兼容性 | 电容版本 | `@adapty/capacitor` 版本 | | --- | --- | | 8.x 电话 | 3.1.6.0和较新的 | | 7.x 电话 | 3.15.x及以上 | | 6.x及以上 | 不予支持 | ### iOS 依赖管理器 | `@adapty/capacitor` 版本 | iOS 依赖管理器 | | --- | --- | | 4.x和较新的 | 只有Swift 软件包管理器( SPM) | | 3.x 运算 | CocoaPods 和 Swift 软件包管理器(SPM) | ## 实例 我们提供演示适应性SDK集成的示例应用程序: - **基本实例** (单位:千美元)**反应**, (中文(简体) ), **角质**, (中文(简体) ), **阴道**) - 显示SDK核心功能的最小应用程序(激活,付费墙,购买). 完全可以开始了解基本整合流程. - **适应性开发工具** - 用于错误报告和SDK测试的高级开发工具。 这个全面的例子包括详细记录,调试面板,以及为从事SDK集成或报告问题的开发者测试公用设施. ## 捐款 - 随便你打开一个问题,我们检查一下他们或者把邮件寄到 [支持@ adapty.io](mailto:support@adapty.io) 告诉我们你想要的一切. - 想建议一个特色吗? 联系我们,或打开一个问题 在repo. ## 像适应性SDK? 我们也是! 让我们的开发者快乐! ## 许可证 适应性在麻省理工学院的许可下提供. 见 [自由主义](https://github.com/adaptyteam/AdaptySDK-Capacitor/blob/master/LICENSE) 详细情况. ## 常见问题 ### @adapty/capacitor 是什么？ 用于控制器的官方适配 SDK ### 如何安装 @adapty/capacitor？ 在项目目录运行 npm install @adapty/capacitor，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 adapty-kids-mode，可以用 npx adapty-kids-mode 直接运行。 ### @adapty/capacitor 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @adapty/capacitor 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @adapty/capacitor 可以商用吗？ @adapty/capacitor 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @adapty/capacitor 的下载量有多少？ 根据 npm 官方下载统计，@adapty/capacitor 在 2026/10/05 – 2026/11/03 这 30 天内被下载 5,041 次，日均约 168 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @adapty/capacitor 还在维护吗？ 最新版本 4\.1\.3 发布于 2026/09/15（1 个月前）；至今共发布 24 个版本，其中过去 12 个月发布了 19 个；首次发布于 2025/10/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。