HarmonyOS 如何添加新页面,并设置为模拟器默认启动页面(Stage模型
·
很多刚上手鸿蒙开发的小伙伴会问:怎么新建一个页面,并且让模拟器启动后直接打开这个页面?
整个流程可以分为两大步:添加新页面、设置页面为默认启动页
第一步:添加新页面,两种实现方式(优先推荐方式一)
方式一:IDE 直接新建 Empty Page(推荐) 这种方式会自动帮我们在
main_pages.json路由配置文件里注册页面,不容易漏写配置导致白屏。 操作步骤:
- 在工程目录选中 pages 文件夹;
- 右键 → New → Empty Page;
- 在弹窗中填写页面名称,点击 Finish 完成创建。


方式二:手动新建 ArkTS 文件 + 手动配置路由
- 在 pages 目录新建
.etsArkTS 页面文件; - 打开
main_pages.json,手动把页面路径添加到路由数组中;
⚠️ 注意:这种方式很容易写错路径、忘记配置,新手不优先选


第二步:设置页面为模拟器启动后直接展示的首页
想要模拟器运行就直接打开我们新建的页面,需要修改 EntryAbility 里的启动页面参数:
- 找到
EntryAbility.ts; - 定位到设置默认页面的代码位置,把页面路由名称修改成你新建页面的名字;
- 重新编译项目,启动模拟器,就会默认打开这个新页面了

新手避坑
- 页面名称尽量英文,不要中文、空格、特殊字符;
main_pages.json路径写错,页面会直接白屏;- 修改完 EntryAbility 的启动页面之后,一定要重新编译运行,热更新不一定生效;
- 本文基于 Stage 模型,FA 模型配置方式不一样,不要混用。
更多推荐




所有评论(0)