开始用Swift开发iOS 10 - 25 使用3D Touch

接着上一篇开始用Swift开发iOS 10 - 24 使用TestFlight进行Beta测试，这一篇学习使用3D Touch。

自从iPhone 6s和iPhone 6s Plus开始，Apple介绍了一种新的交互方式就是3D Touch。这新的特性需要硬件的支持，是iPhone屏幕不仅能感应到触摸，还能感应到压力。

现在3D Touch主要有三类交互方式：

Quick Action ：点击应用图标后的快捷操作。👇是例子：

Peek(preview) 和 Pop(commit)一般是一起的：主要应用于app中快速查看详细内容。
自带的Photos app是很好的例子：

微信公众号也是不错的例子：

Home Screen Quick Action

Quick Action分两种：
- 静态的：在Info.plist中编写，固定不变的。
- 动态的：在代码中创建和更新。以自带的News app为例：

不同的频道是随着时间而变化的。

静态的Quick Action
静态的Quick Action只需要在Info.plist中配置UIApplicationShortcutItems数组就可以了，数组的每一项（字典）就是一个Action，每一个Action有6个类型的字段配置：
- UIApplicationShortcutItemType(必须)
- UIApplicationShortcutItemTitle(必须)
- UIApplicationShortcutItemSubtitle(可选)
- UIApplicationShortcutItemIconType(可选)
- UIApplicationShortcutItemIconFile(可选)
- UIApplicationShortcutItemUserInfo(可选)
  如果是下面配置：

结果就是：

动态的Quick Action
动态的的Quick Action配置只要在AppDelegate.swift的application(:didFinishLaunchingWithOptions)中添加如下代码即可：

        let shortcutItem = UIApplicationShortcutItem(type: "com.andyron.NewRestaurant", localizedTitle: "New Restaurant", localizedSubtitle: nil, icon: UIApplicationShortcutIcon(type: .add), userInfo: nil)
        UIApplication.shared.shortcutItems = [shortcutItem]

使用动态的Quick Action配置我的FoodPin应用
由于我之前使用UIPageViewController创建了开始结束页面，如果在在AppDelegate.swift的application(:didFinishLaunchingWithOptions)中添加动态的Quick Action就会出现直接跳过介绍页面的情况，所以要在看完结束也之后再添加Quick Action。

下载图标，拖进Assets.xcassets

在WalkthroughContentViewController的nextButtonTapped方法的case 2: 里添加3个Action：

// 1
if traitCollection.forceTouchCapability == UIForceTouchCapability.available {
    let bundleIdentifier = Bundle.main.bundleIdentifier
    // 2
    let shortcutItem1 = UIApplicationShortcutItem(type: "\(bundleIdentifier).OpenFavorites", localizedTitle: "Show Favorites", localizedSubtitle: nil, icon: UIApplicationShortcutIcon(templateImageName: "favortie-shortcut"), userInfo: nil)
    
    let shortcutItem2 = UIApplicationShortcutItem(type: "\(bundleIdentifier).OpenDiscover", localizedTitle: "Discover restaurants", localizedSubtitle: nil, icon: UIApplicationShortcutIcon(templateImageName: "discover-shortcut"), userInfo: nil)
    
    let shortcutItem3 = UIApplicationShortcutItem(type: "\(bundleIdentifier).NewRestaurant", localizedTitle: "New Restaurant", localizedSubtitle: nil, icon: UIApplicationShortcutIcon(type: .add), userInfo: nil)
    // 3
    UIApplication.shared.shortcutItems = [shortcutItem1, shortcutItem2, shortcutItem3]
}

1 判断设备是否支持3D Touch
2 UIApplicationShortcutIcon可以使用系统的图标，也可以使用外部图标
3 shortcutItems数组顺序对应从靠近图标开始向上或向下显示

实现Quick Action的具体跳转动作
UIApplicationDelegate协议中的application(_:performActionFor:completionHandler:)方法会在Quick Action被点击后调用。

在AppDelegate.swift文件中定义一个QuickAction枚举。列举出quick action相关动作。

  enum QuickAction: String {
      case OpenFavorites = "OpenFavorites"
      case OpenDiscover = "OpenDiscover"
      case NewRestaurant = "NewRestaurant"
      
      init?(fullIdentifier: String) {
          guard let shortcutIdentifier = fullIdentifier.components(separatedBy: ".").last else {
              return nil
          }
          self.init(rawValue: shortcutIdentifier)
      }
  }

在AppDelegate中实现application(_:performActionFor:completionHandler:)方法：

  func application(_ application: UIApplication, performActionFor shortcutItem: UIApplicationShortcutItem, completionHandler: @escaping (Bool) -> Void) {
      
      completionHandler(handleQuickAction(shortcutItem: shortcutItem))
  }
  
  private func handleQuickAction(shortcutItem: UIApplicationShortcutItem) -> Bool {
      let shortcutType = shortcutItem.type
      guard let shortcutIdentifier = QuickAction(fullIdentifier: shortcutType) else {
              return false
      }
      guard let tabBarController = window?.rootViewController as? UITabBarController else {
              return false
      }
      switch shortcutIdentifier {
      case .OpenFavorites:
          tabBarController.selectedIndex = 0
      case .OpenDiscover:
          tabBarController.selectedIndex = 1
      case .NewRestaurant:
          if let navController = tabBarController.viewControllers?[0] {
              let restaurantTableViewController = navController.childViewControllers[0]
              restaurantTableViewController.performSegue(withIdentifier: "addRestaurant", sender: restaurantTableViewController)
          } else {
              return false
          }
      }
      return false
  }

Peek 和 Pop

在RestaurantTableViewController的viewDidLoad方法中添加如下代码。使用UIViewController中的registerForPreviewing方法注册使用peek和pop。

      // 如果3D Touch可以用，就注册本控制器可以peek和pop
      if traitCollection.forceTouchCapability == .available {
          registerForPreviewing(with: self as! UIViewControllerPreviewingDelegate, sourceView: view)
      }

让RestaurantTableViewController符合UIViewControllerPreviewingDelegate协议：

class RestaurantTableViewController: UITableViewController, NSFetchedResultsControllerDelegate, UISearchResultsUpdating, UIViewControllerPreviewingDelegate {

实现UIViewControllerPreviewingDelegate协议的方法：

  // 当按压时调用（peek）
  func previewingContext(_ previewingContext: UIViewControllerPreviewing, viewControllerForLocation location: CGPoint) -> UIViewController? {
      // 1
      guard let indexPath = tableView.indexPathForRow(at: location) else {
          return nil
      }
      // 2
      guard let cell = tableView.cellForRow(at: indexPath) else {
          return nil
      }
      // 3
      guard let restaurantDetailViewController = storyboard?.instantiateViewController(withIdentifier: "RestaurantDetailViewController") as? RestaurantDetailViewController else {
          return nil
      }
      
      let selectedRestaurant = restaurants[indexPath.row]
      restaurantDetailViewController.restaurant = selectedRestaurant
      // 4
      restaurantDetailViewController.preferredContentSize = CGSize(width: 0.0, height: 450.0)
      
      previewingContext.sourceRect = cell.frame
      
      return restaurantDetailViewController
  }
  // pop时调用
  func previewingContext(_ previewingContext: UIViewControllerPreviewing, commit
      viewControllerToCommit: UIViewController) {
      show(viewControllerToCommit, sender: self)
  }