iOS 3D touch 之 Home Screen Quick Action 的创建

由于 3D touch 的功能 iPhone 的模拟器并不支持、但是这并不能阻止我们进行调试
在 gitHub 早有大神提供了模拟器调试 Quick Action 的方法
项目的地址是：https://github.com/DeskConnect/SBShortcutMenuSimulator
下面简单介绍一下安装的步骤：
打开终端

git clone https://github.com/DeskConnect/SBShortcutMenuSimulator.git
cd SBShortcutMenuSimulatmake

如果电脑中有多个Xcode版本，先做如下操作，如果只有Xcode7 那么你可以跳过此步

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

这里需要注意的是：上面命令中，Xcode2.app 是你电脑中Xcode的名字
如果名字中有空格，需要修改一下，把空格去掉，否则会影响终端命令的正常执行。

然后你需执行如下命令进入 SBShortcutMenuSimulator 的目录

cd SBShortcutMenuSimulatmake

继续执行下面的两个命令

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

看到终端输出下面这些提示 说明服务已经配置成功了
Service configured for next launch.

接着我们就可以通过向指定端口发送消息的方法来在模拟器上 模拟 3D Touch 的效果：

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

需要注意的是 单引号中 com.apple.mobilecal 是应用的 Bundle ID
如果要测试你自己的应用，直接将其改成你们应用的 Bundle ID 即可
上面的 'com.apple.mobilecal' iOS系统的日历
我们可以看一下模拟器上的效果：

Simulator Screen Shot 2015年11月27日 下午4.01.19

* 这里不得不提一下 apple 公司考虑事情确实很周到

当我们的 app 在屏幕的靠左边的位置时
3D touch 的菜单弹出时 图片在左边、文字在右边 如上图所示的样子

---------------------- 牛逼的分割线 ----------------------

相反当我们的 app 在屏幕的右边时
3D touch 的菜单弹出时 图片在右边、文字在左边 如下图所示

Simulator Screen Shot 2015年11月27日 下午4.02.50.png

接下来就是如何将装逼进行到底
如何创建 Quick Action 也就是重按 app 图标时弹出的那几个菜单

imooc 免费 IT 教育

正如上面的图中有两个Action Item 【历史记录】【查看下载】
每个 Action 都是使用 UIApplicationShortcutItem 这个对象进行创建的
下面列出每一个 UIApplicationShortcutItem 中能够包含的信息：

名称	描述	必须
UIApplicationShortcutItemType	item事件的唯一标示、通过茨表示可以确定点击的那个item	YES
UIApplicationShortcutItemTitle	item的标题、subtitle为空时、title过长可能会换行显示	YES
UIApplicationShortcutItemSubtitle	item的子标题、在title下方以小文字显示	NO
UIApplicationShortcutItemIconType	item图标枚举、系统的样式	NO
UIApplicationShortcutItemIconFile	自定义item图标、大小为 35*35 的单一颜色样式呈现、 如果设置此项 UIApplicationShortcutItemIconType 将会失效	NO
UIApplicationShortcutItemUserInfo	以字典的形式 key : value	NO

* Home Screen Quick Action 的创建 有两种方式

1. 静态
2. 动态

* 需要注意的是
每个App最多能够显示 4个Action Item，4个Action Item，4个Action Item
重要的事情要说 三 遍 最多4个Action Item
支持【静态方式】和【动态方式】同时存在、并不会冲突
如果你比较够叛逆、够任性、同时使用了【静态】和【动态】方式
那么你给 UIApplication 的 shortcutItems 这个数组赋值的时候并不会覆盖、并不会覆盖、并不会覆盖
我又说了三遍... 见谅

• 静态方式

  静态创建的方式是在项目的 Info.plist 文件中添加数组即可

  <key>UIApplicationShortcutItems</key>
  <array>
       <dict>
          <key>UIApplicationShortcutItemType</key>
          <string>download</string> 
          <key>UIApplicationShortcutItemTitle</key>
          <string>历史记录</string>
          <key>UIApplicationShortcutItemSubtitle</key>
          <string></string>
          <key>UIApplicationShortcutItemIconFile</key>            
          <string>shortcut_history.png</string>
          <key>UIApplicationShortcutItemUserInfo</key>
          <dict>
                   <key>***</key>
                   <string>***</string>
          </dict>
       </dict> 
       <dict> 
             <key>UIApplicationShortcutItemType</key>
             <string>download</string>
             <key>UIApplicationShortcutItemTitle</key>
             <string>查看下载</string>
             <key>UIApplicationShortcutItemSubtitle</key>
             <string></string>
             <key>UIApplicationShortcutItemIconFile</key>
             <string>shortcut_download.png</string>
             <key>UIApplicationShortcutItemUserInfo</key>
             <dict> 
                  <key>***</key>
                  <string>***</string>
             </dict>
       </dict>
  </array>

• 动态方式

  动态方式需要在 application didFinishLachingWithOption: 方法中实现

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 
{
      if (self.forceTouchCapability == UIForceTouchCapabilityAvailable) {
          // 为了更直观的阅读代码 这里分成两行写
          UIApplicationShortcutIcon *historyIcon;
          historyIcon = [UIApplicationShortcutIcon iconWithTemplateImageName:@"shortcut_history"];
          UIApplicationShortcutItem *historyItem = [[UIApplicationShortcutItem alloc]
                                                    initWithType:@"history"
                                                    localizedTitle:@"历史记录"
                                                    localizedSubtitle:nil
                                                    icon:historyIcon
                                                    userInfo:nil];

           // 为了更直观的阅读代码 这里分成两行写
          UIApplicationShortcutIcon *downloadIcom;
          downloadIcom = [UIApplicationShortcutIcon iconWithTemplateImageName:@"shortcut_download"];
          UIApplicationShortcutItem *downloadItem = [[UIApplicationShortcutItem alloc]
                                                     initWithType:@"download"
                                                     localizedTitle:@"查看下载"
                                                     localizedSubtitle:nil
                                                     icon:downloadIcom
                                                     userInfo:nil];

          application.shortcutItems = @[historyItem, downloadItem];
    }
}

关于Quick Action 中 item 的点击事件 回调响应

- (void)application:(UIApplication *)application 
           performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem     
           completionHandler:(void (^)(BOOL))completionHandler {

}

我可以从 shortcutItem 的 type 和 userinfo 来做不同的事件处理
而最后的 completionHandler 在 API 的说明中我们看到当应用并非在后台
而是直接重新开进程的时候，会直接返回NO 这样的话我们的回调会放在

- (BOOL)application:(UIApplication *)application 
        didFinishLaunchingWithOptions:(NSDictionary *)launchOptions;

这时候 UIApplication 刚好提供了一个可以从 launchOptions 这个字典中
获取到 shortcutItem 的 key UIApplicationLaunchOptionsShortcutItemKey
有了这个Key 我们就可以处理不同的事件

UIApplicationShortcutItem *item;  // 为了更直观的阅读代码 这里分成两行写
item = [launchOptions valueForKey:UIApplicationLaunchOptionsShortcutItemKey];

这样我们根据获取到不同的 Action Item 来处理不同的事件
在 performActionForShortcutItem 回调中

- (void)application:(UIApplication *)application 
        performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem
        completionHandler:(void(^)(BOOL succeeded))completionHandler  
{
        if ([shortcutItem.type isEqualToString:@"history"]) {
            NSLog(@"历史记录");
        }else if ([shortcutItem.type isEqualToString:@"download"]){
            NSLog(@"查看下载");
        }
        if (completionHandler) { 
              completionHandler(YES); 
        }
}