iOS 3D Touch

在项目中需要添加 3D Touch 功能， 虽然之前做过，但是一些细节的设置忘了，所以就写下来吧，权当作自己的复习

需要明白

• UITouch 里有一个 force 属性，它代表的是按压的力度
• UIViewController 的 peek 为开始按压作用的视图的动作， pop ：在peek的基础上继续按压
• UIApplicationShortcutItem 可以在按压应用的图标处添加一些快捷操作

Peek & Pop

1. 注册使用

    // MARK: - Register for 3D touch
    override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {
        super.traitCollectionDidChange(previousTraitCollection)
        switch traitCollection.forceTouchCapability {
        case .available:
            print("available")
            registerForPreviewing(with: self, sourceView: tableView)
        case .unavailable:
            print("unavailable")
        case .unknown:
            print("unknown")
        }
    }

（ tableView 可以改为作用的视图 ）

2. 实现代理

// MARK: - Peek & Pop
extension ViewController: UIViewControllerPreviewingDelegate {
    
    func previewingContext(_ previewingContext: UIViewControllerPreviewing, viewControllerForLocation location: CGPoint) -> UIViewController? {
        print("viewControllerForLocation")

        guard let indexPath = tableView.indexPathForRow(at: location),
            let cell = tableView.cellForRow(at: indexPath) else {
                return nil
        }
        
        let identifier = "DetailViewController"
        guard let detailVC = storyboard?.instantiateViewController(withIdentifier: identifier) as? DetailViewController else {
            return nil
        }
        
        // for peek & pop
        detailVC.item = TableItem.all[indexPath.row]
        previewingContext.sourceRect = cell.frame
        
        // for preview action
        detailVC.fromViewController = self

        return detailVC
    }
    
    func previewingContext(_ previewingContext: UIViewControllerPreviewing, commit viewControllerToCommit: UIViewController) {
        print("viewControllerToCommit")

        show(viewControllerToCommit, sender: self)
    }
}

其中 previewingContext(_:viewControllerForLocation:) 方法是在 peek 的时候调用的，此时可以做一些赋值操作（比如数据传递等），然后根据方法文档的提示需要设置一下 sourceRect ；

previewingContext(_:commitViewController:)方法是在 Pop 时调用的。

（需要注意的是在测试的时候发现
调用 previewingContext(:viewControllerForLocation:) 的时候 destination view controller 会调用一次 viewWillAppear & viewDidAppear了；
调用 previewingContext(:commitViewController:) 的时候 destination view controller 还会再次 调用一次 viewWillAppear & viewDidAppear）。

此时就能够使用 Peek & Pop功能了！

3. 添加 Preview actions

    // MARK: - Preview Action
    override var previewActionItems: [UIPreviewActionItem] {
        // default style
        let show = UIPreviewAction(title: "Show", style: .default) { (action, viewController) in
            guard let sourceVC = self.fromViewController,
                let desVC = self.storyboard?.instantiateViewController(withIdentifier: "DetailViewController") as? DetailViewController else {
                    return
            }
            desVC.fromViewController = sourceVC
            desVC.item = self.item
            sourceVC.show(desVC, sender: nil)
        }
        // selected style
        let check = UIPreviewAction(title: "selected", style: .selected) { (action, viewController) in
        }
        // delete style
        let delete = UIPreviewAction(title: "Delete", style: .destructive) { (action, viewController) in
            guard let sourceVC = self.fromViewController,
                let item = self.item else { return }
            TableItem.delete(item: item)
            sourceVC.tableView.reloadData()
        }
        
        return [show, check, delete]
    }

主要是在 destination view controller 里设置一些Action 的操作（类似于UIAlertController）

此时 Peek 的时候再向上滑动就可以看到相应的Action 了！

按压应用图标

app 的按压 shortcuts 共有两种类型：

• Static shortcuts, 直接在 Info.plist 里面配置，安装应用的时候就可以直接使用了
• Dynamic shortcuts，在 runtime 的时候配置，可以添加，删除。只有执行相关操作的时候才会在按压应用图标的时候显示

添加 static shortcut

屏幕快照 2017-09-06 下午5.57.02.png

代码配置如下

    UIApplicationShortcutItems
    
        
            UIApplicationShortcutItemTitle
            Add
            UIApplicationShortcutItemType
            com.ju.demo.add
            UIApplicationShortcutItemIconType
            UIApplicationShortcutIconTypeAdd
        
    

可以在里面配置【类型，主标题，副标题，图片等】

在 AppDelegate.swift实现相关操作

// MARK: - Home screen shortcuts
extension AppDelegate {
    
    func application(_ application: UIApplication, performActionFor shortcutItem: UIApplicationShortcutItem, completionHandler: @escaping (Bool) -> Void) {
        
        handleShortcutItem(shortcutItem: shortcutItem)
        completionHandler(true)
    }
    
    private func handleShortcutItem(shortcutItem: UIApplicationShortcutItem) {
        switch shortcutItem.type {
        case "com.ju.demo.add":   // static
            addNewOne()
            case "com.ju.demo.share":    // dynamic
            share()
        default:
            break
        }
    }
    
    // static method
    private func addNewOne() {
        if let newvc = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "NewViewController") as? NewViewController,
            let rootVC = window?.rootViewController?.targetViewController as? ViewController {
            newvc.delegate = rootVC
            let navc = UINavigationController(rootViewController: newvc)
            rootVC.present(navc, animated: true, completion: nil)
        }
    }
    
    // dynamic method
    private func share() {
        if let item = TableItem.all.first,
            let detailVC = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "DetailViewController") as? DetailViewController,
            let rootVC = window?.rootViewController?.targetViewController as? ViewController {
            detailVC.item = item
            detailVC.share = true
            rootVC.show(detailVC, sender: nil)
        }
    }
    
}

现在按压应用图标就可以使用 Static shortcuts 了

添加 dynamic shortcut

添加类似下面的方法

    static func configureDynamicShortcuts() {
        if all.count > 0 {
            let shortcutType = "com.ju.demo.share"
            let shortcutItem = UIApplicationShortcutItem(type: shortcutType,
                                                         localizedTitle: "Share",
                                                         localizedSubtitle: "share content",
                                                         icon: UIApplicationShortcutIcon(type: .share),
                                                         userInfo: nil)
            UIApplication.shared.shortcutItems = [shortcutItem]
        } else {
            UIApplication.shared.shortcutItems = []
        }
    }

方法做的是判断是否满足出现对应的 dynamic shortcut，满足条件显示，否则不显示

现在 Static shortcuts & Dynamic shortcuts 都实现了

Demo地址

Apple 3D Touch 文档