Vicky
61454e36b1
为什么：a) 应用对外名称要统一成 FruitShorts（产品名，nontonki 是原型代号）； b) 首发市场是印尼，界面必须有印尼语；c) 归档要求"新增 id-ID 与改名合并生成一次 l10n，别分两次"。 改名： - pubspec name: nontonki → fruitshorts（Dart 包名），description 同步；28 个文件的 package: 导入前缀替换 - Android android:label、iOS CFBundleDisplayName/CFBundleName → FruitShorts - 图标资源 assets/icon/nontonki.png → fruitshorts.png（含 pubspec 两处引用） - README 同步（补印尼语说明，顺带修掉写错的模块名 reelshort-app-api → fruitshorts-app-api） 文案： - 三份 arb 的 appName → FruitShorts、brandMark → FRUITSHORTS、shareFooter → FruitShorts（不留 demo 标记） - 新增 lib/l10n/app_id.arb：174 个值键与 en/zh 完全一致，按印尼语习惯翻译（Coin→Koin、Episode→Episode） - 一次性 flutter gen-l10n 生成 app_localizations_id.dart；id 自动进入 supportedLocales，默认 locale 未改 - 新增 test/config/l10n_id_test.dart：钉住 id 文案、supportedLocales 含 id、品牌文案无 demo 标记、占位符渲染 不动：applicationId / bundle id（lumadrama 遗留，等裁定）、目录名、业务逻辑与页面结构、语言选择页（仍只有 en/zh） 门禁：dart analyze lib test 零告警；flutter test 159 全过（基线 155 + 新增 4）；残留扫描 0 命中； 三份 arb 键集一致（174/174/174）；真机（iPhone iOS 26.6.1）构建安装启动成功，devicectl 列出显示名 FruitShorts
51 lines
3.0 KiB
Markdown
51 lines
3.0 KiB
Markdown
一个使用 Flutter 开发的短剧播放 App 原型，面向海外用户，重点探索沉浸式刷剧、找剧和连续观看的移动端体验
|
||
|
||
## 主要功能
|
||
|
||
- **沉浸式首页**：竖屏播放，上下滑切换短剧，左右滑切换内容类别；支持拖动进度、横屏全屏观看。
|
||
- **剧集播放**：从详情页进入后按集连续播放，支持选集和本地续看。
|
||
- **找剧与个人页**：浏览、搜索和查看剧集详情；在个人页查看观看记录、收藏与喜欢的内容。
|
||
- **互动与多语言**：本地演示评论、系统分享，以及英文、简体中文和印尼语界面。
|
||
- **画中画**：Android 接入系统画中画；iOS 画中画尚未实现。
|
||
|
||
## 技术实现
|
||
|
||
项目使用 Flutter、Provider 和 `video_player`。播放会话统一管理播放器生命周期；观看进度和演示互动数据保存在本机。首页、找剧、我的共用同一个根页面，切换时保留页面状态。
|
||
|
||
## 对接后端
|
||
|
||
目录数据来自短剧服务的客户端接口（`FruitServer` 的 `fruitshorts-app-api`，默认 `http://127.0.0.1:8081`）：
|
||
|
||
- `GET /app/home/feed`、`GET /app/discover/feed`：轮播 + 分区，一次请求渲染整页。
|
||
每张卡片带 `preview`（首个可播免费集），首页竖屏播放可以直接起播；
|
||
没有片源的剧不下发 `preview`，也不会出现在首页的滑动队列里
|
||
- `GET /app/dramas/{id}`：详情（含剧集列表；可播放的剧集直接带播放地址）
|
||
- `GET /app/episodes/{id}/play`：播放票据，返回可访问性与地址
|
||
|
||
启动后端后直接 `flutter run` 或 Xcode 里 Run 即可，接口地址按运行环境自动选择
|
||
（见 `lib/core/config/app_config.dart`）：
|
||
|
||
| 运行环境 | 默认地址 |
|
||
| --- | --- |
|
||
| iOS 模拟器 / 桌面端 | `http://127.0.0.1:8081` |
|
||
| iPhone 真机 | [`devHostBaseUrl`]，即电脑当前的局域网地址（`ipconfig getifaddr en0`） |
|
||
| Android 模拟器 | 需手动指定 `--dart-define=API_BASE_URL=http://10.0.2.2:8081` |
|
||
|
||
任何环境都可以用 `--dart-define=API_BASE_URL=http://x.x.x.x:8081` 覆盖默认值。
|
||
电脑换网络后局域网地址会变，改 `devHostBaseUrl` 即可；也可以换成 Bonjour 名字
|
||
（`http://$(scutil --get LocalHostName).local:8081`），换网络也不用改。
|
||
|
||
真机调试还需注意：手机和电脑在同一个 Wi-Fi；首次启动时 iPhone 会弹「本地网络」权限，
|
||
必须允许；iOS 的明文 HTTP 与局域网访问已在 `ios/Runner/Info.plist` 里放行
|
||
（`NSAllowsLocalNetworking`、`NSLocalNetworkUsageDescription`），改动这些配置后
|
||
要重新构建安装，热重载不生效；如果仍连不上，到「系统设置 → 网络 → 防火墙 → 选项」
|
||
把 `java` 设为允许传入连接。
|
||
|
||
封面与视频都走 `http://<host>:8081/files/**`，本地不再打包演示素材
|
||
（原先 `assets/media` 里的演示视频有 316MB，已从打包清单移除）。
|
||
|
||
## 当前说明
|
||
|
||
收藏、点赞、评论与观看进度仍保存在本机（后端互动接口尚未开发）；
|
||
金币与会员相关界面仍是占位数据。
|