iOS开发Quick Actions创建桌面Icon快捷方式
个言
很久没发随笔了,有一年多了吧。期间也曾想继续去写随笔,但是因为各种原因而耽搁了。最近又想了一下,还是有很多东西想要写,想要分享,想要记录下来的东西。之后我也会不断写随笔,但不止于 ios 的方向,也想去体验一下新东西。在此不多说,我们开始阅读正文吧。
简介
在支持 3d touch 的设备上,quick actions 可以让用户更快,更少的操作步骤去完成他们最常做的事情,其中这么多操作可以通过主屏幕直接完成。比如用力地长按微信图标,会弹出诸如"扫一扫"和"我的二维码"等常用功能,这个我在加好友的情况下经常会用到,不是"扫"别人就是被别人"扫"。然后这是它的官方介绍,3d touch - ios - apple developer。
本文的 demo 已放到 github 上,demo 请到 garveycalvin/ios-travel 下载。
支持的设备是在 iphone 6s 和 6s plus 及后续出的 iphone 系列,系统则是从 ios 9.0 开始支持 3d touch。
info.plist 创建快捷方式
快捷方式支持在 info.plist 里直接定义,主键是uiapplicationshortcutitems,它是一个数组array。各个 key 值可以在查看information property list key reference,在这里简单地介绍一下各个 key 的作用。
key | 作用 |
---|---|
uiapplicationshortcutitemtype(必需) | 唯一标识 |
uiapplicationshortcutitemtitle(必需) | 显示的标题 |
uiapplicationshortcutitemsubtitle(可选) | 显示的副标题 |
uiapplicationshortcutitemicontype(可选) | 使用系统的图标 |
uiapplicationshortcutitemiconfile(可选) | 使用项目的图标 |
uiapplicationshortcutitemuserinfo(可选) | 附加的信息 |
以下是一个详细的例子,上述的 key 除了 uiapplicationshortcutitemuserinfo 外,其它都实现了。
现在我们来看看运行效果,值得一提的是,图标分别在上半屏和下半屏的情况下,显示的排序是会不同的,具体运行效果如下所示。
图标在上半屏
图标在下半屏
判断用户点击了哪个快捷方式
通过在 appdelegate.m 文件中实现 uiapplicationdelegate 的代理方法
application:performactionforshortcutitem:completionhandler:,可以得知用户是从哪个快捷方式进来的,具体代码如下。
- (void)application:(uiapplication *)application performactionforshortcutitem:(uiapplicationshortcutitem *)shortcutitem completionhandler:(void (^)(bool))completionhandler api_available(ios(9.0)) { nslog(@"%s", __function__); if ([shortcutitem.type isequaltostring:@"search"]) { nslog(@"用户从快捷方式“搜索”进来的"); } else if ([shortcutitem.type isequaltostring:@"list"]) { nslog(@"用户从快捷方式“榜单”进来的"); } else if ([shortcutitem.type isequaltostring:@"public"]) { nslog(@"用户从快捷方式“一键发布”进来的"); } }
代码创建快捷方式
快捷方式也支持代码创建,每一个 uiapplicationshortcutitem 就是一个快捷方式,一般在 appdelegate.m 文件中实现方法 application:didfinishlaunchingwithoptions: 里编写实现代码,代码比较易懂,这里就不再说明了。
- (bool)application:(uiapplication *)application didfinishlaunchingwithoptions:(nsdictionary *)launchoptions { nslog(@"%s", __function__); if (@available(ios 9.0, *)) { uiapplicationshortcuticon *searchicon = [uiapplicationshortcuticon iconwithtype:uiapplicationshortcuticontypesearch]; uiapplicationshortcutitem *search = [[uiapplicationshortcutitem alloc] initwithtype:@"search" localizedtitle:@"搜索" localizedsubtitle:nil icon:searchicon userinfo:nil]; uiapplicationshortcuticon *publicicon = [uiapplicationshortcuticon iconwithtemplateimagename:@"upload"]; uiapplicationshortcutitem *public = [[uiapplicationshortcutitem alloc] initwithtype:@"public" localizedtitle:@"一键发布" localizedsubtitle:nil icon:publicicon userinfo:nil]; uiapplicationshortcutitem *list = [[uiapplicationshortcutitem alloc] initwithtype:@"list" localizedtitle:@"榜单" localizedsubtitle:@"全区排行" icon:nil userinfo:nil]; application.shortcutitems = @[list, public, search]; } return yes; }
资料
本文的 demo 已放到 github 上,demo 请到 garveycalvin/ios-travel 下载。
环境
xcode: version 10.1 (10b61)
测试机型:iphone xs max
测试系统:ios 12.1
总结
无论是在 info.plist 或 代码 创建 quick actions 都比较简单,没什么很复杂的逻辑,学起来很容易。
quick actions 的使用情况还是比较多的,就我而言,我经常会用支付宝和微信放出来的"扫一扫",支付宝的"乘车码"等等。
3d touch 的应用范围不止这些,还有 peek and pop 和 pressure sensitivity,在以后或许会补上这系列的文章。