本机快速入门
用几分钟完成最短的本地闭环:创建 App → 创建 Page → 人工检查 → Build → Preview → Start → Stop。本页不需要登录账号,不连接远程目标,也不使用真实设备。
1. 创建 App
- 在应用中心选择新建项目。
- App 名称输入“我的第一个 App”。
- 选择项目的创建位置。
- 保持包含模块全部不选,然后选择创建项目。
Theseus 会创建项目并打开编辑器。空白项目的 Resources → Pages 为空是正常现象。
2. 创建第一个 Page
- 在 Resources → Pages 的右键菜单中选择新建页面。
- 页面名称输入“quickstart”。
- 打开新 Page,并切换到 Design。
- 从 Palette 加入一个标题和一段文本。
- 在右侧 Inspector 中把标题改为“我的第一个 App”,把正文改为“本机运行已就绪”。
这一步只创建静态画面,不添加 Object、QG、Query、自定义代码或设备配置。
3. 检查并设置首页
- 在 Design 中确认标题和正文都能看到。
- 在 Resources → Pages 中右键“quickstart”,选择设为首页。
- 确认 Page 名称旁出现首页标记。
- 保存所有文件。
4. Build 并 Preview
- 确认标题栏选择的是本机 Runtime target。
- 执行 Build,等待操作成功。
- 打开 Problems,确认本次 Build 没有错误。
- 回到“quickstart”,选择 Preview。
- 确认页面显示“我的第一个 App”和“本机运行已就绪”。
Preview 只检查当前目标上的版本,不会替你保存或 Build。完成后选择 Stop,等待状态回到 Stopped。
5. Start 并完成运行检查
- 选择 Start,等待状态变为 Running。
- 在浏览器中打开本机运行页 http://127.0.0.1:9210/。
- 确认运行页直接打开“quickstart”,并显示与 Preview 相同的内容。
- 回到编辑器选择 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 课。只想查某项功能时,使用按你的目标开始。