87年的鸿蒙开发者
2026-11-16 15:37:20 发布先说一个容易被忽略的问题
很多开发者做完一个功能,第一反应是"怎么让用户知道我们有这个功能",于是去做推送、做运营位、做引导页。
但用户真正的需求往往是:我现在就想干一件事,不想先打开某个 App。
比如:
"帮我订一张明天去上海的机票"
"把这张照片发给张三"
"打开上次的会议纪要"
用户说这句话的时候,并不关心是哪个 App 提供的能力,他只想事情被办成。
Intents Kit 解决的就是这件事:把你的 App 能力声明给系统,让系统(小艺、负一屏、搜索、快捷操作)在合适的时机,主动把你的能力推到用户面前。
Intents Kit 到底是什么?
一句话:它让你的 App 能力变成系统可调用的"原子服务"。
传统 App 的入口是图标,用户得先找到你、点开你、再在 App 里找功能。
Intents Kit 的入口是意图,用户说一句话或点一下,系统直接把你需要的页面拉起来,甚至带着参数。
举个例子:
| 传统方式 | Intents Kit 方式 |
|---|---|
| 打开 App → 找订单 → 点物流 | 对小艺说"查我的快递" → 直接跳到物流页 |
| 打开相册 → 找照片 → 分享 | 长按照片 → 系统推荐"用 XX App 编辑" |
| 打开笔记 App → 搜索 → 打开文档 | 小艺说"打开上周的会议纪要" → 直接打开 |
用户少走了 3 步,你的 App 多了一个入口。
核心概念:Intent 和 Ability
Intents Kit 的核心是两个东西:
Intent:描述"用户想干什么",比如 VIEW_ORDER、SHARE_PHOTO、CREATE_NOTE
Ability:你的 App 里真正干活的组件,接收 Intent 并执行
系统负责匹配:用户说了一句话 → 系统解析出 Intent → 找到能处理这个 Intent 的 Ability → 启动它。
你不需要自己写匹配逻辑,只需要声明:我能处理哪些 Intent。
实战场景:电商 App 的"快捷查物流"
假设你做了一个电商 App,用户经常问"我的快递到哪了"。
传统做法:用户打开 App → 我的订单 → 找到订单 → 点物流。
用 Intents Kit 改造后:用户对小艺说"查我的快递",系统直接拉起你的物流页面,甚至自动定位到最新订单。
第一步:声明你能处理的 Intent
在 module.json5 里声明你的 Ability 能响应哪些 Intent:
{
"module": {
"abilities": [
{
"name": "LogisticsAbility",
"srcEntry": "./ets/logistics/LogisticsAbility.ets",
"description": "查看订单物流信息",
"exported": true,
"skills": [
{
"actions": [
"ohos.action.VIEW",
"myapp.action.CHECK_LOGISTICS"
],
"entities": [
"ohos.entity.VIEW_ORDER"
],
"uri": {
"scheme": "myapp",
"host": "logistics"
}
}
]
}
]
}
}几个关键字段:
actions:你能响应的动作类型,比如查看、分享、创建
entities:你能处理的实体类型,比如订单、照片、联系人
uri:你的 App 内部路由,系统通过它找到具体页面
exported: true:允许外部(小艺、其他 App)调用你
第二步:在 Ability 里接收 Intent 参数
当系统拉起你的 Ability 时,会把参数通过 want 传进来:
// LogisticsAbility.ets
import { Ability, Want } from '@kit.AbilityKit';
export default class LogisticsAbility extends Ability {
onWant(want: Want) {
// 1. 解析 Intent 携带的参数
const orderId = want.parameters?.orderId as string;
const source = want.parameters?.source as string; // 来源:小艺/快捷方式/其他App
// 2. 根据参数决定展示什么
if (orderId) {
// 有指定订单,直接展示该订单物流
this.loadLogistics(orderId);
} else {
// 没指定,展示最新订单
this.loadLatestOrder();
}
// 3. 埋点:统计从哪个入口进来的
this.reportEntry(source);
}
private loadLogistics(orderId: string) {
// 加载指定订单物流
}
private loadLatestOrder() {
// 加载最新订单
}
private reportEntry(source: string) {
hilog.info(0x0000, 'LogisticsAbility', `入口来源: ${source}`);
}
}第三步:让小艺能"发现"你的能力
光声明还不够,你得告诉系统你的能力描述,这样小艺才能理解什么时候该调用你。
在 resources/base/profile/ 下创建 intent_config.json:
{
"intents": [
{
"action": "myapp.action.CHECK_LOGISTICS",
"description": "查看订单物流信息",
"parameters": [
{
"name": "orderId",
"type": "string",
"description": "订单编号,可选",
"required": false
}
],
"examples": [
"查我的快递",
"订单到哪了",
"物流信息"
]
}
]
}这样小艺在解析用户语音时,就能匹配到你的能力。
进阶:跨 App 调用
Intents Kit 不只是给小艺用的,其他 App 也能调用你的能力。
比如你的 App 支持"分享图片到 XX 社区",其他 App 可以这样调用:
// 其他 App 的代码
import { common } from '@kit.AbilityKit';
const context = getContext() as common.UIAbilityContext;
await context.startAbility({
bundleName: 'com.example.myapp',
abilityName: 'ShareAbility',
action: 'myapp.action.SHARE_IMAGE',
parameters: {
imagePath: '/data/media/photo.jpg',
title: '好看的照片'
}
});你的 App 不需要知道是谁在调用,只需要处理 Want 里的参数。
踩坑提醒
Intent 命名要规范 系统预置的 action 用 ohos.action.xxx,自定义的用 你的包名.action.xxx,别混用。
exported 字段要谨慎 如果设为 true,其他 App 也能调用你的能力,要注意参数校验和权限控制。
参数要有默认值 用户说"查快递"时可能没指定订单号,你的 Ability 要能处理"无参数"的情况,别直接崩溃。
入口来源要埋点 从 want.parameters.source 能拿到调用来源,统计一下小艺带来的流量占比,对运营很有价值。
为什么 Intents Kit 值得做?
它解决的是一个很实际的问题:用户越来越不愿意打开 App 了。
当用户习惯了对小艺说"帮我订机票"、"查快递"、"打开文档",你的 App 如果只能靠图标入口,就会慢慢被边缘化。
Intents Kit 让你的能力变成系统的一部分,用户不需要记住你的 App 叫什么,只要说出需求,系统就能找到你。
暂无评论数据
发布
相关推荐
19
0
29
0
21
0
21
0
28
0
87年的鸿蒙开发者
我还没有写个人简介......
帖子
提问
粉丝
使用 DevEco CLI 构建 HarmonyOS 命令行开发工作流
2026-11-10 17:20:51 发布利用 DevEco Code 开发本地数据管理功能,完善 HarmonyOS 应用离线体验
2026-11-10 17:19:50 发布


京公网安备:11010502051901号