1、3DTouch 简介

• 3DTouch 是 iOS9 + 系统下，在 iPhone6s（iPhone6s Plus）+ 手机上才能够使用的功能。

1.1 3DTouch 基本类型

• 1、主屏幕快速选项（Home Screen Quick Action）

  • 通过主屏幕的应用图标，通过 3D 手势呼出一个菜单，在主屏幕上的应用 Icon 处，直接进入应用的相应功能模块。

• 2、Peek（展示预览）和 Pop（跳页至预览的界面）

  • 是对 App 的一个优化，用户可以通过 3DTouch 手势在 view 上来预览一些预加载信息，这样的设计可以使 App 更加简洁大方，交互性也更强。

  • 在使用 3DTouch 时，ViewController 中会有如下三个交互阶段：

    • 1) 提示用户这里有 3DTouch 的交互，会使交互控件周围模糊。
    • 2) 继续深按，会出现预览视图。

    • 3) 通过视图上的交互控件进行进一步交互。

• 3、Force Properties（力度）

  • iOS9 + 为我们提供了一个新的交互参数：力度。我们可以检测某一交互的力度值，来做相应的交互处理。例如，我们可以通过力度来控制快进的快慢，音量增加的快慢等。

2、Xcode 模拟器实现测试

• 插件 SBShortcutMenuSimulator：GitHub

• 打开电脑终端，执行以下命令：

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

• 如果电脑中有多个 Xcode 版本，先做如下操作，如果只有一个 Xcode，则可以跳过。Xcode2.app 是你电脑中 Xcode 的名字，这里如要特别注意，如果名字中有空格，需要修改一下，把空格去掉，否则会影响命令的执行。

      $ sudo xcode-select -switch /Applications/Xcode2.app/Contents/Developer/

• 之后在 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

• 如果没有报错，我们可以通过向指定端口发送消息的方法来在模拟器上模拟3D Touch的效果：

      $ echo 'com.apple.mobilecal' | nc 127.0.0.1 8000

  • 其中 com.apple.mobilecal 是应用的 Bundle ID ，如果要测试我们的应用，将其改为我们应用的 BundleID 即可。上面的示例应用是系统日历，可以看到模拟器的效果如下：

3、主屏幕快速选项创建

• 快捷标签最多可以创建 4 个，包括静态的和动态的。每个标签的题目和 icon 最多两行，多出的会用...省略。

3.1 静态标签添加

• 打开我们项目的 Info.plist 文件，添加如下项（选择框中并没有，需要我们手工敲上去）。

      <key>UIApplicationShortcutItems</key>
      <array>
          <dict>
              <key>UIApplicationShortcutItemTitle</key>
              <string>第一个按钮</string>
              <key>UIApplicationShortcutItemType</key>
              <string>com.mycompany.myapp.one</string>
          </dict>
          <dict>
              <key>UIApplicationShortcutItemTitle</key>
              <string>搜索</string>
              <key>UIApplicationShortcutItemType</key>
              <string>com.mycompany.myapp.search</string>
              <key>UIApplicationShortcutItemIconType</key>
              <string>UIApplicationShortcutIconTypeSearch</string>
              <key>UIApplicationShortcutItemSubtitle</key>
              <string>我是副标题</string>
              <key>UIApplicationShortcutItemUserInfo</key>
              <dict>
                  <key>key1</key>
              <string>value1</string>
          </dict>
          </dict>
      </array>

• 参数说明

      UIApplicationShortcutItems             // 数组中的元素就是我们的那些快捷选项标签。
      UIApplicationShortcutItemTitle         // 标签标题（必填）
      UIApplicationShortcutItemType          // 标签的唯一标识（必填）
      UIApplicationShortcutItemIconType      // 使用系统图标的类型，如搜索、定位、home等（可选）
      UIApplicationShortcutItemIconFile      // 使用项目中的图片作为标签图标（可选）
      UIApplicationShortcutItemSubtitle      // 标签副标题（可选）
      UIApplicationShortcutItemUserInfo      // 字典信息，如传值使用（可选）
  
      // 系统风格 icon 的枚举
      UIApplicationShortcutIconTypeCompose   // 编辑的图标
      UIApplicationShortcutIconTypePlay      // 播放图标
      UIApplicationShortcutIconTypePause     // 暂停图标
      UIApplicationShortcutIconTypeAdd       // 添加图标
      UIApplicationShortcutIconTypeLocation  // 定位图标
      UIApplicationShortcutIconTypeSearch    // 搜索图标
      UIApplicationShortcutIconTypeShare     // 分享图标

3.2 动态标签添加

• 在 AppDelegate.m 文件中加如下代码

      - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
          // 加载主界面
          UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
          ViewController *mainView = [storyboard instantiateViewControllerWithIdentifier:@"mainController"];
          UINavigationController *mainNav = [[UINavigationController alloc] initWithRootViewController:mainView];
          self.window.rootViewController = mainNav;
          [self.window makeKeyAndVisible];
  
          // 创建应用图标上的 3D touch 快捷选项，会和 Info.plist 中静态添加的一起创建
          [self creatShortcutItem];
  
          // 如果是从快捷选项标签启动 app，则根据不同标识执行不同操作，然后返回 NO，止处理逻辑被反复回调。
  
          UIApplicationShortcutItem *shortcutItem = [launchOptions valueForKey:UIApplicationLaunchOptionsShortcutItemKey];
  
          if (shortcutItem) {
  
              // 判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作
              if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.one"]) {
  
                  // 进入第一个按钮界面，执行操作
                  NSArray *arr = @[@"hello 3D Touch"];
                  UIActivityViewController *vc = [[UIActivityViewController alloc]initWithActivityItems:arr applicationActivities:nil];
                  [self.window.rootViewController presentViewController:vc animated:YES completion:^{
  
                  }];
  
              } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.search"]) {
  
                  // 进入搜索界面，执行操作
                  SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"];
                  [mainNav pushViewController:childVC animated:NO];
  
              } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.share"]) {
  
                  // 进入分享界面，执行操作
                  SharedViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"sharedController"];
                  [mainNav pushViewController:childVC animated:NO];
              }
              return NO;
          }
  
          return YES;
      }
  
      // 创建应用图标上的 3DTouch 快捷选项
      - (void)creatShortcutItem {
  
          // 创建系统风格的 icon
          UIApplicationShortcutIcon *icon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare];
  
          // // 创建自定义图标的 icon
          // UIApplicationShortcutIcon *icon2 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"分享.png"];
  
          // 创建快捷选项
          UIApplicationShortcutItem *item = [[UIApplicationShortcutItem alloc] initWithType:@"com.mycompany.myapp.share"
                                                                             localizedTitle:@"分享"
                                                                          localizedSubtitle:@"分享副标题"
                                                                                       icon:icon
                                                                                   userInfo:nil];
  
          // 添加到快捷选项数组
          [UIApplication sharedApplication].shortcutItems = @[item];
      }

• 相关方法属性说明

      @interface UIApplicationShortcutItem : NSObject <NSCopying, NSMutableCopying>
  
      // 下面是两个初始化方法 通过设置 type，title 等属性来创建一个标签，这里的 icon 是 UIApplicationShortcutIcon 对象，我们后面再说
      - (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle 
                                                 localizedSubtitle:(nullable NSString *)localizedSubtitle 
                                                              icon:(nullable UIApplicationShortcutIcon *)icon 
                                                          userInfo:(nullable NSDictionary *)userInfo NS_DESIGNATED_INITIALIZER;
      - (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle;
  
      // 下面这是一些只读的属性，获取相应的属性值
      @property (nonatomic, copy, readonly) NSString *type;
      @property (nonatomic, copy, readonly) NSString *localizedTitle;
      @property (nullable, nonatomic, copy, readonly) NSString *localizedSubtitle;
      @property (nullable, nonatomic, copy, readonly) UIApplicationShortcutIcon *icon;
      @property (nullable, nonatomic, copy, readonly) NSDictionary<NSString *, id <NSSecureCoding>> *userInfo;

      // 这个类继承于 UIApplicationShortcutItem，创建的标签可变
      @interface UIMutableApplicationShortcutItem : UIApplicationShortcutItem
  
      @property (nonatomic, copy) NSString *type;
      @property (nonatomic, copy) NSString *localizedTitle;
      @property (nullable, nonatomic, copy) NSString *localizedSubtitle;
      @property (nullable, nonatomic, copy) UIApplicationShortcutIcon *icon;
      @property (nullable, nonatomic, copy) NSDictionary<NSString *, id <NSSecureCoding>> *userInfo;

      // 这个类创建标签中的 icon
      @interface UIApplicationShortcutIcon : NSObject <NSCopying>
  
      // 创建系统风格的 icon
      + (instancetype)iconWithType:(UIApplicationShortcutIconType)type;
  
      // 创建自定义的图片 icon
      + (instancetype)iconWithTemplateImageName:(NSString *)templateImageName;

• 静态标签 + 动态标签 效果

3.3 响应标签的行为

• 如果 App 在后台，通过快捷选项标签进入 App，则调用方法 - (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler。

• 如果 App 不在后台已杀死，则处理通过快捷选项标签进入 App 的逻辑在 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 中。在 launchOptions 中有 UIApplicationLaunchOptionsShortcutItemKey 这样一个键，通过它，我们可以区别是否是从标签进入的 App，如果是则处理结束逻辑后，返回 NO，防止处理逻辑被反复回调。

• 在 AppDelegate.m 文件中加如下代码

  • App 在后台响应

        - (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {
    
            // 加载主界面
            UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
            ViewController *mainView = [storyboard instantiateViewControllerWithIdentifier:@"mainController"];
            UINavigationController *mainNav = [[UINavigationController alloc] initWithRootViewController:mainView];
            self.window.rootViewController = mainNav;
            [self.window makeKeyAndVisible];
    
            // 判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作
            if([shortcutItem.type isEqualToString:@"com.mycompany.myapp.one"]){
    
                // 进入第一个按钮界面，执行操作
                NSArray *arr = @[@"hello 3D Touch"];
                UIActivityViewController *vc = [[UIActivityViewController alloc]initWithActivityItems:arr applicationActivities:nil];
                [self.window.rootViewController presentViewController:vc animated:YES completion:^{
    
                }];
            } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.search"]) {
    
                // 进入搜索界面，执行操作
                SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"];
                [mainNav pushViewController:childVC animated:NO];
            } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.share"]) {
    
                // 进入分享界面，执行操作
                SharedViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"sharedController"];
                [mainNav pushViewController:childVC animated:NO];
            }
    
            if (completionHandler) {
                completionHandler(YES);
            }
        }

  • App 不在后台响应

        - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
            // 加载主界面
            UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
            ViewController *mainView = [storyboard instantiateViewControllerWithIdentifier:@"mainController"];
            UINavigationController *mainNav = [[UINavigationController alloc] initWithRootViewController:mainView];
            self.window.rootViewController = mainNav;
            [self.window makeKeyAndVisible];
    
            // 如果是从快捷选项标签启动 app，则根据不同标识执行不同操作，然后返回 NO，止处理逻辑被反复回调。
    
            UIApplicationShortcutItem *shortcutItem = [launchOptions valueForKey:UIApplicationLaunchOptionsShortcutItemKey];
    
            // 判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作
            if (shortcutItem) {
    
                // 判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作
                if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.one"]) {
    
                    // 进入第一个按钮界面，执行操作
                    NSArray *arr = @[@"hello 3D Touch"];
                    UIActivityViewController *vc = [[UIActivityViewController alloc]initWithActivityItems:arr applicationActivities:nil];
                    [self.window.rootViewController presentViewController:vc animated:YES completion:^{
    
                    }];
    
                } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.search"]) {
    
                    // 进入搜索界面，执行操作
                    SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"];
                    [mainNav pushViewController:childVC animated:NO];
    
                } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.share"]) {
    
                    // 进入分享界面，执行操作
                    SharedViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"sharedController"];
                    [mainNav pushViewController:childVC animated:NO];
                }
                return NO;
            }
    
            return YES;
        }

3.4 动态修改快捷标签内容

• 修改UIApplicationShortcutItem

      // 获取第 0 个 shortcutItem
      UIApplicationShortcutItem *shortcutItem0 = [[UIApplication sharedApplication].shortcutItems objectAtIndex:0];
  
      // 将 shortcutItem0 的类型由 UIApplicationShortcutItem 改为可修改类型 UIMutableApplicationShortcutItem
      UIMutableApplicationShortcutItem * newShortcutItem0 = [shortcutItem0 mutableCopy];
  
      // 修改 shortcutItem 的标题
      [newShortcutItem0 setLocalizedTitle:@"按钮1"];
  
      // 将 shortcutItems 数组改为可变数组
      NSMutableArray *newShortcutItems = [[UIApplication sharedApplication].shortcutItems mutableCopy];
  
      // 替换原 ShortcutItem
      [newShortcutItems replaceObjectAtIndex:0 withObject:newShortcutItem0];
  
      [UIApplication sharedApplication].shortcutItems = newShortcutItems;

4、Peek 和 Pop 创建

• 1、首先给 view 注册 3DTouch 的 Peek（展示预览）和 Pop（跳页至预览的界面）功能，这里给 cell 注册 3DTouch 的 peek 和 pop 功能。

      - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
  
          UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"myCell"];
          if (cell == nil) {
              cell = [[UITableViewCell alloc]initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"myCell"];
          }
          cell.textLabel.text = _myArray[indexPath.row];
  
          // 判断 3D Touch 是否可用
          if (self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable) {
  
              NSLog(@"3D Touch 可用!");
  
              // 给 cell 注册 3DTouch 的 peek 和 pop 功能
              [self registerForPreviewingWithDelegate:self sourceView:cell];
  
          } else {
              NSLog(@"3D Touch 无效");
          }
  
          return cell;
      }

• 2、遵守协议 UIViewControllerPreviewingDelegate 并实现其方法

      // peek（预览）
      - (nullable UIViewController *)previewingContext:(id <UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location {
  
          // 获取按压的 cell 所在行，[previewingContext sourceView] 就是按压的那个视图
          NSIndexPath *indexPath = [_myTableView indexPathForCell:(UITableViewCell* )[previewingContext sourceView]];
  
          // 设定预览的界面
          UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
          SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"];
          childVC.preferredContentSize = CGSizeMake(0.0f, 500.0f);
          childVC.str = [NSString stringWithFormat:@"我是%@, 用力按一下进来", _myArray[indexPath.row]];
  
          // 调整不被虚化的范围，按压的那个 cell 不被虚化（轻轻按压时周边会被虚化，再少用力展示预览，再加力跳页至设定界面）
          CGRect rect = CGRectMake(0, 0, self.view.frame.size.width, 40);
          previewingContext.sourceRect = rect;
  
          // 返回预览界面
          return childVC;
      }
  
      // pop（按用点力进入）
      - (void)previewingContext:(id <UIViewControllerPreviewing>)previewingContext commitViewController:(UIViewController *)viewControllerToCommit {
          [self showViewController:viewControllerToCommit sender:self];
      }

  • 效果图：（当用户按下时 cell 周边会虚化，增加压力达到一定值会弹出设定的预览界面，继续增加力按压会跳页至预览界面）

• 3、打开预览的视图的 .m 文件，这里是 SearchViewController.m 中加上如下代码

      - (NSArray<id<UIPreviewActionItem>> *)previewActionItems {
  
          // setup a list of preview actions
          UIPreviewAction *action1 = [UIPreviewAction actionWithTitle:@"Aciton1" 
                                                                style:UIPreviewActionStyleDefault 
                                                              handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
              NSLog(@"Aciton1");
          }];
  
          UIPreviewAction *action2 = [UIPreviewAction actionWithTitle:@"Aciton2" 
                                                                style:UIPreviewActionStyleDefault 
                                                              handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
              NSLog(@"Aciton2");
          }];
  
          UIPreviewAction *action3 = [UIPreviewAction actionWithTitle:@"Aciton3" 
                                                                style:UIPreviewActionStyleDefault 
                                                              handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
              NSLog(@"Aciton3");
          }];
  
          NSArray *actions = @[action1,action2,action3];
  
          // and return them (return the array of actions instead to see all items ungrouped)
          return actions;
      }

  • 效果图：（当弹出预览时，上滑预览视图，出现预览视图中快捷选项）

5、3DTouch 压力值的运用

• 直接在 SearchViewController.m 加这个方法即可，按压 SearchViewController 中的任何视图都会调用这个方法。

      // 按住移动 or 压力值改变时的回调
      - (void)touchesMoved:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
  
          NSArray *arrayTouch = [touches allObjects];
          UITouch *touch = (UITouch *)[arrayTouch lastObject];
  
          // 通过 tag 确定按压的是哪个 view，注意：如果按压的是 label，将 label 的 userInteractionEnabled 属性设置为 YES
          if (touch.view.tag == 105) {
  
              NSLog(@"move压力 ＝ %f", touch.force);
  
              // 红色背景的 label 显示压力值
              _lbForce.text = [NSString stringWithFormat:@"压力%f", touch.force];
  
              // 红色背景的 label 上移的高度＝压力值*100
              _bottom.constant = ((UITouch *)[arrayTouch lastObject]).force * 100;
          }
      }

• 用不同力度按压那个蓝色背景的 label，随着力度的变化红色背景的 label 会上下移动。