3D-Touch Home Screen Quick Actions 使用

1. 3D-Touch简单介绍

　　3D-Touch是iPhone 6s推出的一种可以让你与手机进行互动的全新方式。这一次，iPhone 能够感应你按压屏幕的力度。除了轻点、轻扫、双指开合这些熟悉的 Multi‑Touch 手势之外，3D Touch 还带来 Peek 和 Pop，为 iPhone 的使用体验开拓出全新的维度。而且，当你使用 3D Touch 时，iPhone 将回以轻微的触感，让你不仅能够看到按下屏幕的操作效果，还能感觉得到。

　　3D-Touch含有3种feature功能，压力感应（Press Sensitivity）、Peek和Pop手势、快捷方式（Quick Actions）

2. 如果让模拟器支持3D-Touch

　　 目前官方文档还不支持3d-touch,可以借助github的开源项目,SBShortcutMenuSimulator(点击下载).

安装和使用也比较简单

1. 安装　

   git clone https://github.com/DeskConnect/SBShortcutMenuSimulator.git
   cd SBShortcutMenuSimulator
   make

2. 安装完,在SBShortcutMenuSimulator的目录执行以下方法

   xcrun simctl spawn booted launchctl debug system/com.apple.SpringBoard --environment DYLD_INSERT_LIBRARIES=$PWD/SBShortcutMenuSimulator.dylib
   xcrun simctl spawn booted launchctl stop com.apple.SpringBoard

3. 使用

   // 'com.x.x' 为程序的bundle id, id可以随便指定
   echo 'com.xxx.xxx' | nc 127.0.0.1 

3. Quick Actions2种适配方法

　　1. 静态定义

　　　　静态定义常用的key:

UIApplicationShortcutItemType  　　 //(必须使用) 用来区分与其他快速选项的分类
UIApplicationShortcutItemTitle  　　//(必须使用) 快速选项显示的标题
UIApplicationShortcutItemSubtitle  // 快速选项显示的子标题
UIApplicationShortcutItemIconType  // 图片类型由系统提供,大约提供了29种
UIApplicationShortcutItemIconFile  // 自定义的图标
UIApplicationShortcutItemUserInfo  // 附加信息(NSDictionary)

　　   静态设置在Info.plist文件中定义

<key>UIApplicationShortcutItems</key>
    <array>
        <dict>
            <key>UIApplicationShortcutItemIconType</key>
            <string>UIApplicationShortcutIconTypeBookmark</string>
            <key>UIApplicationShortcutItemTitle</key>
            <string>打开最后阅读的书籍</string>
            <key>UIApplicationShortcutItemType</key>
            <string>3dTouchOpenBookItem</string>
            <key>UIApplicationShortcutItemUserInfo</key>
            <dict>
                <key>shorcutKey</key>
                <string>shorcutValue</string>
            </dict>
        </dict>
        <dict>
            <key>UIApplicationShortcutItemIconType</key>
            <string>UIApplicationShortcutIconTypeSearch</string>
            <key>UIApplicationShortcutItemTitle</key>
            <string>搜索书架</string>
            <key>UIApplicationShortcutItemType</key>
            <string>3dTouchSearchItem</string>
        </dict>

　　　　　　<dict>
　　　　　　　　<key>UIApplicationShortcutItemIconFile</key>
　　　　　　　　<string>dl_d.png</string>
　　　　　　　　<key>UIApplicationShortcutItemTitle</key>
　　　　　　　　<string>热门活动</string>
　　　　　　　　<key>UIApplicationShortcutItemType</key>
　　　　　　　　<string>QuickActionActivityItem</string>
　　　　　　</dict>

    </array>

　　ps : 如果使用 UIApplicationShortcutItemIconFile, UIApplicationShortcuIconType将不起作用,使用参考上面红色字体的地址

　　2. 动态定义

- (void)initApplication3DTouch:(UIApplication *)application {

    NSMutableDictionary *userInfo = [[NSMutableDictionary alloc] init];
    [userInfo setObject:@"哈哈" forKey:@"haha"];
    // 自定义获取本地的图片并传递一些参数
    UIMutableApplicationShortcutItem *itemTest = [[UIMutableApplicationShortcutItem alloc] initWithType:@"" localizedTitle:@"标题" localizedSubtitle:@"副标题" icon:[UIApplicationShortcutIcon iconWithTemplateImageName:@"本地图片"] userInfo:userInfo];

    // 打开最后阅读的一本书
    UIApplicationShortcutIcon *openBook = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeBookmark];
    UIMutableApplicationShortcutItem *itemOpenBook = [[UIMutableApplicationShortcutItem alloc] initWithType:@"" localizedTitle:@"打开最后阅读的书籍"];
    itemOpenBook.icon = openBook;

    // 找书
    UIApplicationShortcutIcon *searchBook = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeSearch];
    UIMutableApplicationShortcutItem *itemSearchBook = [[UIMutableApplicationShortcutItem alloc] initWithType:@"" localizedTitle:@"搜索书架"];
    itemSearchBook.icon = searchBook;

    //
    application.shortcutItems = @[itemTest, itemOpenBook, itemSearchBook];
}

　　

　　3. 响应Quick Actions事件

- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {

    if ([shortcutItem.type isEqualToString:@""]) {
        NSLog(@"搜索书架");
    } else if ([shortcutItem.type isEqualToString:@""]) {
        NSDictionary *dict = shortcutItem.userInfo;
        NSLog(@"dict为传递过来的参数");
    }
}

3. 备注

　　1. 快捷标签最多可以创建四个,包括静态的和动态的. 静态的会显示在动态的前面

　　2. 静态的可以在程序不打开的情况下显示,动态的不可以

　　3. 关于如何动态的移除动态添加的Quick Actions　　　

application.shortcutItems = nil; // 尝试了一下,可以通过这个方式把动态quick action移除

　　如果你不是在wb145230博客园看到本文,请点击查看原文.