
个人主页杨利杰YJlio❄️个人专栏《Windows 疑难杂症与工单复盘案例库》 《Sysinternals实战教程》《WINDOWS教程》 《Windows PowerShell 实战》 《IOS插件分析测试》《超简单用Python让Excel飞起来》让复杂的事情更简单让重复的工作自动化文章目录前言启动入口、窗口和页面要分开看一、用四个角色建立职责地图二、先读当前模板的 EntryAbility三、沿模板找到窗口与首个页面的联系四、初始化位置先问三个问题五、分清日志、画面和异步结果六、在现有回调中添加少量日志七、比较三种操作的实际现象八、入口和日志问题怎么排查学习总结参考资料前言启动入口、窗口和页面要分开看大家好我是杨利杰 YJlio。上一篇找到了EntryAbility.ets这篇继续沿着模板阅读应用入口。我想弄清楚组件创建阶段做什么窗口在哪里管理首个页面由哪段代码加载。这是 HarmonyOS 7.0 学习笔记第 03 篇。我的练习方法是先读当前模板再在已有回调里增加少量日志同时观察设备画面。冷启动、恢复和窗口重建可能涉及不同路径具体结果需要实测记录。日志出现只能证明执行到该位置不能直接证明页面绘制或异步数据加载完成。环境项本次实际记录DevEco Studio 版本待填写HarmonyOS SDK/API待填写目标设备与系统版本待填写观察对象当前模板的EntryAbility.ets、页面入口和日志窗口本文图片为职责与操作方法示意图不预先填写本机日志和运行结果。一、用四个角色建立职责地图我会先区分 AbilityStage、UIAbility、WindowStage 和页面组件的作用再查看它们在本机模板中的具体位置。角色入门时先理解的作用AbilityStage与模块中代码首次加载相关的运行入口UIAbility应用组件与对应生命周期EntryAbility通常是模板中的实现WindowStage应用进程内的窗口管理对象涉及主窗口管理页面组件描述 UI 与交互加载后呈现在窗口中华为的Stage 模型说明介绍了 AbilityStage 与 HAP 的关联以及 UIAbility 通过 WindowStage 持有主窗口的关系。本文用职责卡片帮助阅读不把四个角色排列成固定的回调执行时间表。二、先读当前模板的 EntryAbility打开EntryAbility.ets后先看继承关系和模板已有的回调再记录方法名、参数与关键调用。我会记录三类信息哪些方法已经重写、每个方法做了什么、页面加载调用位于哪个回调中。初次阅读先保留模板避免整段覆盖入口文件。阅读线索需要记录的内容继承关系当前类继承的基类及已有导入创建相关回调方法名、参数类型与已有初始化窗口相关回调窗口对象、页面加载调用及错误处理三、沿模板找到窗口与首个页面的联系阅读时可以沿“组件创建相关逻辑—窗口创建相关逻辑—页面加载调用”寻找代码位置。这里表达的是阅读路径实际回调现象仍以设备上的操作记录为准。在常见 Stage 模板中会在窗口创建相关回调中加载首个页面。官方窗口生命周期文档说明UIAbility 通过 WindowStage 管理主窗口主窗口是 ArkUI 的绘制区域。下面只是阅读标记不是可以覆盖工程文件的完整 ArkTS 代码EntryAbility 继承 UIAbility 创建相关回调查看已有的初始化工作 窗口创建相关回调寻找首个页面加载调用 页面组件查看实际 UI 与交互声明具体导入、方法签名、参数类型和页面加载接口应按当前模板与 SDK 文档核对。四、初始化位置先问三个问题找到创建回调以后我不会把所有初始化都集中放进去而是先判断工作的归属、重复执行的后果和耗时。问题与代码位置的关系属于应用、模块、窗口还是页面确认职责和对象生命周期重建时会不会再次执行判断是否需要安全的重复执行逻辑是否耗时或影响首屏避免把长任务直接堆在启动路径中初学阶段先做轻量、可重复的实验。网络请求和数据库初始化留到后续对应章节再结合具体生命周期与异常处理安排。不要假设某个初始化回调永远只执行一次先记录组件重建、窗口重建和页面显示各自的现象。五、分清日志、画面和异步结果日志、首屏呈现和数据任务完成是不同的观察信号需要分别记录。一条“进入回调”的日志可以证明代码执行到了该位置却不能替代设备画面或数据校验。页面已经出现时后台任务仍可能继续日志输出顺序也不足以推断全部 UI 行为。我会分别记录入口回调、关键任务完成和设备画面的表现。这样看到“日志晚到”或“页面显示但数据没加载”时能更准确地描述现象。六、在现有回调中添加少量日志实际实验只在模板已有的创建相关回调和窗口相关回调中添加观察点。使用一个容易筛选的唯一标签例如YJlioStageDemo。下面给出日志内容示例。它们保持注释形式实际插入时先核对当前工程的hilog导入、domain、日志等级与参数用法// 在模板已有回调的方法体中按当前SDK写法添加// hilog.info(DOMAIN, YJlioStageDemo, %{public}s, Ability created);// hilog.info(DOMAIN, YJlioStageDemo, %{public}s, Window stage created);本次不新增空生命周期方法不修改页面路由也不把注释当成已经编译验证的代码。先用少量日志建立最小观察点再看结果是否支持自己的判断。七、比较三种操作的实际现象我的实验会分别观察首次启动、退出后重新启动和前后台切换记录日志与设备状态。保存工程当前状态记录模板已有回调。在已有回调方法体中添加少量日志。构建并运行分别观察日志窗口和设备画面。退出后重新启动再做前后台切换记录每次操作。实验结束后移除临时日志再次构建检查。操作实际日志实际画面设备状态首次启动待填写待填写待填写退出后重新启动待填写待填写待填写前后台切换待填写待填写待填写观察表必须来自实际操作不预先填入固定的回调顺序或“启动成功”。八、入口和日志问题怎么排查出现问题时先检查当前模块与启动路径再处理过滤条件、模板差异或重复初始化。现象先检查什么模板没有教程里的回调当前 SDK 生命周期文档以及是否确实需要重写该阶段日志没出现运行工程和模块、日志等级、标签拼写、当前启动路径页面出现但日志稍晚分开记录画面、日志输出和异步任务不混为同一事件返回应用时初始化再次出现区分 Ability 创建、窗口创建和页面展示再判断工作归属一次只改一个观察点保留完整日志和操作步骤。需要持久化或创建资源时应考虑重复调用的影响本篇先记录现象不直接给后续业务初始化下结论。学习总结这篇从四个角色的职责出发阅读模板入口并用日志观察启动路径。我的重点是保留模板、设置明确观察点再把日志与设备画面分别记录。完成实际操作后补齐工具版本、日志截图和观察表。下一篇学习 ArkTS 变量、基础类型与类型推导用具体字段表达页面数据。参考资料华为开发者联盟Stage 模型开发概述华为开发者文档窗口生命周期华为开发者文档UIAbilityContext声明本文为学习方法与模板阅读笔记配图为示意信息图生命周期、参数和运行现象以当前模板、实际设备与官方文档为准。返回顶部