当前位置：首页 > news >正文

ios 快捷指令扩展（Intents Extension）简单使用 swift语言

news 2025/6/19 8:01:33

本文介绍使用Xcode15 建立快捷指令的Extension，并描述如何修改快捷指令的IntentHandler，带参数跳转主应用；以及展示多个选项的快捷指令弹框(配置intentdefinition文件)，点击选项带参数跳到主应用的方法

创建快捷指令

快捷指令是一个项目的extension，所以先要有一个ios项目：
在这里插入图片描述
新建扩展
搜索Intent字段，点击下图选中的

左边箭头勾中就会额外自动给快捷指令UI扩展
右边箭头选None 另一个选项是Messaging，选中会使得自动创建message发送功能的相关代码

在这里插入图片描述
选中根目录，新建文件

新建文件类型中搜索Intent，新建唯一搜索结果类型文件

新建文件的target membership需要全部都勾选

在这个新建文件里面定义快捷指令支持的动作（Action），点击加号，点击new intent
在这里插入图片描述

新建的Intent按照需要重命名（双击名字重命名）还有标题描述修改
在这里插入图片描述
配置Intent展示的属性

确认主应用和扩展的info.plist文件有配置Intent，没有的话加上build一下
在这里插入图片描述
build你的项目，xcode会根据添加的Intent生成对应的如下后缀的代码：Handle类、 intent类、 Handling协议、Response类。

快捷指令逻辑

修改默认生成的IntentHandler，如下划线和框住的都是添加代码，其中response的属性show_name为上面配的属性。
这里的continueInApp枚举，表示快捷指令是打开主应用
在这里插入图片描述

主应用获取快捷指令传参

下面是主应用被快捷指令打开，在SceneDelegate获取传过来的参数：

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {if userActivity.activityType == NSStringFromClass(MyIntentIntent.self) {var msg: String?if let response = userActivity.interaction?.intentResponse as? MyIntentIntentResponse {msg = response.show_name}let alert = UIAlertController(title: "提示", message: "从快捷指令传递的消息：\(msg ?? "")", preferredStyle: .alert)alert.addAction(UIAlertAction(title: "确定", style: .default, handler: nil))// 显示弹框self.window?.rootViewController?.present(alert, animated: true, completion: nil)}}

展示多项的快捷指令弹窗
这个弹窗在快捷指令中心点击快捷指令后弹出，点击里面的项，可以带着参数跳到主应用
在这里插入图片描述

在 Intents.intentdefinition文件中新建一个类型Topping(名字随便)
在这里插入图片描述
response里面加上这个刚才定义类型的一个参数toping

intent里面也加一个参数 myParamter

需要注意的是快捷指令弹窗标题是这里配置：

build你的项目。会生成对应类还有属性：
出现ToppingResolutionResult类 MyIntentIntentResponse类中会多出属性toping MyIntentIntent类会多出属性myParamter

下面是IntentHandler适配修改：


class IntentHandler: INExtension, MyIntentIntentHandling {func resolveMyParamter(for intent: MyIntentIntent, with completion: @escaping (ToppingResolutionResult) -> Void) {guard let myParamter = intent.myParamter else {completion(ToppingResolutionResult.disambiguation(with: DataManager.allTops()))return}completion(ToppingResolutionResult.success(with: myParamter))}func provideMyParamterOptionsCollection(for intent: MyIntentIntent, searchTerm: String?, with completion: @escaping (INObjectCollection<Topping>?, Error?) -> Void) {completion(INObjectCollection(items: DataManager.allTops()), nil)}func handle(intent: MyIntentIntent, completion: @escaping (MyIntentIntentResponse) -> Void) {let userActivity  = NSUserActivity(activityType: NSStringFromClass(MyIntentIntent.self))let response  = MyIntentIntentResponse(code:.continueInApp,userActivity: userActivity)response.toping = intent.myParamtercompletion(response)}func confirm(intent: MyIntentIntent, completion: @escaping (MyIntentIntentResponse) -> Void) {let response  = MyIntentIntentResponse(code:.ready,userActivity: nil)completion(response)}override func handler(for intent: INIntent) -> Any {// This is the default implementation.  If you want different objects to handle different intents,// you can override this and return the handler you want for that particular intent.return self}}

数据获取类DataManager：

class DataManager : NSObject {static func allTops()-> [Topping] {var tops:[Topping] = []for i in 0..<3{let top = Topping(identifier: "\(i)", display: "啦啦啦\(i)")tops.append(top)}return tops}
}

同样在主应用中可以获取传过来的response里的Toping对象，依次来获得传参

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {if userActivity.activityType == NSStringFromClass(MyIntentIntent.self) {var msg: String?if let response = userActivity.interaction?.intentResponse as? MyIntentIntentResponse {
//                msg = response.show_namemsg = response.toping?.displayString ?? ""}let alert = UIAlertController(title: "提示", message: "从快捷指令传递的消息：\(msg ?? "")", preferredStyle: .alert)alert.addAction(UIAlertAction(title: "确定", style: .default, handler: nil))// 显示弹框self.window?.rootViewController?.present(alert, animated: true, completion: nil)}}