From 1d393f4f1e96a149b36b6aafcaf21f8a453b9b73 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=BC=96=E7=A0=81=E5=B7=A5=E7=A8=8B=E5=B8=88?= Date: Mon, 31 Aug 2026 00:56:12 +0800 Subject: [PATCH] =?UTF-8?q?fix(mobile):=20=E8=AE=A9=E5=8D=8E=E4=B8=BA=20AG?= =?UTF-8?q?Connect=20=E5=9C=A8=20AGP=209=20=E4=B8=8B=E8=83=BD=E8=AF=86?= =?UTF-8?q?=E5=88=AB=E7=9C=9F=E5=AE=9E=E9=85=8D=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 放入 agconnect-services.json 后原插件坐标无法解析，且 1.9.1 不兼容 AGP 9。 映射到 agcp 1.9.5.301，Gradle 可按包名校验；该文件继续忽略不入库。 Co-authored-by: Cursor Co-authored-by: multica-agent --- docs/任务清单.md | 8 +++--- docs/最新进度.md | 14 +++++---- docs/项目需求.md | 2 +- mobile/README.md | 2 +- mobile/analysis_options.yaml | 5 ++++ mobile/android/app/README-agconnect.md | 9 +++--- mobile/android/app/build.gradle.kts | 21 ++++++++++++-- mobile/android/gradle/libs.versions.toml | 7 +++++ mobile/android/settings.gradle.kts | 13 ++++++++- mobile/pubspec.lock | 36 +++++++++++++++++------- 10 files changed, 88 insertions(+), 29 deletions(-) create mode 100644 mobile/android/gradle/libs.versions.toml diff --git a/docs/任务清单.md b/docs/任务清单.md index 99b4c93..d194daa 100644 --- a/docs/任务清单.md +++ b/docs/任务清单.md @@ -4,7 +4,7 @@ ## 正在做 -公网第一阶段返工：overlay 端口覆盖、`JPUSH_PUSH_INTENT` 引号与 `SERVER_IP` 校验已改完，等待总工复审后部署测试环境。 +无。华为配置注入与 Gradle 识别已提交，等待审核。 ## 已做完 @@ -16,13 +16,13 @@ - 建立本目录四份交接手册，并为三份过时旧说明加上明确的留档提示。 - 手机端应用标识统一为 `cn.solsum.jinxunda`。 - 安卓极光 SDK 初始化、通知权限、alias 回传、点击处理，以及 OpenIM 离线推送所需的服务端配置入口（Master Secret 从服务器文件注入）。 -- 公网反向代理 / HTTPS / WSS / 防火墙与回滚说明（配置进仓库，未实际部署）。 +- 公网反向代理 / HTTPS / WSS / 防火墙与回滚说明（配置进仓库；香港测试环境已由总工部署）。 - 公网 overlay 用 `!override` 覆盖内部端口绑定；部署脚本校验 `SERVER_IP` 非空。 +- 构建机本地放入华为 `agconnect-services.json`（不入库）；AGConnect 插件映射/版本已按 AGP 9 补齐，Gradle 能识别包名 `cn.solsum.jinxunda`。 ## 还没安排 -- 总工在测试机按 `deploy/public/README.md` 部署并验证证书与推送。 -- 向构建机放入华为 `agconnect-services.json` 后重打安卓包（见 `mobile/android/app/README-agconnect.md`）。 +- 在可编译 LiveKit 的环境打出安卓包，并用真机验证华为厂商通道到达。 - 组织真实手机和 Windows 电脑的回归：重点确认文件传输、一对一语音通话和杀进程后的离线通知。 - 明确手机正式签名的负责人和安全保管方式；不能把签名密钥提交进仓库。 - 获得负责人同意后，再导入真实员工名单并验证账号管理流程。 diff --git a/docs/最新进度.md b/docs/最新进度.md index af24a58..b6e325d 100644 --- a/docs/最新进度.md +++ b/docs/最新进度.md @@ -4,13 +4,13 @@ ## 现在做到哪里 -项目已经具备可继续测试的手机端、Windows 电脑端、账号服务和内网部署配置，并完成本阶段公网接入的**客户端与部署配置**（未在测试机上实际部署）： +项目已经具备可继续测试的手机端、Windows 电脑端、账号服务，香港测试环境已由总工部署；本轮补齐了安卓华为厂商通道的客户端构建配置： - 手机端在 `mobile/`，使用 OpenIM Flutter SDK `3.8.3+hotfix.12`，版本 `1.0.7+8`。 - 安卓/苹果应用标识为 `cn.solsum.jinxunda`。 -- 手机端已接入极光官方 Flutter 插件（AppKey 在客户端配置），登录后把 OpenIM userID 设为极光 alias；华为厂商通道依赖已打开，缺华为后台下载的 `agconnect-services.json`。 +- 手机端已接入极光官方 Flutter 插件（AppKey 在客户端配置），登录后把 OpenIM userID 设为极光 alias。 +- 华为 AGConnect 插件在放入本地 `agconnect-services.json` 后启用（agcp `1.9.5.301`，适配 AGP 9）；该文件含密钥，仓库继续忽略，不入库。 - 手机默认服务地址为 `jxd.jinniu.ink` 的 HTTPS/WSS；内网可用 `--dart-define=SERVER_HOST=... --dart-define=USE_TLS=false` 覆盖。 -- 电脑端 `.env.example` 已改为同一套公网路径。 - 公网部署 overlay、Nginx、证书步骤、Master Secret 注入脚本和回滚脚本在 `deploy/public/` 与 `scripts/deploy-public.sh`；由总工部署，施工员不改测试机。 - overlay 的内部端口用 Compose `!override` 覆盖基础 `0.0.0.0` 绑定，只留 `127.0.0.1`；LiveKit `17881/tcp`、`17882/udp` 仍对公网开放。部署脚本会拒绝空 `SERVER_IP`。 @@ -19,13 +19,17 @@ - `docs/phase4-regression-2026-08-16.md` 记录过手机与电脑之间的文字、同事申请、图片、语音消息等跨端回归结果。 - 该记录中的文件传输和一对一语音通话，曾因模拟器环境无法闭环，仍需要用真实设备再次确认。 - 旧记录使用的是更早的提交、安装包版本和端口状态；因此已保留为档案并在开头标明过时，不能当作当前验收结论。 +- 放入与 `cn.solsum.jinxunda` 匹配的真实华为配置后，Gradle `:app:processDebugAGCPlugin` 与 `:app:processReleaseAGCPlugin` 通过；debug/release/profile 均识别该配置文件。未因配置缺失或包名不一致失败。 +- `flutter pub get` 已写入 `jpush_flutter 3.5.6` / `jpush_flutter_android 1.0.2` 到 `mobile/pubspec.lock`。 +- `flutter analyze` 仅有 2 条既有 OpenIM `group` 弃用 info；`flutter test` 中 `config_test` 通过。 +- 整包 `flutter build apk` 未出包：锁定的 `livekit_client 2.5.0+hotfix.3` 与 Flutter 3.47 / Dart 3.13 的空安全检查不兼容。此项不在华为配置本卡范围，未改 LiveKit 版本。 ## 当前停在哪 -客户端与部署配置已提交。测试机上的 Nginx/证书/compose 公网拉起、以及华为 `agconnect-services.json` 放入构建机，等总工审核后处理。本阶段未在测试机执行部署。 +华为配置已在构建机本地注入并被 Gradle 识别。整包 APK 与真机华为通道到达，仍待后续在可编译 LiveKit 的环境或真机上完成。本轮未改测试机、未回退公网端口与部署安全修复。 ## 已知风险和待验证事实 - 真机上的文件传输、一对一语音通话、杀进程后的离线推送（尤其华为通道）仍需实际设备验证。 -- 本施工环境无 Flutter / JDK / Android SDK，未能在本机执行 `flutter analyze` 与 `flutter build apk`。 +- 整包 APK 受 `livekit_client 2.5.0+hotfix.3` 与当前 Flutter 空安全检查限制，需另卡决定是否升级 LiveKit。 - 电脑端使用较旧的 Electron；公网接入后仍需评估 HTTPS、登录限流和跨域策略。 diff --git a/docs/项目需求.md b/docs/项目需求.md index 9ef12f7..3f23207 100644 --- a/docs/项目需求.md +++ b/docs/项目需求.md @@ -26,6 +26,6 @@ - 只做集团内部通讯，不改造成公开社交产品。 - 保留 OpenIM 的现有标识，禁止替换品牌。 -- 公网第一阶段：安卓极光 + 华为厂商通道（华为配置文件仍缺，见 `mobile/android/app/README-agconnect.md`）；不接小米/OPPO/vivo/荣耀/魅族/FCM/苹果推送。 +- 公网第一阶段：安卓极光 + 华为厂商通道（`agconnect-services.json` 只放构建机、不入库，见 `mobile/android/app/README-agconnect.md`）；不接小米/OPPO/vivo/荣耀/魅族/FCM/苹果推送。 - 不把员工名单、密码、管理员口令、极光 Master Secret、华为 Secret、私钥或服务器私密配置写入仓库和文档。 - 本仓库的日常任务如无明确授权，不做发布、部署或改动生产环境。 \ No newline at end of file diff --git a/mobile/README.md b/mobile/README.md index dba24de..bf8803b 100644 --- a/mobile/README.md +++ b/mobile/README.md @@ -41,7 +41,7 @@ flutter build apk --release \ | `livekitUrl` | LiveKit 语音通话 | `wss://jxd.jinniu.ink/livekit` | | `authApiBase` | 公司账号登录后端 | `https://jxd.jinniu.ink/account` | -华为厂商通道还缺 `android/app/agconnect-services.json`，取得方式见同目录 `README-agconnect.md`。不要把该文件提交进 Git。 +华为厂商通道需要本地放置 `android/app/agconnect-services.json`（与包名 `cn.solsum.jinxunda` 对应），取得方式见 `android/app/README-agconnect.md`。不要把该文件提交进 Git。 ## 登录接口契约（后端：任务 B-60 account-service，已上线） diff --git a/mobile/analysis_options.yaml b/mobile/analysis_options.yaml index 0d29021..0d87f43 100644 --- a/mobile/analysis_options.yaml +++ b/mobile/analysis_options.yaml @@ -7,6 +7,11 @@ # The following line activates a set of recommended lints for Flutter apps, # packages, and plugins designed to encourage good coding practices. +analyzer: + exclude: + - build/** + - android/** + - ios/** include: package:flutter_lints/flutter.yaml linter: diff --git a/mobile/android/app/README-agconnect.md b/mobile/android/app/README-agconnect.md index 88a597a..4301084 100644 --- a/mobile/android/app/README-agconnect.md +++ b/mobile/android/app/README-agconnect.md @@ -1,6 +1,6 @@ -# 华为厂商通道配置文件（缺口） +# 华为厂商通道配置文件 -华为通道客户端其余依赖已接入。**唯一还缺的文件**是： +华为通道客户端依赖已接入。构建机需要一份本地文件： `mobile/android/app/agconnect-services.json` @@ -14,8 +14,7 @@ 没有这份文件时： -- 安卓包仍可构建（AGConnect 插件按文件是否存在条件启用） -- 极光自己的通道仍可初始化 +- AGConnect 插件不会启用，安卓包仍可走极光自有通道构建 - **华为真机的厂商通道无法接通**，杀进程后的到达率会明显下降 -本阶段不伪造、不提交该文件。 +放入真实配置后，`:app` 会启用 AGConnect（agcp `1.9.5.301`，适配 AGP 9）。Gradle 会按包名 `cn.solsum.jinxunda` 校验该文件；校验失败则构建失败。 diff --git a/mobile/android/app/build.gradle.kts b/mobile/android/app/build.gradle.kts index 13c3e6f..aec10a9 100644 --- a/mobile/android/app/build.gradle.kts +++ b/mobile/android/app/build.gradle.kts @@ -1,3 +1,19 @@ +buildscript { + repositories { + maven("https://maven.aliyun.com/repository/google") + maven("https://maven.aliyun.com/repository/central") + maven("https://developer.huawei.com/repo/") + google() + mavenCentral() + } + // agcp 1.9.x 用 apply() 时会检查 buildscript classpath 里有没有 AGP； + // 仅靠 plugins DSL 会报「com.android.tools.build:gradle is no set」。 + dependencies { + classpath("com.android.tools.build:gradle:9.0.1") + classpath("com.huawei.agconnect:agcp:1.9.5.301") + } +} + plugins { id("com.android.application") // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins. @@ -6,8 +22,9 @@ plugins { // 华为 agconnect-services.json 到位后才启用 AGConnect 插件，避免缺文件时整包编不过。 // 文件从华为 AppGallery Connect 下载，放到本目录，不要提交进 Git。 -val agconnectServices = file("agconnect-services.json") -if (agconnectServices.exists()) { +// jpush_flutter_android 只在自己的 library 模块 apply 该插件，不会处理本 app 的配置文件， +// 所以这里仍要在 :app 上 apply，并不是重复。 +if (file("agconnect-services.json").exists()) { apply(plugin = "com.huawei.agconnect") } diff --git a/mobile/android/gradle/libs.versions.toml b/mobile/android/gradle/libs.versions.toml new file mode 100644 index 0000000..dee00f9 --- /dev/null +++ b/mobile/android/gradle/libs.versions.toml @@ -0,0 +1,7 @@ +[versions] +agp = "9.0.1" +agcp = "1.9.5.301" + +[plugins] +android-application = { id = "com.android.application", version.ref = "agp" } +huawei-agconnect = { id = "com.huawei.agconnect", version.ref = "agcp" } diff --git a/mobile/android/settings.gradle.kts b/mobile/android/settings.gradle.kts index d2c3964..2977a4b 100644 --- a/mobile/android/settings.gradle.kts +++ b/mobile/android/settings.gradle.kts @@ -20,13 +20,24 @@ pluginManagement { mavenCentral() gradlePluginPortal() } + + // 华为插件发布在 Maven 的 agcp 构件上，没有 Plugin Portal 的 + // com.huawei.agconnect.gradle.plugin 坐标。plugins DSL 必须映射过去， + // 否则放入 agconnect-services.json 后启用插件会解析失败。 + resolutionStrategy { + eachPlugin { + if (requested.id.id == "com.huawei.agconnect") { + useModule("com.huawei.agconnect:agcp:1.9.5.301") + } + } + } } plugins { id("dev.flutter.flutter-plugin-loader") version "1.0.0" id("com.android.application") version "9.0.1" apply false id("org.jetbrains.kotlin.android") version "2.3.20" apply false - id("com.huawei.agconnect") version "1.9.1.301" apply false + id("com.huawei.agconnect") version "1.9.5.301" apply false } include(":app") diff --git a/mobile/pubspec.lock b/mobile/pubspec.lock index 95e8415..eea9f17 100644 --- a/mobile/pubspec.lock +++ b/mobile/pubspec.lock @@ -369,10 +369,10 @@ packages: dependency: transitive description: name: intl - sha256: "3df61194eb431efc39c4ceba583b95633a403f46c9fd341e550ce0bfa50e9aa5" + sha256: "1ca20c894b1717686a2319b8548763d812bc0aabdac580420a44c5178c57a867" url: "https://pub.dev" source: hosted - version: "0.20.2" + version: "0.20.3" jni: dependency: transitive description: @@ -397,6 +397,22 @@ packages: url: "https://pub.dev" source: hosted version: "1.0.0" + jpush_flutter: + dependency: "direct main" + description: + name: jpush_flutter + sha256: "5dcfcd553787db0c92a9b2f0898a6dbc053530c6636ed488416cd9edf12f08d3" + url: "https://pub.dev" + source: hosted + version: "3.5.6" + jpush_flutter_android: + dependency: "direct main" + description: + name: jpush_flutter_android + sha256: d2bae547aefb2ff5acf28badaf115bb358e9244b6acef84625d8db0228bbc0b2 + url: "https://pub.dev" + source: hosted + version: "1.0.2" js: dependency: transitive description: @@ -489,10 +505,10 @@ packages: dependency: transitive description: name: matcher - sha256: dc0b7dc7651697ea4ff3e69ef44b0407ea32c487a39fff6a4004fa585e901861 + sha256: "31bd099b47c10cd1aeb55146a2d46ce0277630ecef3f7dae54ad7873f36696cd" url: "https://pub.dev" source: hosted - version: "0.12.19" + version: "0.12.20" material_color_utilities: dependency: transitive description: @@ -505,10 +521,10 @@ packages: dependency: transitive description: name: meta - sha256: "1741988757a65eb6b36abe716829688cf01910bbf91c34354ff7ec1c3de2b349" + sha256: "307249ce4ff29d58a18e97f6345f539382eb9c9c29ecda628900f31de0443dd9" url: "https://pub.dev" source: hosted - version: "1.18.0" + version: "1.19.0" mime: dependency: transitive description: @@ -902,10 +918,10 @@ packages: dependency: transitive description: name: test_api - sha256: "949a932224383300f01be9221c39180316445ecb8e7547f70a41a35bf421fb9e" + sha256: "2a122cbe059f8b610d3a5415f42e255b6c17b1f21eee1d960f31080237fb4f11" url: "https://pub.dev" source: hosted - version: "0.7.11" + version: "0.7.12" typed_data: dependency: transitive description: @@ -926,10 +942,10 @@ packages: dependency: transitive description: name: vector_math - sha256: d530bd74fea330e6e364cda7a85019c434070188383e1cd8d9777ee586914c5b + sha256: f36f9f3be64c6198714492bb455c11056e33e2f85d9a0b676a48301e44fdcf47 url: "https://pub.dev" source: hosted - version: "2.2.0" + version: "2.4.2" vm_service: dependency: transitive description: