安卓aosp 16新特性分屏收藏保存功能AppPairIcon剖析

背景前面一篇blog仿oppo三星samsung手机分屏收藏代码实现有给大家展示分屏收藏功能相关的实现详细步骤等最后也实行了这种分屏收藏demo这些都是自己在aosp14版本实现的。不过在文章发布后vip学员朋友反馈发现在aosp16版本上安卓已经自带实现了这个分屏收藏的功能所以本文将带大家以前来探索google官方是如何实现这个分屏收藏功能对这块功能的源码进行相关的剖析。功能展示先打开2个task而且操作进入分屏在分屏的画面下点击最近任务进入分屏可以看到分屏的task卡片。在安卓16版本上在分屏情况下再进入最近任务可以看到这时候有分屏的两个task的卡片点击双图标点击后会出现如下弹框发现有一个Save app pair点击这个“Save app pair”按钮其实字面意思就可以理解这个按钮就是保存这对app的task卡片图标点击后桌面出现多了一个刚才分屏的两个app图标的app点击后直接可以进入分屏。源码剖析创建AppPairIcon部分剖析以“Save app pair”按钮为切入点分析packages/apps/Launcher3/quickstep/src/com/android/quickstep/TaskShortcutFactory.javaOverridepublicvoidonClick(View view){dismissTaskMenuView();//核心就是调用了AppPairsController的saveAppPair方法((RecentsView)mTarget.getOverviewPanel()).getSplitSelectController().getAppPairsController().saveAppPair(mTaskView);}下面重点看看AppPairsController的saveAppPair方法部分saveAppPair方法剖析/** * Creates a new app pair ItemInfo and adds it to the workspace. * br * We create WorkspaceItemInfos to save onto the app pair in the following way: * br 1. We verify that the ComponentKey from our Recents tile corresponds to a real * launchable app in the app store. * br 2. If it doesnt, we search for the underlying launchable app via package name, and use * that instead. * br 3. If that fails, we re-use the existing WorkspaceItemInfo by cloning it and replacing * its intent with one from PackageManager. * br 4. If everything fails, we just use the WorkspaceItemInfo as is, with its existing * intent. This is not preferred, but will still work in most cases (notably it will not work * well on trampoline apps). */publicvoidsaveAppPair(GroupedTaskView gtv){//参数类型GroupedTaskView中包含了分屏两个Task的相关信息//通过GroupedTaskView获取TaskViewItemInfo和WorkspaceItemInfo信息ListTaskViewItemInforecentsInfosgtv.getTaskContainers().stream().map(TaskContainer::getItemInfo).toList();//注意这里resolveAppPairWorkspaceInfo是一个匹配方法核心就是匹配componentNameListWorkspaceItemInfoappsrecentsInfos.stream().map(this::resolveAppPairWorkspaceInfo).toList();for(inti0;iapps.size();i){apps.get(i).rankencodeRank(getIndex(i),snapPosition);}//根据两个task对应的WorkspaceItemInfo信息创建AppPairInfo对象AppPairInfo newAppPairnewAppPairInfo(apps);IconCache iconCacheLauncherAppState.getInstance(mContext.asContext()).getIconCache();MODEL_EXECUTOR.execute(()-{//根据newAppPair创建对应的桌面分屏两个小图标newAppPair.getAppContents().forEach(member-{member.title;member.bitmapiconCache.getDefaultIcon(newAppPair.user);iconCache.getTitleAndIcon(member,member.getMatchingLookupFlag());});MAIN_EXECUTOR.execute(()-{LauncherAccessibilityDelegate delegateQuickstepLauncher.getLauncher(mContext.asContext()).getAccessibilityDelegate();if(delegate!null){//调用addToWorkspace方法添加newAppPair信息到桌面delegate.addToWorkspace(newAppPair,true,(success)-{});}});});}这saveAppPair方法里面核心步骤有以下几个1、参数GroupedTaskView转换成TaskViewItemInfo信息2、TaskViewItemInfo信息转换WorkspaceItemInfo信息3、使用WorkspaceItemInfo构造AppPairInfo信息4、根据AppPairInfo创建对应的桌面图标Icon5、调用addToWorkspace把这个AppPairInfo对应的Icon添加到桌面UI及保存相关数据信息addToWorkspace这块就不展开了熟悉桌面同学都懂这个。点击AppPairIcon部分剖析packages/apps/Launcher3/src/com/android/launcher3/touch/ItemClickHandler.javaprivatestaticvoidonClick(View v){Object tagv.getTag();if(tag instanceof WorkspaceItemInfo){onClickAppShortcut(v,(WorkspaceItemInfo)tag,launcher);}elseif(tag instanceof FolderInfo){onClickFolderIcon(v);}elseif(tag instanceof AppPairInfo){//针对AppPairInfo类型的桌面图标调用onClickAppPairIcon方法onClickAppPairIcon(v);}看看onClickAppPairIcon方法privatestaticvoidonClickAppPairIcon(View v){// Either the app pair is not disabled, or it is a disabled state that can be handled by// framework directly (e.g. one app is paused), so go ahead and launch.launcher.launchAppPair(icon);//核心就是调用launchAppPair}这里再来看看 launcher.launchAppPair方法在QuickstepLauncher中packages/apps/Launcher3/quickstep/src/com/android/launcher3/uioverrides/QuickstepLauncher.java/** * Launches two apps as an app pair. */publicvoidlaunchAppPair(AppPairIcon appPairIcon){// Potentially show the Taskbar education once the app pair launch finishes//可以看到最后调用到了SplitSelectStateController的launchAppPair方法mSplitSelectStateController.getAppPairsController().launchAppPair(appPairIcon,CUJ_LAUNCHER_LAUNCH_APP_PAIR_FROM_WORKSPACE,(success)-{if(successmTaskbarUIController!null){mTaskbarUIController.showEduOnAppLaunch();}});}下面看看launchAppPair具体实现packages/apps/Launcher3/quickstep/src/com/android/quickstep/util/SplitSelectStateController.java/** * Launches an app pair by searching the RecentsModel for running instances of each app, and * staging either those running instances or launching the apps as new Intents. * * param cuj Should be an integer from {link Cuj} or -1 if no CUJ needs to be logged for jank * monitoring * param callback Called after the app pair launch finishes animating, or null if no method is * to be called */publicvoidlaunchAppPair(AppPairIcon appPairIcon,intcuj,Nullable ConsumerBooleancallback){//核心调用findLastActiveTasksAndRunCallback来寻找当前活跃的taskmSplitSelectStateController.findLastActiveTasksAndRunCallback(Arrays.asList(app1Key,app2Key),false/* findExactPairMatch */,foundTasks-{//如果寻找到对应的活跃task则被放到foundTasks集合中Nullable Task foundTask1foundTasks[0];//访问集合中的taskIntent task1Intent;inttask1Id;if(foundTask1!null){//如果找到task则使用taks既可以task1IdfoundTask1.key.id;task1Intentnull;}else{//如果没找到task那么task1Id就为INVALID_TASK_IDtask1IdINVALID_TASK_ID;task1Intentapp1.intent;}//调用setInitialTaskSelect接口设置第一个要启动task相关变量mSplitSelectStateController.setInitialTaskSelect(task1Intent,AppPairsController.convertRankToStagePosition(app1.rank),app1,LAUNCHER_APP_PAIR_LAUNCH,task1Id);Nullable Task foundTask2foundTasks[1];//下面也是判断task2的情况来设置secondTask的情况if(foundTask2!null){mSplitSelectStateController.setSecondTask(foundTask2,app2);}else{mSplitSelectStateController.setSecondTask(app2.intent,app2.user,app2);}mSplitSelectStateController.setLaunchingIconView(appPairIcon);//最后调用launchSplitTasks进行两个task的启动mSplitSelectStateController.launchSplitTasks(AppPairsController.convertRankToSnapPosition(app1.rank),callback);});}再看看最核心launchSplitTasks方法publicvoidlaunchTasks(Nullable ConsumerBooleancallback,boolean freezeTaskList,PersistentSnapPositionintsnapPosition,Nullable InstanceId shellInstanceId){SplitSelectDataHolder.SplitLaunchData launchDatamSplitSelectDataHolder.getSplitLaunchData();intfirstTaskIdlaunchData.getInitialTaskId();intsecondTaskIdlaunchData.getSecondTaskId();ShortcutInfo firstShortcutlaunchData.getInitialShortcut();ShortcutInfo secondShortcutlaunchData.getSecondShortcut();PendingIntent firstPIlaunchData.getInitialPendingIntent();PendingIntent secondPIlaunchData.getSecondPendingIntent();Intent widgetIntentlaunchData.getWidgetSecondIntent();intfirstUserIdlaunchData.getInitialUserId();intsecondUserIdlaunchData.getSecondUserId();intinitialStagePositionlaunchData.getInitialStagePosition();//根据上面的数据情况识别不同的LaunchType然后调用不同的start接口switch(launchData.getSplitLaunchType()){caseSPLIT_TASK_TASK-//2个都有taskId类型情况mSystemUiProxy.startTasks(firstTaskId,optionsBundle,secondTaskId,null/* options2 */,initialStagePosition,snapPosition,remoteTransition,shellInstanceId);caseSPLIT_TASK_PENDINGINTENT-mSystemUiProxy.startIntentAndTask(secondPI,secondUserId,optionsBundle,firstTaskId,extrasBundle,initialStagePosition,snapPosition,remoteTransition,shellInstanceId);caseSPLIT_TASK_SHORTCUT-mSystemUiProxy.startShortcutAndTask(secondShortcut,optionsBundle,firstTaskId,null/*options2*/,initialStagePosition,snapPosition,remoteTransition,shellInstanceId);caseSPLIT_PENDINGINTENT_TASK-mSystemUiProxy.startIntentAndTask(firstPI,firstUserId,optionsBundle,secondTaskId,null/*options2*/,initialStagePosition,snapPosition,remoteTransition,shellInstanceId);caseSPLIT_PENDINGINTENT_PENDINGINTENT-//2个都没有taskId类型情况mSystemUiProxy.startIntents(firstPI,firstUserId,firstShortcut,optionsBundle,secondPI,secondUserId,secondShortcut,extrasBundle,initialStagePosition,snapPosition,remoteTransition,shellInstanceId);caseSPLIT_SHORTCUT_TASK-mSystemUiProxy.startShortcutAndTask(firstShortcut,optionsBundle,secondTaskId,null/*options2*/,initialStagePosition,snapPosition,remoteTransition,shellInstanceId);}}原文地址https://mp.weixin.qq.com/s/Ao7qN6uxxWjo1FLB6FZ9yA更多framework实战开发干货请关注“千里马学框架”