【鴻蒙基地】鴻蒙從窗口開始：Page Ability誕生記

作者：蒙娜麗寧 2021-01-12 09:42:05

Page Ability是FA唯一支持的Ability，本質上是一個窗口，類似于Android的Activity，用于提供與用戶交互的能力。為了方便，在后面的內容就將Page Ability簡稱為Page。

https://harmonyos.51cto.com/#zz

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的關系。

圖1 Page與AbilitySlice的關系

如果在Page中使用多個AbilitySlice，那么這些AbilitySlice提供的業務能力應高度相關。下面是一個典型的應用場景：

在線視頻播放器的主界面可以用一個Page來實現，在主界面中包含了兩個AbilitySlice：一個AbilitySlice用于展示視頻列表，另一個AbilitySlice用于播放視頻。

在DevEco Studio中創建HarmonyOS工程時，IDE會提供一些Page模板，如圖2所示。通過這些Page模板，可以生成HarmonyOS工程的骨架代碼，其中會包含一些簡單的例子，相當于HelloWorld。

圖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的最終形式如下：

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的配置代碼如下：

在創建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文件，并輸入下面的代碼：

關于布局的更多內容在后面的章節會詳細討論，這里只要知道，first_layout.xml文件中使用了方向布局，而且是垂直方向。在垂直方向上從上到下放置了3個組件，分別是Button1、Text和Button2。

5. 裝載布局文件

創建完布局文件后，需要與Page Ability關聯才能顯示布局中的組件。通常需要在Page Ability啟動時裝載布局文件，這就要使用到Page Ability的生命周期方法onStart，該方法會在Page Ability開始時調用，通常在onStart方法中做一些初始化的工作，例如，為組件指定事件監聽器。

現在需要在FirstAbility類中添加一個onStart方法，并使用super.setUIContent方法裝載布局文件，代碼如下：

在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部分，將其改成如下形式：

但要主要，可能在config.json文件中還有其他Page Ability的actions也設為action.system.home。而HarmonyOS只會顯示在config.json文件中遇到的第一個主Ability。所以要么將FirstAbility的注冊信息調整為abilities的第1個元素，要么注釋掉其他的action.system.home。

如果想在其他的Page Ability中顯示FirstAbility，需要使用下面的代碼。