美文网首页
iOS 实现长按桌面图标弹出快捷选项

iOS 实现长按桌面图标弹出快捷选项

作者: 那月无痕 | 来源:发表于2023-08-29 14:15 被阅读0次

    苹果的3dtouch功能主要有3中呈现方式

    • 主屏交互(Home Screen Interaction)
    • 预览和跳转(Peek and Pop)
    • LivePhoto
      本文主要讲解一下前两种用法

    主屏交互

    所谓的主屏交互也就是在手机的桌面页,用力的按压(当然别太用力。。按碎了屏幕)应用图标,生成的几个快捷操作按钮的。

    主屏交互的按钮有指定的模型类,UIApplicationShortcutItem
    添加shortCutItem有两种方式:

    1. 静态添加
    2. 动态添加

    静态添加 shortCutItem

    这种方式主要是在工程的info.plist文件中添加相关的属性。
    如下图所示


    infoPlist.png
    • UIApplicationShortcutItemIconFile
      主屏交互中使用的按钮自定义图片名。
    • UIApplicationShortcutItemTitle
      主屏交互中使用的按钮名称。
    • UIApplicationShortcutItemType
      主屏交互中使用的按钮的唯一标示符,用作判断点击了哪一个快捷按钮。
    • UIApplicationShortcutItemSubtitle
      快捷可选项的子标题(可选)
    • UIApplicationShortcutItemIconType
      快捷可选项的图标(可选)
    • UIApplicationShortcutItemUserInfo
      快捷可选项的附加信息(可选)

    动态添加 shortCutItem

    UIApplicationShortcutItem:可以看作是3D Touch点击后,弹出菜单每行对应的模型,一行对应一个UIApplicationShortcutItem对象。
    动态添加时就是我们可以通过生成shortcutItem对象数组,添加给
    UIApplication单例对象.
    UIApplicationShortcutItem 初始方法如下

    - (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle localizedSubtitle:(nullable NSString *)localizedSubtitle icon:(nullable UIApplicationShortcutIcon *)icon userInfo:(nullable NSDictionary *)userInfo;
    
    
    • type
      快捷可选项的特定字符串(必填)
    • localizedTitle
      快捷可选项的标题(必填)
    • localizedSubtitle
      快捷可选项的子标题(可选)
    • icon
      快捷可选项的图标(可选)
    • userInfo
      快捷可选项的附加信息(可选)

    初始化生成对象这一步操作我们可以写在app的启动方法里:

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

    生成shortcutItem代码,以及赋值给UIApplication单例数组

    NSMutableArray *arrShortcutItem = (NSMutableArray *)[UIApplication sharedApplication].shortcutItems;
        
    UIApplicationShortcutItem *shoreItem1 = [[UIApplicationShortcutItem alloc] initWithType:@"co.erplus.search" localizedTitle:@"搜索" localizedSubtitle:nil icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeSearch] userInfo:nil];
    [arrShortcutItem addObject:shoreItem1];
        
    UIApplicationShortcutItem *shoreItem2 = [[UIApplicationShortcutItem alloc] initWithType:@"co.erplus.newTask" localizedTitle:@"新建任务" localizedSubtitle:@"" icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeCompose] userInfo:nil];
    [arrShortcutItem addObject:shoreItem2];
        
    [UIApplication sharedApplication].shortcutItems = arrShortcutItem;
    

    在动态添加快捷按钮时,我并没有选择使用自定义的图片,因为苹果也为我们准备了很多系统图标,也是非常丰富的。
    苹果准备的系统icon.jpg

    苹果的系统icon是丰富的,但如果想使用自定的图标icon,官方推荐一倍图使用35x35

    监听主屏交互按钮的点击事件

    成功设置好主屏交互的快捷按钮后,我们剩下要做的就是在APP内监听快捷按钮的点击事件,此时我们就需要用到UIApplicationShortcutItemType,快捷按钮的唯一标示符。

    - (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {
        //不管APP在后台还是进程被杀死,只要通过主屏快捷操作进来的,都会调用这个方法
        NSLog(@"name:%@\ntype:%@", shortcutItem.localizedTitle, shortcutItem.type);    
    }
    

    用这个方法就可以监听到按钮的点击事件了,通过shortcutItem.type区别点击的是哪一个按钮,进行不同的跳转或者操作。

    预览和跳转

    Peek and Pop 在操作上是指用户在手机屏幕上用力按压想要预览的选项位置,弹出一个可以预览二级页面的预览窗口,可以根据设置,设置一些快捷的操作选项,以类似sheetAlertView的方式呈现出来。

    预览.png

    根据上图流程,点击ListView中指定栏,会跳转到DetailView详情页,但加入3dtouch后,用力按压会出现Preview视图,力度到达最大极限会去到DetailView。

    1. 要完成Peek and Pop,首先要在ListView视图控制器需要遵守UIViewControllerPreviewingDelegate协议

    @interface ViewController () <uiviewcontrollerpreviewingdelegate>
    
    

    2. 在ListView控制器中注册3dtouch功能。

    [self registerForPreviewingWithDelegate:self sourceView:view];
    
    

    sourceView就是控制器上需要响应3dtouch的视图。

    3. ListView控制器实现peek方法

    - (nullable UIViewController *)previewingContext:(id <UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location NS_AVAILABLE_IOS(9_0) { }
    
    • previewingContext
      注册了3dtouch的视图,也就是sourceView。
    • location
      手指在屏幕上按压的位置,通常可以根据这个位置计算出是在按压哪一个单元格。

    在peek方法中返回了UIViewController,这个控制器就是会预览出来的控制器了,因为并没有对这个返回值受限,所以返回的预览视图是可以自定义的,即可以预览真是的二级页面视图,也可以自定义一个视图,包含一些关键内容给大家预览。

    注册心得:
    本人在学习使用3dtouch的时,看了很多开发者写的关于3dtouch使用的博客,大部分peek效果都会用在tableViewCell上,长按cell预览DetailView视图。因为在peek方法里需要设置一个previewingContext.sourceRect,用力按压中过度的一个效果,一般设置的范围就是cell的frame范围,为了方便的取到cell的frame,很多朋友的注册都写在了cellForRowAtIndexPath方法里。

    - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
    

    本人先开始也学习了这个方法,动态的注册了3dtouch,但在后来在使用应用中,ListView发生了惨烈的滑动卡顿问题,后来经过排查发现在cellForRowAtIndexPath方法里动态注册3dtouch严重消耗tableView的性能,造成了卡顿。

    建议将3dtouch注册在控制器的view或者tableView上,在页面生成的时候注册一次,然后通过peek方法中的location来计算点击的单元格位置,这样写在体验不变情况下,减少了性能的消耗。

    4. ListView控制器实现pop方法

    - (void)previewingContext:(id <UIViewControllerPreviewing>)previewingContext commitViewController:(UIViewController *)viewControllerToCommit NS_AVAILABLE_IOS(9_0) {
            NewTaskDetailVC *vc = [NewTaskDetailVC alloc] init];
            [self showViewController:vc sender:self];
    }
    

    pop方法是3dtouch 效果的最后一步了,用力的按压想要预览的单元格,力度达到了极限会直接进入到DetailView。
    在这个方法里做一般的Push操作就可以了。

    5.快捷菜单的生成(类sheetAlertView)

    如果我们需要在ListView快速预览视图出现时,向上拖拽得到一个快捷功能菜单,这个需要在DetailView中重写以下方法:

    - (NSArray<id<UIPreviewActionItem>> *)previewActionItems {
        
        NSMutableArray *arrItem = [NSMutableArray array];
        
        UIPreviewAction *previewAction0 = [UIPreviewAction actionWithTitle:@"开始任务" style:UIPreviewActionStyleDestructive handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
            
            NSLog(@"点击开始任务");
        }];
        
        UIPreviewAction *previewAction1 = [UIPreviewAction actionWithTitle:@"快速延期" style:UIPreviewActionStyleDefault handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
          
            NSLog(@"点击快速延期");
        }];
        
        [arrItem addObjectsFromArray:@[previewAction0 ,previewAction1]];
        
        return arrItem;
    }
    

    将这段代码加入到 DetailView中,在peek阶段向上滑动就可以出现类sheetAlertView的选项菜单栏了。

    相关文章

      网友评论

          本文标题:iOS 实现长按桌面图标弹出快捷选项

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