# react-native Documentation


### 快速开始

  - **1. 安装与配置**
    - [Expo](https://adapty.io/docs/zh/sdk-installation-react-native-expo.md): Step-by-step guide on installing Adapty React Native SDK in an Expo project for subscription-based apps.
    - [纯 React Native](https://adapty.io/docs/zh/sdk-installation-react-native-pure.md): Step-by-step guide on installing Adapty SDK on React Native for subscription-based apps.
  - [2. 通过流程启用购买功能](https://adapty.io/docs/zh/react-native-quickstart-paywalls.md): 通过 Adapty Flow Builder 启用应用内购买的快速入门指南。
  - [3. 检查订阅状态](https://adapty.io/docs/zh/react-native-check-subscription-status.md): 了解如何在 React Native 应用中使用 Adapty 检查订阅状态。
  - [4. 识别用户](https://adapty.io/docs/zh/react-native-quickstart-identify.md): 在 React Native 中设置 Adapty 进行应用内订阅管理的快速入门指南。
  - **与 AI 集成**
    - [基于技能的集成](https://adapty.io/docs/zh/adapty-sdk-integration-skill-react-native.md): 使用 adapty-sdk-integration 技能，通过 AI 编程工具将 Adapty SDK 端到端集成到您的 React Native 应用中。
    - [分步集成](https://adapty.io/docs/zh/adapty-cursor-react-native.md): 一步步指引你使用 Cursor、Context7、ChatGPT、Claude 或其他 AI 工具将 Adapty 集成到 React Native 应用中。

### 流程与付费墙

  - [获取流程与付费墙](https://adapty.io/docs/zh/react-native-get-pb-paywalls.md): 在 React Native 应用中从 Adapty 获取 flow 和付费墙。
  - [展示流程与付费墙](https://adapty.io/docs/zh/react-native-present-paywalls.md): 在 React Native 应用中使用 Adapty 向用户展示流程与付费墙。
  - [响应操作](https://adapty.io/docs/zh/react-native-handle-paywall-actions.md): 使用 Adapty 在 React Native 中处理流程和付费墙的按钮操作，提升应用变现效果。
  - [处理事件](https://adapty.io/docs/zh/react-native-handling-events-1.md): 使用 Adapty SDK 在 React Native 应用中处理流程和付费墙事件。
  - **使用备用付费墙**
    - [Expo](https://adapty.io/docs/zh/react-native-use-fallback-paywalls-expo.md): 通过 react-native-adapty 配置插件在 Expo React Native 项目中配置备用付费墙。
    - [Pure React Native](https://adapty.io/docs/zh/react-native-use-fallback-paywalls-pure.md): 在纯 React Native（非 Expo）项目中配置备用付费墙。
  - [本地化](https://adapty.io/docs/zh/react-native-localizations-and-locale-codes.md): 了解如何使用 Adapty SDK 在 React Native 应用中对付费墙进行本地化。
  - [实现 Web 付费墙](https://adapty.io/docs/zh/react-native-web-paywall.md): 了解如何使用 Adapty SDK 在 React Native 应用中实现网页付费墙。
  - [处理付费墙编辑工具中的错误](https://adapty.io/docs/zh/react-native-troubleshoot-paywall-builder.md): 在 React Native SDK 中排查付费墙编辑工具问题
  - **手动实现付费墙**
    - [快速入门指南](https://adapty.io/docs/zh/react-native-quickstart-manual.md): 将 Adapty SDK 集成到您的 React Native 自定义付费墙中，以启用应用内购买功能。
    - [获取付费墙与产品](https://adapty.io/docs/zh/fetch-paywalls-and-products-react-native.md): 通过 Adapty React Native SDK 获取付费墙和产品，提升用户变现效果。
    - [展示远程配置付费墙](https://adapty.io/docs/zh/present-remote-config-paywalls-react-native.md): 了解如何在 Adapty React Native SDK 中展示远程配置付费墙，以个性化用户体验。
    - [完成购买](https://adapty.io/docs/zh/react-native-making-purchases.md): 使用 Adapty 处理应用内购买和订阅的指南。
    - [恢复购买](https://adapty.io/docs/zh/react-native-restore-purchase.md): 了解如何在 Adapty 中恢复购买，以确保无缝的用户体验。
    - [实现观察者模式](https://adapty.io/docs/zh/implement-observer-mode-react-native.md): 在 Adapty 中实现观察者模式，以跟踪 React Native SDK 中的用户订阅事件。
    - [在观察者模式中上报交易](https://adapty.io/docs/zh/report-transactions-observer-mode-react-native.md): 在 React Native SDK 中通过 Adapty Observer Mode 上报购买交易，用于用户洞察和收入追踪。
    - [处理错误](https://adapty.io/docs/zh/react-native-troubleshoot-purchases.md): 排查 React Native SDK 中的购买问题

### 用户与访问

  - [识别用户](https://adapty.io/docs/zh/react-native-identifying-users.md): 了解如何使用 Adapty SDK 在 React Native 应用中识别用户。
  - [更新用户数据](https://adapty.io/docs/zh/react-native-setting-user-attributes.md): 了解如何使用 Adapty SDK 在 React Native 应用中更新用户属性和用户画像数据。
  - [检查订阅状态](https://adapty.io/docs/zh/react-native-listen-subscription-changes.md): 在 Adapty 中跟踪和管理用户订阅状态，提升 React Native 应用的用户留存率。
  - [处理应用跟踪透明度 (ATT)](https://adapty.io/docs/zh/react-native-deal-with-att.md): 在 React Native 上开始使用 Adapty，以简化订阅设置和管理。
  - [儿童模式](https://adapty.io/docs/zh/kids-mode-react-native.md): 轻松启用儿童模式，符合 Apple 和 Google 政策。React Native SDK 不会收集 IDFA、GAID 或广告数据。

### 用户引导

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

### 最佳实践

  - [SDK 调用顺序](https://adapty.io/docs/zh/react-native-sdk-call-order.md): 按正确顺序调用 Adapty SDK 方法，避免付费权限丢失、归因缺失及间歇性 #2002 错误。
  - [优化付费墙获取](https://adapty.io/docs/zh/react-native-optimize-paywall-fetching.md): 可靠地获取 Adapty 付费墙：React Native 的时机、缓存与备用模式。
  - [在首次启动时展示面向AA的付费墙](https://adapty.io/docs/zh/react-native-show-aa-targeted-paywall.md): 在 React Native 中，通过 AdaptyProfile.appliedAttributionSources 立即展示付费墙，并在归因应用后为 Apple Ads 用户升级付费墙。
- [测试与发布](https://adapty.io/docs/zh/react-native-test.md): 了解如何使用 Adapty SDK 测试和发布您的 React Native 应用。

### 参考文档

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

### SDK 迁移指南

  - [迁移至 v4.0](https://adapty.io/docs/zh/migration-to-react-native-sdk-v4.md): 通过将付费墙 API 替换为 flow API，迁移至 Adapty React Native SDK v4.0（测试版），兼容 Flow Builder 和 付费墙编辑工具。
  - [迁移至 v3.14](https://adapty.io/docs/zh/migration-react-native-314.md): 迁移至 Adapty React Native SDK v3.14，享受更好的性能与全新的变现功能。
  - [迁移至 v3.8](https://adapty.io/docs/zh/react-native-migration-guide-380.md): 迁移至 Adapty React Native SDK v3.8，获得更好的性能和新的变现功能。
  - [迁移至 v3.4](https://adapty.io/docs/zh/migration-to-react-native-sdk-34.md): 迁移至 Adapty React Native SDK v3.4，获得更好的性能和新的变现功能。
  - [迁移至 v3.3](https://adapty.io/docs/zh/migration-to-react-native330.md): 迁移至 Adapty React Native SDK v3.3，享受更佳性能与新的变现功能。
  - [迁移至 v3.0](https://adapty.io/docs/zh/migration-to-react-native-sdk-v3.md): 迁移至 Adapty React Native SDK v3.0，享受更优性能与全新变现功能。