feat(mobile-next): 导入官方 openim-flutter-demo 固定基线 3.8.3-patch.3 并完成双构建

- 上游: github.com/OpenIMSDK/openim-flutter-demo tag 3.8.3-patch.3 commit b3dfdb1e8aaeaaf6f0793e10cadd20d5c184a31f - 并行目录 mobile-next/ 原样导入（含 LICENSE），不覆盖现网 mobile/ - 锁定 Flutter 3.24.5 / Dart 3.5.4 / JDK 17 / Gradle 7.6.3 / AGP 7.3.1 - 实测 Android debug 与 release 构建均成功（见 docs/mobile-next-baseline-import.md） - 本提交可单独回退：git revert 1db1229（重写前） Co-authored-by: multica-agent <github@multica.ai>
2026-08-19 15:24:33 +08:00
parent fa8584a73f
commit 8046ec7483
767 changed files with 57658 additions and 0 deletions
@@ -0,0 +1,88 @@
+
+# 常见功能配置指南
+
+- [离线推送功能](#离线推送功能)
+- [地图功能](#地图功能)
+
+## 离线推送功能
+
+目前使用的是集成方案。
+
+### 客户端配置
+
+#### 1. 中国大陆地区使用个推（[Getui](https://getui.com/)）
+
+###### 在[Getui](https://getui.com/)的集成指南，配置iOS和Android。
+
+**iOS 平台配置：**
+根据[其文档](https://docs.getui.com/getui/mobile/ios/overview/)做好相应的iOS配置。然后在代码中找到以下文件并修改对应的 iOS侧Key：
+
+- **[push_controller.dart](openim_common/lib/src/controller/push_controller.dart)**
+
+```dart
+  const appID = 'your-app-id';
+  const appKey = 'your-app-key';
+  const appSecret = 'your-app-secret';
+```
+
+**Android 平台配置：**
+根据[其文档](https://docs.getui.com/getui/mobile/android/overview/)做好相应的Android配置，注意[多厂商](https://docs.getui.com/getui/mobile/vendor/vendor_open/)配置。然后修改以下文件内容：
+
+- **[build.gradle](android/app/build.gradle)**
+
+```gradle
+  manifestPlaceholders = [
+      GETUI_APPID    : "",
+      XIAOMI_APP_ID  : "",
+      XIAOMI_APP_KEY : "",
+      MEIZU_APP_ID   : "",
+      MEIZU_APP_KEY  : "",
+      HUAWEI_APP_ID  : "",
+      OPPO_APP_KEY   : "",
+      OPPO_APP_SECRET: "",
+      VIVO_APP_ID    : "",
+      VIVO_APP_KEY   : "",
+      HONOR_APP_ID   : "",
+  ]
+```
+
+#### 2. 海外地区使用 [FCM（Firebase Cloud Messaging）](https://firebase.google.com/docs/cloud-messaging)
+
+根据 [FCM](https://firebase.google.com/docs/cloud-messaging) 的集成指南，替换以下文件：
+
+- **[google-services.json](android/app/google-services.json)**（Android 平台）
+- **[GoogleService-Info.plist](ios/Runner/GoogleService-Info.plist)**（iOS 平台）
+- **[firebase_options.dart](openim_common/lib/src/controller/firebase_options.dart)**（Dart 项目中的 Firebase 配置）
+
+### 离线推送横幅设置
+
+目前SDK的设计是直接由客户端控制推送横幅的展示内容。发送消息时，设置入参[offlinePushInfo](https://github.com/openimsdk/openim-flutter-demo/blob/cc72b6d7ca5f70ca07885857beecec512f904f8c/lib/pages/chat/chat_logic.dart#L543)：
+
+```dart
+  final offlinePushInfo = OfflinePushInfo(
+    title: "填写标题",
+    desc: "填写描述信息，例如消息内容",
+    iOSBadgeCount: true,
+  );
+  // 如果不自定义offlinePushInfo，则title默认为app名称，desc默认为为“你收到了一条新消息”
+```
+
+根据实际需求，完成对应的客户端和服务端配置后即可启用离线推送功能。
+
+---
+
+## 地图功能
+
+### 配置指南
+
+需要配置对应的 AMap Key。具体请参考 [AMap 文档](https://lbs.amap.com/)，工程中的代码需要修改以下 Key：
+
+- **[webKey](https://github.com/openimsdk/openim-flutter-demo/blob/5720a10a31a0a9bc5319775f9f4da83d6996dbfe/openim_common/lib/src/config.dart#L49)**
+- **[webServerKey](https://github.com/openimsdk/openim-flutter-demo/blob/5720a10a31a0a9bc5319775f9f4da83d6996dbfe/openim_common/lib/src/config.dart#L50)**
+
+```dart
+  static const webKey = 'webKey';
+  static const webServerKey = 'webServerKey';
+```
+
+完成配置后即可启用地图功能。