# flutter Documentation


### 快速入门

  - [1. 安装与配置](https://adapty.io/docs/zh/sdk-installation-flutter.md): 在 Flutter 上安装 Adapty SDK 的分步指南，适用于基于订阅的应用。
  - [2. 通过流程启用购买](https://adapty.io/docs/zh/flutter-quickstart-paywalls.md): 使用 Adapty 付费墙编辑工具启用应用内购买的快速入门指南。
  - [3. 检查订阅状态](https://adapty.io/docs/zh/flutter-check-subscription-status.md): 了解如何在 Flutter 应用中使用 Adapty 检查订阅状态。
  - [4. 识别用户](https://adapty.io/docs/zh/flutter-quickstart-identify.md): 在 Flutter 中设置 Adapty 以管理应用内订阅的快速入门指南。
  - **与 AI 集成**
    - [基于技能的集成](https://adapty.io/docs/zh/adapty-sdk-integration-skill-flutter.md): 使用 adapty-sdk-integration 技能，借助 AI 编程工具将 Adapty SDK 端到端集成到 Flutter 应用中。
    - [分步集成](https://adapty.io/docs/zh/adapty-cursor-flutter.md): 使用 Cursor、Context7、ChatGPT、Claude 或其他 AI 工具，将 Adapty 集成到 Flutter 应用的分步指南。

### 流程与付费墙

  - [获取流程与付费墙](https://adapty.io/docs/zh/flutter-get-pb-paywalls.md): 在 Flutter 应用中从 Adapty 获取流程和付费墙。
  - [展示流程与付费墙](https://adapty.io/docs/zh/flutter-present-paywalls.md): 使用 Adapty 的变现功能在 Flutter 应用中展示流程和付费墙。
  - [响应操作](https://adapty.io/docs/zh/flutter-handle-paywall-actions.md): 使用 Adapty 在 Flutter 中处理付费墙按钮操作，提升应用变现效果。
  - [处理事件](https://adapty.io/docs/zh/flutter-handling-events.md): 了解如何在 Flutter 中使用 Adapty 处理订阅相关事件，从而有效追踪用户交互。
  - [使用备用付费墙](https://adapty.io/docs/zh/flutter-use-fallback-paywalls.md): 处理用户离线或 Adapty 服务器不可用的情况
  - [本地化](https://adapty.io/docs/zh/flutter-localizations-and-locale-codes.md): 管理应用本地化和语言区域代码，触达全球用户。
  - [实现网页付费墙](https://adapty.io/docs/zh/flutter-web-paywall.md): 设置 web 付费墙，无需支付 App Store 费用和审核即可获得收入。
  - [处理付费墙编辑工具的错误](https://adapty.io/docs/zh/flutter-troubleshoot-paywall-builder.md): 在 Flutter SDK 中排查付费墙编辑工具问题
  - [在观察者模式下呈现流程](https://adapty.io/docs/zh/flutter-present-flows-in-observer-mode.md): 在 Flutter 应用中以 Observer 模式展示流程和付费墙编辑工具付费墙，同时使用自己的代码处理购买。
  - **手动实现付费墙**
    - [快速入门指南](https://adapty.io/docs/zh/flutter-quickstart-manual.md): 将 Adapty SDK 集成到您的自定义 Flutter 付费墙中，以启用应用内购买。
    - [获取付费墙与产品](https://adapty.io/docs/zh/fetch-paywalls-and-products-flutter.md): 在 Adapty Flutter SDK 中获取付费墙和产品，提升用户变现效果。
    - [呈现远程配置付费墙](https://adapty.io/docs/zh/present-remote-config-paywalls-flutter.md): 了解如何在 Adapty Flutter SDK 中展示远程配置付费墙，以个性化用户体验。
    - [发起购买](https://adapty.io/docs/zh/flutter-making-purchases.md): 使用 Adapty 处理应用内购买和订阅的指南。
    - [恢复购买](https://adapty.io/docs/zh/flutter-restore-purchase.md): 了解如何在 Adapty 中恢复购买，以确保无缝的用户体验。
    - [实现观察者模式](https://adapty.io/docs/zh/implement-observer-mode-flutter.md): 在 Adapty 中实现观察者模式，以在 Flutter SDK 中跟踪用户订阅事件。
    - [在观察者模式下上报交易](https://adapty.io/docs/zh/report-transactions-observer-mode-flutter.md): 在 Adapty 观察者模式下上报购买交易，用于 Flutter SDK 的用户洞察和收入跟踪。
    - [处理错误](https://adapty.io/docs/zh/flutter-troubleshoot-purchases.md): 排查 Flutter SDK 中的购买问题

### 用户与访问

  - [识别用户](https://adapty.io/docs/zh/flutter-identifying-users.md): 在 Adapty 中识别用户，以改善个性化订阅体验。
  - [更新用户数据](https://adapty.io/docs/zh/flutter-setting-user-attributes.md): 了解如何在 Adapty 中设置用户属性以实现更好的目标受众细分。
  - [检查订阅状态](https://adapty.io/docs/zh/flutter-listen-subscription-changes.md): 在 Adapty 中追踪和管理用户订阅状态，提升 Flutter 应用的用户留存率。
  - [处理应用追踪透明度（ATT）](https://adapty.io/docs/zh/flutter-deal-with-att.md): 开始在 Flutter 上使用 Adapty，简化订阅设置与管理。
  - [儿童模式](https://adapty.io/docs/zh/kids-mode-flutter.md): 轻松启用儿童模式，遵守 Apple 和 Google 政策。Flutter SDK 中不收集 IDFA、GAID 或广告数据。

### 用户引导

  - [获取用户引导](https://adapty.io/docs/zh/flutter-get-onboardings.md): 了解如何在 Adapty 的 Flutter SDK 中获取用户引导。
  - [展示用户引导](https://adapty.io/docs/zh/flutter-present-onboardings.md): 了解如何有效展示用户引导以提升转化率。
  - [处理用户引导事件](https://adapty.io/docs/zh/flutter-handling-onboarding-events.md): 使用 Adapty 在 Flutter 中处理用户引导相关事件。
  - [处理来自用户引导的数据](https://adapty.io/docs/zh/flutter-onboarding-input.md): 使用 Adapty SDK 在 Flutter 应用中保存和使用用户引导数据。

### 最佳实践

  - [SDK 调用顺序](https://adapty.io/docs/zh/flutter-sdk-call-order.md): 按正确顺序调用 Adapty SDK 方法，避免丢失高级访问权限、归因缺失以及间歇性 #2002 错误。
  - [优化付费墙获取](https://adapty.io/docs/zh/flutter-optimize-paywall-fetching.md): 可靠地获取 Adapty 付费墙：Flutter 中的时机选择、缓存策略与备用方案。
  - [在首次启动时显示面向 AA 的付费墙](https://adapty.io/docs/zh/flutter-show-aa-targeted-paywall.md): 在 Flutter 中首次启动时短暂等待 Apple Ads 归因数据后再显示付费墙，超时则回退到默认目标受众。使用 AdaptyProfile.appliedAttributionSources。
- [测试与发布](https://adapty.io/docs/zh/flutter-test.md): 了解如何在 Flutter 应用中使用 Adapty 检查订阅状态。

### 参考文档

  - [SDK models](https://pub.dev/documentation/adapty_flutter/latest/adapty_flutter/#classes)
  - **处理错误**
    - [修复 Code-1000 noProductIDsFound 错误](https://adapty.io/docs/zh/InvalidProductIdentifiers-flutter.md): 解决在 Adapty 中管理订阅时出现的无效产品标识符错误。
    - [修复 Code-1003 cantMakePayment 错误](https://adapty.io/docs/zh/cantMakePayments-flutter.md): 解决在 Adapty 中管理订阅时出现的支付错误。

### SDK 迁移指南

  - [迁移至 v4.0](https://adapty.io/docs/zh/migration-to-flutter-sdk-v4.md): 通过将付费墙 API 替换为 flow API，迁移至 Adapty Flutter SDK v4.0，兼容 Flow Builder 和 Paywall Builder。
  - [迁移至 v3.10](https://adapty.io/docs/zh/flutter-migration-guide-310.md)
  - [迁移至 v3.8](https://adapty.io/docs/zh/flutter-migration-guide-38.md): 迁移至 Adapty Flutter SDK v3.8，获得更好的性能和新的货币化功能。
  - [迁移至 v3.4](https://adapty.io/docs/zh/migration-to-flutter-sdk-34.md): 迁移至 Adapty Flutter SDK v3.4，获得更好的性能和全新的变现功能。
  - [迁移至 v3.3](https://adapty.io/docs/zh/migration-to-flutter330.md): 迁移至 Adapty Flutter SDK v3.3，获得更佳性能与全新变现功能。
  - [迁移至 v3.0](https://adapty.io/docs/zh/migration-to-flutter-sdk-v3.md): 迁移至 Adapty Flutter SDK v3.0，获得更好的性能和新的变现功能。