安卓开发- 安卓13 Launcher3 主页结构修改

修改主页结构

概述

​ 在 Android 操纵系统中，Launcher （主页应用）是用户与设备交互的核心界面之一，它负责显示应用程序列表、提供快捷方式、管理小部件等功能。其中，Launcher3 是 Android 系统默认的启动器应用程序，我们可以通过修改Launcher3的源码，来改变主页应用的样式和结构。下面将联合源码，分析如何修改Launcher3主页的相关样式和结构。
结构构成

​ Launcher3最核心的类是一个Launcher.java（可以看作是Launcher中的MainActivity），基本上所有操纵(包括UI的定制)都会合在这个Activity上。在Launcher.java 中，通过setContentView()设置的结构参数是R.layout.launcher，对应的是launcher.xml文件，它定义了启动器界面的整体结构和组件的位置，我们看下这个结构文件里的内容：

1. <?xml version="1.0" encoding="utf-8"?>
2. <com.android.launcher3.LauncherRootView
3.     xmlns:android="http://schemas.android.com/apk/res/android"
4.     xmlns:launcher="http://schemas.android.com/apk/res-auto"
5.     android:id="@+id/launcher"
6.     android:layout_width="match_parent"
7.     android:layout_height="match_parent"
8.     android:fitsSystemWindows="true">
10.     <com.android.launcher3.dragndrop.DragLayer
11.         android:id="@+id/drag_layer"
12.         android:layout_width="match_parent"
13.         android:layout_height="match_parent"
14.         android:clipChildren="false"
15.         android:clipToPadding="false"
16.         android:importantForAccessibility="no">
18.         <com.android.launcher3.views.AccessibilityActionsView
19.             android:layout_width="match_parent"
20.             android:layout_height="match_parent"
21.             android:contentDescription="@string/home_screen"
22.             />
24.         <!-- The workspace contains 5 screens of cells -->
25.         <!-- DO NOT CHANGE THE ID -->
26.         <com.android.launcher3.Workspace
27.             android:id="@+id/workspace"
28.             android:layout_width="match_parent"
29.             android:layout_height="match_parent"
30.             android:layout_gravity="center"
31.             android:theme="@style/HomeScreenElementTheme"
32.             launcher:pageIndicator="@+id/page_indicator" />
34.         <!-- DO NOT CHANGE THE ID -->
35.         <include
36.             android:id="@+id/hotseat"
37.             layout="@layout/hotseat" />
39.         <!-- Keep these behind the workspace so that they are not visible when
40.          we go into AllApps -->
41.         <com.android.launcher3.pageindicators.WorkspacePageIndicator
42.             android:id="@+id/page_indicator"
43.             android:layout_width="match_parent"
44.             android:layout_height="@dimen/workspace_page_indicator_height"
45.             android:layout_gravity="bottom|center_horizontal"
46.             android:theme="@style/HomeScreenElementTheme" />
48.         <include
49.             android:id="@+id/drop_target_bar"
50.             layout="@layout/drop_target_bar" />
52.         <com.android.launcher3.views.ScrimView
53.             android:layout_width="match_parent"
54.             android:layout_height="match_parent"
55.             android:id="@+id/scrim_view"
56.             android:background="@android:color/transparent" />
58.         <include
59.             android:id="@+id/apps_view"
60.             layout="@layout/all_apps"
61.             android:layout_width="match_parent"
62.             android:layout_height="match_parent" />
64.         <include
65.             android:id="@+id/overview_panel"
66.             layout="@layout/overview_panel" />
68.     </com.android.launcher3.dragndrop.DragLayer>
70. </com.android.launcher3.LauncherRootView>

复制代码

​ 由上面内容可以看到，Launcher3，父结构是一个自定义的LauncherRootView，在这个LauncherRootView中只有一个子结构DragLayer，在DragLayer中放置了Workspace、Hotseat、WorkspacePageIndicator等内容。这里我们先看下Launcher3主页的构造图，以便我们相识各个子结构的相关内容：

• Launcher3结构的最外貌是一个自定义的View：LauncherRootView，它是继承自FrameLayout；LauncherRootView内里只有一个叫DragLayer的ViewGroup，它同样继承自FrameLayout，主要功能就是处置惩罚拖拽事件，当你在拖拽一个图标的时候，就相当于是一个view放到了DragLayer内里，这个view会跟随你的手在屏幕上移动。
  
• 屏幕上可以左右滑动的整个页面叫做Workspace，Workspace的父类是PagedView，PagedViewk用来处置惩罚左右滑动。
  
• Workspace内里可能含有多个页面（屏），多个页面存在时，可以左右滑动来切换页面；可以滑动的单独一屏就是一个CellLayout，CellLayout负责本身页面图标和小部件的显示和整齐摆放。
  
• 在左右滑动屏幕切换页面时 屏幕最下方会出现的指示器PageIndicator（一样平常是几个小圆点，这里图示中被隐藏了），告诉你桌面有几屏，当前在哪一屏上（圆点会高亮）。
  
• 在Workspace中，向上滑动屏幕可以唤出所有应用列表（抽屉样式），向下滑动可以唤出状态栏和关照栏。
  
• 在CellLayout中可以放置组件、应用、包罗应用的文件夹等。如上图中顶部的搜索框就是谷歌提供的原生搜索框（实在它并不算一个组件，而是一个特别元素），屏幕靠下方的左右两边分别是应用文件夹和单个应用图标。当长按CellLayout上的组件、应用、文件夹或者空缺地方的时候，会出现一个MENU菜单，可以对组件或应用进行配置，或者添加组件等。当长按组件、应用或文件夹，并拖动到屏幕上方时，屏幕上方会显示一个DropTargetBar区域，内里有“移除”按钮，可以对组件进行移除，对app进行卸载等操纵。
  
• 底部有五个固定不动的图标所在的区域叫做Hotseat，用来放置比较常用的应用，好比拨号，短信，相机等。
  
• 底部右侧有三个白色按钮的区域是导航栏。导航栏可以在所有页面中常显，用于全局控制（返回、回到主页、最近应用）。
  

这里简单展示下几个控件的结构代码：
hotseat.xml

1. <com.android.launcher3.Hotseat
2.     xmlns:android="http://schemas.android.com/apk/res/android"
3.     xmlns:launcher="http://schemas.android.com/apk/res-auto"
4.     android:id="@+id/hotseat"
5.     android:layout_width="match_parent"
6.     android:layout_height="match_parent"
7.     android:theme="@style/HomeScreenElementTheme"
8.     android:importantForAccessibility="no"
9.     android:preferKeepClear="true"
10.     launcher:containerType="hotseat" />

复制代码

all_apps.xml

1. <com.android.launcher3.allapps.LauncherAllAppsContainerView xmlns:android="http://schemas.android.com/apk/res/android"
2.     android:id="@+id/apps_view"
3.     android:layout_width="match_parent"
4.     android:layout_height="match_parent"
5.     android:clipChildren="true"
6.     android:clipToPadding="false"
7.     android:focusable="false"
8.     android:saveEnabled="false" />

复制代码

drop_target_bar.xml

1. <com.android.launcher3.DropTargetBar xmlns:android="http://schemas.android.com/apk/res/android"
2.     android:layout_width="match_parent"
3.     android:layout_height="@dimen/dynamic_grid_drop_target_size"
4.     android:layout_gravity="center_horizontal|top"
5.     android:focusable="false"
6.     android:alpha="0"
7.     android:theme="@style/HomeScreenElementTheme"
8.     android:visibility="invisible">
10.     <!-- Delete target -->
11.     <com.android.launcher3.DeleteDropTarget
12.         android:id="@+id/delete_target_text"
13.         style="@style/DropTargetButton"
14.         android:layout_width="wrap_content"
15.         android:layout_height="wrap_content"
16.         android:layout_gravity="center"
17.         android:gravity="center"
18.         android:text="@string/remove_drop_target_label" />
20.     <!-- Uninstall target -->
21.     <com.android.launcher3.SecondaryDropTarget
22.         android:id="@+id/uninstall_target_text"
23.         style="@style/DropTargetButton"
24.         android:layout_width="wrap_content"
25.         android:layout_height="wrap_content"
26.         android:layout_gravity="center"
27.         android:gravity="center"
28.         android:text="@string/uninstall_drop_target_label" />
30. </com.android.launcher3.DropTargetBar>

复制代码

上面这三个控件都是直接include在Launcher.xml的结构中的，其他子结构也是以类似于自定义View的情势被添加到Launcher.xml中的，好比workspace：

1. <com.android.launcher3.Workspace
2.     android:id="@+id/workspace"
3.     android:layout_width="match_parent"
4.     android:layout_height="match_parent"
5.     android:layout_gravity="center"
6.     android:theme="@style/HomeScreenElementTheme"
7.     launcher:pageIndicator="@+id/page_indicator" />

复制代码

Workspace.java是在Launcher的onCreate()阶段被创建并添加到主页内里的：

1. // Launcher3/src/com/android/launcher3/Launcher.java
3. @Thunk
4. Workspace<?> mWorkspace;
5. @Thunk
6. DragLayer mDragLayer;
8. @Override
9. @TargetApi(Build.VERSION_CODES.S)
10. protected void onCreate(Bundle savedInstanceState) {
11.     // ...
13.     setupViews();
14.     // ...
15. }
17. protected void setupViews() {
18.     inflateRootView(R.layout.launcher);
19.     mDragLayer = findViewById(R.id.drag_layer);
20.     mFocusHandler = mDragLayer.getFocusIndicatorHelper();
21.     // 绑定workspace
22.     mWorkspace = mDragLayer.findViewById(R.id.workspace);
23.    
24.     // workspace做一些初始化的工作
25.     mWorkspace.initParentViews(mDragLayer);
26.     mOverviewPanel = findViewById(R.id.overview_panel);
27.     mHotseat = findViewById(R.id.hotseat);
28.     mHotseat.setWorkspace(mWorkspace);
29.     mDragLayer.setup(mDragController, mWorkspace);
30.     mWorkspace.setup(mDragController);
31.     mWorkspace.lockWallpaperToDefaultPage();
32.     mWorkspace.bindAndInitFirstWorkspaceScreen();
33.     mDragController.addDragListener(mWorkspace);
35.     // ...
36. }

复制代码

​ 各子结构的添加和加载就不展开介绍了，这里先介绍一个Launcher3很重要的内容：DeviceProfile.java和device_profiles.xml：
DeviceProfile

​ DeviceProfile.java包罗了多个用于描述设备配置的属性，比方mNumColumns(列数)、mNumRows(行数)、mHotseatHeight(Dock的高度)、mIconSizePx(图标大小)等，这些属性用于确定Launcher的结构和各个组件的位置。DeviceProfile在Launcher启动时被创建，并根据设备的现实配置(device_profiles.xml)进行初始化。

• 初始化过程中会根据设备的屏幕尺寸、方向等因素盘算出各种关键属性。
  
• 当设备的配置发生变化时（比方旋转屏幕），DeviceProfile会被更新以反映新的配置。
  
• 更新过程中会重新盘算关键属性，并关照Launcher的各个组件进行相应的调解。
  

​ device_profiles.xml是一个XML配置文件，位于Launcher3项目的res/xml目次下。它定义了一系列设备配置，每种配置对应着不同的屏幕尺寸、方向和密度等信息，这一系列配置用于在不同设备上适配Launcher。这样可以确保Launcher在不同设备上都可以大概良好地显示和运行。
​ 当Launcher启动时，它会被DeviceProfile.java动态加载，并根据当前设备的现实配置找到最合适的预设配置，这些预设配置【mNumColumns(列数)、mNumRows(行数)、mIconSizePx(图标大小)等】用于初始化DeviceProfile对象。【各属性的介绍放到下一末节中了】
下面简单介绍下DeviceProfile.java和device_profiles.xml的加载流程：

1. // Launcher3/src/com/android/launcher3/Launcher.java
2. @Override
3. @TargetApi(Build.VERSION_CODES.S)
4. protected void onCreate(Bundle savedInstanceState) {
5.     // ...
6.         LauncherAppState app = LauncherAppState.getInstance(this);
7.     // 通过LauncherAppState的getInvariantDeviceProfile方法获取InvariantDeviceProfile对象
8.     InvariantDeviceProfile idp = app.getInvariantDeviceProfile();
9.     // 在initDeviceProfile方法里获取DeviceProfile对象
10.     initDeviceProfile(idp);
11.     // ...
12. }
14. /**
15. * Returns {@code true} if a new DeviceProfile is initialized, and {@code false} otherwise.
16. */
17. protected boolean initDeviceProfile(InvariantDeviceProfile idp) {
18.     // 获取DeviceProfile，这里DeviceProfile对象来源是InvariantDeviceProfile.getDeviceProfile()
19.     DeviceProfile deviceProfile = idp.getDeviceProfile(this);
20.     if (mDeviceProfile == deviceProfile) {
21.         return false;
22.     }
23.     mDeviceProfile = deviceProfile;
24.     // ...
25. }

复制代码

​ 在Launcher.java的onCreate()方法中，先调用LauncherAppState.getInvariantDeviceProfile()方法获取一个InvariantDeviceProfile对象，然后在initDeviceProfile()方法中，通过InvariantDeviceProfile对象的getDeviceProfile()方法获取到DeviceProfile对象。跟进到LauncherAppState中看下：

1. // Launcher3/src/com/android/launcher3/LauncherAppState.java
3. private final InvariantDeviceProfile mInvariantDeviceProfile;
4. public LauncherAppState(Context context) {
5.     // 调用两个参数的构造方法
6.     this(context, LauncherFiles.APP_ICONS_DB);
7.     Log.v(Launcher.TAG, "LauncherAppState initiated");
8.     // ...
9. }
11. public LauncherAppState(Context context, @Nullable String iconCacheFileName) {
12.     mContext = context;
13.     // 获取mInvariantDeviceProfile对象
14.     mInvariantDeviceProfile = InvariantDeviceProfile.INSTANCE.get(context);
15.     // ...
16. }
18. public InvariantDeviceProfile getInvariantDeviceProfile() {
19.      // 返回InvariantDeviceProfile对象
20.     return mInvariantDeviceProfile;
21. }

复制代码

​ 由上面代码可以看出，InvariantDeviceProfile对象是在LauncherAppState的构造方法中创建的，并通过getInvariantDeviceProfile()方法返回一个InvariantDeviceProfile对象。继续跟进到InvariantDeviceProfile.java中：

1. // Launcher3/src/com/android/launcher3/InvariantDeviceProfile.java
3. // 这里的 INSTANCE可以理解为获取自身的单例对象
4. // MainThreadInitializedObject是一个用于定义在主线程上启动的单例的实用工具类
5. public static final MainThreadInitializedObject<InvariantDeviceProfile> INSTANCE =
6.         new MainThreadInitializedObject<>(InvariantDeviceProfile::new);
8. @TargetApi(23)
9. private InvariantDeviceProfile(Context context) {
10.     String gridName = getCurrentGridName(context);
11.      // 调用initGrid()方法
12.     String newGridName = initGrid(context, gridName);
13.     // ...
14. }
16. private String initGrid(Context context, String gridName) {
17.     Info displayInfo = DisplayController.INSTANCE.get(context).getInfo();
18.     @DeviceType int deviceType = getDeviceType(displayInfo);
19.     // 调用getPredefinedDeviceProfiles方法加载device_profiles.xml文件
20.     ArrayList<DisplayOption> allOptions =
21.             getPredefinedDeviceProfiles(context, gridName, deviceType,
22.                     RestoreDbTask.isPending(context));
23.     // 把device_profiles.xml文件中的配置信息记录到displayOption中
24.     DisplayOption displayOption =
25.             invDistWeightedInterpolate(displayInfo, allOptions, deviceType);
26.     // 调用四个参数的initGrid()方法
27.     initGrid(context, displayInfo, displayOption, deviceType);
28.     return displayOption.grid.name;
29. }
31. private static ArrayList<DisplayOption> getPredefinedDeviceProfiles(Context context,
32.         String gridName, @DeviceType int deviceType, boolean allowDisabledGrid) {
33.     ArrayList<DisplayOption> profiles = new ArrayList<>();
34.     // 加载device_profiles.xml文件
35.     try (XmlResourceParser parser = context.getResources().getXml(R.xml.device_profiles)) {
36.         final int depth = parser.getDepth();
37.         // ...
38.     } catch (IOException | XmlPullParserException e) {
39.         throw new RuntimeException(e);
40.     }
42.     // ...
43. }
45. private void initGrid(Context context, Info displayInfo, DisplayOption displayOption, @DeviceType int deviceType) {
46.     DisplayMetrics metrics = context.getResources().getDisplayMetrics();
47.     // 获取displayOption里面配置信息（实际上就是device_profiles.xml中读取的信息）
48.     GridOption closestProfile = displayOption.grid;
49.     numRows = closestProfile.numRows;
50.     numColumns = closestProfile.numColumns;
51.     numSearchContainerColumns = closestProfile.numSearchContainerColumns;
52.     // ...
54.     final List<DeviceProfile> localSupportedProfiles = new ArrayList<>();
55.     defaultWallpaperSize = new Point(displayInfo.currentSize);
56.     SparseArray<DotRenderer> dotRendererCache = new SparseArray<>();
57.     for (WindowBounds bounds : displayInfo.supportedBounds) {
58.         // 通过DeviceProfile.Build()方法创建DeviceProfile对象
59.         localSupportedProfiles.add(new DeviceProfile.Builder(context, this, displayInfo)
60.                 .setIsMultiDisplay(deviceType == TYPE_MULTI_DISPLAY)
61.                 .setWindowBounds(bounds)
62.                 .setDotRendererCache(dotRendererCache)
63.                 .build());
64.         // ...
65.     }
66.    
67.     // 把DeviceProfile列表存到supportedProfiles中，supportedProfiles是一个类型为List<DeviceProfile>的列表
68.     // 这里创建了DeviceProfile列表，是因为DeviceProfile中有多个不同的配置，一套配置可以视为一个DeviceProfile对象
69.     supportedProfiles = Collections.unmodifiableList(localSupportedProfiles);
70.    
71.     // ...
72. }

复制代码

​ 在InvariantDeviceProfile.java的构造方法中，调用了initGrid(context, gridName)方法，然后在initGrid()方法中调用getPredefinedDeviceProfiles()方法去加载device_profiles.xml配置文件，随后又调用了四个参数的initGrid()方法创建DeviceProfile对象列表，并把它赋值给supportedProfiles，supportedProfiles是一个类型为List<DeviceProfile>的列表。
​ 在Launcher.java中是是通过idp.getDeviceProfile(this)来获取DeviceProfile对象的，我们看下InvariantDeviceProfile的getDeviceProfile()方法：

1. // Launcher3/src/com/android/launcher3/InvariantDeviceProfile.java
3. public DeviceProfile getDeviceProfile(Context context) {
4.     Resources res = context.getResources();
5.     Configuration config = context.getResources().getConfiguration();
7.     float screenWidth = config.screenWidthDp * res.getDisplayMetrics().density;
8.     float screenHeight = config.screenHeightDp * res.getDisplayMetrics().density;
9.     int rotation = WindowManagerProxy.INSTANCE.get(context).getRotation(context);
10.     // ...
12.     // 根据屏幕的宽高等信息，获取最适合的DeviceProfile配置文件
13.     return getBestMatch(screenWidth, screenHeight, rotation);
14. }
16. /**
17. * 返回与所提供的屏幕配置相匹配的设备配置文件
18. */
19. public DeviceProfile getBestMatch(float screenWidth, float screenHeight, int rotation) {
20.     DeviceProfile bestMatch = supportedProfiles.get(0);
21.     float minDiff = Float.MAX_VALUE;
22.     // 遍历supportedProfiles列表，找出最匹配的配置文件。这里的supportedProfiles就是前面保存的DeviceProfile列表
23.     for (DeviceProfile profile : supportedProfiles) {
24.         float diff = Math.abs(profile.widthPx - screenWidth) + Math.abs(profile.heightPx - screenHeight);
25.         if (diff < minDiff) {
26.             minDiff = diff;
27.             bestMatch = profile;
28.         } else if (diff == minDiff && profile.rotationHint == rotation) {
29.             bestMatch = profile;
30.         }
31.     }
32.     return bestMatch;
33. }

复制代码

​ 所以执行到这里，Launcher.java中就可以拿到与当前屏幕最匹配的DeviceProfile配置了，通过这个DeviceProfile配置，可以去调解桌面的结构和组件，如下：

1. // Launcher3/src/com/android/launcher3/Launcher.java
2. public void finishBindingItems(IntSet pagesBoundFirst) {
3.     Object traceToken = TraceHelper.INSTANCE.beginSection("finishBindingItems");
4.     mWorkspace.restoreInstanceStateForRemainingPages();
6.         // ...
8.     // 获取mDeviceProfile配置信息里面的numFolderColumns和numFolderRows去做计算
9.     getViewCache().setCacheSize(R.layout.folder_application,
10.             mDeviceProfile.inv.numFolderColumns * mDeviceProfile.inv.numFolderRows);
11.     getViewCache().setCacheSize(R.layout.folder_page, 2);
13.     TraceHelper.INSTANCE.endSection(traceToken);
14.     mWorkspace.removeExtraEmptyScreen(true);
15. }

复制代码

实在不但是Launcher.java，在其他的类内里也会调用去做一些UI上的处置惩罚，好比Workspace.java中更新格子的Padding：

1. // Launcher3/src/com/android/launcher3/Workspace.java
2. private void updateCellLayoutPadding() {
3.     // 获取配置信息里面的cellLayoutPaddingPx
4.     Rect padding = mLauncher.getDeviceProfile().cellLayoutPaddingPx;
5.     mWorkspaceScreens.forEach(s -> s.setPadding(padding.left, padding.top, padding.right, padding.bottom));
6. }

复制代码

​ 到这里DeviceProfile的加载分析流程就结束了，如上面示例所说，在Launcher3中，DeviceProfile.java和device_profiles.xml是两个非常重要的文件，它们对Launcher3主页结构是至关重要的，想要修改Launcher3主页的结构，可以从这个方面入手。
主页结构修改

​ 上面的内容简单介绍了DeviceProfile的功能和加载流程，下面来分析，如何修改主页结构，还是沿着上面的思绪，从DeviceProfile配置文件入手。
​ Launcher3启动的时候，会加载 Launcher3\res\xml\device_profiles.xml 文件中预设的结构，内容如下：

1. <?xml version="1.0" encoding="utf-8"?>
2. <profiles xmlns:launcher="http://schemas.android.com/apk/res-auto" >
3.     <grid-option
4.         launcher:name="3_by_3"
5.         launcher:numRows="3"
6.         launcher:numColumns="3"
7.         launcher:numFolderRows="2"
8.         launcher:numFolderColumns="3"
9.         launcher:numHotseatIcons="3"
10.         launcher:dbFile="launcher_3_by_3.db"
11.         launcher:defaultLayoutId="@xml/default_workspace_3x3"
12.         launcher:deviceCategory="phone" >
13.         
14.         <!--省略多个display-option子标签内容-->
15.         
16.     </grid-option>
18.     <grid-option
19.         launcher:name="4_by_4"
20.         launcher:numRows="4"
21.         launcher:numColumns="4"
22.         launcher:numFolderRows="3"
23.         launcher:numFolderColumns="4"
24.         launcher:numHotseatIcons="4"
25.         launcher:numExtendedHotseatIcons="6"
26.         launcher:dbFile="launcher_4_by_4.db"
27.         launcher:inlineNavButtonsEndSpacing="@dimen/taskbar_button_margin_split"
28.         launcher:defaultLayoutId="@xml/default_workspace_4x4"
29.         launcher:deviceCategory="phone|multi_display" >
30.         
31.         <!--省略多个display-option子标签内容-->
32.             
33.     </grid-option>
35.     <grid-option
36.         launcher:name="5_by_5"
37.         launcher:numRows="5"
38.         launcher:numColumns="5"
39.         launcher:numFolderRows="4"
40.         launcher:numFolderColumns="4"
41.         launcher:numHotseatIcons="5"
42.         launcher:numExtendedHotseatIcons="6"
43.         launcher:dbFile="launcher.db"
44.         launcher:inlineNavButtonsEndSpacing="@dimen/taskbar_button_margin_split"
45.         launcher:defaultLayoutId="@xml/default_workspace_5x5"
46.         launcher:deviceCategory="phone|multi_display" >
47.         
48.         <!--省略多个display-option子标签内容-->
49.         
50.     </grid-option>
52.     <grid-option
53.         launcher:name="6_by_5"
54.         launcher:numRows="6"
55.         launcher:numColumns="7"
56.         launcher:numSearchContainerColumns="5"
57.         launcher:numFolderRows="3"
58.         launcher:numFolderColumns="4"
59.         launcher:numHotseatIcons="0"
60.         launcher:hotseatColumnSpanLandscape="2"
61.         launcher:numAllAppsColumns="6"
62.         launcher:isScalable="true"
63.         launcher:inlineNavButtonsEndSpacing="@dimen/taskbar_button_margin_6_5"
64.         launcher:devicePaddingId="@xml/paddings_6x5"
65.         launcher:dbFile="launcher_6_by_5.db"
66.         launcher:defaultLayoutId="@xml/default_workspace_6x5"
67.         launcher:deviceCategory="tablet" >
69.         <display-option
70.             launcher:name="Tablet"
71.             launcher:minWidthDps="900"
72.             launcher:minHeightDps="820"
73.             launcher:minCellHeight="120"
74.             launcher:minCellWidth="102"
75.             launcher:minCellHeightLandscape="104"
76.             launcher:minCellWidthLandscape="120"
77.             launcher:iconImageSize="60"
78.             launcher:iconTextSize="14"
79.             launcher:borderSpaceHorizontal="16"
80.             launcher:borderSpaceVertical="64"
81.             launcher:borderSpaceLandscapeHorizontal="64"
82.             launcher:borderSpaceLandscapeVertical="16"
83.             launcher:horizontalMargin="54"
84.             launcher:horizontalMarginLandscape="120"
85.             launcher:allAppsCellWidth="96"
86.             launcher:allAppsCellHeight="142"
87.             launcher:allAppsCellWidthLandscape="126"
88.             launcher:allAppsCellHeightLandscape="126"
89.             launcher:allAppsIconSize="60"
90.             launcher:allAppsIconTextSize="14"
91.             launcher:allAppsBorderSpaceHorizontal="8"
92.             launcher:allAppsBorderSpaceVertical="16"
93.             launcher:allAppsBorderSpaceLandscape="16"
94.             launcher:hotseatBarBottomSpace="30"
95.             launcher:hotseatBarBottomSpaceLandscape="40"
96.             launcher:canBeDefault="true" />
97.     </grid-option>
98. </profiles>

复制代码

​ 这个文件配置代码是用于定义Google Launcher在不同设备和显示模式下的结构参数，特别是针对具有特定屏幕尺寸和平板电脑类设备的结构。该文件里定义了4个不同的结构类型，分别是3x3、4x4、5x5、6x5，上面有讲到，在调用InvariantDeviceProfile的getDeviceProfile()方法时，设备会根据当前屏幕的尺寸来加载相应的结构配置。
​ 那我们在开发时如何确定设备加载哪个结构呢？可以在桌面长按应用图标，然后拖动一下，观察在x和y方向上可以移动多少个格子，这样就可以确定本身的设备加载的是哪一个结构类型了。一样平常平板（或者移动大屏等）设备会加载6*5的结构，如今较新的手机也可以支持5x5乃至6x5的结构了。
​ device_profiles.xml文件中的<grid-option>标签包罗了各种属性，用于定制Launcher界面的外貌和活动。结构内里具体的属性说明如下：

• launcher:name="6_by_5": 定义了结构的名称，这里是“6_by_5”，代表的是6行5列的基本结构结构，但现实上后续可以通过launcher:numRows、launcher:numColumns属性设置为其他的结构。因为项目需要，我这里对6 * 5的结构做了改动，改成了 7 * 6的结构。
  
• launcher:numRows="6" 和 launcher:numColumns="7": 指定了主屏幕上行数和列数。
  
• launcher:numSearchContainerColumns="5": 搜索栏容器的列数。
  
• launcher:numFolderRows="3" 和 launcher:numFolderColumns="4": 文件夹中的行数和列数。
  
• launcher:numHotseatIcons="0": Hotseat（快速启动栏）中的图标数目，在这里设置为0，意味着不显示Hotseat。
  
• launcher:hotseatColumnSpanLandscape="2": 在横屏模式下，Hotseat占据的列数。
  
• launcher:numAllAppsColumns="6": 所有应用列表中的列数。
  
• launcher:isScalable="true": 表示是否可以缩放结构。
  
• launcher:inlineNavButtonsEndSpacing 和 launcher:devicePaddingId: 分别定义了内联导航按钮的结束间距和设备的填充空间ID。
  
• launcher:dbFile 和 launcher:defaultLayoutId: 数据库文件名和默认结构ID，用于存储和恢复结构状态。
  
• launcher:deviceCategory="tablet": 设备类别，这里是平板电脑。
  

接下来的 <display-option> 标签提供了更多细节：

• launcher:minWidthDps="900" 和 launcher:minHeightDps="820": 最小宽度和高度（以密度无关像素dp为单元），用于确定此结构适用于哪种屏幕尺寸。
  
• launcher:minCellHeight 和 launcher:minCellWidth: 单个单元格的最小高度和宽度。
  
• 背面的属性，如 launcher:iconImageSize、launcher:iconTextSize 等，分别定义了图标、文本、边框空间等元素的尺寸和间距。
  
• launcher:horizontalMargin 和 launcher:horizontalMarginLandscape: 程度方向上的外边距，在竖屏和横屏模式下可能不同。
  
• launcher:hotseatBarBottomSpace 和 launcher:hotseatBarBottomSpaceLandscape: Hotseat在竖屏和横屏模式下的底部间距。
  
• launcher:canBeDefault="true": 表示此结构选项可以作为默认结构。
  

​ 这里我们重点关注下defaultLayoutId这个属性：在上面的配置文件中，6x5结构的defaultLayoutId=“@xml/default_workspace_6x5”，即指定了default_workspace_6x5.xml文件作为6x5样式的结构资源文件。
​ default_workspace_MxN.xml这是用于定义用户桌面快捷方式（Favorites）配置的一个资源文件，代表主页结构是M行N列，我们可以在内里定义显示在利用这个结构情况下，worksapce中的各个控件，如下面给出了显示一个Hotseat应用的示例：

1. <?xml version="1.0" encoding="utf-8"?>
2. <favorites xmlns:launcher="http://schemas.android.com/apk/res-auto/com.android.launcher3">
3.     <!-- 配置一个Hotseat应用-->
4.     <resolve
5.         launcher:container="-101"
6.         launcher:screen="0"
7.         launcher:x="0"
8.         launcher:y="0" >
9.         <favorite launcher:uri="#Intent;action=android.intent.action.MAIN;category=android.intent.category.APP_EMAIL;end" />
10.         <favorite launcher:uri="mailto:" />
11.     </resolve>
12.     <!-- 其他配置 -->
13. </favorites>

复制代码

​ 文件由<favorites>标签括起来，内里可以包罗一个或多个<resolve>标签，每个<resolve>标签都定义了一组快捷方式项，这些快捷方式可以直接链接到特定的应用或者执行特定的操纵（如打开邮件客户端、日历、图库等）。<resolve>的子标签表示快捷方式项的类型，快捷方式项必须放在<resolve>标签内才生效。<resolve>支持的子标签如下：

1. favorite //应用程序快捷方式
2. widget   //桌面控件（小组件）
3. shortcut //链接，如网址、本地磁盘路径等
4. search   //搜索框（谷歌搜索框）
5. clock    //桌面上的钟表Widget
6. folder   //桌面文件夹（如谷歌应用的文件夹）

复制代码

​ 同时<resolve>标签或其子标签通过launcher:XXX来设定快捷方式项的位置等信息，这些属性可以写在<resolve>标签或其子标签中，支持的属性如下：

1. // resolve标签支持的属性
2. launcher:title  // 图标下面的文字，目前只支持引用，不能直接书写字符串;
3. launcher:icon   // 图标引用（适用于应用快捷方式）;
4. launcher:uri    // 链接地址，链接网址用的，使用shortcut标签就可以定义一个超链接，打开某个网址，文件等。
5. launcher:packageName   // 应用程序的包名;
6. launcher:className     // 应用程序的启动类名（要写全路径）;
7. launcher:screen        // 图标所在的屏幕编号，0表示第一页
8. launcher:x   // 应用图标所处x位置（从左到右，从0开始），（-1是默认值：第一行或者第一列）
9. launcher:y   // 应用图标所处y位置（从上往下，从0开始）
10. launcher:container   // 定义一个快捷方式（Favorite）或桌面项目应该放置在哪个容器中；-101表示HotSeat、-100表示DeskTop、0表示默认的桌面容器、其他正整数表示App shortcut
11. launcher:spanX  //在x方向上所占格数
12. launcher:spanY  //在y方向上所占格数

复制代码

这里特别说明下launcher:uri属性：uri 定义了控件点击时的链接操纵，通常以#Intent;...;end的格式编写，指定了一系列操纵（如打开某个应用的主界面）或数据类型（如打开图库应用或欣赏特定网站）。

1. // 下面列举几个常用launcher:uri的写法：
3. 跳转到网页: "http://www.google.com"
4. 跳转到设置的辅助功能:"#Intent;action=android.settings.ACCESSIBILITY_SETTINGS;end"
5. 打开音乐文件:"file:///mnt/sdcard/song.mp3#Intent;action=android.intent.action.VIEW;type=audio/mp3;end"
6. 指定应用程序打开音乐文件:"file:///mnt/sdcard/song.mp3#Intent;action=android.intent.action.VIEW;type=audio/mp3;component=com.android.music/.MusicBrowserActivity;end"
8. // 指定应用程序打开音乐文件，在Java中对应的操作如下
9. Intent it = new Intent(Intent.ACTION_VIEW);
10. Uri uri = Uri.fromFile(new File("/mnt/sdcard/song.mp3" ));
11. it.setDataAndType(uri, “audio/mp3”);
12. it.setClassName(“com.android.music”, “com.android.music.MusicBrowserActivity”);
13. String lancher_uri = it.toUri(0);

复制代码

常用几种桌面控件的示例：

1. <?xml version="1.0" encoding="utf-8"?>
2. <favorites xmlns:launcher="http://schemas.android.com/apk/res-auto/com.android.launcher3">
3.    
4.     <!--定义一个HotSeat-->
5.     <resolve
6.         launcher:container="-101"
7.         launcher:screen="0"
8.         launcher:x="0"
9.         launcher:y="5" >
10.         <favorite launcher:uri="#Intent;action=android.intent.action.MAIN;category=android.intent.category.APP_EMAIL;end" />
11.         <favorite launcher:uri="mailto:" />
12.     </resolve>
13.    
14.     <!--定义一个时钟小组件-->
15.     <resolve>
16.         <appwidget
17.             launcher:screen="0"
18.             launcher:x="2"
19.             launcher:y="0"
20.             launcher:spanX="3"
21.             launcher:spanY="1"
22.             launcher:packageName="com.google.android.deskclock"
23.             launcher:className="com.android.alarmclock.DigitalAppWidgetProvider"/>
24.     </resolve>
25.    
26.     <!--定义一个谷歌搜索框-->
27.     <resolve>
28.         <search
29.             launcher:screen="0"
30.             launcher:x="1"
31.             launcher:y="2"
32.             launcher:spanX="5"
33.             launcher:spanY="1"
34.             launcher:packageName="com.google.android.googlequicksearchbox"
35.             launcher:className="com.google.android.googlequicksearchbox.SearchWidgetProvider"/>
36.     </resolve>
37.    
38.     <!--定义一个文件夹，里面包含三个应用-->
39.         <resolve>
40.                 <folder
41.             launcher:title="@string/google_folder_title"
42.             launcher:screen="0"
43.             launcher:x="1"
44.             launcher:y="3">
45.             <favorite
46.                 launcher:packageName="com.google.android.googlequicksearchbox"
47.                 launcher:className="com.google.android.googlequicksearchbox.SearchActivity"/>
48.             <favorite
49.                 launcher:packageName="com.android.chrome"
50.                 launcher:className="com.google.android.apps.chrome.Main"/>
51.             <favorite
52.                 launcher:packageName="com.google.android.gm"
53.                 launcher:className="com.google.android.gm.ConversationListActivityGmail"/>
54.                   </folder>
55.     </resolve>
56.    
57.     <!--定义一个普通应用程序快捷方式-->
58.     <resolve>
59.         <favorite
60.             launcher:screen="0"
61.             launcher:x="2"
62.             launcher:y="3"
63.             launcher:packageName="com.android.vending"
64.             launcher:className="com.android.vending.AssetBrowserActivity"/>
65.     </resolve>
66.    
67.     <!--定义一个shortcut链接-->
68.     <resolve>
69.         <shortcut
70.             launcher:title="@string/google"
71.             launcher:icon="@drawable/google"
72.             launcher:uri="http://www.baidu.com"
73.             launcher:screen="0"
74.             launcher:x="3"
75.             launcher:y="3" />
76.     </resolve>
77. </favorites>

复制代码

注意：这些属性并不都是resolve标签支持的，大多数的属性可以写在resolve标签中，也可以写在子标签中，但是对于uri、packageName、className等几个特别的属性，只能写在对应的子标签内。
除了上面的方式，还可以利用GMS中的配置文件来处置惩罚（条件是项目是有嵌入GMS框架）。在google_gms包下的配置文件release\vendor\partner_gms\apps\GmsSampleIntegration\res_dhs_full\xml\partner_default_layout.xml（下面是我项目中改的示例）：

1. <?xml version="1.0" encoding="utf-8"?>
2. <!-- Copyright (C) 2017 Google Inc. All Rights Reserved. -->
3. <favorites>
5.     <!--定义应用文件夹-->
6.     <folder title="@string/google_folder_title" screen="0" x="1" y="3">
7.         <favorite packageName="com.google.android.googlequicksearchbox" className="com.google.android.googlequicksearchbox.SearchActivity"/>
8.         <favorite packageName="com.android.chrome" className="com.google.android.apps.chrome.Main"/>
9.         <favorite packageName="com.google.android.gm" className="com.google.android.gm.ConversationListActivityGmail"/>
10.         <favorite packageName="com.google.android.apps.maps" className="com.google.android.maps.MapsActivity"/>
11.         <favorite packageName="com.google.android.youtube" className="com.google.android.youtube.app.honeycomb.Shell$HomeActivity"/>
12.         <favorite packageName="com.google.android.apps.docs" className="com.google.android.apps.docs.app.NewMainProxyActivity"/>
13.         <favorite packageName="com.google.android.apps.youtube.music" className="com.google.android.apps.youtube.music.activities.MusicActivity"/>
14.         <favorite packageName="com.google.android.videos" className="com.google.android.videos.GoogleTvEntryPoint"/>
15.         <favorite packageName="com.google.android.apps.tachyon" className="com.google.android.apps.tachyon.MainActivity"/>
16.         <favorite packageName="com.google.android.apps.photos" className="com.google.android.apps.photos.home.HomeActivity"/>
17.     </folder>
18.   
19.     <!--添加应用-->
20.     <favorite screen="0" x="2" y="3" packageName="com.android.vending" className="com.android.vending.AssetBrowserActivity"/>
22.         <!--添加组件-->
23.     <appwidget screen="0" x="2" y="0" packageName="com.google.android.deskclock" className="com.android.alarmclock.DigitalAppWidgetProvider" spanX="3" spanY="2" />
24.    
25.         <!-- Hotseat (We use the screen as the position of the item in the hotseat) -->
26.     <!-- 定义桌面的hotSeat显示的应用，本项目中已经设定不显示HotSeat，所以下面的代码设置也不起作用 -->
27.     <favorite container="-101" screen="0" x="0" y="0" packageName="com.google.android.dialer" className="com.google.android.dialer.extensions.GoogleDialtactsActivity"/>
28.     <favorite container="-101" screen="1" x="1" y="0" packageName="com.google.android.apps.messaging" className="com.google.android.apps.messaging.ui.ConversationListActivity"/>
29.     <favorite container="-101" screen="0" x="0" y="0" packageName="com.android.settings" className="com.android.settings.Settings"/>
30.     <favorite container="-101" screen="1" x="1" y="0" packageName="com.android.deskclock" className="com.android.deskclock.DeskClock"/>
31.     <favorite container="-101" screen="2" x="2" y="0" packageName="com.google.android.calendar" className="com.android.calendar.event.LaunchInfoActivity"/>
32.     <favorite container="-101" screen="3" x="3" y="0" packageName="com.google.android.contacts" className="com.android.contacts.activities.PeopleActivity"/>
33.     <favorite container="-101" screen="4" x="4" y="0" packageName="com.android.camera2" className="com.android.camera.CameraLauncher"/>
34. </favorites>

复制代码

上面文件有几个属性参数解析一下：

• folder标签表示文件夹；
  
• favorite标签表示应用；
  
• appwidget表示组件；
  
• container表示放置的位置或区域，-101表示hotseat；-100代表是desktop；container=正数，则代表App shortcut；
  
• screen表示位于第几页屏幕，0表示第一页；
  
• x表示x轴方向的位置（从左到右，从0开始）；
  
• y表示y轴方向的位置（从上往下，从0开始）；
  
• packageName表示应用或组件的包名；
  
• className表示应用或组件对应的Activity或AppWidgetProvider；
  
• spanX表示x轴方向占用的格子数；
  
• spanY表示y轴方向占用的格子数
  

在partner_default_layout.xml中改动效果如下：

注意：如果你修改了结构文件，但是重新编译后运行模仿器，发现桌面应用并没有改变，有可能是launcher3的database没有更新，因为这些结构文件的内容，在launcher第一次开机启动时会创建database并生存数据到其中，后续有利用直接从db读取，而不消重复读结构文件

1. # 恢复默认布局
2. adb root
3. adb shell rm /data/data/com.android.launcher3/databases/launcher.db
4. # 实测我这里使用的是6x5布局，所以db文件是：launcher_6_by_5.db
5. # 重启模拟器即可生效

复制代码

修改谷歌搜索框

​ 如果要修改搜索框占用格子的宽度，可以在Launcher3\res\xml\device_profiles.xml文件内里，对应的尺寸结构中修改numSearchContainerColumns的值：

1. <?xml version="1.0" encoding="utf-8"?>
2. <profiles xmlns:launcher="http://schemas.android.com/apk/res-auto" >
3.     <grid-option
4.         launcher:name="6_by_5"
5.         launcher:numRows="6"
6.         launcher:numColumns="7"
7.         launcher:numSearchContainerColumns="5"
8.         .../>
9. />

复制代码

我在6x5的结构（现实上是后7x6）中将谷歌搜索框的宽度改成了5，即在x轴方向上，占用五个格子。
接下来是修改谷歌搜索框的位置：在workspace.java的bindAndInitFirstWorkspaceScreen()方法中:

1. // Launcher3/src/com/android/launcher3/Workspace.java
2. /**
3. * Initializes and binds the first page
4. */
5. public void bindAndInitFirstWorkspaceScreen() {
6.     if (!FeatureFlags.QSB_ON_FIRST_SCREEN) {
7.         return;
8.     }
10.     // Add the first page
11.     CellLayout firstPage = insertNewWorkspaceScreen(Workspace.FIRST_SCREEN_ID, getChildCount());
12.     // Always add a first page pinned widget on the first screen.
13.     if (mFirstPagePinnedItem == null) {
14.         mFirstPagePinnedItem = LayoutInflater.from(getContext())
15.                 .inflate(R.layout.search_container_workspace, firstPage, false);
16.     }
18.     // 先获取device_profiles.xml中定义的numSearchContainerColumns值
19.     int cellHSpan = mLauncher.getDeviceProfile().inv.numSearchContainerColumns;
20.     // 在这里修改搜索框的位置，五个参数分别代表：x坐标、y坐标，占用宽度、占用高度、屏幕id
21.     // 所以这里效果是：在第一个CellLayout的第二列第三行（xy都是从0开始算的）添加谷歌搜索框，宽度为5个格子，高度为1个格子
22.     CellLayoutLayoutParams lp = new CellLayoutLayoutParams(1, 2, cellHSpan, 1, FIRST_SCREEN_ID);
23.    
24.     lp.canReorder = false;
25.     // 将谷歌搜索框添加到布局中，最后一个参数是代表是否可移动的意思
26.     if (!firstPage.addViewToCellLayout(
27.             mFirstPagePinnedItem, 0, R.id.search_container_workspace, lp, true)) {
28.         Log.e(TAG, "Failed to add to item at (0, 0) to CellLayout");
29.         mFirstPagePinnedItem = null;
30.     }
31. }

复制代码

另外：还要在LoaderCursor.java的checkItemPlacement()方法中修改搜索框对位置的占用效果：

1. // Launcher3/src/com/android/launcher3/model/LoaderCursor.java
2. /**
3. * check & update map of what's occupied; used to discard overlapping/invalid items
4. */
5. protected boolean checkItemPlacement(ItemInfo item) {
6.     int containerIndex = item.screenId;
7.         // ...
9.     if (!occupied.containsKey(item.screenId)) {
10.         GridOccupancy screen = new GridOccupancy(countX + 1, countY + 1);
11.         if (item.screenId == Workspace.FIRST_SCREEN_ID && FeatureFlags.QSB_ON_FIRST_SCREEN) {
12.             int spanX = mIDP.numSearchContainerColumns;
13.             int spanY = 1;
14.             // 这里需要跟WorkSpace.java中设置的搜索框位置保持一致
15.             screen.markCells(1, 2, spanX, spanY, true);
16.         }
17.         occupied.put(item.screenId, screen);
18.     }
19.     final GridOccupancy occupancy = occupied.get(item.screenId);
21.     // Check if any workspace icons overlap with each other
22.     if (occupancy.isRegionVacant(item.cellX, item.cellY, item.spanX, item.spanY)) {
23.         occupancy.markCells(item, true);
24.         return true;
25.     } else {
26.         Log.e(TAG, "Error loading shortcut " + item
27.                 + " into cell (" + containerIndex + "-" + item.screenId + ":"
28.                 + item.cellX + "," + item.cellX + "," + item.spanX + "," + item.spanY
29.                 + ") already occupied");
30.         return false;
31.     }
32. }

复制代码

​ 如果只修改WorkSpace、而没有修改LoaderCursor中的代码，那么搜索框原本的结构(默认位置是x=0，y=0)占用效果会一直存在，导致背面一些应用或者组件无法放置在首页的首行位置。
注意：Workspace.java的bindAndInitFirstWorkspaceScreen方法不但是设定谷歌搜索框位置的关键代码，也是控制了谷歌搜索框是否显示，如果不需要显示谷歌搜索框，可以将上面代码注释：

1. // Launcher3/src/com/android/launcher3/Workspace.java
2. /**
3. * Initializes and binds the first page
4. */
5. public void bindAndInitFirstWorkspaceScreen() {
6.     if (!FeatureFlags.QSB_ON_FIRST_SCREEN) {
7.         return;
8.     }
10.     // 注意要保留这一行，否则会报错
11.     CellLayout firstPage = insertNewWorkspaceScreen(Workspace.FIRST_SCREEN_ID, getChildCount());
12.    
13. //        if (mFirstPagePinnedItem == null) {
14. //            mFirstPagePinnedItem = LayoutInflater.from(getContext())
15. //                    .inflate(R.layout.search_container_workspace, firstPage, false);
16. //        }
17. //
18. //        int cellHSpan = mLauncher.getDeviceProfile().inv.numSearchContainerColumns;
19. //        CellLayoutLayoutParams lp = new CellLayoutLayoutParams(1, 2, cellHSpan, 1, FIRST_SCREEN_ID);
20. //        lp.canReorder = false;
21. //        if (!firstPage.addViewToCellLayout(
22. //                mFirstPagePinnedItem, 0, R.id.search_container_workspace, lp, true)) {
23. //            Log.e(TAG, "Failed to add to item at (0, 0) to CellLayout");
24. //            mFirstPagePinnedItem = null;
25. //        }
26. }

复制代码

除了通过Java文件配置谷歌搜索框之外，也可以通过XML文件来配置谷歌搜索框，主要是在default_workspace.xml或partner_default_layout.xml中进行配置。如果项目有配置GMS框架，那么会读取partner_default_layout.xml文件中的配置，否则会读取default_workspace.xml的配置。
先在device_profiles.xml文件内里定义桌面的行列数：

1. <?xml version="1.0" encoding="utf-8"?>
2. <profiles xmlns:launcher="http://schemas.android.com/apk/res-auto" >
3.     <grid-option
4.         launcher:name="6_by_5"
5.         launcher:numRows="6"
6.         launcher:numColumns="7"
7.         launcher:numSearchContainerColumns="5"
8.         .../>
9. />

复制代码

​ 这里定义的app分布结构是六行七列。然后根据系统是否会读取partner_default_layout.xml结构文件来决定修改的位置：
注意：利用xml配置时，需要先将Java代码中配置谷歌搜索框的代码（Workspace.java和LoaderCursor.java）注释掉，避免相互影响。

1. // Launcher3/src/com/android/launcher3/Workspace.java
2. public void bindAndInitFirstWorkspaceScreen() {
3.     if (!FeatureFlags.QSB_ON_FIRST_SCREEN) {
4.         return;
5.     }
6.     // 注意要保留这一行，否则会报错
7.     CellLayout firstPage = insertNewWorkspaceScreen(Workspace.FIRST_SCREEN_ID, getChildCount());
8.    
9. //        if (mFirstPagePinnedItem == null) {
10. //            mFirstPagePinnedItem = LayoutInflater.from(getContext())
11. //                    .inflate(R.layout.search_container_workspace, firstPage, false);
12. //        }
13. //
14. //        int cellHSpan = mLauncher.getDeviceProfile().inv.numSearchContainerColumns;
15. //        CellLayoutLayoutParams lp = new CellLayoutLayoutParams(1, 2, cellHSpan, 1, FIRST_SCREEN_ID);
16. //        lp.canReorder = false;
17. //        if (!firstPage.addViewToCellLayout(
18. //                mFirstPagePinnedItem, 0, R.id.search_container_workspace, lp, true)) {
19. //            Log.e(TAG, "Failed to add to item at (0, 0) to CellLayout");
20. //            mFirstPagePinnedItem = null;
21. //        }
22. }

复制代码

1. // Launcher3/src/com/android/launcher3/model/LoaderCursor.java
2. protected boolean checkItemPlacement(ItemInfo item) {
3.     int containerIndex = item.screenId;
4.         // ...
6.     if (!occupied.containsKey(item.screenId)) {
7.         GridOccupancy screen = new GridOccupancy(countX + 1, countY + 1);
8.         // 注释下面if中的内容
9. //            if (item.screenId == Workspace.FIRST_SCREEN_ID && FeatureFlags.QSB_ON_FIRST_SCREEN) {
10. //                // Mark the first X columns (X is width of the search container) in the first row as
11. //                // occupied (if the feature is enabled) in order to account for the search
12. //                // container.
13. //                int spanX = mIDP.numSearchContainerColumns;
14. //                int spanY = 1;
15. //                screen.markCells(1, 2, spanX, spanY, true);
16. //            }
17.         occupied.put(item.screenId, screen);
18.     }
19.     final GridOccupancy occupancy = occupied.get(item.screenId);
21.     // Check if any workspace icons overlap with each other
22.     if (occupancy.isRegionVacant(item.cellX, item.cellY, item.spanX, item.spanY)) {
23.         occupancy.markCells(item, true);
24.         return true;
25.     } else {
26.         Log.e(TAG, "Error loading shortcut " + item
27.                 + " into cell (" + containerIndex + "-" + item.screenId + ":"
28.                 + item.cellX + "," + item.cellX + "," + item.spanX + "," + item.spanY
29.                 + ") already occupied");
30.         return false;
31.     }
32. }

复制代码

（1）如果适配了GMS框架并读取partner_default_layout.xml结构文件，则在google_gms包下的release\vendor\partner_gms\apps\GmsSampleIntegration\res_dhs_full\xml\partner_default_layout.xml内里定义应用的包名和类型以及位置信息,比方

1. <?xml version="1.0" encoding="utf-8"?>
2. <!-- Copyright (C) 2017 Google Inc. All Rights Reserved. -->
3. <favorites>
4.     <!--其他配置-->
5.     <appwidget screen="0" x="1" y="2" packageName="com.google.android.googlequicksearchbox" className="com.android.alarmclock.DigitalAppWidgetProvider" spanX="5" spanY="1" />
6. </favorites>

复制代码

（2）如果不读取partner_default_layout.xml结构文件，则在对应的default_workspace_MxN.xml内里修改应用的位置（MN分别代表行列数）：

1. <?xml version="1.0" encoding="utf-8"?>
2. <favorites xmlns:launcher="http://schemas.android.com/apk/res-auto/com.android.launcher3">
3.     <!--其他配置-->
4.     <resolve>
5.         <search
6.             launcher:screen="0"
7.             launcher:x="1"
8.             launcher:y="2"
9.             launcher:spanX="5"
10.             launcher:spanY="1"
11.             launcher:packageName="com.google.android.googlequicksearchbox"
12.             launcher:className="com.google.android.googlequicksearchbox.SearchWidgetProvider"/>
13.     </resolve>
14. </favorites>

复制代码

通过XML配置出来的效果和在Java代码中配置的一样，这里就不贴图了。
修改主页应用、组件

​ 和谷歌搜索框的改动一样，也是先在device_profiles.xml文件内里定义桌面的行列数：

1. <?xml version="1.0" encoding="utf-8"?>
2. <profiles xmlns:launcher="http://schemas.android.com/apk/res-auto" >
3.     <grid-option
4.         launcher:name="6_by_5"
5.         launcher:numRows="6"
6.         launcher:numColumns="7"
7.         launcher:numSearchContainerColumns="5"
8.         .../>
9. />

复制代码

​ 这里定义的app分布结构是六行七列。然后根据系统是否会读取partner_default_layout.xml结构文件来决定修改的位置：
（1）如果读取partner_default_layout.xml结构文件，则在partner_default_layout.xml内里定义应用的包名和类型以及位置信息,比方

1. <favorite screen="0" x="2" y="3" packageName="com.android.vending" className="com.android.vending.AssetBrowserActivity"/>
2. <!--表示在screen=“0”（第一屏）的第3列格子，第4行格子添加谷歌商店app。-->

复制代码

（2）如果不读取partner_default_layout.xml结构文件，则在对应的default_workspace_MxN.xml内里修改应用的位置（MN分别代表行列数）：

1. <!--定义一个普通应用程序快捷方式-->
2. <resolve>
3.     <favorite
4.         launcher:screen="0"
5.         launcher:x="2"
6.         launcher:y="3"
7.         launcher:packageName="com.android.vending"
8.         launcher:className="com.android.vending.AssetBrowserActivity"/>
9. </resolve>

复制代码

由于个人能力有限，上面的分析和讲解不免有错漏之处，接待各位批评指正；接待大家相互互换学习，一起进步，共勉！！！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。