借助 AI 将 Adapty 集成到 React Native 应用

本页介绍了将 Adapty 集成到 React Native 应用的两种方式。你可以使用下方的 SDK 集成技能进行自动化的端到端流程，也可以按照后续的手动步骤逐步操作。

使用 SDK 集成技能（测试版）

adapty-sdk-integration skill 可将集成流程全程自动化：看板配置、SDK 安装、付费墙设置以及各阶段验证。如果你的工具不支持 Claude Skills 格式，可以参考下方的手动操作指南作为备用方案。

支持的工具：Claude Code、GitHub Copilot CLI、OpenAI Codex、Gemini CLI。

安装

根据你使用的工具选择对应的安装方式。完整列表请参见 skill README。

Claude Code：在终端运行 claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill，然后运行 claude plugin install adapty-sdk-integration@adapty。
GitHub Copilot CLI：运行 gh skill install adaptyteam/adapty-sdk-integration-skill。
Gemini CLI：运行 gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill。
OpenAI Codex 或其他工具：克隆仓库，将 plugins/adapty-sdk-integration/skills/adapty-sdk-integration/ 目录复制到你的工具的 skills 目录中。

运行

在你的项目中运行 /adapty-sdk-integration。该技能会检测你的平台并提出几个配置问题，然后逐步引导你完成看板设置、SDK 安装、付费墙配置和验证——并在每个阶段自动获取相关的 Adapty 文档。

该技能目前处于测试阶段。如果遇到卡顿或异常行为，请参考下方的手动操作指南，其中涵盖了每个阶段的详细步骤。

开始之前：看板配置

在编写任何 SDK 代码之前，Adapty 需要先完成一些看板配置。你可以通过交互式 LLM 工具完成配置，也可以手动在看板中操作。

技能方式（推荐）

Adapty CLI 技能让你的 LLM 能够直接设置你的应用、产品、访问等级、付费墙和版位，无需为每一步打开看板。你只需在看板中连接你的商店。

npx skills add adaptyteam/adapty-cli --skill adapty-cli

添加技能后，在你的代理中运行 /adapty-cli。它会引导你完成每个步骤，包括何时需要打开看板连接你的商店。

看板配置方式

如果你更倾向于手动配置，以下是写代码前需要准备的内容。LLM 无法自动查找看板中的值，需要你自行提供。

连接应用商店：在 Adapty 看板中，前往 App settings → General，根据应用支持的平台连接 App Store 和/或 Google Play。这是内购功能正常运行的必要步骤。连接应用商店
复制您的 Public SDK key：在 Adapty 看板中，前往 App settings → General，找到 API keys 部分。在代码中，这是您传入 adapty.activate("YOUR_PUBLIC_SDK_KEY") 的字符串。
至少创建一个产品：在 Adapty 看板中，前往 Products 页面。您无需在代码中直接引用产品——Adapty 会通过付费墙来下发产品。添加产品
创建付费墙和版位：在 Adapty 看板中，在 Paywalls 页面创建付费墙，然后在 Placements 页面将其分配到版位。在代码中，版位 ID 是传递给 adapty.getPaywall("YOUR_PLACEMENT_ID") 的字符串。创建付费墙
设置访问等级：在 Adapty 看板的 Products 页面中，为每个产品配置访问等级。在代码中，通过 profile.accessLevels['premium']?.isActive 检查对应字符串。默认的 premium 访问等级适用于大多数应用。如果付费用户根据所购产品获得不同功能的访问权限（例如 basic 方案与 pro 方案），请在开始编写代码之前创建额外的访问等级。

准备好这五项之后，就可以开始写代码了。告诉你的 LLM：“我的 Public SDK key 是 X，我的版位 ID 是 Y”，它就能生成正确的初始化和付费墙获取代码。

准备好后再设置

这些配置不是开始编码的必要条件，但随着集成趋于成熟，你会需要用到它们：

A/B 测试：在 Placements 页面进行配置，无需修改代码。 A/B 测试
更多付费墙和版位：使用不同的版位 ID 添加更多 getPaywall 调用。
分析集成：在 Integrations 页面进行配置，不同集成的设置方式各有不同。请参阅分析集成和归因集成。

将 Adapty 文档喂给你的 LLM

使用 Context7（推荐）

Context7 是一个 MCP 服务器，可让你的 LLM 直接访问最新的 Adapty 文档。它能根据你的问题自动获取相关文档，无需手动粘贴 URL。

Context7 支持 Cursor、Claude Code、Windsurf 以及其他兼容 MCP 的工具。运行以下命令即可完成配置：

npx ctx7 setup

该命令会自动检测你的编辑器并配置 Context7 服务器。如需手动配置，请参阅 Context7 GitHub 仓库。配置完成后，在提示词中引用 Adapty 库：

Use the adaptyteam/adapty-docs library to look up how to install the React Native SDK

尽管 Context7 无需手动粘贴文档链接，实现顺序仍然很重要。请按照下方的实现步骤逐步操作，确保一切正常运行。

使用纯文本文档

你可以将任意 Adapty 文档以纯文本 Markdown 格式获取。在文档 URL 末尾添加 .md，或点击文章标题下方的 Copy for LLM。例如：adapty-cursor-react-native.md。

下方实现步骤说明中的每个阶段都包含一个”发送给 LLM”模块，其中附有可直接粘贴的 .md 链接。

如需一次获取更多文档，请参阅下方的索引文件及平台专属子集。

实施步骤详解

本指南的其余部分将按实施顺序逐步讲解 Adapty 的集成过程。每个阶段均包含应发送给 LLM 的文档、完成后的预期效果以及常见问题。

规划你的集成方案

在开始写代码之前，先让你的 LLM 分析项目结构并制定实现方案。如果你使用的 AI 工具支持规划模式（例如 Cursor 或 Claude Code 的 plan 模式），建议先用该模式让 LLM 同时读取你的项目结构和 Adapty 文档，再开始编写代码。

告诉你的 LLM 你采用哪种购买方式——这会影响它应该参考的文档：

Adapty 付费墙编辑工具：在 Adapty 的无代码编辑工具中创建付费墙，SDK 会自动渲染。
手动创建付费墙：自行用代码构建付费墙 UI，但仍使用 Adapty 获取产品并处理购买流程。
观察者模式：保留现有的购买基础设施，仅使用 Adapty 进行数据分析和集成。

不确定该选哪个？请查看快速入门中的对比表格。

安装和配置 SDK

使用 npm（或 yarn）添加 Adapty SDK 依赖，并通过你的 Public SDK key 激活它。这是一切功能的基础——没有这一步，其他任何功能都无法使用。

我们为 Expo 和纯 React Native 项目分别提供了独立的安装指南——请根据你的项目类型选择对应的指南。

指南：

Read these Adapty docs before writing code:
- https://adapty.io/docs/zh/sdk-installation-react-native-expo.md
- https://adapty.io/docs/zh/sdk-installation-react-native-pure.md

检查点

预期结果： 应用可以在 iOS 和 Android 上正常构建运行，Metro bundler 日志中显示 Adapty 激活日志。
常见问题： 出现”Public API key is missing”错误 → 请确认你已将占位符替换为 App settings 中的真实密钥。

显示付费墙并处理购买

通过版位 ID 获取付费墙、展示付费墙，并处理购买事件。你需要参考哪些指南，取决于你处理购买的方式。

在开发过程中，请随时在沙盒环境中测试每笔购买，不要等到最后再测试。设置方法详见在沙盒中测试购买。

指南：

Read these Adapty docs before writing code:
- https://adapty.io/docs/zh/react-native-quickstart-paywalls.md
- https://adapty.io/docs/zh/react-native-get-pb-paywalls.md
- https://adapty.io/docs/zh/react-native-present-paywalls.md
- https://adapty.io/docs/zh/react-native-handling-events-1.md
- https://adapty.io/docs/zh/react-native-handle-paywall-actions.md

检查点

预期效果： 付费墙显示已配置的产品，点击产品后触发沙盒购买弹窗。
常见问题： 付费墙为空或出现 getPaywall 错误 → 请确认版位 ID 与看板中完全一致，且该版位已分配目标受众。

指南：

Read these Adapty docs before writing code:
- https://adapty.io/docs/zh/react-native-quickstart-manual.md
- https://adapty.io/docs/zh/fetch-paywalls-and-products-react-native.md
- https://adapty.io/docs/zh/present-remote-config-paywalls-react-native.md
- https://adapty.io/docs/zh/react-native-making-purchases.md
- https://adapty.io/docs/zh/react-native-restore-purchase.md

检查点

预期结果： 自定义付费墙显示从 Adapty 获取的产品。点击某个产品会触发沙盒购买对话框。
注意事项： 产品数组为空 → 请确认看板中已为该付费墙分配产品，且该版位已设置目标受众。

检查订阅状态

购买完成后，检查用户画像中是否有有效的访问等级，以控制对高级内容的访问。

指南：检查订阅状态

将以下内容发送给你的 LLM：

Read these Adapty docs before writing code:
- https://adapty.io/docs/zh/react-native-check-subscription-status.md

检查点

预期结果： 在沙盒环境完成购买后，profile.accessLevels['premium']?.isActive 返回 true。
注意事项： 购买后 accessLevels 为空 → 请在看板中确认该产品已分配访问等级。

识别用户

将应用的用户账户与 Adapty 用户画像关联，确保购买记录在多设备间持续同步。

如果你的应用不需要身份验证，请跳过此步骤。

指南： 识别用户

将以下内容发送给你的 LLM：

Read these Adapty docs before writing code:
- https://adapty.io/docs/zh/react-native-quickstart-identify.md

Checkpoint

预期结果： 调用 adapty.identify("your-user-id") 后，看板的 Profiles 部分会显示你的自定义用户 ID。
注意事项： 请在激活之后、获取付费墙之前调用 identify，以避免匿名用户画像的归因问题。

准备发布

沙盒测试通过后，按照发布清单逐项检查，确保一切都已准备好投入生产环境。

指南： 发布清单

将以下内容发送给你的 LLM：

Read these Adapty docs before releasing:
- https://adapty.io/docs/zh/release-checklist.md

检查点

预期结果： 所有清单项均已确认：商店连接、服务器通知、购买流程、访问等级检查及隐私合规要求。
注意事项： 如果服务器通知缺失，请在 App settings → iOS SDK 中配置 App Store 服务器通知，并在 App settings → Android SDK 中配置 Google Play 实时开发者通知。

纯文本文档索引文件

如果你需要为 LLM 提供超出单个页面范围的更广泛上下文，我们提供了列出或汇总所有 Adapty 文档的索引文件：

llms.txt：列出所有页面的 .md 链接。这是一项新兴标准，旨在让网站对 LLM 更易访问。注意，某些 AI 智能体（例如 ChatGPT）需要你先下载 llms.txt，再将其作为文件上传到对话中。
llms-full.txt：将整个 Adapty 文档站合并为一个文件。体积非常大——仅在需要完整内容时使用。
React Native 专用的 react-native-llms.txt 和 react-native-llms-full.txt：平台专属子集，相比完整站点可节省 token 用量。