在项目中需要添加 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
代码配置如下
<key>UIApplicationShortcutItems</key>
<array>
<dict>
<key>UIApplicationShortcutItemTitle</key>
<string>Add</string>
<key>UIApplicationShortcutItemType</key>
<string>com.ju.demo.add</string>
<key>UIApplicationShortcutItemIconType</key>
<string>UIApplicationShortcutIconTypeAdd</string>
</dict>
</array>
可以在里面配置【类型，主标题，副标题，图片等】
在 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 都实现了
