1# 意图执行 2 3### 介绍 4 5本示例使用[@ohos.app.ability.InsightIntentExecutor](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-insightIntentExecutor.md)、[@ohos.app.ability.insightIntent](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-insightIntent.md)、[@ohos.app.ability.insightIntentDriver](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-insightIntentDriver.md)等接口，展示了意图绑定到UIAbility前台执行、意图绑定到ServiceExtension执行两种意图执行方法，主要包括构造意图配置文件、构造意图调用执行参数、触发意图调用的执行、取得意图调用结果等。 6 7### 效果预览： 8 9| 主页 | 意图绑定到UIAbility前台执行<br>(参照应用[IntentExecutor](../../../BasicFeature/InsightIntent/IntentExecutor)） | 意图绑定到ServiceExtension执行 | 10| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | 11| <img alt="home" height="640" src="screenshots/zh/home.png" width="360"/> | <img alt="UIAbility" height="640" src="screenshots/zh/executeInUIAbility.png" width="360"/> | <img alt="ServiceExtension" height="640" src="screenshots/zh/executeInServiceExtension.png" width="360"/> | 12 13使用说明 14 151.启动应用后，主页面上显示两个按钮：意图绑定到UIAbility前台、意图绑定到ServiceExtension； 16 172.点击按钮“意图绑定到UIAbility前台”，触发意图执行，在意图调用业务逻辑中加载新的页面，返回意图调用结果通过promptAction.showToast显示结果； 18 193.点击按钮“意图绑定到ServiceExtension”，触发意图执行，返回意图调用结果并通过promptAction.showToast显示结果； 20 21### 工程目录 22 23``` 24entry/src/main/ 25├─ets 26│ ├─entryability 27│ │ └─EntryAbility.ets // UIAbility，意图绑定到该UIAbility前台执行 28│ ├─intents 29│ │ ├─PlayMusicIntentDriver.ets // 通过insightIntentDriver.execute执行意图调用 30│ │ └─PlayMusicIntentExecutorImpl.ets // 通过意图调用执行基类对接端侧意图框架，实现响应意图调用的业务逻辑 31│ ├─pages 32│ │ └─Index.ets // 主页面，通过按钮点击事件将意图调用转发给模块PlayMusicIntentDriver 33│ ├─serviceextability 34│ │ └─ServiceExtAbility.ets // ServiceExtensionAbility，意图绑定到该ServiceExtension执行 35│ └─util 36│ └─Logger.ets // 日志工具 37└─resources 38 └─base 39 └─profile 40 └─insight_intent.json // 意图配置文件 41``` 42 43### 具体实现 44 45* 实现意图调用业务逻辑的功能接口封装在PlayMusicIntentExecutorImpl，源码参考：[PlayMusicIntentExecutorImpl.ets](entry/src/main/ets/intents/PlayMusicIntentExecutorImpl.ets) 46 * 意图绑定到ServiceExtension运行的业务逻辑： 47 48 实现意图调用执行基类InsightIntentExecutor的onExecuteInServiceExtensionAbility()回调函数； 49 50* 触发意图调用的接口封装在PlayMusicIntentDriver，源码参考：[PlayMusicIntentDriver.ets](entry/src/main/ets/intents/PlayMusicIntentDriver.ets) 51 * 触发绑定到UIAbility前台运行的意图调用： 52 在函数executeUIAbilityForeground中，构造意图调用执行参数，调用@ohos.app.ability.insightIntentDriver中的execute接口触发意图调用； 53 54 * 触发绑定到ServiceExtension运行的意图调用： 55 56 在函数executeServiceExtension中，构造意图调用执行参数，调用@ohos.app.ability.insightIntentDriver中的execute接口触发意图调用； 57 58* 在意图配置文件[insight_intent.json](entry/src/main/resources/base/profile/insight_intent.json)中配置应用支持的意图API列表 59 * 配置内容包括： 60 意图API名称、意图API所属的垂域、意图API版本号、代码相对路径入口、执行模式等； 61 62* 在主页面[Index.ets](entry/src/main/ets/pages/Index.ets)中通过按钮的onClick事件将意图调用转发给模块PlayMusicIntentDriver 63 * 意图绑定到UIAbility前台按钮 64 点击按钮时，调用PlayMusicIntentDriver的executeUIAbilityForeground函数，触发意图调用； 65 * 意图绑定到ServiceExtension按钮 66 点击按钮时，调用PlayMusicIntentDriver的executeServiceExtension函数，触发意图调用； 67 68### 相关权限 69 70[ohos.permission.EXECUTE_INSIGHT_INTENT](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/permission-list.md) 71 72### 依赖 73 74本应用的运行依赖应用[IntentExecutor](../../../BasicFeature/InsightIntent/IntentExecutor)。 75 76### 约束与限制 77 781.本示例仅支持标准系统上运行，支持设备：RK3568; 79 802.本示例为Stage模型，支持API11版本SDK，版本号：4.1.3.1； 81 823.本示例涉及使用系统接口：insightIntentDriver.execute，需要手动替换Full SDK才能编译通过； 83 844.本示例需要使用DevEco Studio 3.1.1 Release (Build Version: 3.1.0.501, built on June 20, 2023)才可编译运行； 85 865.本示例涉及[ohos.permission.EXECUTE_INSIGHT_INTENT](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/permission-list.md)权限为system_basic级别，需要配置高权限签名； 87 886.本示例使用了ServiceExtensionAbility，需要手动配置特权应用能力申请"app-privilege-capabilities": ["AllowAppUsePrivilegeExtension"]，否则安装失败。具体操作指南可参考[应用特权配置指南]( https://gitee.com/openharmony/docs/blob/eb73c9e9dcdd421131f33bb8ed6ddc030881d06f/zh-cn/device-dev/subsystems/subsys-app-privilege-config-guide.md/ )。在文件最后添加内容： 89 "app-privilege-capabilities" : [ 90 "AllowAppUsePrivilegeExtension" 91 ] 92 937.本示例中使用到ServiceExtensionAbility，需要将本示例加入到白名单中再进行安装。详细内容如下 94{ 95 "bundleName": "com.samples.intentdriver", 96 "app_signature" : [], 97 "allowAppUsePrivilegeExtension": true 98} 99 100### 下载 101 102如需单独下载本工程，执行如下命令： 103 104``` 105git init 106git config core.sparsecheckout true 107echo code/SystemFeature/InsightIntent/IntentDriver/ > .git/info/sparse-checkout 108git remote add origin https://gitee.com/openharmony/applications_app_samples.git 109git pull origin master 110``` 111
