跳到主要内容

App 里有什么

一个 App 是一套可以独立编辑、构建和交付的工程。日常工作应在编辑器的 Resources、Settings 和 Git 面板中完成，不需要了解 Theseus 如何在内部组织或编译这些内容。

什么时候需要这页​

  • 判断某项内容是否应随项目交给同事；
  • 把 App 迁移到另一台开发机或从 Git 恢复；
  • 打开 App 后发现 Page、Object、QG 或功能包不完整；
  • 区分“已保存”“已 Build”“已交付”和“正在运行”。

先分清四类内容​

内容客户应该如何理解
项目内容可维护的 Page、Component、QG、Object、设置和素材；通过 Git 协作和备份
本机构建版本Build 生成的当前结果；可以重新生成，不是项目备份
运行目标上的已交付版本当前 Runtime target 收到的 App；保存项目不会自动更新它
现场状态Saved Variable 当前值、设备状态、登录会话和日志等；通常只属于该运行目标

因此，复制项目不等于复制现场状态；反过来，运行目标上能打开 App，也不代表项目已经妥善备份。

在哪里管理内容​

内容推荐入口
Page、Component、Object、QG、Vision、Safety 和素材Resources
App 名称、首页、功能包、Variable、Recipe、Query、多语言、用户和角色Settings
项目修改、提交和团队同步Git
构建与运行问题Problems / Console
当前交付目标和运行状态编辑器顶栏的 Runtime target 与运行控制

创建、移动或重命名资源时，优先从 Resources 操作，让编辑器同步检查引用和诊断。功能包版本通过 Settings → 功能包管理；不要通过修改项目内部文件绕过界面。

哪些内容会随项目移动​

内容随项目 / Git 移动迁移后还要做什么
Page、Component、QG、Object、App 设置和素材是打开 App 后等待所需功能包准备完成
App user 与 role 定义是在目标环境重新验证登录和角色分支
当前 Build 结果和已交付版本否在新环境重新 Build，并交付到正确目标
Saved Variable 当前值和设备持久状态否按项目的数据迁移方案处理
Runtime target 账户、License 和连接设置否在新机器重新连接和配置
编辑器布局和 AI 会话历史不属于 App 项目如有需要单独保留

迁移或交付流程​

  1. 保存所有需要交付的修改，并在 Git 面板检查变更范围。
  2. 提交项目需要的 Page、Object、QG、设置和素材，不提交密码、API Key 或临时文件。
  3. 在另一台开发机通过 App Hub 打开或从 Git 导入项目。
  4. 等待功能包准备完成；若失败，在 Settings → 功能包处理界面显示的明确错误。
  5. 在 Resources 和 Settings 检查首页、核心资源、启用模块、用户与外部连接配置。
  6. 选择正确的 Runtime target，执行 Build，然后用 Start 或 Debug 验收。
  7. 另行迁移现场数据、License、目标账户和连接信息；不要把这些当成 Git 内容。

验收清单​

  • App Hub 能正常打开项目；
  • 所需功能包全部准备成功，没有被替换为其他版本；
  • 首页和核心资源完整；
  • Build 成功，Problems 中没有阻断项；
  • Start / Debug 使用的是刚交付的版本；
  • App user、设备连接、Saved Variable 和外部系统分别完成环境验收；
  • 在一台干净环境中可以从团队项目恢复编辑与构建。

常见问题​

Git 导入后能看文件，但 Design、Preview 或 QG Flow 一直等待​

通常是项目所需功能包尚未准备好。保留原始错误，在 Settings → 功能包检查缺失版本或来源问题，然后重试。不要安装额外依赖或手工修改项目内部文件来绕过问题。

已保存修改，但运行页仍是旧版本​

保存只更新项目。先确认修改已保存，再执行 Build；Build 完成后再 Start 或 Debug。Preview、Start 和 Debug 都不会把未保存草稿自动带入运行目标。

换了一台机器后没有现场数据或目标账户​

这是预期边界。现场状态、License、目标账户和连接设置不属于项目。按交付清单单独迁移或重新配置。

Git 中出现不应提交的自动生成内容​

这些内容不是可维护项目。确认来源后从提交中移除，并通过正常 Build 验证项目可以重新生成运行版本。

相关内容​