3D Touch的基本使用

3D Touch主要的使用场景为两个，一个静态这设置，一个动态添加，还有包括修改UIApplicationShortcutItem，peek(预览)和pop(跳转)的实现。
应用最多添加4个快捷选项标签，iOS给我们提供了2种方式开发。
一、静态的标签实现
打开项目的plist文件，添加如下项(需要我们手工添加)

或者代码编写plist

<key>UIApplicationShortcutItems</key>
    <array>
        <dict>
            <key>UIApplicationShortcutItemIconFile</key>
            <string>open-favorites</string>
            <key>UIApplicationShortcutItemTitle</key>
            <string>Favorites</string>
            <key>UIApplicationShortcutItemType</key>
            <string>com.mycompany.myapp.openfavorites</string>
            <key>UIApplicationShortcutItemUserInfo</key>
            <dict>
                <key>key1</key>
                <string>value1</string>
            </dict>
        </dict>
        <dict>
            <key>UIApplicationShortcutItemIconType</key>
            <string>UIApplicationShortcutIconTypeCompose</string>
            <key>UIApplicationShortcutItemTitle</key>
            <string>New Message</string>
            <key>UIApplicationShortcutItemType</key>
            <string>com.mycompany.myapp.newmessage</string>
            <key>UIApplicationShortcutItemUserInfo</key>
            <dict>
                <key>key2</key>
                <string>value2</string>
            </dict>
        </dict>
    </array>

UIApplicationShortcutItems：数组中的元素就是我们的那些快捷选项标签。

UIApplicationShortcutItemTitle：标签标题（必填）

UIApplicationShortcutItemType：标签的唯一标识（必填）

UIApplicationShortcutItemIconType：使用系统图标的类型，如搜索、定位、home等（可选）

UIApplicationShortcutItemIconFile：使用项目中的图片作为标签图标（可选）

UIApplicationShortcutItemSubtitle：标签副标题（可选）

UIApplicationShortcutItemUserInfo：字典信息，如传值使用（可选）

二、动态标签的实现
1、在AppDelegate.m文件中加如下代码：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
    // Override point for customization after application launch.

    UINavigationController *Nav = [[UINavigationController alloc] initWithRootViewController:[[TestOneViewController alloc] init]];
    self.window.rootViewController = Nav;
    self.window.backgroundColor = [UIColor whiteColor];
    [self.window makeKeyAndVisible];

    //设置3D Touch 标签
    NSMutableArray *arrShortcutItem = (NSMutableArray *)[UIApplication sharedApplication].shortcutItems;
    //icon 快捷按钮的图标 可以自定义
    //创建系统风格的icon
   // UIApplicationShortcutIcon *icon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare];

    //创建自定义图标的icon
   //   UIApplicationShortcutIcon *icon2 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"分享.png"];

    UIApplicationShortcutItem *shoreItem1 = [[UIApplicationShortcutItem alloc] initWithType:@"cn.damon.DM3DTouchDemo.openSeach" localizedTitle:@"搜索" localizedSubtitle:nil icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeSearch] userInfo:nil];
    [arrShortcutItem addObject:shoreItem1];
    UIApplicationShortcutItem *shoreItem2 = [[UIApplicationShortcutItem alloc] initWithType:@"cn.damon.DM3DTouchDemo.openCompose" localizedTitle:@"新消息" localizedSubtitle:@"新消息副标题" icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeCompose] userInfo:nil];
    [arrShortcutItem addObject:shoreItem2];
    [UIApplication sharedApplication].shortcutItems = arrShortcutItem;

    return YES;
}

效果图：

2、点击快捷键标签进入对应的响应
在AppDelegate.m中加入代码：

- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler{
    //这里可以获的shortcutItem对象的唯一标识符
    //不管APP在后台还是进程被杀死，只要通过主屏快捷操作进来的，都会调用这个方法
    NSLog(@"name:%@\ntype:%@", shortcutItem.localizedTitle, shortcutItem.type);
    UINavigationController *Nav = [[UINavigationController alloc] initWithRootViewController:[[TestOneViewController alloc] init]];
    self.window.rootViewController = Nav;
    self.window.backgroundColor = [UIColor whiteColor];
    [self.window makeKeyAndVisible];

    //判断跳转界面

    if ([shortcutItem.type isEqualToString: @"cn.damon.DM3DTouchDemo.openCompose"]) {
        TestTowViewController *TwoVC = [[TestTowViewController alloc] init];
        [Nav pushViewController:TwoVC animated:YES];
    }else if ([shortcutItem.type isEqualToString: @"cn.damon.DM3DTouchDemo.openSeach"]){
        SeachViewController *VC = [[SeachViewController alloc] init];
        [Nav pushViewController:VC animated:YES];
    }else if ([shortcutItem.type isEqualToString: @"com.mycompany.myapp.openfavorites"]){
        SeachViewController *VC = [[SeachViewController alloc] init];
        [Nav pushViewController:VC animated:YES];
    }

    if (completionHandler) {
        completionHandler(YES);
    }
    /* 也可以在这里面修改UIApplicationShortcutItem */
}

3、peek ( 预览 ) 和pop（跳转到预览的界面）
首先注册peer和pop功能，以我的代码为例，想点击TestOneViewController中的cell，预览TestTwoViewController界面，然后跳转到TestTwoViewController界面，那就先在TestOneViewController里面注册，并继承协议UIViewControllerPreviewingDelegate

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
    NSArray *arr = @[@"test1",@"test2"];

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"cellID" forIndexPath:indexPath];
    cell.textLabel.text = arr[indexPath.row];

    //注册3D Touch
    /**
     从iOS9开始，我们可以通过这个类来判断运行程序对应的设备是否支持3D Touch功能。
     UIForceTouchCapabilityUnknown = 0,     //未知
     UIForceTouchCapabilityUnavailable = 1, //不可用
     UIForceTouchCapabilityAvailable = 2    //可用
    */

    if ([self respondsToSelector:@selector(traitCollection)]) {
        if ([self.traitCollection respondsToSelector:@selector(forceTouchCapability)]) {
            if (self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable) {
                [self registerForPreviewingWithDelegate:(id)self sourceView:cell];
            }
        }
    }

    return cell;
}

然后实现UIViewControllerPreviewingDelegate方法：

#pragma mark - 3D Touch代理 UIViewControllerPreviewingDelegate

//预览图
- (UIViewController *)previewingContext:(id<UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location{
    NSArray *arr = @[@"1",@"2"];
    NSIndexPath *indexPath = [self.tableView indexPathForCell:(UITableViewCell *)[previewingContext sourceView]];
    //创建要预览的控制器
    TestTowViewController *TwoVC = [[TestTowViewController alloc] init];
    TwoVC.InfoStr = arr[indexPath.row];
    TwoVC.index = indexPath.row;

    //指定当前上下文视图Rect
    CGRect rect = CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, 300);
    previewingContext.sourceRect = rect;
    return TwoVC;

}

//从预览图跳转进入TestTwo 控制器
//(用力按压 跳转)
- (void)previewingContext:(id<UIViewControllerPreviewing>)previewingContext commitViewController:(UIViewController *)viewControllerToCommit{
    [self showViewController:viewControllerToCommit sender:self];
}

预览界面的设置和向上拖拽预览图生成快捷键的代码需要在TestTowViewController.m里面设置：

//3D Touch 预览图时 向上拖拽得到的快捷功能菜单
- (NSArray<id<UIPreviewActionItem>> *)previewActionItems{
    NSMutableArray *arrItem = [NSMutableArray new];
    UIPreviewAction *previewAction0 = [UIPreviewAction actionWithTitle:@"取消" style:UIPreviewActionStyleDestructive handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
        //

        NSLog(@"didClickCancel");
    }];
    UIPreviewAction *previewAction1 = [UIPreviewAction actionWithTitle:@"替换元素" style:UIPreviewActionStyleDefault handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
        //

        NSLog(@"替换元素");
    }];
    [arrItem addObjectsFromArray:@[previewAction0,previewAction1]];
    return arrItem;
}

效果图如下：

这就是基本的 3D Touch的运用。
源码：https://github.com/Jadekirin/3D-TouchTest.git。