文档开发者中心
我的
|

3D Engine

如何更改主入口页面

的如何更改应用主入口页面
点赞
收藏
回复
7
分享
举报
浏览179 发布于2025-08-17 13:47河南
全部评论
最多点赞
最新发布
最早发布
|
技术支持

【背景知识】
loadContent根据当前工程中指定的页面路径为WindowStage的主窗口加载具体页面内容。其中path为要加载到窗口中的页面内容的路径,该路径需添加到工程的main_pages.json文件中。
【解决方案】

找到EntryAbility.ets里onWindowStageCreate方法,在windowStage.loadContent('pages/Index'里修改页面入口,默认为Index,修改需要更改的页面即可。
main_pages.json里要配置对应页面。

收起
自动换行
深色代码主题
复制
onWindowStageCreate(windowStage: window.WindowStage): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
    AppStorage.setOrCreate("windowStage",windowStage);
    //修改pages/Index为需要的页面即可
    windowStage.loadContent('pages/Index', (err) => {
      if (err.code) {
        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
        return;
      }
      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
    });
  }
6楼编辑于2025-08-19 03:01 来自广东

Empty Ability或Native C++项目,入口页面在entry/src/main/ets/entryability/EntryAbility.ets文件:

cke_1076.png

仓颉项目则在entry/src/main/cangjie/main_ability.cj文件中。

2楼回复于2025-08-18 00:08 来自浙江

1.楼主想更改的主入口页面可以查询entry/src/main/ets/entryability/EntryAbility.ets下面的回调onWindowStageCreate里面的loadContent加载的页面

2.按照下面图示找到对应的加载页面,再去分析页面内部的加载情况,如果里面使用Navigation的话内部还有可能包裹一层页面
cke_2932.png

3.关于上面的问题基本都是和页面的生命周期和UIAbility的生命周期相关的楼主可以参考学习一下这个文档:下面这个图是整个应用的启动示例,和生命周期简图

UIAbility组件生命周期-UIAbility组件-Stage模型应用组件-Stage模型开发指导-Ability Kit(程序框架服务)-应用框架 - 华为HarmonyOS开发者

7楼回复于2025-08-20 13:22 来自湖南

在你的项目里面找到截图中的EntryAbility.ts,双击进入

cke_141.png

把“windowStage.loadContent”中的“pages/CanvasPage”换成你的主入口页面即可。

cke_7486.png

5楼回复于2025-08-18 07:55 来自河北
在entry/src/main/ets/entryability/EntryAbility.ets文件中找到
收起
自动换行
深色代码主题
复制
 windowStage.loadContent('pages/Index', (err, data) => {

 把其中

收起
自动换行
深色代码主题
复制
'pages/Index'

刚才你要更换的 

4楼回复于2025-08-18 07:47 来自山东

在entry/src/main/ets/entryability/EntryAbility.ets文件中找到

收起
自动换行
深色代码主题
复制
onWindowStageCreate(windowStage: window.WindowStage): void {
收起
自动换行
深色代码主题
复制
  onWindowStageCreate(windowStage: window.WindowStage): void {
    // Main window is created, set main page for this ability
    // 这句代码
    windowStage.loadContent('pages/Index', (err, data) => {
      if (err.code) {
        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
        return;
      }
      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
    });
  }

将

收起
自动换行
深色代码主题
复制
'pages/Index'

改成你需要的页面即可

3楼回复于2025-08-18 02:12 来自安徽
收起
自动换行
深色代码主题
复制
EntryAbility 里面 
收起
自动换行
深色代码主题
复制
onWindowStageCreate 试试
1楼回复于2025-08-17 14:15 来自浙江
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。