3D touch 静态、动态设置及进入APP的跳转方式

申明Quick Action有两种方式：静态和动态

静态是在info.plist文件中申明，动态则是在代码中注册，系统支持两者同时存在。

-系统限制每个app最多显示4个快捷图标，包括静态和动态

静态

在app的plist文件中增加如下申明：

<key>UIApplicationShortcutItems</key>
<array>
<dict>

    <key>UIApplicationShortcutItemIconType</key>
    <string>UIApplicationShortcutIconTypeSearch</string>

    <key>UIApplicationShortcutItemSubtitle</key>
    <string>shortcutSubtitle1</string>

    <key>UIApplicationShortcutItemTitle</key>
    <string>shortcutTitle1</string>

    <key>UIApplicationShortcutItemType</key>
    <string>First</string>

    <key>UIApplicationShortcutItemUserInfo</key>
    <dict>
    <key>firstShorcutKey1</key>
    <string>firstShortcutKeyValue1</string>
   </dict>

</dict>
</array>

UIApplicationShortcutItemType：其实是快捷方式的id，唯一标签

UIApplicationShortcutItemTitle：标题

UIApplicationShortcutItemSubtitle：副标题

UIApplicationShortcutItemIconType：图标

UIApplicationShortcutItemIconFile：自定义图标，上面IconType定义将被忽略。图标格式35x35像素单色。

UIApplicationShortcutItemUserInfo：额外信息

系统自带图标的样式分别是：

UIApplicationShortcutIconTypeCompose,

UIApplicationShortcutIconTypePlay,

UIApplicationShortcutIconTypePause,

UIApplicationShortcutIconTypeAdd,

UIApplicationShortcutIconTypeLocation,

UIApplicationShortcutIconTypeSearch,

UIApplicationShortcutIconTypeShare,

UIApplicationShortcutIconTypeProhibit NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeContact NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeHome NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeMarkLocation NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeFavorite NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeLove NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeCloud NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeInvitation NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeConfirmation NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeMail NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeMessage NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeDate NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeTime NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeCapturePhoto NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeCaptureVideo NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeTask NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeTaskCompleted NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeAlarm NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeBookmark NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeShuffle NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeAudio NS_ENUM_AVAILABLE_IOS(9_1),

UIApplicationShortcutIconTypeUpdate NS_ENUM_AVAILABLE_IOS(9_1)

NS_ENUM_AVAILABLE_IOS(9_1) 有这个的是在9.1 系统后才支持的，注意下哈。

上面的看不懂，没关系，照着下面的图打，就行。

我打的时候，没提示，打错一个字母就没效果。

实际效果：

动态

UIApplication对象多了一个支持快捷方式的数组

@property(nonatomic, copy) NSArray <UIApplicationShortcutItem *> *shortcutItems

如果需要增加快捷方式，可以赋值给shortcutItems属性。

如果静态和动态方式同时使用的话，赋值的时候也不会覆盖静态方式申明的快捷方式，不用担心。

UIApplicationShortcutItem对象init方法

(instancetype)initWithType:(NSString *)type 
      localizedTitle:(NSString *)localizedTitle
   localizedSubtitle:(NSString *)localizedSubtitle
                icon:(UIApplicationShortcutIcon *)icon
            userInfo:(NSDictionary *)userInfo`

各个字段跟上面静态方式申明的时候意义一样。

其中定义快捷方式图标UIApplicationShortcutIcon，有3种init方法：

// 根据系统预置图标类型
-(instancetype)iconWithType:(UIApplicationShortcutIconType)type

// 根据app bundle里面的图标名称自定义
-(instancetype)iconWithTemplateImageName:(NSString *)templateImageName

// 根据通讯录联系人名称
-(instancetype)iconWithContact:(CNContact *)contact`



// 下面demo， 可以直接复制进入application.m 里使用

//快捷方式响应方法

- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void(^)(BOOL succeeded))completionHandler NS_AVAILABLE_IOS(9_0) __TVOS_PROHIBITED{

/* //这是我的demo里面的控制器跳转方法，原理就是根据shortcutItem.type 判断跳转页面

　UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
    ViewController *mainView = [storyboard instantiateViewControllerWithIdentifier:@"mainController"];
    UINavigationController *mainNav = [[UINavigationController alloc] initWithRootViewController:mainView];
    self.window.rootViewController = mainNav;
    [self.window makeKeyAndVisible];

    //判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作
    if([shortcutItem.type isEqualToString:@"Video" ]){
        VideoViewController *videoVC= [VideoViewController new];
        [self.window.rootViewController presentViewController:videoVC animated:YES completion:^{
        }];
    } else if ([shortcutItem.type isEqualToString:@"PIC"]) {
        PICViewController *picVC = [PICViewController new];
        [mainNav pushViewController:picVC animated:NO];
    } else if ([shortcutItem.type isEqualToString:@"NEW"]) {
        NewViewController *newVC = [NewViewController new];
        [mainNav pushViewController:newVC animated:NO];
    }

    if (completionHandler) {
        completionHandler(YES);
    }
*/

// 打印userInfo （传值用） type（这是快捷方式的唯一标签，根据它的返回值进行判断，在执行需要的操作）

    NSLog(@"userInfo %@ type %@",shortcutItem.userInfo,shortcutItem.type);

}
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    //代码的方式添加快捷方式动态
    if (application.shortcutItems.count==0) {
        //
        UIMutableApplicationShortcutItem *shortItem1=[[UIMutableApplicationShortcutItem alloc] initWithType:@"UIApplicationShortcutIconTypePlay" localizedTitle:@"段子" localizedSubtitle:@"进入段子" icon:[UIApplicationShortcutIcon iconWithType: UIApplicationShortcutIconTypePlay]userInfo:@{@"firstShortcutKey1":@"fristShorcut"}];
        UIMutableApplicationShortcutItem *shortItem2=[[UIMutableApplicationShortcutItem alloc] initWithType:@"UIApplicationShortcutIconTypePlay" localizedTitle:@"视频" localizedSubtitle:@"进入视频" icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypePause] userInfo:@{@"firstShortcutKey1":@"secondShorcut"}];
         UIMutableApplicationShortcutItem *shortItem3=[[UIMutableApplicationShortcutItem alloc] initWithType:@"UIApplicationShortcutIconTypePlay" localizedTitle:@"图片" localizedSubtitle:@"进入图片" icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypePause] userInfo:@{@"firstShortcutKey1":@"thridShorcut"}];
         UIMutableApplicationShortcutItem *shortItem4=[[UIMutableApplicationShortcutItem alloc] initWithType:@"UIApplicationShortcutIconTypePlay" localizedTitle:@"资讯" localizedSubtitle:@"进入资讯" icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypePause] userInfo:@{@"firstShortcutKey1":@"fiveShorcut"}];

        application.shortcutItems=@[shortItem1,shortItem2,shortItem3,shortItem4];

    }
    return YES;

}

测试效果如下：

最后一个小点： APP 图标在屏幕的哪侧，快捷方式就在哪侧。

右边

左边：