Refactor observability and analytics documentation

- Updated the crash reporting section to clarify the integration of Bugly and sensors analytics.
- Revised the logging rules to ensure sensitive data is scrubbed before logging.
- Enhanced the session management guidelines to ensure user context is correctly set during login and logout processes.
- Consolidated the analytics event tracking strategy, emphasizing backend-driven event logging.
- Removed references to third-party SDKs for crash reporting and analytics, focusing on internal logging mechanisms.
This commit is contained in:
Guangfei.Zhao
2026-09-03 11:38:54 +08:00
parent 45cb240c40
commit acdfc95686
6 changed files with 39 additions and 487 deletions
+6 -6
View File
@@ -11,7 +11,7 @@
| 版本 | 日期 | 状态 | 说明 |
| --- | --- | --- |
| 0.1 | 2026-09-02 | POC 方案已冻结 | 定义范围、验收矩阵、证据要求及决策规则,实施后持续回写实际结果 |
| 0.2 | 2026-09-02 | 部分通过 | 记录 Flutter_OH 3.41.10-ohos-1.0.0 / Dart 3.11.5 的依赖解析和 `main_dev.dart` debug HAP 构建通过;确定首期 ArkTS 采用宿主 `entry` MethodChannel 路径 |
| 0.2 | 2026-09-02 | 部分通过 | 记录 Flutter_OH 3.41.10-ohos-1.0.0 / Dart 3.11.5 的依赖解析和默认 `main.dart` debug HAP 构建通过;确定首期 ArkTS 采用宿主 `entry` MethodChannel 路径 |
## 0. 结论摘要(实施后填写)
@@ -31,7 +31,7 @@
| --- | --- |
| 推荐级别 | `部分通过;尚不足以给出 Conditional Go` |
| 使用的 Flutter_OH 版本 | Flutter `3.41.10-ohos-1.0.0`;Dart `3.11.5` |
| App 基线 | `harmony_3.41.9` 分支;本轮使用 `lib/main_dev.dart` |
| App 基线 | `harmony_3.41.9` 分支;使用默认 `lib/main.dart`(未指定 flavor 时加载 dev 配置) |
| 模拟器基线 | 待记录 DevEco Studio、SDK、设备镜像/API、系统 Build |
| 已证明的能力 | OHOS 工程存在;依赖解析完成;debug HAP 可由 Flutter_OH + hvigor 构建输出 |
| 未证明的能力 | 模拟器运行/热重载、Dart/ArkTS 桥接、真机相机与实体扫码、相册/文件、权限、定位、推送、性能、签名发布、真实 F6 页面 |
@@ -44,7 +44,7 @@
在 App 仓库根目录执行 `. .\enable-ohos.ps1`,再进入 `app` 目录执行:
```powershell
flutter build hap --debug -t lib\main_dev.dart
flutter build hap --debug
```
依赖解析及 hvigor 构建成功,输出 `app/ohos/entry/build/default/outputs/default/entry-default-unsigned.hap`。该产物是**未签名的 debug HAP**,不等同于已安装、已启动或可发布的完整验证。构建期间仍有 `targetSdkVersion` 未显式配置的 hvigor warning,需在后续 OHOS 工程配置中处理。
@@ -227,7 +227,7 @@ flutter devices
### 4.5 使用既有 OHOS 工程首次运行
`app/ohos` 已在本轮生成并完成 HAP 构建,**不得重复执行** `flutter create --platforms ohos .`,也不创建新的 Dart `main` 文件。现有环境入口使用 `lib/main_dev.dart`、`lib/main_uat.dart` 和 `lib/main_prod.dart`。
`app/ohos` 已在本轮生成并完成 HAP 构建,**不得重复执行** `flutter create --platforms ohos .`。项目使用唯一 Dart 入口 `lib/main.dart`;未指定 flavor 的 OHOS 默认加载 dev 配置。
只有在一个新的 `harmony` 工作树中确认 `app/ohos` 缺失、并在运行前后人工审查 Git diff 时,才允许在 `app` 目录执行一次 `flutter create --platforms ohos .`。当前工作树的后续运行与构建从仓库根目录执行:
@@ -236,7 +236,7 @@ flutter devices
cd app
flutter pub get
flutter devices
flutter run --debug -d <device-id> -t lib\main_dev.dart
flutter run --debug -d <device-id>
```
上游 README 公开了 `flutter create --platforms ohos <projectName>`、`flutter devices`、`flutter run --debug -d <device-id>` 和 `flutter build hap --release` 作为 OHOS 工程的创建、设备发现、调试运行和正式构建入口。本 POC 仅在 OHOS 平台目录缺失时使用一次 `--platforms ohos` 生成;任何生成操作前后都要看 Git diff,防止工具意外改写 Android/iOS 配置。[上游 Flutter_OH README](https://gitee.com/openharmony-sig/flutter_flutter/blob/master/README.md?force_mobile=true)
@@ -250,7 +250,7 @@ flutter run --debug -d <device-id> -t lib\main_dev.dart
首次可运行后执行一次构建验证(若只需复现本轮已通过的编译证据,也可直接执行本命令):
```powershell
flutter build hap --debug -t lib\main_dev.dart
flutter build hap --debug
git status --short
git diff --stat
```