Runtime 与现场交付
Runtime target(运行目标)是 App 实际接收版本并运行的位置。它可以是开发电脑上的本机目标,也可以是工控机、边缘设备或现场服务器上的远程目标。
编辑器始终留在开发电脑上。切换运行目标只改变 Preview、Build、Start 和 Debug 面向哪台设备,不会移动工程、Git、AI 会话或编辑器设置。
选择本机还是远程目标
| 选择 | 适合的工作 | 使用前重点确认 |
|---|---|---|
| 本机目标 | 首次学习、页面和逻辑验证、开发期间的快速迭代 | 本机具备测试所需的功能包和设备条件;测试结果不能代替现场验收 |
| 远程目标 | 在工控机或边缘设备上联调、使用真实网络和设备、交付现场终端 | 地址与证书可信、目标账户权限正确、许可证和设备可用、停机窗口已批准 |
首次教程默认使用本机目标。只有当 App 需要在另一台设备的真实环境中运行时,才需要连接远程 Runtime target。
交付顺序
保存 → 核对目标 → Stop → Build → Preview / Start / Debug → 验收 → Stop
保存、Build 和运行是独立阶段。保存不会改变目标上的版本,Build 不会自动 Start,Start 也不会读取尚未交付的修改。动作和状态含义见从保存到运行;完整操作和 Problems 处理以Build 与运行验收为准。
远程交付前的检查
在生产或现场目标上操作前,至少确认:
- 目标名称、地址、设备和现场位置一致;
- 远程连接使用受信任的 HTTPS,并且网络路径符合现场安全要求;
- 当前人员使用目标
Admin完成部署和生命周期操作; - 目标上的现有 App、运行状态和替换影响已经核对;
- 许可证、外部设备、工艺参数、联锁和恢复方案已经就绪;
- 终端需要长期展示页面时,已经安排 Theseus Player 验收。
Runtime target 账户只授权某个运行目标。Qixin 在线服务账号和 App 内的操作员身份不随目标切换,详见Runtime target 账户与权限。
按任务继续
| 要完成的任务 | 文档 |
|---|---|
| 新增、检查并绑定远程目标 | 连接远程 Runtime target |
| 判断 User、Admin 和 App user 的权限 | Runtime target 账户与权限 |
| 判断当前状态下可以做什么 | 运行状态与控制 |
| 完成 Build 和运行验收 | Build 与运行验收 |
| 配置和验收现场运行终端 | 在现场终端使用 Theseus Player |
| 安装或更新目标许可证 | 许可证管理 |
| 排查连接、构建和运行故障 | 故障排查 |
交付原则
- 开发验证优先使用本机目标,现场验收必须在实际目标和实际设备条件下完成。
- Build、Start、Debug、Stop 和目标切换都由有权限的人显式执行。
- 远程可访问不等于允许部署;必须同时确认目标身份、Admin 权限和现场状态。
- Build 成功只说明版本可以生成并交付,不代表已经获得生产放行。