Android移植Launcher

Launcher概述

Android系统启动后，加载的第一个程序就是Launcher应用。



Launcher的构

成：HomeScreen(workspace(AppWidget、WallPaper、LiveFolder、ShortCut))、HotSeats、AllApps/AllApplist:GridView

这是launcher的主界面，里面有一些应用的图标，可以点击图标来启动该应用。默认的情况下，主界面由五个屏组成，每一个屏都可以放置多个程序的图标。可以用手指按住屏幕在五个屏之间来回拖动，也可以快速地滑动来快速切换不同的屏。主界面主要关注UI是如何生成的，五个屏来回滑动是如何实现的，小图标的拖放是如何实现的。

点击顶部中间的格子图标后进入程序管理器，如下图所示。



程序管理器列出了系统已经安装的所有应用和小部件，可以点击图标来启动应用。长按住小图标一会，可以拖动小图标回到主界面并放置在主界面作为快捷方式。程序管理器主要关注UI是如何生成的，小图标的拖放是如何实现的，拖动画面时的动画是如何实现的。

系统框图如下：

1.分辨率

Android原生为sw600dp和sw720dp提供了两种不同的home界面布局。

sw600dp的hotseat放置在右侧，sw720dp的hotseat放置在底部。

Hotseat水平放置和垂直放置是可以调整的，在

packages/apps/Launcher2/res/layout-land/hotseat.xml中有如下属性：

launcher:cellCountX="1"
launcher:cellCountY="@integer/hotseat_cell_count">
packages/apps/Launcher2/res/layout-port/hotseat.xml里是：

launcher:cellCountX="@integer/hotseat_cell_count"
launcher:cellCountY="1">
即在横屏时hotseat是垂直放置的，竖屏时是水平放置的。

因为两个分辨率下的布局不同，所以对应的value也有很大差别，如果想统一界面显示，目前的方法是把某一分辨率的布局文件和value文件都删除掉，用另一个的文件代替，这样修改工作会少很多。

因为Launcher不同分辨率的布局文件中的数值都是用dimen或者config设置，所以在做sw600dp和sw480dp适配的时候，只需要修改values-sw480dp、values-sw480dp-land以及values-sw480dp-port目录下的文件就可以了。

dimen.xml里面的参数不一一解释了，因为从名字上面就能够看出是什么布局的数值，例如<dimen name="hotseat_cell_width">60dp</dimen>就是hotseat中每个图标的width，<dimen name="apps_customize_cell_width">76dp</dimen>应用列表界面中每个应用的width。

2.workspace

Launcher应用的启动activity是Launcher.java中的Launcher，其中的onCreate( )函数作为应用的起始点。根据其中的setContentView(R.layout.launcher); 可以看出应用的UI布局从launcher.xml开始。launcher.xml中包括有:

workspace ―― 主界面。

apps_customize_pane ―― 程序管理器。

qsb_bar ―― 上文中的图1顶部的搜索条。

workspace_cling ―― 是提示可以将应用拖动到主界面的提示画面。

folder_cling ―― 是提示可以将应用程序放到一个文件夹里面的提示画面。

Workspace是Launcher的主界面，布局由workspace.xml设置：

<com.android.launcher2.Workspace
android:id="@+id/workspace"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingStart="@dimen/workspace_left_padding"
android:paddingEnd="@dimen/workspace_right_padding"
android:paddingTop="@dimen/workspace_top_padding"
android:paddingBottom="@dimen/workspace_bottom_padding"
launcher:defaultScreen="2"
launcher:cellCountX="@integer/cell_count_x"
launcher:cellCountY="@integer/cell_count_y"
launcher:pageSpacing="@dimen/workspace_page_spacing"
launcher:scrollIndicatorPaddingLeft="@dimen/qsb_bar_height"
launcher:scrollIndicatorPaddingRight="@dimen/button_bar_height">

<include android:id="@+id/cell1" layout="@layout/workspace_screen" />
<include android:id="@+id/cell2" layout="@layout/workspace_screen" />
<include android:id="@+id/cell3" layout="@layout/workspace_screen" />
<include android:id="@+id/cell4" layout="@layout/workspace_screen" />
<include android:id="@+id/cell5" layout="@layout/workspace_screen" />
</com.android.launcher2.Workspace>
由上可以看出，workspace（继承PagedView、ViewGroup）由五个workspace_screen(实际是CellLayout, ViewGroup)组成，实现五个可以来回拖动的页面，缺省显示的是第二页。背景图是系统的WallPaper，与launcher无关。

在A20-android4.4中，home默认有5个屏，编号从左到右依次为0-4。这样五个页面就按顺序在水平方向并排地放置。



PagedView通过重写onMeasure（）方法来设置每个页面的宽高，重写onLayout( )方法来设置五个页面的坐标。

PagedView.onMeasure() －>CellLayout.onMeasure():
newWidth = mPaddingLeft + mPaddingRight + (mCountX * mCellWidth)
+ ((mCountX - 1) * mWidthGap);
newHeight = mPaddingTop + mPaddingBottom + (mCountY * mCellHeight)
+ ((mCountY - 1) * mHeightGap);
setMeasuredDimension(newWidth, newHeight); //设置每一页的宽高

PagedView.onLayout():
for (int i = 0; i < childCount; i++) //将五个页面指定到相应的坐标。
{
final View child = getPageAt(i);
if (child.getVisibility() != View.GONE)
{
final int childWidth = getScaledMeasuredWidth(child);
final int childHeight = child.getMeasuredHeight();
int childTop = mPaddingTop;

child.layout(childLeft, childTop,
childLeft + child.getMeasuredWidth(), childTop
+ childHeight); //指定每一页的坐标
childLeft += childWidth + mPageSpacing;
}
}


home显示的默认应用在xml-swXXXdp/default_workspace.xml中设置。

<appwidget/>表示小部件，<favorite/>快捷图标，<search/>搜索栏，<folder/>表示文件夹。

1．<appwidget/>的属性如下：

<appwidget
launcher:packageName="com.android.settings"
launcher:className="com.android.settings.widget.SettingsAppWidgetProvider"
launcher:screen="1"
launcher:x="2"
launcher:y="1"
launcher:spanX="4"
launcher:spanY="1" />
launcher:packageName、launcher:className指定启动对应的包名和类名；如果不知道没有源码的第三方应用的包名和类名，可以启动应用的时候打印logcat就能看到了。

launcher:screen指定显示的第几个屏幕。

launcher:x、launcher:y显示的坐标，即在X/Y轴上的位置，values-swXXXdp目录下的config.xml定义了每个屏幕横竖显示多少个网格，参数为 <integer name="cell_count_x">6</integer>和<integer name="cell_count_y">6</integer>，launcher:x、launcher:y指的就是在这些网格中的位置。在X轴上是向右从0开始依次增加，在Y轴上是向下从0开始依次增加。

launcher:spanX和launcher:spanY是小部件特有的属性，指定小部件在X/Y轴上的占用网格的个数。



2．<favorite/>

<favorite/>也有特定的属性：launcher:container="-101"，如果定义了这个属性，那么该<favorite/>就会放置在hotseat中，而 launcher:screen、launcher:x和launcher:y 三个属性的意义就会改变。

首先需要知道在config.xml中定义了HotSeat的图标个数<integer name="hotseat_cell_count">X</integer>，编号从左到右或者从下到上依次为0到X-1。上面所说的launcher:screen和launcher:x 需要等于相同的值x，表示按钮的位置，0表示第一个，launcher:y需要等于0，那么该<favorite/>就会放置在hotseat的第x-1的位置上。Hotseat的中间位置是放置appcutoms的按钮，<favorite/>放置在那里不会有效果。



3．<folder/>

在<folder/>内部可以添加不同<favorite/>，这些<favorite/>不需要定义坐标等，只要定义包名和类名可以。根据GMS要求，就需要在桌面的添加这样一个<folder/>，在这个<folder/>里面有所有google的<favorite/>。



图标可放置图标的位置并不是随意的，而是在每一页中一个固定的表格之内，在拖动小图标时才会显示该表格。

在workspace的构造函数中，计算该表格的行数和列数：

final float actionBarHeight = actionBarSizeTypedArray.getDimension(0, 0f);

Point minDims = new Point();
Point maxDims = new Point();
mLauncher.getWindowManager().getDefaultDisplay().getCurrentSizeRange(minDims, maxDims);
cellCountX = 1;
//cellCountX初始化为1，然后通过一个while循环去计算X、Y方向各能放多少个应用
while (CellLayout.widthInPortrait(res, cellCountX + 1) <= minDims.x) {
cellCountX++;
}
cellCountY = 1;
while (actionBarHeight + CellLayout.heightInLandscape(res, cellCountY + 1)
<= minDims.y) {
cellCountY++;
}
}
我们看看widthInPortrait方法：
static int widthInPortrait(Resources r, int numCells) {
//We use this method from Workspace to figure out how many rows/columns Launcher should
// have. We ignore the left/right padding on CellLayout because it turns out in our design
// the padding extends outside the visible screen size, but it looked fine anyway.
int cellWidth = r.getDimensionPixelSize(R.dimen.workspace_cell_width);
int minGap = Math.min(r.getDimensionPixelSize(R.dimen.workspace_width_gap),
r.getDimensionPixelSize(R.dimen.workspace_height_gap));

return minGap * (numCells - 1) + cellWidth * numCells;
}
getDimensionPixelSize方法实际上是把dimens.xml中设置的cellWidth大小由dp转换成px！

widthInPortrait计算后的返回值会与smallestScreenDim进行比较，如果比smallestScreenDim 小，那么说明能够再放一个APP，cellCount进行加一。循环比较之后就会得出在该屏幕上能放多少行，多少列个应用。

大致如下图的虚线表格：

3.AllApp列表配置文件

配置AllAPP应用列表界面的配置文件是\res\Layout\apps_customize_pane.xml文件。AllAPP列表使用了一个TabHost组织了两个页面（全部应用和Widget），通过界面上面的TabHost进行切换。下面对部分属性进行分析：

android:id="@+id/tabs_container" //TabHost栏，可以配置TabHost栏的高度和宽度

android:id="@android:id/tabs" //TabHost上面widget的按钮

android:id="@+id/market_button" //TabHost右边的Android市场的图标，不需要可以去掉

<!--下面这里就是我们所有应用列表的选项和所有应用列表的显示View，需要注意的是AppsCustomizePagedView同时支持显示所有应用列表和Widget列表 -->
<FrameLayout
android:id="@android:id/tabcontent"
android:layout_width="match_parent"
android:layout_height="match_parent">
<!-- 所有应用列表是通过自定义VIewAppsCustomizePagedView显示，后面会详细分析这个View下面只对部分重要属性加入注释 -->
<com.android.launcher2.AppsCustomizePagedView
android:id="@+id/apps_customize_pane_content"
android:layout_width="match_parent"
android:layout_height="match_parent"
//MaxAppCellCountX 和MaxAppCellCounY指的是所有App图标排列的最大行列数。
//一般设置为-1，表示无限制
launcher:maxAppCellCountX="@integer/apps_customize_maxCellCountX" launcher:maxAppCellCountY="@integer/apps_customize_maxCellCountY"
//pageLayoutWidthGap和pageLayoutHeightGap分别表示菜单界面与屏幕边缘的距离，

//一般小屏幕这里设置为-1。避免边框太窄误触屏幕才需要设置。 launcher:pageLayoutWidthGap="@dimen/apps_customize_pageLayoutWidthGap" launcher:pageLayoutHeightGap="@dimen/apps_customize_pageLayoutHeightGap"
//pageLayoutPaddingXXX指的是内填充，这个和系统的padding一样 launcher:pageLayoutPaddingTop="@dimen/apps_customize_pageLayoutPaddingTop" launcher:pageLayoutPaddingBottom="@dimen/apps_customize_pageLayoutPaddingBottom" launcher:pageLayoutPaddingLeft="@dimen/apps_customize_pageLayoutPaddingLeft" launcher:pageLayoutPaddingRight="@dimen/apps_customize_pageLayoutPaddingRight"
//widgetCellWithGap和widgetCellHeightGap指的是widget列表界面各个widget之间的间隔，

//和系统的margin属性类似
launcher:widgetCellWidthGap="@dimen/apps_customize_widget_cell_width_gap"
launcher:widgetCellHeightGap="@dimen/apps_customize_widget_cell_height_gap"
//widgetCountX和WidgetCountY都是表示Widget界面每行每列显示多少Widget
launcher:widgetCountX="@integer/apps_customize_widget_cell_count_x" launcher:widgetCountY="@integer/apps_customize_widget_cell_count_y"
//提示界面的焦点
launcher:clingFocusedX="@integer/apps_customize_cling_focused_x"
launcher:clingFocusedY="@integer/apps_customize_cling_focused_y"
launcher:maxGap="@dimen/workspace_max_gap" />
<!-- 加载全部应用时的旋转动画 -->
<FrameLayout
android:id="@+id/animation_buffer"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#FF000000"
android:visibility="gone" />
<!-- 分页符，代表多少页和当前页面-->
<include
android:id="@+id/paged_view_indicator"
layout="@layout/scroll_indicator"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="bottom" />
</FrameLayout>
</LinearLayout>
<!--第一次进入所有应用列表的提示界面，和workspace提示界面一样-->
<include layout="@layout/all_apps_cling"
android:id="@+id/all_apps_cling"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:visibility="gone" />
</com.android.launcher2.AppsCustomizeTabHost>
图标下面的名称行数也可以通过修改res/values/styles.xml来调整：

<item name="android:singleLine">false</item>

<item name="android:maxLines">2</item>

这两行代码可以进行修改。

4.动画参数

res/values/config.xml文件定义了workspace到appsCustomize两界面切换时的动画参数，如下：

config_appsCustomizeSpringLoadedBgAlpha 进入appcustomize界面背景的透明度

config_workspaceUnshrinkTime home键返回时，workspace的扩张动画时间

config_appsCustomizeWorkspaceShrinkTime 返回workspace的收缩动画时间

config_workspaceSpringLoadShrinkPercentage 把应用拖放到主界面的时候，显示主界面边框的大小

config_appsCustomizeZoomInTime/ config_appsCustomizeZoomOutTime 进入/退出appsCustomize的扩张收缩动画时间

config_appsCustomizeFadeInTime/ config_appsCustomizeFadeOutTime 进入/退出appsCustomize的透明度改变时间

config_appsCustomizeWorkspaceAnimationStagger/ config_workspaceAppsCustomizeAnimationStagger 进入/退出workspace时桌面上图标的移动时间

PagedView.java里面定义翻页速度MAX_PAGE_SNAP_DURATION。