目录
一、HarmonyOS 开发基础：组件容器的概念
二、认识 AbilityStage 组件容器
（一）独特的对应关系
（二）核心功能
三、如何使用 AbilityStage 组件容器
（一）新建文件
（二）导入与继承
（三）配置文件
四、AbilityStage 的生命周期与事件回调
（一）onCreate () 生命周期回调
（二）onAcceptWant () 事件回调
（三）onConfigurationUpdated () 事件回调
（四）onMemoryLevel () 事件回调
五、总结
一、HarmonyOS 开发基础：组件容器的概念
在 HarmonyOS 开发的广阔天地里，组件容器是构建丰富用户界面的基石。简单来说，组件容器就像是一个 “超级收纳盒”，它能够容纳并组织各种组件，让它们按照特定的规则排列，从而形成我们在应用中看到的各种页面布局。
想象一下，你正在搭建一座房子，组件就是房子里的各种家具和装饰，而组件容器则是划分房间、规划空间布局的结构框架。它决定了各个组件的摆放位置、排列顺序以及相互之间的关系，确保整个界面既美观又实用。
在 HarmonyOS 中，组件容器发挥着举足轻重的作用。它是实现页面布局多样化和灵活性的关键，无论是简单的登录界面，还是复杂的多页面应用，都离不开组件容器的支持。通过合理运用组件容器，开发者可以轻松应对不同设备屏幕尺寸和分辨率的挑战，确保应用在各种终端上都能呈现出最佳的视觉效果和用户体验 。例如，在手机端，组件容器可以将各个组件紧凑而有序地排列，充分利用有限的屏幕空间；而在平板或大屏设备上，又能根据屏幕的宽敞程度，调整组件的布局，使其更加舒展和大气。
二、认识 AbilityStage 组件容器
（一）独特的对应关系
在 HarmonyOS 应用开发中，AbilityStage 与 Module 之间存在着紧密且一一对应的关系。一个 Module 就如同一个独立的功能模块，而每个 Module 都拥有且仅拥有一个 AbilityStage 。这种对应关系就像是为每个功能模块量身定制了一个专属的 “舞台管理者”，使得每个 Module 中的组件和功能能够在这个特定的 “舞台” 上有序地展示和运行。
以一个电商应用为例，商品展示模块、购物车模块、用户管理模块等都可以看作是独立的 Module。每个 Module 都有自己的 AbilityStage，商品展示模块的 AbilityStage 负责管理商品展示页面的生命周期、事件处理和布局等；购物车模块的 AbilityStage 则专注于购物车页面相关的管理工作。这样清晰的对应关系，使得应用的架构更加模块化、层次化，便于开发者进行代码的组织和维护，也提高了代码的可复用性和可扩展性。
（二）核心功能
生命周期管理：AbilityStage 对 Ability 的生命周期管理涵盖了多个关键阶段，包括创建（onCreate）、启动（onStart）、暂停（onPause）、恢复（onResume）和销毁（onDestroy）等。当应用启动时，AbilityStage 首先触发 Ability 的 onCreate 回调，开发者可以在此进行一些初始化操作，比如加载数据、初始化网络连接等；当页面切换到后台时，onPause 回调被触发，此时可以暂停一些不必要的操作，如动画播放、传感器数据采集等，以节省系统资源；当页面重新回到前台时，onResume 回调让应用恢复之前暂停的操作，确保页面能够正常响应用户的交互。通过对这些生命周期阶段的精细管理，AbilityStage 确保了页面在各种状态下都能正常运行，为用户提供流畅的使用体验。
强大的导航能力：AbilityStage 提供了便捷的页面切换和跳转功能，这在构建多页面应用时尤为重要。它支持通过多种方式进行页面导航，比如使用显式意图（Explicit Intent）明确指定要跳转的目标页面，或者通过隐式意图（Implicit Intent）根据系统定义的动作和数据类型来匹配合适的页面进行跳转。在一个新闻应用中，当用户点击新闻列表中的某条新闻时，AbilityStage 可以通过导航功能快速跳转到新闻详情页面，并将新闻的相关信息传递过去；当用户想要返回上一级页面时，AbilityStage 也能准确地处理返回操作，让用户轻松在不同页面之间切换，这种强大的导航能力极大地提升了应用的交互性和用户体验。
全面的事件处理：AbilityStage 能够处理应用中的各种事件，如触摸事件、按键事件、手势事件等。当用户在屏幕上进行触摸操作时，AbilityStage 会捕获到触摸事件，并将其分发给相应的组件进行处理。在一个绘图应用中，用户通过触摸屏幕绘制图形，AbilityStage 可以精确地捕获触摸点的位置、移动轨迹等信息，并将这些信息传递给绘图组件，从而实现流畅的绘图功能。对于按键事件，AbilityStage 也能根据不同的按键操作执行相应的逻辑，比如在游戏应用中，用户通过按键控制角色的移动、攻击等动作，AbilityStage 能够及时响应这些按键事件，保证游戏的流畅运行。通过对各种事件的有效处理，AbilityStage 增强了应用的交互性，使用户能够更加自然地与应用进行交互。
灵活的布局管理：根据应用的布局要求，AbilityStage 可以对 Ability 中的组件进行灵活的布局管理。它支持多种布局方式，如线性布局（LinearLayout）、相对布局（RelativeLayout）、网格布局（GridLayout）等，开发者可以根据页面的设计需求选择合适的布局方式。在一个音乐播放应用中，播放界面可能采用线性布局来排列歌曲信息、播放进度条和控制按钮等组件，使得界面简洁明了；而在设置界面，可能会使用相对布局来灵活地定位各个设置项，充分利用屏幕空间。AbilityStage 还支持动态布局，根据设备的屏幕尺寸、分辨率和方向等因素自动调整组件的布局，确保应用在不同设备上都能呈现出最佳的视觉效果，为用户提供一致的使用体验。
三、如何使用 AbilityStage 组件容器
（一）新建文件
在使用 AbilityStage 组件容器时，首先需要在工程中创建相关文件。打开 DevEco Studio 开发工具，找到工程 Module 对应的 ets 目录 。在该目录上右键点击，选择 “New -> Directory”，此时会弹出新建目录的对话框，在对话框中输入 “myabilitystage” 作为目录名称，然后点击确定，这样就成功新建了一个名为 myabilitystage 的目录。
接着，进入刚创建的 myabilitystage 目录，再次右键点击，选择 “New -> TypeScript File”，在弹出的新建文件对话框中，将文件命名为 “MyAbilityStage.ts” 。这个文件将用于定义和配置 AbilityStage 相关的逻辑和功能，通过这种方式创建的文件结构清晰，便于管理和维护代码，为后续使用 AbilityStage 组件容器奠定了基础。
（二）导入与继承
当我们创建好 “MyAbilityStage.ts” 文件后，就需要在文件中导入 AbilityStage 的依赖包。在文件开头，使用以下代码导入：
import AbilityStage from '@ohos.app.ability.AbilityStage';
import type Want from '@ohos.app.ability.Want';
通过这两行代码，我们引入了 HarmonyOS 中定义的 AbilityStage 类以及 Want 类型。AbilityStage 类是我们要使用的组件容器的核心类，而 Want 类型则用于处理页面跳转和意图传递等相关操作 。
接下来，我们需要自定义一个类来继承 AbilityStage，代码如下：
export default class MyAbilityStage extends AbilityStage {
onCreate(): void {
// 应用的HAP在首次加载的时，为该Module初始化操作
}
onAcceptWant(want: Want): string {
// 仅specified模式下触发
return 'MyAbilityStage';
}
}
在这个自定义类MyAbilityStage中，我们继承了 AbilityStage 类，从而获得了它的所有属性和方法。然后，我们重写了onCreate和onAcceptWant两个方法。onCreate方法在应用的 HAP 首次加载时触发，我们可以在这个方法中进行一些初始化操作，比如加载资源、初始化数据等；onAcceptWant方法则在 UIAbility 指定实例模式（specified）启动时触发，它接收一个Want类型的参数，用于处理启动时的意图传递，这里我们简单返回一个字符串，表示当前的 AbilityStage 实例 。通过这种导入和继承的方式，我们能够根据应用的具体需求，对 AbilityStage 进行定制化的开发和配置。
（三）配置文件
在完成上述代码编写后，还需要在 module.json5 配置文件中进行相应的配置。打开 module.json5 文件，找到 “module” 字段，在其中添加 “srcEntry” 参数，代码示例如下：
{
"module": {
"name": "entry",
"type": "entry",
"srcEntry": "./ets/myabilitystage/MyAbilityStage.ts",
// 其他配置项...
}
}
这里的 “srcEntry” 参数指定了模块对应的代码路径，即我们刚刚创建的 “MyAbilityStage.ts” 文件的路径。通过这样的配置，当 HAP 加载时，系统会根据这个路径找到对应的 AbilityStage 实例，并进行初始化和启动等操作 。这个配置是连接代码实现和应用运行的关键步骤，确保了 AbilityStage 能够正确地被加载和使用，使得应用的各个模块能够按照预期的方式协同工作。
四、AbilityStage 的生命周期与事件回调
（一）onCreate () 生命周期回调
在 HarmonyOS 应用开发中，onCreate() 生命周期回调是一个至关重要的环节。当应用的 HAP 首次加载时，在开始加载对应 Module 的第一个 UIAbility 实例之前，系统会先创建 AbilityStage ，并在 AbilityStage 创建完成之后立即执行其onCreate()生命周期回调。
这个回调就像是应用启动时的 “初始化哨声”，开发者可以在这个阶段进行一系列关键的初始化操作。比如，进行资源预加载，将应用运行过程中需要用到的图片、音频、视频等资源提前加载到内存中，这样在后续使用时就能够快速响应，减少用户等待的时间，提升应用的流畅度。以一个图片浏览应用为例，在onCreate()中预加载一些常用的图片资源，当用户打开应用查看图片时，就能迅速加载出图片，而不会出现长时间的空白等待界面 。
此外，创建线程也是常见的操作之一。如果应用有一些耗时较长的任务，如数据处理、网络请求等，为了避免阻塞主线程，影响用户界面的响应速度，可以在onCreate()中创建新的线程来执行这些任务。比如在一个电商应用中，在应用启动时需要从服务器获取商品数据，就可以创建一个新线程来进行网络请求获取数据，而主线程则可以继续处理其他界面相关的操作，保证应用的交互性 。
（二）onAcceptWant () 事件回调
onAcceptWant() 事件回调有着特定的触发条件，它仅在 UIAbility 指定实例模式（specified）启动时才会被触发 。当采用这种启动模式时，在 Ability 实例创建之前，开发者可以为该实例创建一个唯一的字符串 Key ，创建的 Ability 实例会绑定这个 Key。后续每次调用 startAbility () 方法时，都会询问应用使用哪个 Key 对应的 Ability 实例来响应 startAbility 请求。
在这种情况下，onAcceptWant()回调就发挥了重要作用。它接收一个Want类型的参数，这个参数包含了启动 Ability 的相关信息，比如启动的意图、传递的数据等。开发者可以在这个回调中根据Want中的信息来决定如何处理启动请求，例如判断是否需要创建新的 Ability 实例，还是复用已有的实例 。该回调有一个返回值，这个返回值是一个字符串，它通常用于标识当前处理启动请求的 AbilityStage 实例，方便系统和应用进行后续的管理和操作。
（三）onConfigurationUpdated () 事件回调
onConfigurationUpdated() 事件回调主要在系统全局配置发生变更时触发。在 HarmonyOS 系统中，有许多配置项会影响应用的运行和展示效果，比如系统语言的切换、深浅色模式的改变等，这些配置项目前均定义在 Configuration 类中 。
当系统语言发生变化时，应用可能需要根据新的语言设置来加载对应的语言资源，更新界面上的文字显示，以确保用户看到的是符合其语言习惯的内容。在一个国际化的社交应用中，用户将系统语言从中文切换到英文时，应用通过onConfigurationUpdated()回调检测到语言变更，然后加载英文语言包，将界面上的菜单、提示信息、聊天记录等文字内容都更新为英文显示 。
对于深浅色模式的变化，应用同样需要做出响应。在深色模式下，应用的界面颜色、图标样式等可能需要进行调整，以适应深色背景，提高用户的视觉舒适度。当系统切换到深色模式时，onConfigurationUpdated()回调被触发，应用可以根据这个回调来修改界面的主题颜色，将白色背景改为深色背景，将亮色图标替换为适配深色模式的暗色图标，为用户提供更好的视觉体验 。
（四）onMemoryLevel () 事件回调
onMemoryLevel() 事件回调是在系统调整内存时触发的。在日常使用手机等设备时，我们经常会打开多个应用，当应用被切换到后台时，系统会将在后台的应用保留在缓存中。然而，即使应用处于缓存中，也会占用一定的系统内存资源，从而影响系统整体性能 。
当系统资源不足时，为了保证关键任务的正常运行，系统会通过多种方式从应用中回收内存，在极端情况下甚至会完全停止应用 。为了避免应用进程被系统停止，影响用户体验，开发者可以在 AbilityStage 中的onMemoryLevel()生命周期回调中订阅系统内存的变化情况 。
系统内存状态分为不同级别，如MEMORY_LEVEL_MODERATE表示系统内存适中，此时系统可能会开始根据 LRU（最近最少使用）缓存规则杀死进程；MEMORY_LEVEL_LOW表示系统内存比较低，此时应用应该释放一些不必要的资源，如暂时不用的图片缓存、闲置的网络连接等，以提升系统的性能；MEMORY_LEVEL_CRITICAL则表示系统内存很低，应用应当尽可能地释放任何不必要的资源，因为系统可能会杀掉所有缓存中的进程，并且开始杀掉应当保持运行的进程，比如后台运行的服务 。
在一个视频播放应用中，当检测到系统内存处于MEMORY_LEVEL_LOW时，应用可以在onMemoryLevel()回调中释放当前未播放视频的缓存数据，关闭一些暂时不用的线程，如视频预加载线程等，从而减少内存占用，确保应用在低内存环境下仍能稳定运行，避免被系统强制停止 。
五、总结
在 HarmonyOS 应用开发的奇妙世界里，AbilityStage 组件容器无疑是一颗璀璨的明星。它以独特的对应关系、强大的核心功能，为开发者搭建起了构建优质应用的坚实桥梁。从新建文件时的精心布局，到导入与继承时的代码雕琢，再到配置文件时的精准把控，每一个使用步骤都蕴含着 HarmonyOS 开发的精髓。
其丰富的生命周期与事件回调，更是为应用的稳定运行和灵活交互提供了有力保障。无论是onCreate()中资源预加载的巧妙安排，还是onAcceptWant()对启动请求的精准处理，亦或是onConfigurationUpdated()对系统配置变更的及时响应，以及onMemoryLevel()在内存管理中的关键作用，都让我们看到了 AbilityStage 组件容器的强大与灵活。
希望各位开发者能够深入理解并熟练运用 AbilityStage 组件容器，在 HarmonyOS 应用开发的道路上，创造出更多精彩、流畅且富有创新性的应用，为 HarmonyOS 生态的繁荣贡献自己的力量 。
暂无评论内容