# SDK 接入状态报告

本文档根据 `SDK接入指南.md` 与实际代码工程（Flutter、iOS Podfile、Android Gradle）的对比，整理了当前各 SDK 的接入进度与状态。

## 接入清单总结

| SDK 名称 | 类别 | 指南要求 | 当前状态 | 备注 |
| :--- | :--- | :---: | :--- | :--- |
| **Riverpod/Hooks/GoRouter** | 核心架构 | ✅ | **已完全接入** | 基于 v2 版本 (Riverpod 3.x, GoRouter 17.x)。 |
| **MMKV** | 本地存储 | ✅ | **已完全接入** | 在 `main.dart` 中完成全局初始化。 |
| **OpenIM SDK** | 即时通讯 | ✅ | **已完全接入** | `RealImAdapter` 已封装并使用。 |
| **AlicloudPush (阿里云推送)** | 推送 | ✅ | **已激活** | 双端原生依赖已配置，`RealPushAdapter` 可用。 |
| **Fluwx (微信 SDK)** | 支付/分享 | ✅ | **已激活** | 支付功能已在 `RealPaymentAdapter` 实现。 |
| **Tobias (支付宝 SDK)** | 支付 | ✅ | **已激活** | 支付功能已在 `RealPaymentAdapter` 实现。 |
| **freerasp** | 安全防护 | ✅ | **已激活** | 在 `AdapterRegistry` 中作为首个 SDK 初始化。 |
| **record / just_audio** | 媒体录制 | ✅ | **已激活** | 用于语音消息与播放。 |
| **wechat_assets_picker** | 媒体选择 | ✅ | **已激活** | 已用于图片与全选。 |
| **AlicloudFeedback (阿里云反馈)** | 反馈 | ✅ | **仅原生配置** | iOS `Podfile` 已引入，但 Dart 侧尚未封装 Adapter。 |
| **友盟统计 (Umeng)** | 业务统计 | ✅ | ⏸️ **已暂停** | 因合规评估需求，`pubspec` 与 `Podfile` 已手动注释。 |
| **穿山甲/GDT (广告)** | 业务广告 | ✅ | 🚫 **已完整移除/禁用** | `RealAdsAdapter` 为 Stub。双端原生依赖与配置均已移除/注释。 |
| **应用内购 (IAP)** | 支付 | ✅ | ⚠️ **部分接入** | `RealPaymentAdapter` 中显示尚未完全实现。 |

---

## 详细分析与差异

### 1. 核心架构与存储
- **状态**: ✅ **100%**
- **结论**: 完全符合 v2 指南要求，采用了最新的异步 `GoRouter` 逻辑与 `MMKV` 初始化流程。

### 2. 业务 SDK（运行中）
- **OpenIM**: 核心 IM 逻辑已全部通过 `RealImAdapter` 接入，支持 Token 自动续期与断网重连。
- **推送 (Push)**: 通过 `MethodChannel` 封装，原生层配置已就绪，账号绑定/解绑逻辑已实现。
- **支付 (Payment)**: 微信与支付宝的拉起支付逻辑已通过适配器模式解耦，直接可用。

### 3. 业务 SDK（已禁用/暂停）
- **广告 (Ads)**:
  - **Android**: `build.gradle.kts` 中保留了 SDK 依赖。
  - **iOS**: `Podfile` 中已注释掉相关的 Pod。
  - **Flutter**: `RealAdsAdapter` 现在是一个占位类，调用展示广告会直接触发 `onDismiss` 回调，跳过广告显示。
- **统计 (Umeng)**:
  - 代码注释明确提到由于"合规评估"暂停，目前完全处于禁用状态。

### 4. 待办与 Gap
- **阿里云反馈 (AlicloudFeedback)**: `Podfile` 中存在依赖，但 Flutter 侧缺乏调用入口，建议后续增加 `FeedbackAdapter`。
- **Apple 内购 (IAP)**: 依赖包 `in_app_purchase` 已引入，但在 `RealPaymentAdapter` 中仅预留了方法定义，业务逻辑尚未跑通。

## 后续建议

1. **确定广告策略**: 如果当前版本不发广告，建议将 Android 端的冗余 SDK 依赖也一并移除/注释。
2. **跟进合规评估**: 若需启用统计功能，关注友盟 SDK 的隐私政策适配情况。
3. **补齐 IAP 逻辑**: 若产品涉及虚拟币充值，需尽快完善 `payWithApple` 流程。