美文网首页ios框架我的ios进阶iOS学习开发
浅谈3D Touch(1) -- Home screen qui

浅谈3D Touch(1) -- Home screen qui

作者: 尛破孩波波 | 来源:发表于2016-03-29 11:21 被阅读96次

    1. 背景:

    随着iOS9 和 iPhone 6s的普及,苹果官方提供的3D Touch将带给我们更好玩,更便捷的操作习惯,桌面快捷菜单可谓是3D Touch功能中最实用的一个,有了它,用户不再需要进入app后做额外的操作,便能快速进入指定的页面。

    2. 前期工作:

    由于手头“并(wo)没(xiang)有(yao)”iPhone 6s 的设备,很多人说,那我怎么开发这个功能呢?不怕,github上早有大神写好了模拟器的解决方案。按照这个文档上的方法依次执行,你的模拟器也能唤出快捷菜单。

    3. 正式接入

    ①.创建UIApplicationShortcutItem

    我们先来看一下每个UIApplicationShortcutItem中能够包含哪些信息

    key Description required
    UIApplicationShortcutItemType 事件的唯一标识,可以通过这个标识来辨别你具体点击了哪个事件 Y
    UIApplicationShortcutItemTitle 标题,在没有子标题的情况下如果标题太长能自动换行 Y
    UIApplicationShortcutItemSubtitle 子标题,在标题的下方 N
    UIApplicationShortcutItemIconType 枚举选取系统中的一个图标类型 N
    UIApplicationShortcutItemIconFile 自定义一个图标,以单一颜色35x35的大小展示,如果设置这个,UIApplicationShortcutItemIconType将不起作用 N
    UIApplicationShortcutItemUserInfo 字典,里面可以添加各种key、value对 N

    UIApplicationShortcutItem 的创建有2种方式

    • 第一种是在info.plist里面静态添加:
    <key>UIApplicationShortcutItems</key>
    <array>
        <dict>
            <key>UIApplicationShortcutItemType</key>
            <string>3dtouch.homePage</string>
            <key>UIApplicationShortcutItemTitle</key>
            <string>首页</string>
            <key>UIApplicationShortcutItemSubtitle</key>
            <string>这是首页</string>
            <key>UIApplicationShortcutItemIconFile</key>
            <string>shouye.png</string>
            <key>UIApplicationShortcutItemUserInfo</key>
            <dict>
                <key>url</key>
                <string>index</string>
            </dict>
        </dict>
        <dict>
            <key>UIApplicationShortcutItemType</key>
            <string>3dtouch.guanzhupage</string>
            <key>UIApplicationShortcutItemTitle</key>
            <string>关注</string>
            <key>UIApplicationShortcutItemSubtitle</key>
            <string>这是关注</string>
            <key>UIApplicationShortcutItemIconFile</key>
            <string>guanzhu.png</string>
            <key>UIApplicationShortcutItemUserInfo</key>
            <dict>
                <key>url</key>
                <string>guanzhu</string>
            </dict>
        </dict>
    </array>
    
    • 第二种是在程序初始化的时候用代码动态添加:

    我们先看一下UIApplicationShortcutItem.h,发现它的使用非常简单,习惯完全符合官方API固有方式,而且和之前那种方式所构建的包含的信息是一一对应的,其中有3个@interface分别是:

    • UIApplicationShortcutIcon
    • UIApplicationShortcutItem
    • UIMutableApplicationShortcutItem
    //创建快捷item的icon 即UIApplicationShortcutItemIconFile
    UIApplicationShortcutIcon *icon1 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"money"];
    
    UIApplicationShortcutIcon *icon2 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"gouwuche"];
    
    UIApplicationShortcutIcon *icon3 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"wode"];
        
    //创建快捷item的userinfo 即UIApplicationShortcutItemUserInfo
    NSDictionary *info1 = @{@"url":@"money"};
    NSDictionary *info2 = @{@"url":@"gouWuche"};
    NSDictionary *info3 = @{@"url":@"wode"};
        
    //创建ShortcutItem
    UIMutableApplicationShortcutItem *item1 = [[UIMutableApplicationShortcutItem alloc]initWithType:@"3dtouch.moneyPage" localizedTitle:@"资产" localizedSubtitle:@"这是资产" icon:icon1 userInfo:info1];
    
    UIMutableApplicationShortcutItem *item2 = [[UIMutableApplicationShortcutItem alloc]initWithType:@"3dtouch.shopPage" localizedTitle:@"购物车" localizedSubtitle:@"这是购物车" icon:icon2 userInfo:info2];
    
    UIMutableApplicationShortcutItem *item3 = [[UIMutableApplicationShortcutItem alloc]initWithType:@"3dtouch.mypage" localizedTitle:@"我的" localizedSubtitle:@"这是我的" icon:icon3 userInfo:info3];
        
    //把原有的shortcutItems拿出来,把动态的放进去
    NSArray *items = @[item1, item2, item3];
    
    NSArray *existingItems = [UIApplication sharedApplication].shortcutItems;
    
    NSArray *updatedItems = [existingItems arrayByAddingObjectsFromArray:items];
        
    //塞回去
    [UIApplication sharedApplication].shortcutItems = updatedItems;
    

    最后我们来看一下效果:

    img_1

    看上去是不是非常和谐?其实我告诉你,我们已经踩到了坑里了

    我在运行中发现:

    NSArray *existingItems = [UIApplication sharedApplication].shortcutItems;
    

    所获得的existingItems并不是我们之前设置在info.plist里面的,而是上一次

    [UIApplication sharedApplication].shortcutItems = updatedItems;
    

    赋值给他的,又因为我自作聪明的做了一次

    NSArray *updatedItems = [existingItems arrayByAddingObjectsFromArray:items];
    

    所以我们每运行一次,shortcutItems中的元素个数就会多3个,

    img_2

    那为什么展示出来没有问题呢?

    仔细看刚刚发的那张效果图,我擦,只有4个,对了,这个就是表象上不出错的原因,在API上并没有写shortcutItems有任何个数限制,也没有写快捷窗口的个数,但是实际上,最多只能显示4个,而且shortcutItems这个里面的对象恐怕是早已被系统默默的存到了某个plist里了,每当程序启动时,会向系统要app的Bundle Identifier对应的shortcutItems,并非我们事先想要的info.plist中的items,当然以上只是我从现象做出的合理猜测,我们并不需要关心info.plist中的那些静态item,只需要动态创建的item直接打包赋值过去

    [UIApplication sharedApplication].shortcutItems = @[item1, item2, item3];
    

    至于只展示4个的问题,这个我们无能为力了,系统做了限制。

    ②.Item点击回调

    当app在后台的时候UIApplication提供了一个回调方法

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

    我们依据这个回调中的shortcutItem的type和userinfo来做出不同的事件处理,而最后的completionHandler在API的说明中我们看到当应用并非在后台,而是直接重新开进程的时候,直接返回No,那么这个时候,我们的回调会放在

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

    UIApplication又给我们一个从launchOptions中获取这个shortcutItem的key--UIApplicationLaunchOptionsShortcutItemKey,所以在这2个都进行对shortcutItem的操作后,我们这个功能算是完成了

    在didFinishLaunchingWithOptions中,由于某些客户端会有启动动画,所以这边加了3秒,具体因程序而异

    UIApplicationShortcutItem *item = [launchOptions valueForKey:UIApplicationLaunchOptionsShortcutItemKey];
    __weak typeof(self) weakSelf = self;
    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
        __strong typeof(weakSelf) strongSelf = weakSelf;
        if (strongSelf)
        {
            [strongSelf actionWithShortcutItem:item];
        }
    });
    

    在performActionForShortcutItem回调中

    - (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void(^)(BOOL succeeded))completionHandler
    {
        if (shortcutItem)
        {
            [self actionWithShortcutItem:shortcutItem];
        }
        
        if (completionHandler)
        {
            completionHandler(YES);
        }
    }
    

    最后就是统一处理actionWithShortcutItem的地方,由于我这个demo中所有的type对应的行为都一样的,所以我这边没有对type做区分,甚至所以的item可以用同一个type

    -(void)actionWithShortcutItem:(UIApplicationShortcutItem *)item
    {
        if (item.userInfo)
        {
            NSLog(@"%@",item.userInfo[@"url"]);
        }
    }
    

    好了,3D Touch的第一个功能就介绍到这里 Demo

    相关文章

      网友评论

        本文标题:浅谈3D Touch(1) -- Home screen qui

        本文链接:https://www.haomeiwen.com/subject/pkkslttx.html