第 4 课：远程交付与 Player
本课把前三课完成的“包装工作站”交付到另一台设备，并在 Player 中打开首页。通用配置和权限规则由 Runtime 手册统一说明；本课只保留连续案例需要执行的步骤。
本节目标
- 确认远程交付的人员、设备和停机边界
- 把当前 App 绑定到正确的远程 Runtime target
- 使用 Release Build 交付并启动已保存版本
- 在 Player 中连接运行目标、进入首页并完成终端验收
开始前
- 已完成第 3 课：QG 流程、对象调用与调试，并保存需要交付的修改。
- 已取得远程目标的名称、访问地址和受信任的安全连接。
- 由目标管理员负责连接和交付；权限说明见Runtime target 账户与权限。
- 已取得适合现场终端的 Player 安装包。
- 已确认测试机或生产机、停机窗口、许可证、备份、设备安全条件和恢复负责人。
注意
远程交付可能替换目标上已有的 App，并可能触发真实设备动作。核对目标和现场状态前，不要 Build、Start、Debug 或 Stop。
第 1 步：形成交付检查单
在 AI Command Center 中新建任务并发送：
只读检查当前“包装工作站”App 是否具备远程交付条件。
列出：
- 当前已保存工程中的 Build 阻塞和未确认修改
- 首页、角色、设备、QG、超时、故障与恢复需要人工验收的项目
- 远程目标、许可证、网络、停机窗口和 Player 需要现场负责人提供的事实
不要修改文件，不要连接或切换运行目标，不要 Build、Deploy、Start、Debug 或 Stop。
把 AI 结果整理成检查单。目标地址、账号、密码、证书风险、设备方向和 Safety 结论必须由负责人提供，不能让 AI 猜测。
第 2 步：连接远程运行目标
- 打开编辑器顶栏的 Runtime target 选择器。
- 按连接远程 Runtime target新增、检查并连接目标。
- 核对目标名称、访问地址、设备信息和
Admin权限。 - 明确记录这是测试目标还是生产目标，以及谁批准本次交付。
连接只会选择后续操作作用的目标，不会上传项目，也不会改变本机文件、Git 或 AI 会话。
第 3 步：Build Release 并运行
- 保存全部交付内容，并记录当前版本基线。
- 确认 App 为 Stopped，顶栏仍显示刚才核对的远程目标。
- 从 Build 菜单选择 Build Release。
- 如果目标上已有另一 App，核对目标、两边 App 名称和停机计划后，再人工确认替换。
- 等待 Build 成功，检查 Problems 没有阻止交付的错误。
- 点击 Start，等待状态进入 Running。
- 打开该目标的运行页，检查首页、导航、角色、正常流程、故障和恢复流程。
Release Build 用于交付验收，不提供 QG 源码断点。若验收失败，先 Stop，回到项目修复并重新 Build，不要用反复 Start 掩盖问题。
第 4 步：配置并验收 Player
- 在现场终端安装并打开 Player。
- 按在现场终端使用 Theseus Player填写同一个运行目标的访问地址并完成连接。
- 使用现场批准的运行目标账户进入运行页；App 使用业务角色时，再通过对应 App user 登录操作员身份。
- 打开“包装工作站”首页，确认 Player 记录了正确的页面绑定。
- 关闭并重新打开 Player，确认仍进入同一目标和页面。
Player 只显示目标上已经交付的 App，不提供项目编辑或 Build，也不能作为项目备份。
交付验收清单
- 目标名称、地址、测试/生产属性和批准人已核对
- 当前会话具备目标管理员权限，普通运行账户另行配置
- Release Build 成功，Problems 没有阻塞错误
- 替换、停机和恢复计划已经批准
- 运行页和 Player 显示同一个 App 与首页
- App user、页面角色和操作路径已用真实账号验证
- 正常、边界、故障、Stop 和恢复场景全部完成
- 许可证、网络、设备和 Safety 结果已记录
出问题时
| 现象 | 从哪里处理 |
|---|---|
| 目标不可访问或连接失败 | 连接远程 Runtime target |
| 已登录但操作权限不足 | Runtime target 账户与权限 |
| Build、Start 或状态异常 | Build 与运行验收 |
| Player 无法进入目标或页面 | 在现场终端使用 Theseus Player |
| 页面角色不符合预期 | 应用用户、角色与运行页登录 |
完成本课后，按版本管理参考记录客户交付基线，并保存现场验收结果。