Handoff使用指南

Handoff简介

Handoff是iOS 8 和 OS X v10.10中引入的功能，可以让同一个用户在多台设备间传递项目。In iOS 9 and OS X v10.11 支持了Spotlight中搜索并打开应用。

Handoff交互：

1. 在你的app中为每一个活动创建一个user activity 对象
2. 定期使用用户的信息更新user activity对象
3. 当用户请求时在不同的设备上继续用户活动

在iOS中这个user activity object是UIKit中的 NSUserActivity类。

Handoff需要的硬性条件：

• 互通的所有设备必须支持 Buletooth LE 4.0，Handoff使用BLE信号来传递用户活动数据。

• 所有设备必须连到同一个iCloud账户。

• 当然你还得保证当前设备的Handoff功能打开了(iOS:设置->通用->Handoff 与建议的应用程序。 Mac:系统偏好设置->通用,倒数第二栏有个选项,"允许这台Mac和iCloud设备之间使用Handoff")

BLE并不像传统的蓝牙，并不需要人工手动进行配对，只要打开就行了，所有的配对数据传输都是自动完成的；设备并不一定需要连在同一个WIFI网络中，Handoff的活动基础数据通过BLE进行传递，较大的数据通过iCloud同步（通过网络streams，比如邮件中有个图片）。

工作流程

Handoff编程的核心类便是NSUserActivity了，代表着一个用户的活动，每一个Activity都有一个activityType，用来标识Activity的类型。当App间进行Handoff的话，需要满足下面几个条件：

• 在iCloud 中使用相同的 Apple ID登录

• 和发布Activity的App拥有相同的TeamID

• 在应用中你想要支持的Target的Info.plist文件中加入活动标识NSUserActivityTypes

第三方开发的app必须通过App Store发布或者使用注册开发者签名。启动了Handoff功能的app，在使用期间Handoff消息会通过BLE进行分发，iOS设备接收到消息后会检查与起始app是否具有相同TeamID以及相同NSUserActivityTypes，如果找到了则在“另一部”设备中显示推荐app。

User Activity 对象

NSUserActivity对象存储用户的活动信息，实现在不同设备上的继续工作。起始app必须显式调用becomeCurrent或者基于文件的app（Document-based apps）进入前台时，给在视图层级中的UIViewController对象设置文件的NSUserActivity对象来启用Handoff功能。将其设置resignCurrent或者Document-based app的NSUserActivity对象设置为nil停用。

NSUserActivity对象的唯一标示是 activityType and title 属性（document name or web page title）。通过eligibleForSearch、 keywords and contentAttributeSet 属性的支持，可以使其app支持Spotlight搜索结果中显示。通过 expirationDate设置失效时间。

NSUserActivity对象通过userInfo dictionary 属性来存储并共享数据信息。

User Activity 同步机制

User Activity的同步机制分两种：延时更新（lazy updating ）和系统管理。

• lazy updating 
  • 需要同步的用户数据有更新时，将User Activity对象的 needsSave属性设置为YES
  • NSUserActivity将要共享数据之前，会调用起始app的userActivityWillSave: 方法（NSUserActivityDelegate），在此方法中通过NSUserActivity method addUserInfoEntriesFromDictionary: 方法merge相关状态信息到userInfo 对象中。调用完此方法，系统会将needsSave属性重置为NO。
• 系统管理
  • 当响应者知道activity的状态已修改，它必须设置needsSave设置为YES（When the responder knows that the activity state is dirty, it must set the object’s needsSave property to YES. ）。系统会在合适的时间自动同步NSUserActivity 对象，首先会通过updateUserActivityState:回调给响应者更新activity’s state的机会。你的响应者子类必须重写updateUserActivityState:方法来给user activity对象添加状态数据(在此方法中通过NSUserActivity method addUserInfoEntriesFromDictionary: 方法merge相关状态信息到userInfo 对象中)。如果多个响应者共用一个NSUserActivity对象，当系统更新user activity对象时，它们都会收到updateUserActivityState:回调。在更新回调发送之前，activity对象的userInfo字典会被清空。

使用App Delegate来继续activity的使用

在非document app中，通过Handoff启动响应者app的时候，会在app的delegate中收到application:willContinueUserActivityWithType:和application:continueUserActivity:restorationHandler:消息，分四种情况处理：

1. 普通模式，正常处理
   1. 　　

      func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]!) -> Void) -> Bool {
          self.window?.rootViewController?.restoreUserActivityState(userActivity)
          return true
      }
      
      override func restoreUserActivityState(activity: NSUserActivity) {
          self.noteTitleField.text = activity.userInfo?["title"] as! String
          self.noteContentView.text = activity.userInfo?["content"] as! String
      }

2. 如果需要其他响应者或者文件对象来恢复user activity，则需要调用block，数组包括UIResponder集合，然后会让每个对象收到restoreUserActivityState: 消息。
3. 如果你继续的activity是通过搜索列表而来，那可以在这里重新设置keyword。
4. 如果没有实现application:continueUserActivity:restorationHandler:或者返回NO，并且app是基于文件的（document-based），AppKit可以自动恢复用默认的NSUserActivity对象。在这种情况，文件会使用NSDocumentController的方法openDocumentWithContentsOfURL:display:completionHandler: 来打开，并且会收到一条restoreUserActivityState: 消息。

基于文件的app中支持User Activity 

基于文件的app如果Info.plist中添加了CFBundleDocumentTypes则默认支持Handoff功能。NSUbiquitousDocumentUserActivityType 对应的字符串作为NSUserActivity对象的activity type。基于iCloud来同步文件，并且自动生成并存储到fileURL属性中，如果app delegate方法application:continueUserActivity:restorationHandler:返回NO，或者没有实现，那么AppKit可以自动恢复用上面方式创建的NSUserActivity对象。在这种情况，文件会使用NSDocumentController的方法openDocumentWithContentsOfURL:display:completionHandler: 来打开，并且会收到一条restoreUserActivityState: 消息。

总结

Handoff可以实现iOS8之后的设备之间的“连续互动”，基于UIDocument 的文件app（Info.plist实现了CFBundleDocumentTypes）则默认支持Handoff功能。非文件的app需要实现NSUserActivityTypes在Info.plist中，然后可以分为laze和系统管理两种同步机制。看的一些blog说需要连接同一网络，其实是没有必要的。可以通过apple自己提供的默认支持app来做测试（Mac 访问Safari，手机关闭wifi也会有提示）

iphone左下角的提醒应用图标的机制有三种方式,Handoff只是其中一种，后面我会有单独介绍着三种的实现及却别。

参考资料

https://developer.apple.com/library/ios/documentation/UserExperience/Conceptual/Handoff/HandoffFundamentals/HandoffFundamentals.html#//apple_ref/doc/uid/TP40014338-CH3-SW1