Adapty 包含两个关键 SDK，可无缝集成到您的移动应用中：

• 核心 AdaptySDK：这是 Adapty 在您的应用中正常运行所必需的基础 SDK。
• AdaptyUI SDK：如果您使用 Adapty 付费墙编辑工具，则需要此可选 SDK。付费墙编辑工具是一款用户友好的无代码工具，可轻松创建跨平台付费墙。这些付费墙直接在我们的看板中通过可视化构建器创建，完全在设备上原生运行，只需极少的工作量即可创建出高效的付费墙。

请参考下方兼容性表格，选择正确的 Adapty SDK 和 AdaptyUI SDK 版本组合。

Adapty SDK 版本	AdaptyUI SDK 版本
2.9.3	2.1.0
2.10.0	2.1.1
2.10.1	2.1.2
2.10.3	2.1.3

安装 Adapty SDK

1. 将 Adapty 和 AdaptyUI 模块添加到您的 pubspec.yaml 文件中：

   dependencies:
   adapty_flutter: ^2.10.3
   adapty_ui_flutter: ^2.1.3

2. 运行：

   flutter pub get

3. 在您的应用中按以下方式导入 Adapty 模块：

   import 'package:adapty_flutter/adapty_flutter.dart';
   import 'package:adapty_ui_flutter/adapty_ui_flutter.dart';

配置 Adapty SDK

Flutter 版 Adapty SDK 的配置方式因您所针对的移动操作系统（iOS 或 Android）而略有不同。

为 iOS 配置 Adapty SDK

创建 Adapty-Info.plist 并将其添加到您的项目中。在该文件中添加 AdaptyPublicSdkKey 标志，值为您的 Public SDK key。

<dict>
    <key>AdaptyPublicSdkKey</key>
    <string>PUBLIC_SDK_KEY</string>
    <key>AdaptyObserverMode</key>
    <false/>
</dict>

参数说明：

参数	是否必填	描述
AdaptyPublicSdkKey	必填	您可以在 Adapty 应用设置的 Public SDK key 字段中找到该密钥：App settings -> General 标签页 -> API keys 小节
AdaptyObserverMode	选填	一个布尔值，用于控制观察者模式。如果您自行处理购买和订阅状态，并使用 Adapty 发送订阅事件和分析数据，请开启此选项。在应用中每次购买或恢复时，您需要调用 .restorePurchases() 方法以在 Adapty 中记录该操作。默认值为 false。 🚧 在观察者模式下运行时，Adapty SDK 不会关闭任何交易，请确保您自行处理。
idfaCollectionDisabled	选填	一个布尔参数，允许您为 iOS 应用禁用 IDFA 收集。默认值为 false。 更多详情，请参阅分析集成部分。

为 Android 配置 Adapty SDK

1. 将 AdaptyPublicSdkKey 标志添加到应用的 AndroidManifest.xml（Android）文件中，值为您的 Public SDK key。

   <application ...>
       ...
       <meta-data
              android:name="AdaptyPublicSdkKey"
              android:value="PUBLIC_SDK_KEY" />
     	<meta-data
              android:name="AdaptyObserverMode"
              android:value="false" />
   </application>

   必填参数：

参数	是否必填	描述
PUBLIC_SDK_KEY	必填	Adapty 看板中 App Settings -> General 标签页 的 Public SDK key 字段内容。SDK keys 对每个应用都是唯一的，如果您有多个应用，请确保选择正确的那个。 请确保使用 Public SDK key 初始化 Adapty，因为 Secret key 仅应用于服务端 API。
AdaptyObserverMode	选填	一个布尔值，用于控制观察者模式。如果您自行处理购买和订阅状态，并使用 Adapty 发送订阅事件和分析数据，请开启此选项。 默认值为 false。 🚧 在观察者模式下运行时，Adapty SDK 不会关闭任何交易，请确保您自行处理。
AdaptyIDFACollectionDisabled	选填	一个布尔参数，允许您为应用禁用 IDFA 收集。默认值为 false。 更多详情，请参阅分析集成部分。

2. 在您的应用中添加：

   import 'package:adapty_flutter/adapty_flutter.dart';

3. 使用以下代码激活 Adapty SDK：

   try {
   	Adapty().activate();
   } on AdaptyError catch (adaptyError) {}
   } catch (e) {}

请注意，要在您的移动应用中显示付费墙和产品，以及使分析功能正常运行，您需要展示付费墙，并且如果您使用的是非付费墙编辑工具创建的付费墙，还需要在应用中处理购买流程。

设置日志系统

Adapty 会记录错误和其他关键信息，以便深入了解您应用的运行状况。可用的日志级别如下：

级别	描述
error	仅记录错误。
warn	记录错误以及 SDK 中不会导致严重错误但值得关注的消息。
info	记录错误、警告以及重要信息消息，例如记录各模块生命周期的消息。
verbose	记录调试过程中可能有用的任何附加信息，例如函数调用、API 请求等。

您可以在配置 Adapty 之前在应用中设置 logLevel。

try {
	await Adapty().setLogLevel(AdaptyLogLevel.verbose);
} on AdaptyError catch (adaptyError) {
} catch (e) {}