- AnalyticsRouteObserver：didPush/didReplace/didPop 集中捕获，页面零侵入 - AnalyticsPageName 枚举：pageName 编译期锁死（字典 v2 九个初始值 + 客户端现存 create/pet_archive/services/post_detail），字典外路由不上报 - PageViewTracker：page_viewed 单一上报出口，维护 referrer 链（栈底/冷启动首页为 null）与去重（Tab 重复点选） - 三类非路由曝光手动补点：主壳 Tab 切换（IndexedStack）、认证状态机切页（AnimatedSwitcher）、回栈到无名根路由（resolveRootPage） - 既有 Navigator.push 挂 RouteSettings.name：login_page（register）、main_shell_page（post_detail）；fade_route 签名扩展可选 settings - M2 健康档案页面（pet_list/pet_detail/pet_form/record_form/record_detail）先留枚举定义，待功能落地接线 测试新增 8 例（analytics_route_observer_test）：push 上报/push 两页 referrer 链正确 + pop 补报/根路由 resolveRootPage 补报/枚举外不报/dialog 不报/Tab 去重/referrer 连贯/reportTab。 验收对照（06 号报告 §5.2 六条）：1✓ observer 注册、2✓ pageName 枚举含 pet_form、3✓ referrer 链、4✓ 字典外不报、5✓ 单测 push/pop/referrer、6✓ M1 存量四页接全。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,237 @@
|
||||
import 'package:flutter/material.dart';
|
||||
import 'package:flutter_test/flutter_test.dart';
|
||||
import 'package:patbond_flutter/analytics/analytics_page_name.dart';
|
||||
import 'package:patbond_flutter/analytics/analytics_route_observer.dart';
|
||||
import 'package:patbond_flutter/analytics/page_view_tracker.dart';
|
||||
|
||||
void main() {
|
||||
group('AnalyticsRouteObserver', () {
|
||||
testWidgets('push 路由报 page_viewed', (tester) async {
|
||||
final events = <Map<String, dynamic>>[];
|
||||
final tracker = PageViewTracker((name, [props]) async {
|
||||
events.add({'event': name, ...?props});
|
||||
});
|
||||
final observer = AnalyticsRouteObserver(tracker: tracker);
|
||||
|
||||
await tester.pumpWidget(
|
||||
MaterialApp(
|
||||
navigatorObservers: [observer],
|
||||
home: Builder(
|
||||
builder: (context) => ElevatedButton(
|
||||
onPressed: () => Navigator.of(context).push(
|
||||
MaterialPageRoute<void>(
|
||||
settings: RouteSettings(
|
||||
name: AnalyticsPageName.login.pageName,
|
||||
),
|
||||
builder: (_) => const Placeholder(),
|
||||
),
|
||||
),
|
||||
child: const Text('Go'),
|
||||
),
|
||||
),
|
||||
),
|
||||
);
|
||||
await tester.tap(find.text('Go'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(events, hasLength(1));
|
||||
expect(events.first['event'], 'page_viewed');
|
||||
expect(events.first['pageName'], 'login');
|
||||
});
|
||||
|
||||
testWidgets('push 两页 referrer 链正确，pop 返回补报前一页', (tester) async {
|
||||
final events = <Map<String, dynamic>>[];
|
||||
final tracker = PageViewTracker((name, [props]) async {
|
||||
events.add({'event': name, ...?props});
|
||||
});
|
||||
final observer = AnalyticsRouteObserver(tracker: tracker);
|
||||
|
||||
await tester.pumpWidget(
|
||||
MaterialApp(
|
||||
navigatorObservers: [observer],
|
||||
home: Builder(
|
||||
builder: (context) => ElevatedButton(
|
||||
onPressed: () => Navigator.of(context).push(
|
||||
MaterialPageRoute<void>(
|
||||
settings: RouteSettings(
|
||||
name: AnalyticsPageName.login.pageName,
|
||||
),
|
||||
builder: (loginContext) => ElevatedButton(
|
||||
onPressed: () => Navigator.of(loginContext).push(
|
||||
MaterialPageRoute<void>(
|
||||
settings: RouteSettings(
|
||||
name: AnalyticsPageName.register.pageName,
|
||||
),
|
||||
builder: (registerContext) => ElevatedButton(
|
||||
onPressed: () => Navigator.of(registerContext).pop(),
|
||||
child: const Text('Back'),
|
||||
),
|
||||
),
|
||||
),
|
||||
child: const Text('Next'),
|
||||
),
|
||||
),
|
||||
),
|
||||
child: const Text('Go'),
|
||||
),
|
||||
),
|
||||
),
|
||||
);
|
||||
await tester.tap(find.text('Go'));
|
||||
await tester.pumpAndSettle();
|
||||
await tester.tap(find.text('Next'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
// push 两页：两条事件，referrer 链正确（06 §5.2 验收 5）。
|
||||
expect(events.map((e) => e['pageName']), ['login', 'register']);
|
||||
expect(events[0].containsKey('referrer'), isFalse);
|
||||
expect(events[1]['referrer'], 'login');
|
||||
|
||||
// pop 返回：didPop 补报重新曝光的前一页，referrer 为弹出页。
|
||||
await tester.tap(find.text('Back'));
|
||||
await tester.pumpAndSettle();
|
||||
expect(events, hasLength(3));
|
||||
expect(events[2]['pageName'], 'login');
|
||||
expect(events[2]['referrer'], 'register');
|
||||
});
|
||||
|
||||
testWidgets('pop 回无名根路由经 resolveRootPage 补报', (tester) async {
|
||||
final events = <Map<String, dynamic>>[];
|
||||
final tracker = PageViewTracker((name, [props]) async {
|
||||
events.add({'event': name, ...?props});
|
||||
});
|
||||
final observer = AnalyticsRouteObserver(
|
||||
tracker: tracker,
|
||||
resolveRootPage: () => AnalyticsPageName.home,
|
||||
);
|
||||
|
||||
await tester.pumpWidget(
|
||||
MaterialApp(
|
||||
navigatorObservers: [observer],
|
||||
home: Builder(
|
||||
builder: (context) => ElevatedButton(
|
||||
onPressed: () => Navigator.of(context).push(
|
||||
MaterialPageRoute<void>(
|
||||
settings: RouteSettings(
|
||||
name: AnalyticsPageName.profile.pageName,
|
||||
),
|
||||
builder: (innerContext) => ElevatedButton(
|
||||
onPressed: () => Navigator.of(innerContext).pop(),
|
||||
child: const Text('Back'),
|
||||
),
|
||||
),
|
||||
),
|
||||
child: const Text('Go'),
|
||||
),
|
||||
),
|
||||
),
|
||||
);
|
||||
await tester.tap(find.text('Go'));
|
||||
await tester.pumpAndSettle();
|
||||
await tester.tap(find.text('Back'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(events.map((e) => e['pageName']), ['profile', 'home']);
|
||||
expect(events[1]['referrer'], 'profile');
|
||||
});
|
||||
|
||||
testWidgets('未在枚举的路由名不上报', (tester) async {
|
||||
final events = <Map<String, dynamic>>[];
|
||||
final tracker = PageViewTracker((name, [props]) async {
|
||||
events.add({'event': name, ...?props});
|
||||
});
|
||||
final observer = AnalyticsRouteObserver(tracker: tracker);
|
||||
|
||||
await tester.pumpWidget(
|
||||
MaterialApp(
|
||||
navigatorObservers: [observer],
|
||||
home: Builder(
|
||||
builder: (context) => ElevatedButton(
|
||||
onPressed: () => Navigator.of(context).push(
|
||||
MaterialPageRoute<void>(
|
||||
settings: const RouteSettings(name: '/debug/unknown'),
|
||||
builder: (_) => const Placeholder(),
|
||||
),
|
||||
),
|
||||
child: const Text('Go'),
|
||||
),
|
||||
),
|
||||
),
|
||||
);
|
||||
await tester.tap(find.text('Go'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(events, isEmpty);
|
||||
});
|
||||
|
||||
testWidgets('dialog 不上报（PopupRoute 不是 PageRoute）', (tester) async {
|
||||
final events = <Map<String, dynamic>>[];
|
||||
final tracker = PageViewTracker((name, [props]) async {
|
||||
events.add({'event': name, ...?props});
|
||||
});
|
||||
final observer = AnalyticsRouteObserver(tracker: tracker);
|
||||
|
||||
await tester.pumpWidget(
|
||||
MaterialApp(
|
||||
navigatorObservers: [observer],
|
||||
home: Builder(
|
||||
builder: (context) => ElevatedButton(
|
||||
onPressed: () => showDialog<void>(
|
||||
context: context,
|
||||
builder: (_) => const AlertDialog(title: Text('Dialog')),
|
||||
),
|
||||
child: const Text('Show'),
|
||||
),
|
||||
),
|
||||
),
|
||||
);
|
||||
await tester.tap(find.text('Show'));
|
||||
await tester.pumpAndSettle();
|
||||
|
||||
expect(events, isEmpty);
|
||||
});
|
||||
});
|
||||
|
||||
group('PageViewTracker', () {
|
||||
test('连续相同页面去重（Tab 重复点选）', () {
|
||||
final events = <Map<String, dynamic>>[];
|
||||
final tracker = PageViewTracker((name, [props]) async {
|
||||
events.add({'event': name, ...?props});
|
||||
});
|
||||
|
||||
tracker.report(AnalyticsPageName.home);
|
||||
tracker.report(AnalyticsPageName.home);
|
||||
tracker.report(AnalyticsPageName.profile);
|
||||
tracker.report(AnalyticsPageName.home);
|
||||
|
||||
expect(events, hasLength(3));
|
||||
expect(events.map((e) => e['pageName']), ['home', 'profile', 'home']);
|
||||
});
|
||||
|
||||
test('referrer 链跨机制连贯（首页无 referrer）', () {
|
||||
final events = <Map<String, dynamic>>[];
|
||||
final tracker = PageViewTracker((name, [props]) async {
|
||||
events.add({'event': name, ...?props});
|
||||
});
|
||||
|
||||
tracker.report(AnalyticsPageName.home);
|
||||
tracker.report(AnalyticsPageName.login);
|
||||
tracker.report(AnalyticsPageName.profile);
|
||||
|
||||
expect(events[0].containsKey('referrer'), isFalse);
|
||||
expect(events[1]['referrer'], 'home');
|
||||
expect(events[2]['referrer'], 'login');
|
||||
});
|
||||
|
||||
test('reportTab 记录当前 Tab', () {
|
||||
final events = <Map<String, dynamic>>[];
|
||||
final tracker = PageViewTracker((name, [props]) async {
|
||||
events.add({'event': name, ...?props});
|
||||
});
|
||||
|
||||
tracker.reportTab(AnalyticsPageName.petArchive);
|
||||
expect(tracker.currentTab, AnalyticsPageName.petArchive);
|
||||
expect(events.single['pageName'], 'pet_archive');
|
||||
});
|
||||
});
|
||||
}
|
||||
Reference in New Issue
Block a user