@adapty/capacitor

中文文档
4.1.3发布于 2026/09/15MITTypeScriptESM + CJS构建来源已验证近 30 天下载 5041

Official Adapty SDK for Capacitor

原始使用文档
文档目录16 节
  1. Table of Contents
  2. Why Adapty?
  3. Talk to Us to Learn More
  4. Getting Started
  5. Integrate IAPs within a few hours without server coding
  6. Design flows in the no-code Flow Builder
  7. Test paywalls & prices on Capacitor without app releases
  8. Real-time analytics for your Capacitor app
  9. Mobile app monetization's largest community
  10. Platform Support
  11. Capacitor compatibility
  12. iOS dependency manager
  13. Examples
  14. Contributing
  15. Like Adapty SDK?
  16. License


Easy In-App Purchases Integration to
Make Your Capacitor App Profitable

npm:  downloads npm: latest version

Website • Follow us on X

Adapty: CRM for mobile apps with subscriptions

Adapty SDK is an open-source framework that makes implementing in-app subscriptions for Capacitor fast and easy. It's 100% open-source and lightweight.

Table of Contents

Why Adapty?

  • No server code implementation. Integrate in-app purchases with server-side receipt validation in minutes — in your own paywall or using the no-code flow builder.
  • No-code flow builder. Create beautiful, natively rendered single- or multi-screen flows in the no-code editor and display them in your app. With flows, you can start getting paid instantly or implement engaging onboardings in your app.
  • On-the-fly paywalls price testing. Test different prices, duration, offers, messages, and designs simultaneously, all without new app releases.
  • Full customer's payment history. Explore the user's payment events from the trial start to subscription cancellation or billing issues.
  • 3rd-party integrations. Send subscription events to 3rd-party analytics, attribution, and ad services with no coding, even if the user uninstalls the app.
  • Advanced analytics. Analyze your app real-time metrics with advanced filters, such as Ad network, Ad campaign, country, A/B test, etc.

Talk to Us to Learn More

Getting Started

npm install @adapty/capacitor
npx cap sync

Follow our quickstart guide to install and configure Adapty SDK. Set up purchases in hours instead of weeks :rocket:

Integrate IAPs within a few hours without server coding

Adapty handles everything, from free trials to refunds, in a simple, developer-friendly SDK.

  • Free trials, upgrades, downgrades, crossgrades, family sharing, renewals, promo offers, intro offers, promo codes, and more – Adapty SDK does everything with a single line of code.
  • Easy subscription management.
  • One-time purchases and lifetime subscriptions supported.
  • Sync subscribers' states across iOS, Android, and Web.

Design flows in the no-code Flow Builder

No-code Flow Builder

With the Adapty Flow Builder, you can visually design complete user experiences — from single-screen paywalls to multi-step onboardings, surveys, and quizzes.

  • Flexible customizable flows: Build any kind of flow: a single-screen paywall, a multi-step sequence, a survey, or anything in between.
  • Native rendering: The Adapty SDK renders flows natively without web views to ensure a seamless user experience.
  • Update without redeploying: Change copy, design, pricing, or logic any time. Updates reach your users without an app release.

Adapty automatically renders your flow and handles all the complex purchase logic, receipt validation, and subscription management behind the scenes.

Test paywalls & prices on Capacitor without app releases

Adapty: In-app subscriptions with paywall A/B testing

  • Optimize in-app subscriptions with the paywall A/B testing. Conversions, trials, revenue, cancellations, and more — everything is calculated for you: each paywall and each A/B test.
  • Change images, colors, layouts, and literally anything using the no-code builder or a custom JSON. Configure different prices, trial periods, promo offers, and more in Adapty without app releases.

Real-time analytics for your Capacitor app

Adapty: How Adapty works

  • Manage the subscription's state without managing transactions.
  • 99.5% accuracy.
  • View and analyze data by attributes, such as status, channels, campaigns, and more.
  • Filter, group, and measure metrics by attribution, platform, custom users' segments, and more in a few clicks.

Mobile app monetization's largest community

Ask questions, participate in discussions about Adapty-related topics, become a part of our community for app developers and marketers. Learn how to monetize your app, ask questions, post jobs, read industry news and analytics. Ad free.

Platform Support

Adapty SDK for Capacitor is fully supported on iOS and Android platforms. Web platform is not supported—the build will succeed, but SDK methods will throw CapacitorException instead of performing actual operations.

Capacitor compatibility

Capacitor version@adapty/capacitor version
8.x3.16.0 and newer
7.x3.15.x and older
6.x and olderNot supported

iOS dependency manager

@adapty/capacitor versioniOS dependency manager
4.x and newerSwift Package Manager (SPM) only
3.xCocoaPods and Swift Package Manager (SPM)

Examples

We provide example applications demonstrating Adapty SDK integration:

  • Basic Examples (React, Angular, Vue) - Minimal applications showing core SDK functionality (activation, paywalls, purchases). Perfect for getting started and understanding the basic integration flow.

  • Adapty Devtools - Advanced development tool for bug reports and SDK testing. This comprehensive example includes detailed logging, debug panels, and testing utilities for developers working on SDK integration or reporting issues.

Contributing

  • Feel free to open an issue, we check all of them or drop us an email at [email protected] and tell us everything you want.
  • Want to suggest a feature? Just contact us or open an issue in the repo.

Like Adapty SDK?

So do we! Feel free to star the repo ⭐️⭐️⭐️ and make our developers happy!

License

Adapty is available under the MIT license. See LICENSE for details.

版本与发布记录

@adapty/capacitor 共发布 24 个版本,首次发布于 2025/10/08;过去 12 个月发布了 19 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.1.3latest2026/09/151 个月前
4.1.22026/09/141 个月前
4.1.12026/09/022 个月前
4.1.02026/08/292 个月前
4.0.2-beta.12026/08/152 个月前
4.0.1-beta.1beta2026/08/043 个月前

关于 @adapty/capacitor 的常见问题

@adapty/capacitor 是什么?

Official Adapty SDK for Capacitor

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