#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记 原创 精华

发布于 2021-1-5 10:42
浏览
17收藏

#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区

 1. Page Ability概述
Page Ability是FA唯一支持的Ability,本质上是一个窗口,类似于Android的Activity,用于提供与用户交互的能力。为了方便,在后面的内容就将Page Ability简称为Page。另外,HarmonyOS还提供了一个AbilitySlice。AbilitySlice的功能与Page类似,只是在切换时可以在同一个Page内完成。如果从Page到Page,相当于Web页面用新窗口导航到另一个页面。如果从AbilitySlice切换到AbilitySlice,相当于Web页面以同一个窗口的方式导航到另一个页面。


一个Page可以不使用AbilitySlice,也可以使用一个或多个AbilitySlice,在创建HarmonyOS工程时,生成的Demo代码中包含了一个默认的AbilitySlice(MainAbilitySlice.java)。图1 是Page和AbilitySlice的关系。
#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区图1 Page与AbilitySlice的关系


如果在Page中使用多个AbilitySlice,那么这些AbilitySlice提供的业务能力应高度相关。下面是一个典型的应用场景:
在线视频播放器的主界面可以用一个Page来实现,在主界面中包含了两个AbilitySlice:一个AbilitySlice用于展示视频列表,另一个AbilitySlice用于播放视频。


在DevEco Studio中创建HarmonyOS工程时,IDE会提供一些Page模板,如图2所示。通过这些Page模板,可以生成HarmonyOS工程的骨架代码,其中会包含一些简单的例子,相当于HelloWorld。
#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区 图2 创建HarmonyOS工程时的提供的Page模板


DevEco Studio提供了自动创建Page Ability的功能,在创建的过程中会自动向config.json文件中添加相应的配置信息。不过为了更深入理解Page Ability的创建和使用过程,本节将用纯手工的方式创建一个Page Ability。


2. 手动创建Page Ability类


Page Ability是一个普通的Java类,所以我们首先应该创建一个Java类,本例创建的Java类是FirstAbility。任何一个Page Ability类都必须从Ability类继承,该类属于ohos.aafwk.ability包,所以FirstAbility的最终形式如下:
#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区

3. 在config.json文件中注册Page Ability
在HarmonyOS App中,任何一个可用的Page Ability,都必须在config.json文件中注册。Page Ability需要在config.json文件中的abilities部分注册。abilities是一个对象数组,每一个元素是一个对象,表示一个Ability(包括Page Ability、Data Ability和Service Ability)。FirstAbility的配置代码如下:
#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区
在创建HarmonyOS工程时,IDE已经自动在config.json文件中添加了MainAbility的注册信息,读者可以照葫芦画瓢,将MainAbility的注册代码复制一份,然后略作修改。


这里主要修改了actions、name和label属性。actions表示一个或多个与Page Ability关联的动作,可以通过这些action来调用当前的Page Ability。name指定了Page Ability类的全名,本例是com.unitymarvel.demo.FirstAbility。label用于指定窗口的标题文本。


4. 创建布局文件
HarmonyOS App既可以用Java代码动态创建组件的方式布局,也可以使用布局文件。本例使用布局文件的方式进行布局,这也是我推荐的布局方式。因为使用Java代码创建复杂的布局非常困难,而且代码量比较大,代码难以维护。
HarmonyOS工程的所有布局文件都放在resources/base/layout目录中,现在创建一个first_layout.xml文件,并输入下面的代码:
#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区关于布局的更多内容在后面的章节会详细讨论,这里只要知道,first_layout.xml文件中使用了方向布局,而且是垂直方向。在垂直方向上从上到下放置了3个组件,分别是Button1、Text和Button2。


5. 装载布局文件
创建完布局文件后,需要与Page Ability关联才能显示布局中的组件。通常需要在Page Ability启动时装载布局文件,这就要使用到Page Ability的生命周期方法onStart,该方法会在Page Ability开始时调用,通常在onStart方法中做一些初始化的工作,例如,为组件指定事件监听器。
现在需要在FirstAbility类中添加一个onStart方法,并使用super.setUIContent方法装载布局文件,代码如下:
#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区在HarmonyOS App中,任何形式的资源都会与一个int类型的值绑定,以便通过该值引用资源,这些值都在ResourceTable类中以常量(static final形式的变量)形式存在。这些值都是自动生成的,通常以资源文件名作为变量名,前面加上前缀。布局文件的前缀是Layout。如本例的布局文件是first_layout.xml,所以生成的ID是Layout_first_layout。根据这个生成规则,要求资源文件的命名必须符合Java标识符的命名规则,否则无法在ResourceTable类中生成ID。


6. 显示Page Ability


到现在为止,一个最小的,而且是完整的Page Ability已经完成了,最后一步就是显示这个Page Ability。如果想让FirstAbility作为主Ability显示(HarmonyOS App运行后显示的第1个Page Ability),可以修改FirstAbility配置信息中的skills部分,将其改成如下形式:
#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区但要主要,可能在config.json文件中还有其他Page Ability的actions也设为action.system.home。而HarmonyOS只会显示在config.json文件中遇到的第一个主Ability。所以要么将FirstAbility的注册信息调整为abilities的第1个元素,要么注释掉其他的action.system.home。
如果想在其他的Page Ability中显示FirstAbility,需要使用下面的代码。

#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区不管使用哪种方式,FirstAbility的效果都会如图3所示。
#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区 图3 FirstAbility的显示效果


7. 销毁Page Ability


在Page Ability用完后,就需要关闭Page Ability,或称为销毁Page Ability,只需要调用下面的代码即可销毁Page Ability。

#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区该方法属于Ability,如果在AbilitySlice(在后面介绍)中调用该方法,需要先获得包含AbilitySlice的Ability对象。

欢迎访问李宁老师的【鸿蒙基地】专栏:https://harmonyos.51cto.com/column/17

李宁老师的课程主页:https://edu.51cto.com/lecturer/974126.html

 

#2020征文-TV#【鸿蒙基地】鸿蒙从窗口开始:Page Ability诞生记-开源基础软件社区

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
资料.zip 853B 93次下载
已于2021-1-23 10:35:02修改
21
收藏 17
回复
举报
回复
添加资源
添加资源将有机会获得更多曝光,你也可以直接关联已上传资源 去关联
    相关推荐