用途:把 Vega OS(Amazon Fire TV)应用迁移为多平台 React Native monorepo,支持 Android TV、Apple TV 及 Vega OS,目标是跨平台复用约 70-85% 代码。
触发场景:需要把 Vega/Fire TV 应用迁移到其他平台、构建多平台 TV 应用、把单平台应用转为 monorepo、新增 Android TV 或 Apple TV 支持、在 TV 平台间共享代码,或为 TV 应用配置 Yarn workspaces 时使用。
分阶段:Phase 1 分析(CRITICAL),用于尚无分析文档时,做代码库分析、依赖分类与迁移规划;Phase 2 实现(CRITICAL),在已有分析后搭建 monorepo 结构、迁移代码并设置 VMRP;Phase 3 平台支持(HIGH),在已有可运行 Vega monorepo 后添加 Android TV 与 Apple TV;另含配置阶段(MEDIUM),用于排查构建与模块解析问题。决策树按「是否有现有 Vega 应用→是否已有分析→是否已搭建 monorepo」决定起点;从零开始则跳过 Phase 1,直接进入 Phase 2。
主要能力与文件:引用文档 PHASE1_ANALYSIS.md、PHASE2_IMPLEMENTATION.md、PHASE3_PLATFORM_SUPPORT.md;模板位于 assets/templates/,含 root-package.json、root-tsconfig.json、yarnrc.yml(依赖去重,标注为 CRITICAL)、shared-package.json 及 .md、vega-metro.config.js、expotv-package.json 及 .md、expotv-app.json 及 .md、expotv-metro.config.js。
使用方式:验证 monorepo 结构可执行 ls -la packages/shared packages/vega packages/expotv;检查 Yarn workspaces 用 grep -A5 "workspaces:" package.json;检查 VMRP 是否生效用 grep "vmrp" packages/vega/babel.config.js,应看到 @vega-tv/react-native-module-resolver-preset。依赖分类常见模式:共享为业务逻辑、UI 组件、工具、状态管理;平台特定为导航、视频播放器、DRM、原生模块;VMRP 兼容为可映射到 Vega 等价物的标准 RN 库。每阶段需通过检查点,并用 VALIDATION_CHECKLIST.md 校验。
限制:资料未提供具体安装命令、支持版本、收费、平台兼容范围或实际效果数据,相关事实暂未提供。