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:
@@ -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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user