跳到主要内容

本机快速入门

用几分钟完成最短的本地闭环:创建 App → 创建 Page → 人工检查 → Build → Preview → Start → Stop。本页不需要登录账号,不连接远程目标,也不使用真实设备。

1. 创建 App

  1. 在应用中心选择新建项目
  2. App 名称输入“我的第一个 App”。
  3. 选择项目的创建位置。
  4. 保持包含模块全部不选,然后选择创建项目

Theseus 会创建项目并打开编辑器。空白项目的 Resources → Pages 为空是正常现象。

2. 创建第一个 Page

  1. Resources → Pages 的右键菜单中选择新建页面
  2. 页面名称输入“quickstart”。
  3. 打开新 Page,并切换到 Design
  4. 从 Palette 加入一个标题和一段文本。
  5. 在右侧 Inspector 中把标题改为“我的第一个 App”,把正文改为“本机运行已就绪”。

这一步只创建静态画面,不添加 Object、QG、Query、自定义代码或设备配置。

3. 检查并设置首页

  1. 在 Design 中确认标题和正文都能看到。
  2. Resources → Pages 中右键“quickstart”,选择设为首页
  3. 确认 Page 名称旁出现首页标记。
  4. 保存所有文件。

4. Build 并 Preview

  1. 确认标题栏选择的是本机 Runtime target。
  2. 执行 Build,等待操作成功。
  3. 打开 Problems,确认本次 Build 没有错误。
  4. 回到“quickstart”,选择 Preview
  5. 确认页面显示“我的第一个 App”和“本机运行已就绪”。

Preview 只检查当前目标上的版本,不会替你保存或 Build。完成后选择 Stop,等待状态回到 Stopped

5. Start 并完成运行检查

  1. 选择 Start,等待状态变为 Running
  2. 在浏览器中打开本机运行页 http://127.0.0.1:9210/
  3. 确认运行页直接打开“quickstart”,并显示与 Preview 相同的内容。
  4. 回到编辑器选择 Stop,等待状态回到 Stopped

现在,你已经在本机完成了第一个可运行 App。保存、Build、Preview 和 Start 是不同操作;后续修改 Page 后,需要再次保存并 Build。

如果没有成功

现象先检查什么
Page 没有出现确认在 Resources → Pages 下创建,并重新打开该 Page
Design 中没有预期内容选中标题或文本,在 Inspector 中检查其文字属性
Build 失败打开 Problems,先处理最早出现的明确错误
Preview 提示需要 Build保存所有文件,确认 App 为 Stopped,再重新 Build
Start 不可用先结束 Preview,并等待状态回到 Stopped
运行页没有进入首页确认“quickstart”已设为首页,然后重新 Build 和 Start
运行页仍显示旧内容Stop,保存 Page,重新 Build,再 Start

下一步

要跟随连续案例学习 AI、Page 交互、QG、调试和远程交付,请继续教程第 1 课。只想查某项功能时,使用按你的目标开始