- 生产接线修复:app.dart 组装时传 analytics 实例给 ApiAuthRepository(_buildRepository),修复 M1 遗留的「生产环境 _analytics 恒为 null、挂接点空转」问题 - sessionId 生命周期:新建 SessionTracker (WidgetsBindingObserver),冷启动生成 UUIDv7、后台超 30 分钟换新、未超阈值沿用原值,不再每事件随机生成 - eventId 改 UUIDv7:对齐 13 号规范(uuid 包已在依赖,直接用 v7()),保留插入时间局部性 - appVersion 动态注入:package_info_plus(新增依赖)异步读取后 setAppVersion,不再硬编码 '1.0.0+1' - osVersion 动态读取:Platform.operatingSystemVersion 正则提取主版本(如 android-14),不再硬编码 - 队列顺手加固:上传失败批次重回队首而非整批丢弃(一行级缓解,分段持久化属 M2 第二波) 测试新增 9 例:session_tracker_test(5 例:冷启动/短后台/长后台/级联状态/连续幂等),analytics_service_test 补强 4 例(UUIDv7/sessionId 不再逐事件生成/appVersion 可注入/失败重回队列)。 验收对照(06 号报告 §5.1 六条):1✓ SessionTracker 新建、2✓ 三条语义、3✓ 同会话 sessionId 一致、4✓ sessionId 为 UUID 不持久化、5✓ 单测 3 例(实际 5 例)、6✓ 真机脚本(开发者手测)。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,38 @@
|
||||
import 'package:patbond_flutter/analytics/analytics_page_name.dart';
|
||||
|
||||
/// trackEvent 形状的回调(生产传 `AnalyticsService.trackEvent`,测试传录制桩)。
|
||||
typedef TrackEventFn =
|
||||
Future<void> Function(String eventName, [Map<String, dynamic>? props]);
|
||||
|
||||
/// page_viewed 上报的单一出口:维护 referrer 链与去重。
|
||||
///
|
||||
/// 路由事件(AnalyticsRouteObserver)、主壳 Tab 切换、认证状态机切页
|
||||
/// 三类曝光都经此上报,referrer(前一页 pageName)才能跨机制连贯;
|
||||
/// 栈底/冷启动首页 referrer 为 null(06 §5.2 验收 3)。
|
||||
class PageViewTracker {
|
||||
PageViewTracker(this._track);
|
||||
|
||||
final TrackEventFn _track;
|
||||
|
||||
String? _lastPageName;
|
||||
AnalyticsPageName? _currentTab;
|
||||
|
||||
/// 主壳当前 Tab(供回栈补报解析根路由曝光页)。
|
||||
AnalyticsPageName? get currentTab => _currentTab;
|
||||
|
||||
/// 上报一次页面曝光;与上一条相同的页面去重(Tab 重复点选等)。
|
||||
void report(AnalyticsPageName page) {
|
||||
if (page.pageName == _lastPageName) return;
|
||||
final referrer = _lastPageName;
|
||||
_lastPageName = page.pageName;
|
||||
final props = <String, dynamic>{'pageName': page.pageName};
|
||||
if (referrer != null) props['referrer'] = referrer;
|
||||
_track('page_viewed', props);
|
||||
}
|
||||
|
||||
/// 主壳 Tab 曝光:记录当前 Tab 后上报(IndexedStack 无路由事件,手动补点)。
|
||||
void reportTab(AnalyticsPageName page) {
|
||||
_currentTab = page;
|
||||
report(page);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user