图解鸿蒙Page Ability的启动类型（LaunchType）

Myth丶恋晨 2022-12-29 14:09 13阅读 0赞

在Page Ability的配置信息（config.json文件）中有一个launchType属性，通过模板默认生成的值是standard，这是launchType属性的默认值（可以不设置launchType，这样默认值就是standard）。launchType属性的另外一个可以设置的值是singleton。这两个属性值的区别如下：

*  standard：在任何情况下，无论Page Ability被显示多少次，都会创建一个新的Page Ability实例；
 *  singleton：如果要显示的Page Ability在栈顶，那么再次显示这个Page Ability时，不会再创建新的Page Ability实例，而是直接使用这个Page Ability实例。如果Page Ability上面有其他的Page Ability，那么首先弹出这些Page Ability，然后再重用这个Page Ability。总之，拥有singleton模式的Page Ability将永远使用唯一的实例；

这里涉及到一个栈的概念，这是HarmonyOS管理Page Ability的模式。HarmonyOS App同时只能显示一个Page Ability，那么哪一个Page Ability才能显示呢？HarmonyOS App会使用一个栈来管理App中所有的Page Ability，只有在栈顶的Page Ability才会显示。如果要想让栈中第2个Page Ability显示，那么栈顶的Page Ability就必须出栈，也就是销毁Page Ability，也就是调用terminateAbility方法要完成的工作。

下面用图示来说明这一过程。图1中每一个矩形区域表示App中当前用于保存Page Ability的栈。1中只有一个Page Ability1，如果让Page Ability2显示，那么Page Ability2必须压栈，Page Ability3显示也需要完成同样的工作。在3的状态中，如果让Page Ability2显示，那么Page Ability3必须出栈，就形成了4中栈的状态。

![format_png][]

图1

现在假设Page Ability1的launchType属性值是standard，那么从Page Ability1中启动Page Ability1，如果启动2次，就会再创建两个Page Ability1实例，这时栈的状态如图2所示。

![format_png 1][]

图2

很明显，在栈中有3个Page Ability1实例。

如果Page Ability1的launchType属性值是singleton，那么不管显示多少次Page Ability1，在栈中永远只有1个Page Ability1实例。所以如果想让某一个Page Ability1永远只有一个实例的时候，可以将该Page Ability的launchType属性值设为singleton。

下面通过一个案例来演示standard和singleton的区别。

首先创建一个名为LaunchTypeAbility的Page Ability，并编写下面的代码：

package com.unitymarvel.demo.ability;
     
    import com.unitymarvel.demo.ResourceTable;
    import ohos.aafwk.ability.Ability;
    import ohos.aafwk.content.Intent;
    import ohos.agp.components.Button;
    import ohos.agp.components.Component;
    import ohos.agp.components.Text;
     
     
    public class LaunchTypeAbility extends Ability {
        private static int count = 0;   // 计数器
        @Override
        public void onStart(Intent intent) {
            super.onStart(intent);
            super.setUIContent(ResourceTable.Layout_launch_type_layout);
            count++;
            Text text = (Text)findComponentById(ResourceTable.Id_text);
            if(text != null) {
                text.setText(String.valueOf(count));
            }
            Button buttonStartAbility = (Button)findComponentById(ResourceTable.Id_button_start_ability);
            if(buttonStartAbility != null) {
                buttonStartAbility.setClickedListener(new Component.ClickedListener() {
                    @Override
                    public void onClick(Component component) {
                        Intent intent = new Intent();
                        intent.setAction("action.harmonyos.demo.ability.testlaunchtype");
                        // 显示另外一个Page Ability
                        startAbility(intent);
                    }
                });
            }
        }
    }

在config.json文件中配置LaunchTypeAbility，代码如下：

{
        "skills": [
          {
            "actions": [
              "action.harmonyos.demo.ability.launchtype"
            ]
          }
        ],
        "orientation": "landscape",
        "formEnabled": false,
        "name": "com.unitymarvel.demo.ability.LaunchTypeAbility",
        "icon": "$media:icon",
        "label": "Page Ability的启动类型",
        "type": "page",
        "launchType": "standard"
      }

这里将LaunchTypeAbility的launchType属性值设为standard。

然后再创建另外一个名为TestLaunchTypeAbility的Page Ability，代码如下：

package com.unitymarvel.demo.ability;
     
    import com.unitymarvel.demo.ResourceTable;
    import ohos.aafwk.ability.Ability;
    import ohos.aafwk.content.Intent;
    import ohos.agp.components.Button;
    import ohos.agp.components.Component;
    import ohos.agp.components.Text;
     
     
    public class TestLaunchTypeAbility extends Ability {
     
        @Override
        public void onStart(Intent intent) {
            super.onStart(intent);
            super.setUIContent(ResourceTable.Layout_launch_type_layout);
     
            Button buttonStartAbility =
                     (Button)findComponentById(ResourceTable.Id_button_start_ability);
            if(buttonStartAbility != null) {
                buttonStartAbility.setClickedListener(new Component.ClickedListener() {
                    @Override
                    public void onClick(Component component) {
                        Intent intent = new Intent();
                        intent.setAction("action.harmonyos.demo.ability.launchtype");
                        // 显示LaunchTypeAbility
                        startAbility(intent);
                    }
                });
            }
        }
    }

本例包含两个Page Ability：LaunchTypeAbility和TestLaunchTypeAbility。目前这两个Page Ability的launchType属性值都是standard。这两个Page Ability的关系是LaunchTypeAbility显示TestLaunchTypeAbility，然后TestLaunchTypeAbility再显示LaunchTypeAbility，如图3所示。

![format_png 2][]

图3

在LaunchTypeAbility类中有一个静态变量count，如果每次显示LaunchTypeAbility时都创建一个新的实例，那么count会不断加1，例如，如果显示3次LaunchTypeAbility，应该看到如图4所示的窗口。

![format_png 3][]

图4

如果将LaunchTypeAbility的launchType属性值改成singleton，那么不管显示多少次LaunchTypeAbility，计数器count的值永远是1，如图5所示。因为LaunchTypeAbility在创建一个实例后，就不会再创建新的LaunchTypeAbility实例了，所以onStart方法自然就不会再次调用了。

![format_png 4][]

图5

\- EOF -

推荐阅读  点击标题可跳转

[鸿蒙IDE（DevEco Studio）怎样1秒下载Gradle][IDE_DevEco Studio_1_Gradle]

[特大喜讯！鸿蒙项目来了：在线电子词典][Link 1]

[【喜讯、喜讯】期待已久的鸿蒙IDE macOS版终于发布了！][IDE macOS]

[【直播回放】独家传授：成为Python高手的武功秘籍][Python]

[调试鸿蒙（HarmonyOS）App源代码的两种方式][HarmonyOS_App]

[开发跨设备的鸿蒙（HarmonyOS） App][HarmonyOS_ App]

[鸿蒙（HarmonyOS）大神都喜欢玩命令行][HarmonyOS]

关注「极客起源」公众号，加星标，不错过精彩技术干货

[format_png]: /images/20221120/d17d10374f954e0a8906e13fd8d890c0.png
[format_png 1]: /images/20221120/1c0b373d7e53493a9ec69891924b10d0.png
[format_png 2]: /images/20221120/ef102abe53814f94b5af7d642720f25a.png
[format_png 3]: /images/20221120/d2ddbd64115840b99d1a1fd71d41f83f.png
[format_png 4]: /images/20221120/933e6b3a5d7f47ffa8fc20c139a7951f.png
[IDE_DevEco Studio_1_Gradle]: http://mp.weixin.qq.com/s?__biz=MjM5MzU1NzQwMQ%3D%3D&chksm=bd693e0f8a1eb719f3c117a4ac2e09b5b85c6a0c495382d55f4fd3abf2262476715c51dc4876&idx=1&mid=2651365625&scene=21&sn=db9474db497431a5b4b36f555cb78d23#wechat_redirect
[Link 1]: http://mp.weixin.qq.com/s?__biz=MjM5MzU1NzQwMQ%3D%3D&chksm=bd693e198a1eb70f1c545a366a15580a5bf1ec627994a901c621472eba1b834f371bd5726243&idx=1&mid=2651365615&scene=21&sn=0ed24184fc154261b845c3e3bc635250#wechat_redirect
[IDE macOS]: http://mp.weixin.qq.com/s?__biz=MjM5MzU1NzQwMQ%3D%3D&chksm=bd693e288a1eb73ee194a7190813e987560009a1b51877bfd562f6213281bdf0763850449271&idx=1&mid=2651365598&scene=21&sn=93b864739de5415aadbe5a65d1b34902#wechat_redirect
[Python]: http://mp.weixin.qq.com/s?__biz=MjM5MzU1NzQwMQ%3D%3D&chksm=bd693e258a1eb733475ffdb3fd5508cad62ac9125e6a371e2be286f8c316508737d1855ac818&idx=1&mid=2651365587&scene=21&sn=ac0e51ce94832ad532574baf4ea02e97#wechat_redirect
[HarmonyOS_App]: http://mp.weixin.qq.com/s?__biz=MjM5MzU1NzQwMQ%3D%3D&chksm=bd693e318a1eb7278af9ec6bed1c8f7a310aaee8e3643aa01acb1103347fb704eaeee7077da6&idx=1&mid=2651365575&scene=21&sn=8c484d10d71c0ba154b5d4e804d5db8b#wechat_redirect
[HarmonyOS_ App]: http://mp.weixin.qq.com/s?__biz=MjM5MzU1NzQwMQ%3D%3D&chksm=bd693e478a1eb751a454ff12ffdce85e0744a5d25fa353640d337f76d2ce558e609a61d976ed&idx=1&mid=2651365553&scene=21&sn=2bbe31e0e06f3cbe06d89d00d15b6b77#wechat_redirect
[HarmonyOS]: http://mp.weixin.qq.com/s?__biz=MjM5MzU1NzQwMQ%3D%3D&chksm=bd693e698a1eb77f2a5af6a3b9672583a375b8915a2226e9e21335548f7312e5a7b0a7464e26&idx=1&mid=2651365535&scene=21&sn=3d6144fa97fd00eb1cae84896bd67c7d#wechat_redirect