【鴻蒙基地】鴻蒙從窗口開始:Page Ability誕生記
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
https://harmonyos.51cto.com/#zz
1. Page Ability概述
Page Ability是FA唯一支持的Ability,本質(zhì)上是一個窗口,類似于Android的Activity,用于提供與用戶交互的能力。為了方便,在后面的內(nèi)容就將Page Ability簡稱為Page。另外,HarmonyOS還提供了一個AbilitySlice。AbilitySlice的功能與Page類似,只是在切換時可以在同一個Page內(nèi)完成。如果從Page到Page,相當(dāng)于Web頁面用新窗口導(dǎo)航到另一個頁面。如果從AbilitySlice切換到AbilitySlice,相當(dāng)于Web頁面以同一個窗口的方式導(dǎo)航到另一個頁面。
一個Page可以不使用AbilitySlice,也可以使用一個或多個AbilitySlice,在創(chuàng)建HarmonyOS工程時,生成的Demo代碼中包含了一個默認(rèn)的AbilitySlice(MainAbilitySlice.java)。圖1 是Page和AbilitySlice的關(guān)系。
圖1 Page與AbilitySlice的關(guān)系
如果在Page中使用多個AbilitySlice,那么這些AbilitySlice提供的業(yè)務(wù)能力應(yīng)高度相關(guān)。下面是一個典型的應(yīng)用場景:
在線視頻播放器的主界面可以用一個Page來實現(xiàn),在主界面中包含了兩個AbilitySlice:一個AbilitySlice用于展示視頻列表,另一個AbilitySlice用于播放視頻。
在DevEco Studio中創(chuàng)建HarmonyOS工程時,IDE會提供一些Page模板,如圖2所示。通過這些Page模板,可以生成HarmonyOS工程的骨架代碼,其中會包含一些簡單的例子,相當(dāng)于HelloWorld。
圖2 創(chuàng)建HarmonyOS工程時的提供的Page模板
DevEco Studio提供了自動創(chuàng)建Page Ability的功能,在創(chuàng)建的過程中會自動向config.json文件中添加相應(yīng)的配置信息。不過為了更深入理解Page Ability的創(chuàng)建和使用過程,本節(jié)將用純手工的方式創(chuàng)建一個Page Ability。
2. 手動創(chuàng)建Page Ability類
Page Ability是一個普通的Java類,所以我們首先應(yīng)該創(chuàng)建一個Java類,本例創(chuàng)建的Java類是FirstAbility。任何一個Page Ability類都必須從Ability類繼承,該類屬于ohos.aafwk.ability包,所以FirstAbility的最終形式如下:

3. 在config.json文件中注冊Page Ability
在HarmonyOS App中,任何一個可用的Page Ability,都必須在config.json文件中注冊。Page Ability需要在config.json文件中的abilities部分注冊。abilities是一個對象數(shù)組,每一個元素是一個對象,表示一個Ability(包括Page Ability、Data Ability和Service Ability)。FirstAbility的配置代碼如下:

在創(chuàng)建HarmonyOS工程時,IDE已經(jīng)自動在config.json文件中添加了MainAbility的注冊信息,讀者可以照葫蘆畫瓢,將MainAbility的注冊代碼復(fù)制一份,然后略作修改。
這里主要修改了actions、name和label屬性。actions表示一個或多個與Page Ability關(guān)聯(lián)的動作,可以通過這些action來調(diào)用當(dāng)前的Page Ability。name指定了Page Ability類的全名,本例是com.unitymarvel.demo.FirstAbility。label用于指定窗口的標(biāo)題文本。
4. 創(chuàng)建布局文件
HarmonyOS App既可以用Java代碼動態(tài)創(chuàng)建組件的方式布局,也可以使用布局文件。本例使用布局文件的方式進(jìn)行布局,這也是我推薦的布局方式。因為使用Java代碼創(chuàng)建復(fù)雜的布局非常困難,而且代碼量比較大,代碼難以維護(hù)。
HarmonyOS工程的所有布局文件都放在resources/base/layout目錄中,現(xiàn)在創(chuàng)建一個first_layout.xml文件,并輸入下面的代碼:
關(guān)于布局的更多內(nèi)容在后面的章節(jié)會詳細(xì)討論,這里只要知道,first_layout.xml文件中使用了方向布局,而且是垂直方向。在垂直方向上從上到下放置了3個組件,分別是Button1、Text和Button2。
5. 裝載布局文件
創(chuàng)建完布局文件后,需要與Page Ability關(guān)聯(lián)才能顯示布局中的組件。通常需要在Page Ability啟動時裝載布局文件,這就要使用到Page Ability的生命周期方法onStart,該方法會在Page Ability開始時調(diào)用,通常在onStart方法中做一些初始化的工作,例如,為組件指定事件監(jiān)聽器。
現(xiàn)在需要在FirstAbility類中添加一個onStart方法,并使用super.setUIContent方法裝載布局文件,代碼如下:
在HarmonyOS App中,任何形式的資源都會與一個int類型的值綁定,以便通過該值引用資源,這些值都在ResourceTable類中以常量(static final形式的變量)形式存在。這些值都是自動生成的,通常以資源文件名作為變量名,前面加上前綴。布局文件的前綴是Layout。如本例的布局文件是first_layout.xml,所以生成的ID是Layout_first_layout。根據(jù)這個生成規(guī)則,要求資源文件的命名必須符合Java標(biāo)識符的命名規(guī)則,否則無法在ResourceTable類中生成ID。
6. 顯示Page Ability
到現(xiàn)在為止,一個最小的,而且是完整的Page Ability已經(jīng)完成了,最后一步就是顯示這個Page Ability。如果想讓FirstAbility作為主Ability顯示(HarmonyOS App運行后顯示的第1個Page Ability),可以修改FirstAbility配置信息中的skills部分,將其改成如下形式:
但要主要,可能在config.json文件中還有其他Page Ability的actions也設(shè)為action.system.home。而HarmonyOS只會顯示在config.json文件中遇到的第一個主Ability。所以要么將FirstAbility的注冊信息調(diào)整為abilities的第1個元素,要么注釋掉其他的action.system.home。
如果想在其他的Page Ability中顯示FirstAbility,需要使用下面的代碼。
不管使用哪種方式,F(xiàn)irstAbility的效果都會如圖3所示。
圖3 FirstAbility的顯示效果
7. 銷毀Page Ability
在Page Ability用完后,就需要關(guān)閉Page Ability,或稱為銷毀Page Ability,只需要調(diào)用下面的代碼即可銷毀Page Ability。
該方法屬于Ability,如果在AbilitySlice(在后面介紹)中調(diào)用該方法,需要先獲得包含AbilitySlice的Ability對象。
歡迎訪問李寧老師的【鴻蒙基地】專欄:https://harmonyos.51cto.com/column/17
李寧老師的課程主頁:https://edu.51cto.com/lecturer/974126.html
©著作權(quán)歸作者和HarmonyOS技術(shù)社區(qū)共同所有,如需轉(zhuǎn)載,請注明出處,否則將追究法律責(zé)任
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
https://harmonyos.51cto.com/#zz