编码工程师andmultica-agent
8046ec7483
- 上游: 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>
89 lines
3.1 KiB
Markdown
89 lines
3.1 KiB
Markdown
|
||
# 常见功能配置指南
|
||
|
||
- [离线推送功能](#离线推送功能)
|
||
- [地图功能](#地图功能)
|
||
|
||
## 离线推送功能
|
||
|
||
目前使用的是集成方案。
|
||
|
||
### 客户端配置
|
||
|
||
#### 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';
|
||
```
|
||
|
||
完成配置后即可启用地图功能。
|