docs(plans): 留痕 K76 开发默认地址

This commit is contained in:
Zhou Weidong committed 2026-10-21 09:58:35 +08:00
1 parent 60fa96b789
commit da60bd8b0f
2 files changed
+43 -57

No files matched your search

+15 -57
View File
@@ -1,73 +1,31 @@
# INBOX
## [已处理] K75-A 首页进详情 / 进播放页改为无感淡入
## [已处理] K76-A 开发默认地址改回 192.168.31.187
### 需求
### 背景
首页 feed:
Mac 的 Wi-Fi 地址已从 `10.39.237.1` 变回 `192.168.31.187`,本机后端已重启并监听 8081,
`http://192.168.31.187:8081/app/categories` 返回 200。客户端需要同步改回该地址。
1. 点短剧标题 → 详情页
2. 点「观看完整剧集」→ 全屏播放页
### 改动
现在都是默认的平台转场(iOS 从右往左滑入、Android 缩放),观感突兀。
改成**无感淡入**:不加左右位移,只做短促的淡入 / 淡出。
### 现状
- `lib/pages/player/player_logic.dart` `openDetail()`:`MaterialPageRoute` → `DramaDetailPage`
- `lib/pages/player/open_player.dart` `playDramaFromCatalog()`:`MaterialPageRoute` → `PlayerPage`
(首页「观看完整剧集」走这里,筛选页 / 榜单等卡片也复用)
- `lib/pages/player/player_logic.dart` `openSeriesAt()`:`MaterialPageRoute` → `PlayerPage`
### 实现
1. 新增 `lib/core/navigation/fade_page_route.dart`:
```dart
// Author: fruit.com.cn
import 'package:flutter/widgets.dart';
/// 无位移的淡入转场:用于首页 feed 进详情 / 播放页,避免平台左右滑入。
class FadePageRoute<T> extends PageRouteBuilder<T> {
FadePageRoute({required WidgetBuilder builder, super.settings})
: super(
transitionDuration: const Duration(milliseconds: 220),
reverseTransitionDuration: const Duration(milliseconds: 180),
pageBuilder: (context, _, __) => builder(context),
transitionsBuilder: (context, animation, _, child) => FadeTransition(
opacity: CurvedAnimation(parent: animation, curve: Curves.easeOut),
child: child,
),
);
}
```
2. 把上述三处 `MaterialPageRoute` 换成 `FadePageRoute`:
- `PlayerLogic.openDetail()`
- `playDramaFromCatalog()`
- `PlayerLogic.openSeriesAt()`
3. 其它入口(登录页、我的、收藏、观看记录、发现页等)**保持原样**,本批不动。
### 测试
- 新增 `test/navigation/fade_page_route_test.dart`:
- push 后 `transitionDuration == 220ms`、`reverseTransitionDuration == 180ms`
- 转场过程中存在 `FadeTransition`,且 `opaque == true`
- 现有 player / home 相关测试必须继续通过(若有用例断言 `MaterialPageRoute` 类型,改为断言页面内容而不是路由类型)
1. `lib/core/config/app_config.dart`
- `devHostBaseUrl` 改为 `'http://192.168.31.187:8081'`(不带结尾斜杠)
- 注释保持「换网络时只改这一行」的说明
2. `test/config/server_endpoint_test.dart`
- 字面量断言同步改为 `'http://192.168.31.187:8081'`
### 验收
- 门禁:`dart analyze lib test` 零告警、`flutter test` 全过、`flutter build apk --debug` 成功。
- 真机自查:首页点标题进详情、点观看完整剧集进播放页,均为淡入无左右滑动;返回同样淡出。
- 探测顺序保持 `127.0.0.1 → 192.168.31.187 → 公网 39.162.50.99`。
### Git
- 从 `develop` 拉 `feat/fade-route-home-feed`。
- 提交:`feat(player): 首页进详情与播放页改为淡入转场`,作者 `Zhou Weidong <502333560@qq.com>`。
- `--no-ff` 合回 `develop` 并 push;`FruitServer/docs/plans/PROGRESS.md` 追加 K75-A 留痕。
- 从 `develop` 拉 `chore/dev-host-192-168-31-187`。
- 提交:`chore(config): 开发默认地址改回 192.168.31.187`,作者 `Zhou Weidong <502333560@qq.com>`。
- `--no-ff` 合回 `develop` 并 push;`FruitServer/docs/plans/PROGRESS.md` 追加 K76-A 留痕。
### 约束
- 全程中文;禁止 `git add -A`;只改上述范围;完成后停住等待验收。
- 全程中文;禁止 `git add -A`;除上述两个文件外不改其它内容;完成后停住等待验收。
+28
View File
@@ -22652,3 +22652,31 @@ Running Gradle task 'assembleDebug'...
```
解读:静态检查零告警,483 条测试全部通过,debug APK 构建成功。首页详情/播放页淡入效果等待真机验收。
## 2026-10-21 ReelShort:K76-A 开发默认地址改回 192.168.31.187
- 前置状态:K75-A 已完成并合并,develop 合并提交 `c0697c0`。
- 分支:`chore/dev-host-192-168-31-187`
- 功能提交:`99b45e4 chore(config): 开发默认地址改回 192.168.31.187`
- develop 合并提交:`76cc52a merge: 合并 K76-A 开发默认地址`,已推送 `c0697c0..76cc52a`。
- `devHostBaseUrl` 改为 `http://192.168.31.187:8081`,不带结尾斜杠;注释保留“换网络时只改这一行”的说明。
- 探测候选保持 `127.0.0.1 → 192.168.31.187 → 公网 39.162.50.99` 的顺序,地址去重、并行探测与运行时优先逻辑未改。
- 本任务只修改 `app_config.dart` 与对应配置测试;对应默认地址字面量断言同步为 `192.168.31.187`。
门禁原始输出:
```text
$ dart analyze lib test
Analyzing lib, test...
No issues found!
$ flutter test
00:53 +483: All tests passed!
$ flutter build apk --debug
Running Gradle task 'assembleDebug'...
15.0s
✓ Built build/app/outputs/flutter-apk/app-debug.apk
```
解读:静态检查零告警,483 条测试全部通过,debug APK 构建成功。真机验收由用户执行。