feat(app): 接入首页轮播 banner

test/discover/discover_banner_test.dart

@@ -0,0 +1,74 @@
+// Author: fruit.com.cn
+
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:fruitshorts/app.dart';
+import 'package:fruitshorts/core/data/models/home_feed.dart';
+import 'package:fruitshorts/core/data/repositories/favorite_repository.dart';
+import 'package:fruitshorts/core/data/repositories/playback_repository.dart';
+import 'package:fruitshorts/core/data/repositories/watch_history_repository.dart';
+import 'package:fruitshorts/pages/drama_detail/drama_detail_view.dart';
+import 'package:shared_preferences_platform_interface/in_memory_shared_preferences_async.dart';
+import 'package:shared_preferences_platform_interface/shared_preferences_async_platform_interface.dart';
+
+import '../support/fake_catalog.dart';
+import '../support/fake_category.dart';
+import '../support/fake_haptics.dart';
+import '../support/fake_interaction_repositories.dart';
+import '../support/widget_player.dart';
+
+void main() {
+  setUp(() {
+    SharedPreferencesAsyncPlatform.instance =
+        InMemorySharedPreferencesAsync.withData({});
+  });
+
+  testWidgets('should_open_linked_drama_when_discover_banner_is_tapped', (
+    tester,
+  ) async {
+    final catalog = FakeCatalogRepository(
+      banners: const [
+        FeedBanner(
+          id: 'banner-1',
+          imageUrl: '/files/banner.jpg',
+          linkType: 'DRAMA',
+          linkValue: 'the-signal-demo',
+        ),
+      ],
+    );
+    await _pumpApp(tester, catalog);
+    await tester.tap(find.byKey(const Key('tab-discover')));
+    await tester.pumpAndSettle();
+
+    expect(find.byKey(const Key('feed-banner-carousel')), findsOneWidget);
+    await tester.tap(find.byKey(const Key('feed-banner-0')));
+    await tester.pumpAndSettle();
+
+    expect(find.byType(DramaDetailPage), findsOneWidget);
+    expect(find.text('The Signal'), findsWidgets);
+  });
+}
+
+Future<void> _pumpApp(
+  WidgetTester tester,
+  FakeCatalogRepository catalog,
+) async {
+  tester.view.physicalSize = const Size(390, 844);
+  tester.view.devicePixelRatio = 1;
+  addTearDown(tester.view.resetPhysicalSize);
+  addTearDown(tester.view.resetDevicePixelRatio);
+  await tester.pumpWidget(
+    LumaDramaApp(
+      playerFactory: createWidgetPlayer,
+      catalogRepository: catalog,
+      categoryRepository: FakeCategoryRepository(catalog: catalog),
+      watchHistoryRepository: InMemoryWatchHistoryRepository(),
+      favoriteRepository: InMemoryFavoriteRepository(cards: catalog.dramas),
+      playbackRepository: FakePlaybackRepository(),
+      commentRepository: FakeCommentRepository(),
+      interactionRepository: FakeInteractionRepository(),
+      haptics: FakeHaptics(),
+    ),
+  );
+  await tester.pumpAndSettle();
+}

test/home/feed_banner_carousel_test.dart

@@ -0,0 +1,88 @@
+// Author: fruit.com.cn
+
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:fruitshorts/core/data/models/home_feed.dart';
+import 'package:fruitshorts/l10n/app_localizations.dart';
+import 'package:fruitshorts/pages/discover/widgets/feed_banner_carousel.dart';
+
+void main() {
+  testWidgets('should_render_nothing_when_banner_list_is_empty', (
+    tester,
+  ) async {
+    await _pump(tester, const []);
+
+    expect(find.byKey(const Key('feed-banner-carousel')), findsNothing);
+  });
+
+  testWidgets('should_open_linked_drama_when_banner_is_tapped', (tester) async {
+    FeedBanner? opened;
+    await _pump(tester, const [
+      FeedBanner(
+        id: 'banner-1',
+        imageUrl: '/files/banner.jpg',
+        linkType: 'DRAMA',
+        linkValue: 'drama-1',
+      ),
+    ], onOpen: (banner) => opened = banner);
+
+    expect(find.byKey(const Key('feed-banner-carousel')), findsOneWidget);
+    expect(find.byKey(const Key('feed-banner-0')), findsOneWidget);
+    await tester.tap(find.byKey(const Key('feed-banner-0')));
+    await tester.pump();
+
+    expect(opened?.dramaId, 'drama-1');
+  });
+
+  testWidgets('should_advance_to_next_banner_when_interval_elapses', (
+    tester,
+  ) async {
+    await _pump(tester, _banners);
+
+    await tester.pump(const Duration(milliseconds: 4600));
+    await tester.pumpAndSettle();
+
+    expect(_page(tester), 1);
+  });
+
+  testWidgets('should_pause_auto_advance_when_pointer_is_held', (tester) async {
+    await _pump(tester, _banners);
+    final gesture = await tester.startGesture(
+      tester.getCenter(find.byKey(const Key('feed-banner-carousel'))),
+    );
+
+    await tester.pump(const Duration(seconds: 5));
+    expect(_page(tester), 0);
+
+    await gesture.up();
+    await tester.pump(const Duration(seconds: 5));
+    await tester.pumpAndSettle();
+    expect(_page(tester), 1);
+  });
+}
+
+const _banners = [
+  FeedBanner(id: 'banner-1', imageUrl: '/files/one.jpg'),
+  FeedBanner(id: 'banner-2', imageUrl: '/files/two.jpg'),
+];
+
+double _page(WidgetTester tester) =>
+    tester.widget<PageView>(find.byType(PageView)).controller!.page!;
+
+Future<void> _pump(
+  WidgetTester tester,
+  List<FeedBanner> banners, {
+  ValueChanged<FeedBanner>? onOpen,
+}) async {
+  await tester.pumpWidget(
+    MaterialApp(
+      locale: const Locale('en'),
+      localizationsDelegates: AppLocalizations.localizationsDelegates,
+      supportedLocales: AppLocalizations.supportedLocales,
+      home: Scaffold(
+        body: FeedBannerCarousel(banners: banners, onOpen: onOpen ?? (_) {}),
+      ),
+    ),
+  );
+  await tester.pump();
+}

test/support/fake_catalog.dart

@@ -4,9 +4,11 @@ import 'package:fruitshorts/core/data/repositories/catalog_repository.dart';
 
 /// 测试用目录数据：三部分区里的短剧，标题与后端演示数据保持一致。
 class FakeCatalogRepository implements CatalogRepository {
-  FakeCatalogRepository({List<Drama>? dramas}) : dramas = dramas ?? demoDramas;
+  FakeCatalogRepository({List<Drama>? dramas, this.banners = const []})
+    : dramas = dramas ?? demoDramas;
 
   final List<Drama> dramas;
+  final List<FeedBanner> banners;
 
   @override
   Future<HomeFeed> fetchHomeFeed() async => _feed();
@@ -20,51 +22,38 @@ class FakeCatalogRepository implements CatalogRepository {
   }
 
   HomeFeed _feed() => HomeFeed(
+    banners: banners,
     sections: [FeedSection(code: 'hot', title: '热门推荐', dramas: dramas)],
   );
 }
 
 final List<Drama> demoDramas = [
-  _drama(
-    'the-signal-demo',
-    'The Signal',
-    'Suspense · Mystery',
-    format: 1,
-  ),
+  _drama('the-signal-demo', 'The Signal', 'Suspense · Mystery', format: 1),
   _drama(
     'city-lights-demo',
     'City Lights & Velvet Nights',
     'Urban Romance',
     format: 8,
   ),
-  _drama(
-    'vengeance-demo',
-    'Vengeance Rising',
-    'Action · Thriller',
-    format: 15,
-  ),
+  _drama('vengeance-demo', 'Vengeance Rising', 'Action · Thriller', format: 15),
 ];
 
-Drama _drama(
-  String id,
-  String title,
-  String genre, {
-  required int format,
-}) => Drama(
-  id: id,
-  title: title,
-  synopsis: '$title synopsis',
-  posterUrl: '/files/$id.png',
-  genre: genre,
-  detailLoaded: true,
-  episodes: [
-    for (var index = 0; index < 7; index++)
-      Episode(
-        id: '$id-${index + 1}',
-        number: index + 1,
-        title: 'Episode ${index + 1}',
-        isFree: true,
-        videoUrl: 'https://example.test/$format-$index.mp4',
-      ),
-  ],
-);
+Drama _drama(String id, String title, String genre, {required int format}) =>
+    Drama(
+      id: id,
+      title: title,
+      synopsis: '$title synopsis',
+      posterUrl: '/files/$id.png',
+      genre: genre,
+      detailLoaded: true,
+      episodes: [
+        for (var index = 0; index < 7; index++)
+          Episode(
+            id: '$id-${index + 1}',
+            number: index + 1,
+            title: 'Episode ${index + 1}',
+            isFree: true,
+            videoUrl: 'https://example.test/$format-$index.mp4',
+          ),
+      ],
+    );