跳到主要内容

运行状态与控制

编辑器顶栏显示当前 Runtime target 上 App 的运行状态。先核对目标名称，再根据状态选择操作；切换目标后，看到的是新目标自己的状态。

典型状态流转为：

Stopped → Previewing → Stopping → Stopped

Stopped → Starting → Running / Debugging → Stopping → Stopped

状态速查​

状态表示什么当前可以做什么
StoppedApp 没有活动的运行实例Admin 可以 Build、Preview、Start 或 Debug
Previewing编辑器正在预览当前目标上的 Page检查页面和交互；Admin 完成后使用 Stop
StartingApp 正在准备启动等待完成；Admin 必要时可以 Stop
RunningApp 正常运行使用和验收 App；Admin 完成后可以 Stop
DebuggingApp 以调试方式运行查看调试信息；暂停时 Continue；Admin 完成后可以 Stop
StoppingApp 正在停止并释放所占资源等待回到 Stopped，不发起新的运行操作

Preview、Build、Start、Debug 和 Stop 都需要 Runtime target Admin。目标 User 可以查看状态并使用已经 Running 的 App，但不能改变运行状态。完整边界见 Runtime target 账户与权限。

Stopped​

Stopped 是交付新版本、正常启动或进入调试的起点。

  • Build：检查已保存的工程，并把新版本交付到当前目标。
  • Preview：在编辑器中检查当前目标上的 Page 版本。
  • Start：启动目标上已经交付的版本。
  • Debug：以调试方式启动已经交付的 Debug 版本。

如果 Preview、Start 或 Debug 提示 Build required，表示当前目标没有可用于该操作的本 App 版本。确认保存内容和目标后再 Build。完整步骤见Build 与运行验收。

Previewing​

Previewing 表示编辑器正在使用当前目标上已经交付的版本显示 Page。

  • 检查布局、输入、导航和页面交互。
  • 真实 Object 调用仍会到达当前目标，可能产生设备动作。
  • 完成后由 Admin 使用 Stop，并等待 Stopped；回到 Stopped 后才能 Build、Start 或 Debug。

Previewing 不是生产运行状态，也不会采用未保存修改。页面需要更新时，先 Stop、保存并重新 Build。

Starting​

Starting 表示启动请求已经被接受，App 正在取得资源并完成启动准备。

  • 等待状态进入 Running 或 Debugging。
  • 不要重复点击 Start、Debug 或 Build。
  • 需要取消本次启动时，由 Admin 使用 Stop，然后等待 Stopped。

如果启动失败，界面会保留错误，并在清理完成后回到 Stopped。记录原始错误，再排查许可证、设备、资源或 App 初始化问题。

Running​

Running 表示 App 已经进入正常运行。

  • 在运行页或 Player 验收页面、角色、外部设备和正常业务流程。
  • 目标 User 可以查看和使用已经 Running 的 App。
  • 需要部署新版本、改用 Debug 或结束本次运行时，先由 Admin Stop。

编辑器中的保存不会改变当前 Running 版本。修改需要进入运行态时，先 Stop，再重新 Build 和 Start。

Debugging​

Debugging 表示 App 正以调试方式运行。

  • 查看日志、变量和断点结果。
  • 命中断点并暂停时，使用 Continue 恢复本次调试。
  • 完成调试后由 Admin 使用 Stop，并等待 Stopped。

Debugging 不是生产运行状态。现场需要正常运行时，停止调试，完成要求的 Build 和验收后再 Start。

Stopping​

Stopping 表示停止已经开始，App 正在结束任务并释放设备和其他资源。

  • 等待状态回到 Stopped。
  • 不要在停止过程中 Preview、Build、Start、Debug 或反复 Stop。
  • 回到 Stopped 后，再进行下一次 Preview、Build、Start 或 Debug。

运行故障也会触发停止清理并最终回到 Stopped。Stopped 只说明清理已经结束，不代表故障已经修复。

常见问题​

Preview、Start 或 Debug 不可用​

先确认当前状态是 Stopped、当前 App 已交付到所选目标，并且目标会话是 Admin。目标错误、权限不足或尚无可用 Build 都会阻止操作。

Starting 或 Stopping 长时间不结束​

不要连续重试操作。保留界面上的原始错误和时间，检查目标连接、许可证、外部设备和资源占用；必要时按现场恢复流程处理。

App 回到 Stopped，并显示运行错误​

先保存错误信息和复现条件。修复配置或源码后重新 Build；如果不需要修改版本，确认现场条件后再 Start。不要用反复启动掩盖同一故障。

已保存修改，但 Running App 仍是旧行为​

这是预期行为。保存只更新工程；由 Admin Stop 当前实例，重新 Build，再 Start 或 Debug。

必须人工确认​

  • 顶栏显示的是本次任务批准的 Runtime target。
  • Preview、Start、Debug 或 Stop 不会造成未批准的设备动作或停机。
  • 故障回到 Stopped 后，根因和恢复条件已经确认。
  • Build 成功和 Running 状态都不能替代现场工艺与安全验收。

更多状态原理见运行生命周期，整体交付路径见 Runtime 与现场交付。