借助 AI 将 Adapty 集成到你的 iOS 应用

本指南帮助你借助 LLM 将 Adapty 集成到 iOS 应用。你将从准备 Adapty 看板开始，然后通过向 LLM 发送相关文档链接逐步完成每个实现阶段。在文末，你还会找到为 AI 工具配置 Adapty 文档的最佳实践。

将本页完整内容复制为 Markdown 并粘贴到你的 LLM 以开始使用——点击页面顶部的 Copy for LLM，或打开 .md 版本。LLM 将根据指南链接和检查点引导你完成每个阶段。

开始前：看板配置

在编写任何 SDK 代码之前，Adapty 需要进行一些看板配置。你可以使用交互式 LLM 技能来完成，也可以通过 Adapty 控制台手动操作。

技能方式（推荐）

Adapty CLI 技能让你的 LLM 可以直接设置应用、产品、访问等级、付费墙和版位——无需为每个步骤打开 Adapty 控制台。你只需要在 Adapty 控制台中连接你的商店。

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

添加技能后，在你的 agent 中运行 /adapty-cli。它将引导你完成每个步骤——包括何时打开 Adapty 控制台连接你的商店。

看板方式

如果你更喜欢手动配置，以下是在编写代码前需要完成的事项。你的 LLM 无法为你查找看板中的值——你需要自行提供。

连接你的应用商店：在 Adapty 控制台中，前往 App settings → General。这是购买功能正常运作的必要条件。连接 App Store
复制你的 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"] 来检查该字符串。默认的 premium 访问等级适用于大多数应用。如果付费用户根据所购产品可以访问不同的功能（例如 basic 方案与 pro 方案），请在开始编码前创建额外的访问等级。

一旦完成以上五项配置，你就可以开始编写代码了。告诉你的 LLM：“我的 Public SDK key 是 X，我的版位 ID 是 Y”，这样它就能生成正确的初始化和付费墙获取代码。

准备就绪后进行设置

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

A/B 测试：在 Placements 页面配置。无需更改代码。 A/B 测试
更多付费墙和版位：使用不同的版位 ID 添加更多 getPaywall 调用。
分析集成：在 Integrations 页面配置。具体设置因集成而异。参见分析集成和归因集成。

向 LLM 提供 Adapty 文档

使用 Context7（推荐）

Context7 是一个 MCP 服务器，可让你的 LLM 直接访问最新的 Adapty 文档。LLM 会根据你的提问自动获取正确的文档——无需手动粘贴 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 iOS SDK

即使 Context7 免去了手动粘贴文档链接的需要，实现顺序仍然重要。请按照下面的实现步骤逐步进行，以确保一切正常运作。

使用纯文本文档

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

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

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

实现步骤

本指南的其余部分按实现顺序介绍 Adapty 集成。每个阶段包含需要发送给 LLM 的文档、完成后应看到的结果以及常见问题。

规划你的集成

在跳入代码之前，请让你的 LLM 分析你的项目并制定实现计划。如果你的 AI 工具支持规划模式（如 Cursor 或 Claude Code 的 plan 模式），请使用它，这样 LLM 在编写任何代码之前可以同时读取你的项目结构和 Adapty 文档。

告诉你的 LLM 你使用哪种购买方式——这会影响它应遵循的指南：

Adapty 付费墙编辑工具：你在 Adapty 的无代码编辑工具中创建付费墙，SDK 自动渲染它们。
手动创建的付费墙：你在代码中构建自己的付费墙 UI，但仍然使用 Adapty 来获取产品和处理购买。
观察者模式：你保留现有的购买基础设施，仅将 Adapty 用于分析和集成。

不确定选哪个？阅读快速入门中的对比表。

安装和配置 SDK

通过 Xcode 中的 Swift Package Manager 安装 Adapty SDK 包，并使用你的 Public SDK key 激活它。这是基础——没有它其他功能都无法运作。

指南： 安装和配置 Adapty SDK

发送给你的 LLM：

Read these Adapty docs before writing code:
- https://adapty.io/docs/zh/sdk-installation-ios.md

检查点

预期结果： 应用构建并运行。Xcode 控制台显示 Adapty 激活日志。
常见问题： “Public API key is missing” → 检查你是否已将占位符替换为 App settings 中的真实密钥。

展示付费墙并处理购买

通过版位 ID 获取付费墙，展示它，并处理购买事件。所需指南取决于你的购买处理方式。

在进行过程中在沙盒中测试每次购买——不要等到最后。有关设置说明，请参阅在沙盒中测试购买。

指南：

发送给你的 LLM：

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

检查点

预期结果： 付费墙显示你配置的产品。点击产品触发沙盒购买对话框。
常见问题： 付费墙为空或 getPaywall 报错 → 验证版位 ID 与 Adapty 控制台中的完全匹配，且该版位已分配目标受众。

指南：

发送给你的 LLM：

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

检查点

预期结果： 你的自定义付费墙显示从 Adapty 获取的产品。点击产品触发沙盒购买对话框。
常见问题： 产品数组为空 → 验证 Adapty 控制台中付费墙已分配产品，且版位已分配目标受众。

指南：

发送给你的 LLM：

Read these Adapty docs before writing code:
- https://adapty.io/docs/zh/observer-vs-full-mode.md
- https://adapty.io/docs/zh/implement-observer-mode.md
- https://adapty.io/docs/zh/report-transactions-observer-mode.md

检查点

预期结果： 使用现有购买流程完成沙盒购买后，交易出现在 Adapty 控制台的 Event Feed 中。
常见问题： 无事件 → 验证你已向 Adapty 报告交易，且 App Store 服务器通知已配置。

检查订阅状态

购买完成后，检查用户画像中的活跃访问等级以控制高级内容的访问权限。

指南： 检查订阅状态

发送给你的 LLM：

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

检查点

预期结果： 沙盒购买后，profile.accessLevels["premium"]?.isActive 返回 true。
常见问题： 购买后 accessLevels 为空 → 检查 Adapty 控制台中该产品是否已分配访问等级。

识别用户

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

如果你的应用没有身份验证功能，请跳过此步骤。

指南： 识别用户

发送给你的 LLM：

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

检查点

预期结果： 调用 Adapty.identify("your-user-id") 后，Adapty 控制台的 Profiles 部分显示你的自定义用户 ID。
常见问题： 在激活后、获取付费墙前调用 identify，以避免匿名用户画像归因问题。

准备发布

一旦你的集成在沙盒中正常工作，请按照发布检查清单确认一切已为生产环境做好准备。

指南： 发布检查清单

发送给你的 LLM：

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

检查点

预期结果： 所有检查项均已确认：商店连接、服务器通知、购买流程、访问等级检查以及隐私要求。
常见问题： 缺少 App Store 服务器通知 → 在 App settings → iOS SDK 中配置，否则事件不会出现在 Adapty 控制台中。

纯文本文档索引文件

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

llms.txt：列出所有页面及其 .md 链接。这是一个新兴标准，旨在让网站对 LLM 更易访问。请注意，对于某些 AI agent（如 ChatGPT），你需要下载 llms.txt 并将其作为文件上传到聊天中。
llms-full.txt：将整个 Adapty 文档网站合并为单个文件。非常大——仅在需要完整内容时使用。
iOS 专属的 ios-llms.txt 和 ios-llms-full.txt：平台专属子集，与完整网站相比可节省 token。