HarmonyOS鸿蒙Next之Ability07——理解HarmonyOS鸿蒙Next Intent

HarmonyOS鸿蒙Next之Ability07——理解HarmonyOS鸿蒙Next Intent 在HarmonyOS中，Intent是对象之间传递信息的载体。例如，当一个Ability需要启动另一个Ability时，或者一个AbilitySlice需要导航到另一个AbilitySlice时，可以通过Intent指定启动的目标同时携带相关数据。

Intent的构成元素包括Operation与Parameters。

5.12.1 Operation与Parameters

Operation由下表5-1所示的属性组成。

表5-1 Operation属性

属性	描述
Action	表示动作，通常使用系统预置Action，应用也可以自定义Action。例如IntentConstants.ACTION_HOME表示返回桌面动作。
Entity	表示类别，通常使用系统预置Entity，应用也可以自定义Entity。例如Intent.ENTITY_HOME表示在桌面显示图标。
Uri	表示Uri描述。如果在Intent中指定了Uri，则Intent将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。
Flags	表示处理Intent的方式。例如Intent.FLAG_ABILITY_CONTINUATION标记在本地的一个Ability是否可以迁移到远端设备继续运行。
BundleName	表示包描述。如果在Intent中同时指定了BundleName和AbilityName，则Intent可以直接匹配到指定的Ability。
AbilityName	表示待启动的Ability名称。如果在Intent中同时指定了BundleName和AbilityName，则Intent可以直接匹配到指定的Ability。
DeviceId	表示运行指定Ability的设备ID。

除上述属性之外，开发者也可以通过Parameters传递某些请求所需的额外信息。Parameters是一种支持自定义的数据结构。

当Intent用于发起请求时，根据指定元素的不同，分为两种类型：

如果同时指定了BundleName与AbilityName，则根据Ability的全称（例如，“com.waylau.hmos.PayAbility”）来直接启动应用。
如果未同时指定BundleName和AbilityName，则根据Operation中的其他属性来启动应用。

5.12.2 根据Ability的全称启动应用

通过构造包含BundleName与AbilityName的Operation对象，可以启动一个Ability、并导航到该Ability。

在“5.8 实战：Service Ability生命周期的例子”的ServiceAbilityLifeCycle应用中，启动本地服务的方式就是根据Ability的全称启动应用的一个例子。代码如下：

/**
 * 启动本地服务
 */
private void startupLocalService(Intent intent) {
    // 构建操作方式
    Operation operation = new Intent.OperationBuilder()
        // 设备ID
        .withDeviceId("")
        // 包名称
        .withBundleName("com.waylau.hmos.serviceabilitylifecycle")
        // 待启动的Ability名称
        .withAbilityName("com.waylau.hmos.serviceabilitylifecycle.TimeServiceAbility")
        .build();
    // 设置操作
    intent.setOperation(operation);
    startAbility(intent);

    HiLog.info(LOG_LABEL, "startupLocalService");
}

在上面代码中，通过Intent中的OperationBuilder类构造operation对象，指定设备标识（空串表示当前设备）、应用包名、Ability名称。

5.12.3 实战：根据Operation的其他属性启动应用

有些场景下，开发者需要在应用中使用其他应用提供的某种能力，而不感知提供该能力的具体是哪一个应用。例如开发者需要通过浏览器打开一个链接，而不关心用户最终选择哪一个浏览器应用，则可以通过Operation的其他属性（除BundleName与AbilityName之外的属性）描述需要的能力。如果设备上存在多个应用提供同种能力，系统则弹出候选列表，由用户选择由哪个应用处理请求。以下示例展示使用Intent跨Ability查询天气信息。

创建一个名为“IntentOperationWithAction”的Car设备类型应用。

创建Page

通过DevEco Studio创建一个关于天气信息的Page，如下图5-26所示。

图5-26 创建Page

自动创建了如下的WeatherAbilitySlice类：

package com.waylau.hmos.intentoperationwithaction.slice;

import com.waylau.hmos.intentoperationwithaction.ResourceTable;
import ohos.aafwk.ability.AbilitySlice;
import ohos.aafwk.content.Intent;
import ohos.hiviewdfx.HiLog;
import ohos.hiviewdfx.HiLogLabel;

public class WeatherAbilitySlice extends AbilitySlice {
    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        super.setUIContent(ResourceTable.Layout_ability_weather);
    }

    @Override
    public void onActive() {
        super.onActive();
    }

    @Override
    public void onForeground(Intent intent) {
        super.onForeground(intent);
    }
}

WeatherAbility使用的布局名称是“ability_weather”。修改ability_weather.xml如下：

<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
    xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:height="match_parent"
    ohos:width="match_parent"
    ohos:orientation="vertical">

    <Text
        ohos:id="$+id:text_weather"
        ohos:height="match_parent"
        ohos:width="match_content"
        ohos:background_element="$graphic:background_ability_weather"
        ohos:layout_alignment="horizontal_center"
        ohos:text="Weather"
        ohos:text_size="50"
        />

</DirectionalLayout>

上述布局会在页面上正中显示“Weather”字样。

配置路由

修改配置文件，增加“action.weather”路由信息内容如下：

"abilities": [
    {
        "skills": [
            {
                "entities": [
                    "entity.system.home"
                ],
                "actions": [
                    "action.system.home"
                ]
            }
        ],
        "orientation": "landscape",
        "name": "com.waylau.hmos.intentoperationwithaction.MainAbility",
        "icon": "$media:icon",
        "description": "$string:mainability_description",
        "label": "IntentOperationWithAction",
        "type": "page",
        "launchType": "standard"
    },
    {
        "skills": [
            {
                "actions": [
                    "action.weather" // 指定路由的动作
                ]
            }
        ],
        "orientation": "landscape",
        "name": "com.waylau.hmos.intentoperationwithaction.WeatherAbility",
        "icon": "$media:icon",
        "description": "$string:weatherability_description",
        "label": "entry",
        "type": "page",
        "launchType": "standard"
    }
]

上述配置，是为了配置路由以便支持以此action导航到对应的AbilitySlice。

修改WeatherAbility

重写WeatherAbility类的onActive的方法，代码如下。

package com.waylau.hmos.intentoperationwithaction;

import com.waylau.hmos.intentoperationwithaction.slice.WeatherAbilitySlice;
import ohos.aafwk.ability.Ability;
import ohos.aafwk.content.Intent;
import ohos.hiviewdfx.HiLog;
import ohos.hiviewdfx.HiLogLabel;

public class WeatherAbility extends Ability {
    private static final HiLogLabel LABEL_LOG =
        new HiLogLabel(HiLog.LOG_APP, 0x00001, "WeatherAbility");
    private final static int CODE = 1;
    private static final String TEMP_KEY = "temperature";

    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        super.setMainRoute(WeatherAbilitySlice.class.getName());
    }

    @Override
    protected void onActive() {
        HiLog.info(LABEL_LOG, "before onActive");

        super.onActive();

        Intent resultIntent = new Intent();
        resultIntent.setParam(TEMP_KEY, "17");

        setResult(CODE, resultIntent); // 暂存返回结果

        HiLog.info(LABEL_LOG, "after onActive");
    }
}

上述代码，

resultIntent是Intent的示例，用于返回结果；
通过Parameters的方式来传递天气信息。Parameters是一种支持自定义的数据结构，通过setParam方法，将温度“17”放到resultIntent中；
调用setResult方法暂存返回结果。

修改MainAbilitySlice

MainAbilitySlice作为请求方，修改代码如下：

package com.waylau.hmos.intentoperationwithaction.slice;

import com.waylau.hmos.intentoperationwithaction.ResourceTable;
import ohos.aafwk.ability.AbilitySlice;
import ohos.aafwk.content.Intent;
import ohos.aafwk.content.Operation;
import ohos.agp.components.Text;
import ohos.hiviewdfx.HiLog;
import ohos.hiviewdfx.HiLogLabel;

public class MainAbilitySlice extends AbilitySlice {
    private static final HiLogLabel LABEL_LOG =
        new HiLogLabel(HiLog.LOG_APP, 0x00001, "MainAbilitySlice");
    private final static int CODE = 1;
    private static final String TEMP_KEY = "temperature";

    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        super.setUIContent(ResourceTable.Layout_ability_main);

        // 添加点击事件来触发请求
        Text text = (Text) findComponentById(ResourceTable.Id_text_helloworld);
        text.setClickedListener(listener -> this.queryWeather());
    }

    private void queryWeather() {
        HiLog.info(LABEL_LOG, "before queryWeather");

        Intent intent = new Intent();

        Operation operation = new Intent.OperationBuilder()
            .withAction("action.weather")
            .build();
        intent.setOperation(operation);

        // 上述方式等同于intent.setAction("action.weather");

        startAbilityForResult(intent, CODE);
    }

    @Override
    protected void onAbilityResult(int requestCode, int resultCode, Intent resultData) {
        HiLog.info(LABEL_LOG, "onAbilityResult");

        switch (requestCode) {
            case CODE:
                HiLog.info(LABEL_LOG, "code 1 result: %s",
                    resultData.getStringParam(TEMP_KEY));
                break;
            default:
                HiLog.info(LABEL_LOG, "defualt result: %s", resultData.getAction());
                break;
        }
    }

    ...
}

上述代码

Text增加了点击事件以触发请求，并路由到“action.weather”；
重写了onAbilityResult方法，用来接收请求的返回值。注意resultData获取的返回参数的值是字符串，以此需要用getStringParam方法；如果是整型，则可以使用getIntParam方法。

运行应用

运行应用，界面效果如下图5-27所示。

图5-27 运行效果

点击“Hello World”字样，触发了路由到“action.weather”的请求，界面效果如下图5-27所示。

图5-28 运行效果

此时，控制台HiLog输出内容如下：

01-04 00:46:11.175 5821-5821/com.waylau.hmos.intentoperationwithaction I 00001/MainAbilitySlice: before queryWeather
01-04 00:46:11.374 5821-5821/com.waylau.hmos.intentoperationwithaction I 00001/WeatherAbility: before onActive
01-04 00:46:11.375 5821-5821/com.waylau.hmos.intentoperationwithaction I 00001/WeatherAbility: after onActive

点击模拟器返回按钮，返回到了“Hello World”界面，效果如下图5-29所示。

图5-29 运行效果

此时，控制台HiLog输出内容如下：

01-04 00:49:57.127 5821-5821/com.waylau.hmos.intentoperationwithaction I 00001/MainAbilitySlice: onAbilityResult
01-04 00:49:57.127 5821-5821/com.waylau.hmos.intentoperationwithaction I 00001/MainAbilitySlice: code 1 result: 17

上述日志文件也可以看出，MainAbilitySlice已经能够拿到WeatherAbility的返回值，温度是17。

bupafengyu 1楼•17 天前

请问北京鸿蒙开发者联盟，您认识吗？

更多关于HarmonyOS鸿蒙Next之Ability07——理解HarmonyOS鸿蒙Next Intent的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

phonegap100 2楼•17 天前

不认识哦~不认识哦~不认识哦~

htzhanglong 3楼•17 天前

在HarmonyOS鸿蒙Next中，Intent 是一种核心机制，用于在不同组件（如Ability、Service等）之间传递信息和触发行为。它类似于Android中的Intent，但针对鸿蒙系统进行了优化。Intent可以携带操作类型、数据、标志等信息，用于启动Ability、传递数据或执行特定任务。通过Intent，开发者可以实现组件间的解耦和灵活交互，提升应用的可扩展性和模块化设计。理解Intent的使用是掌握HarmonyOS开发的关键之一。