LaunchMode.ppt

4.0launcher源码详细分析

从今天起傻蛋打算做一个系列文章,对最新的Android 4.0 系统中的Launcher,也就是Android 4.0原生的桌面程序,进行一个深入浅出的分析,从而引领Android系统的编程爱好者对 Launcher的设计思想,实现方式来做一个研究,从而能够通过这个实例最掌握到目前世界领先的设计方法,同时在程序中加入我们的一些新的实现。众所周知,对一些优秀源代码的分析,是提高编程水平的一条便捷的方式,希望本系列文章能够给大家带来一定的启发,同时欢迎大家和作者一起讨论,作者的微博是:http://weibo.com/zuiniuwang/
先从整体上对Launcher布局作一个分析,让我们通过查看Launcher.xml 和使用hierarchyviewer布局查看工具两者结合的方法来对Launcher的整体结构有个了解。通过hierarchyviewer来对整个桌面做个截图,如下:
image.png
放大后如下所示: 可以看到整个桌面包含的元素,最上面是Google的搜索框,下面是一个始终插件,然后是图标,再有就是一个分隔线,最后是dock。请注意,桌面程序其实并不包含桌面壁纸,桌面壁纸其实是由 WallpaperManagerService来提供,整个桌面其实是叠加在整个桌面壁纸上的另外一个层。
image.png
整个Launcher.xml布局文件如下:

  1. 1.<com.android.launcher2.DragLayer
  2. 2.
  3. xmlns:android="http://schemas.android.com/apk/res/android";
  4. 3.
  5. xmlns:launcher="http://schemas.android.com/apk/res/com.android.launcher";
  6. 4.
  7. 5.
  8. android:id="@+id/drag_layer"
  9. 6.
  10. android:layout_width="match_parent"
  11. 7.
  12. android:layout_height="match_parent">
  13. 8.
  14. 9.
  15. <!-- Keep these behind the workspace so that they are not visible when
  16. 10.
  17. we go into AllApps -->
  18. 11.
  19. <include
  20. 12.
  21. android:id="@+id/dock_divider"
  22. 13.
  23. layout="@layout/workspace_divider"
  24. 14.
  25. android:layout_width="match_parent"
  26. 15.
  27. android:layout_height="wrap_content"
  28. 16.
  29. android:layout_marginBottom="@dimen/button_bar_height"
  30. 17.
  31. android:layout_gravity="bottom" />
  32. 18.
  33. <include
  34. 19.
  35. android:id="@+id/paged_view_indicator"
  36. 20.
  37. layout="@layout/scroll_indicator"
  38. 21.
  39. android:layout_width="wrap_content"
  40. 22.
  41. android:layout_height="wrap_content"
  42. 23.
  43. android:layout_gravity="bottom"
  44. 24.
  45. android:layout_marginBottom="@dimen/button_bar_height" />
  46. 25.
  47. 26.
  48. <!-- The workspace contains 5 screens of cells -->
  49. 27.
  50. <com.android.launcher2.Workspace
  51. 28.
  52. android:id="@+id/workspace"
  53. 29.
  54. android:layout_width="match_parent"
  55. 30.
  56. android:layout_height="match_parent"
  57. 31.
  58. android:paddingTop="@dimen/qsb_bar_height_inset"
  59. 32.
  60. android:paddingBottom="@dimen/button_bar_height"
  61. 33.
  62. launcher:defaultScreen="2"
  63. 34.
  64. launcher:cellCountX="4"
  65. 35.
  66. launcher:cellCountY="4"
  67. 36.
  68. launcher:pageSpacing="@dimen/workspace_page_spacing"
  69. 37.
  70. launcher:scrollIndicatorPaddingLeft="@dimen/workspace_divider_padding_left"
  71. 38.
  72. launcher:scrollIndicatorPaddingRight="@dimen/workspace_divider_padding_right">
  73. 39.
  74. 40.
  75. <include android:id="@+id/cell1" layout="@layout/workspace_screen" />
  76. 41.
  77. <include android:id="@+id/cell2" layout="@layout/workspace_screen" />
  78. 42.
  79. <include android:id="@+id/cell3" layout="@layout/workspace_screen" />
  80. 43.
  81. <include android:id="@+id/cell4" layout="@layout/workspace_screen" />
  82. 44.
  83. <include android:id="@+id/cell5" layout="@layout/workspace_screen" />
  84. 45.
  85. </com.android.launcher2.Workspace>
  86. 46.
  87. 47.
  88. <include layout="@layout/hotseat"
  89. 48.
  90. android:id="@+id/hotseat"
  91. 49.
  92. android:layout_width="match_parent"
  93. 50.
  94. android:layout_height="@dimen/button_bar_height_plus_padding"
  95. 51.
  96. android:layout_gravity="bottom" />
  97. 52.
  98. 53.
  99. <include
  100. 54.
  101. android:id="@+id/qsb_bar"
  102. 55.
  103. layout="@layout/qsb_bar" />
  104. 56.
  105. 57.
  106. <include layout="@layout/apps_customize_pane"
  107. 58.
  108. android:id="@+id/apps_customize_pane"
  109. 59.
  110. android:layout_width="match_parent"
  111. 60.
  112. android:layout_height="match_parent"
  113. 61.
  114. android:visibility="invisible" />
  115. 62.
  116. 63.
  117. <include layout="@layout/workspace_cling"
  118. 64.
  119. android:id="@+id/workspace_cling"
  120. 65.
  121. android:layout_width="match_parent"
  122. 66.
  123. android:layout_height="match_parent"
  124. 67.
  125. android:visibility="gone" />
  126. 68.
  127. 69.
  128. <include layout="@layout/folder_cling"
  129. 70.
  130. android:id="@+id/folder_cling"
  131. 71.
  132. android:layout_width="match_parent"
  133. 72.
  134. android:layout_height="match_parent"
  135. 73.
  136. android:visibility="gone" />
  137. 74.</com.android.launcher2.DragLayer>

Launcher整个布局的根是DragLayer,DragLayer继承了FrameLayout,所以DragLayer本身可以看作是一个FrameLayout。下面是 dock_divider,它通过include关键字包含了另外一个布局文件workspace_divider.xml ,而这个workspace_divider.xml包含了一ImageView,其实dock_divider就是dock区域上面的那条直线。 再下面是paged_view_indicator,同样它包含了scroll_indicator.xml,其中包含了一个ImageView,显示的是一个.9的png文件。实际上就是当Launcher滚动翻页的时候,那个淡蓝色的页面指示条。 然后桌面的核心容器WorkSpace,如下图所示,当然你看到的只是Workspace的一部分,其实是一个workspace_screen,通过 Launcher.xml可以看到,整个workspace由5个workspace_screen组成,每个workspace_screen其实就是对应桌面一页。而每个workspace_screen包含了一个CellLayout,这是一个自定义控件,继承自ViewGroup,所以它算是一个用来布局的控件,在这里主要用来承载我们每页的桌面图标、widget和文件夹。
image.png
通过查看如下的布局结构(由于图太大只截取了一部分)可以看到,Workspace包含了序号从0到4的5个CellLayout。
image.png
接下来是一个Hotseat,其实就是这块dock区域了。如图所示:
image.png
从如下的布局图我们可以看到,这个Hotseat其实还是包含了一个CellLayout,用来承载4个图标和中间启动所有程序的按钮。
image.png
再下来就是那个qsb_bar,就是屏幕最顶端的Google搜索框。这个搜索框是独立于图标界面的,所以当我们对桌面进行翻页的时候,这个搜索框会巍然不动滴固定在最顶端,如下所示:
image.png
紧接着是3个初始化时被隐藏的界面。
apps_customize_pane,点击dock中显示所有应用程序的按钮后才会从隐藏状态转换为显示状态,如下图所示,显示了所有应用程序和所有插件的界面。
image.png

通过查看apps_customize_pane.xml ,我们可以看到apps_customize_pane主要由两部分组成:tabs_container 和tabcontent。tabs部分,用来让我们选择是添加应用程序还是widget,如下图所示:
tabcontent,选择了相应的tab之后,下面的部分就会相应的显示应用程序或是widget了,如下图所示:

image.png
workspace_cling 和 folder_cling 是刚刷完机后,进入桌面时,显示的使用向导界面,介绍怎么使用workspace和folder,跳过以后就再也不会出现了,这里就不截图了。
上一节我们研究了Launcher的整体结构,这一节我们看看整个Laucher的入口点,同时Laucher在加载了它的布局文件Laucher.xml时都干了些什么。
我们在源代码中可以找到LauncherApplication, 它继承了Application类,当整个Launcher启动时,它就是整个程序的入口。我们先来看它们在AndroidManifest.xml中是怎么配置的。

  1. android:name=”com.android.launcher2.LauncherApplication”
  2. android:label=”@string/application_name”
  3. android:icon=”@drawable/ic_launcher_home”
  4. android:hardwareAccelerated=”@bool/config_hardwareAccelerated”
  5. android:largeHeap=”@bool/config_largeHeap”>

首先通过android:name指定了整个Launcher的Application也就是入口是在 com.android.launcher2.LauncherApplication这个路径下,android:lable指定了桌面的名字是叫 Launcher,如果要改名字就改values文件夹的string.xml中的相应属性就可以了。android:icon指定了Laucher的图标,这个图标可以在应用程序管理器中看见,如下图所示,是个可爱机器人住在一个小房子里面,如果需要更改Laucher的图片,重新设置这个属性就可以了。

image.png

android:hardwareAccelerated=”@bool/config_hardwareAccelerated” 指定了整个应用程序是启用硬件加速的,这样整个应用程序的运行速度会更快。
android:largeHeap=”@bool/config_largeHeap” 指定了应用程序使用了大的堆内存,能在一定程度上避免,对内存out of memory错误的出现。我们可以在values文件夹的config.xml中看到对是否启用硬件加速和大内存的配置。如下所示:

  1. <bool name=”config_hardwareAccelerated”>true
  2. <bool name=”config_largeHeap”>false

在Application中onCreate()方法通过:sIsScreenLarge = screenSize == Configuration.SCREENLAYOUT_SIZE_LARGE || screenSize == Configuration.SCREENLAYOUT_SIZE_XLARGE; 和sScreenDensity = getResources().getDisplayMetrics().density;来判断是否是大屏幕,同时得到它的屏幕密度。同时通过mIconCache = new IconCache(this); 来设置了应用程序的图标的cache,然后申明了LauncherModel,mModel = new LauncherModel(this, mIconCache); LauncherModel主要用于加载桌面的图标、插件和文件夹,同时LaucherModel是一个广播接收器,在程序包发生改变、区域、或者配置文件发生改变时,都会发送广播给LaucherModel,LaucherModel会根据不同的广播来做相应加载操作,此部分会在后面做详细介绍。
在LauncherApplication完成初始化工作之后,我们就来到了Launcher.java的onCreate()方法,同样是启动桌面时的一系列初始化工作。
首先需要注意的是在加载launcher布局文件时的一个TraceView的调试方法,它能够对在他们之间的方法进行图形化的性能分析,并且能够具体到method 代码如下:
1.
if (PROFILE_STARTUP) {
2.
android.os.Debug.startMethodTracing(
3.
Environment.getDataDirectory() + “/data/com.android.launcher/launcher”);
4.
}
5.
if (PROFILE_STARTUP) {
6.
android.os.Debug.stopMethodTracing();
7.
}

我指定的生成性能分析的路径是:/data/data/com.android.launcher/launcher,启动launcher后我们会发现在指定的目录下生成了launcher.trace文件,如下图所示:

把launcher.trace文件通过DDMS pull到电脑上,在SDK的tools目录里,执行traceview工具来打开launcher.trace .如下图所示:

可以看到setContentView使用了448.623ms,占整个跟踪代码时间的62%,所以说在加载布局文件时,肯定经过了一系列的加载运算,我们接着分析。
当加载launcher布局文件的过程时,最为关键的时对整个workspace的加载,workspace是一个自定义组件,它的继承关系如下所示,可以看到Workspace实际上也是一个ViewGroup,可以加入其他控件。

当ViewGroup组件进行加载的时候首先会读取本控件对应的XML文件,然后Framework层会执行它的onMeasure()方法,根据它所包含的子控件大小来计算出整个控件要在屏幕上占的大小。Workspace重写了ViewGroup的onMeasure方法(在PagedView中),在workspace中是对5个子CellLayout进行测量,的方法如下, 具体含义请看注释:
1.
@Override
2.
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
3.
if (!mIsDataReady) {
4.
super.onMeasure(widthMeasureSpec, heightMeasureSpec);
5.
return;
6.
}
7.
//得到宽度的模式(在配置文件中对应的是match_parent 或者 wrap_content)和其大小
8.
final int widthMode = MeasureSpec.getMode(widthMeasureSpec);
9.
final int widthSize = MeasureSpec.getSize(widthMeasureSpec);
10.
//宽度必须是match_parent,否则会抛出异常。
11.
if (widthMode != MeasureSpec.EXACTLY) {
12.
throw new IllegalStateException(“Workspace can only be used in EXACTLY mode.”);
13.
}
14.

  1. 15.

/* Allow the height to be set as WRAP_CONTENT. This allows the particular case
16.

  • of the All apps view on XLarge displays to not take up more space then it needs. Width

  • is still not allowed to be set as WRAP_CONTENT since many parts of the code expect

  • each page to have the same width.

*/
20.
//高度允许是wrap_content,因为在大屏幕的情况下,会占了多余的位置
21.
final int heightMode = MeasureSpec.getMode(heightMeasureSpec);
22.
int heightSize = MeasureSpec.getSize(heightMeasureSpec);
23.
int maxChildHeight = 0;
24.
//得到在竖值方向上和水平方向上的Padding
25.
final int verticalPadding = mPaddingTop + mPaddingBottom;
26.
final int horizontalPadding = mPaddingLeft + mPaddingRight;
27.

  1. 28.
  2. 29.
  3. // The children are given the same width and height as the workspace
  4. 30.
  5. // unless they were set to WRAP_CONTENT
  6. 31.
  7. if (DEBUG) Log.d(TAG, "PagedView.onMeasure(): " + widthSize + ", " + heightSize + " mPaddingTop="+mPaddingTop + " mPaddingBottom="+mPaddingBottom);
  8. 32.
  9. final int childCount = getChildCount();
  10. 33.
  11. //对workspace的子View进行遍历,从而对它的几个子view进行测量。
  12. 34.
  13. for (int i = 0; i < childCount; i++) {
  14. 35.
  15. // disallowing padding in paged view (just pass 0)
  16. 36.
  17. final View child = getPageAt(i);
  18. 37.
  19. final LayoutParams lp = (LayoutParams) child.getLayoutParams();
  20. 38.
  21. 39.
  22. int childWidthMode;
  23. 40.
  24. if (lp.width == LayoutParams.WRAP_CONTENT) {
  25. 41.
  26. childWidthMode = MeasureSpec.AT_MOST;
  27. 42.
  28. } else {
  29. 43.
  30. childWidthMode = MeasureSpec.EXACTLY;
  31. 44.
  32. }
  33. 45.
  34. 46.
  35. int childHeightMode;
  36. 47.
  37. if (lp.height == LayoutParams.WRAP_CONTENT) {
  38. 48.
  39. childHeightMode = MeasureSpec.AT_MOST;
  40. 49.
  41. } else {
  42. 50.
  43. childHeightMode = MeasureSpec.EXACTLY;
  44. 51.
  45. }
  46. 52.
  47. 53.
  48. final int childWidthMeasureSpec =
  49. 54.
  50. MeasureSpec.makeMeasureSpec(widthSize - horizontalPadding, childWidthMode);
  51. 55.
  52. final int childHeightMeasureSpec =
  53. 56.
  54. MeasureSpec.makeMeasureSpec(heightSize - verticalPadding, childHeightMode);
  55. 57.
  56. //对子View的大小进行设置,传入width和height参数
  57. 58.
  58. child.measure(childWidthMeasureSpec, childHeightMeasureSpec);
  59. 59.
  60. maxChildHeight = Math.max(maxChildHeight, child.getMeasuredHeight());
  61. 60.
  62. if (DEBUG) Log.d(TAG, "\tmeasure-child" + i + ": " + child.getMeasuredWidth() + ", "
  63. 61.
  64. + child.getMeasuredHeight());
  65. 62.
  66. }
  67. 63.
  68. 64.
  69. if (heightMode == MeasureSpec.AT_MOST) {
  70. 65.
  71. heightSize = maxChildHeight + verticalPadding;
  72. 66.
  73. }
  74. 67.
  75. //存储测量后的宽度和高度
  76. 68.
  77. setMeasuredDimension(widthSize, heightSize);
  78. 69.
  79. 70.
  80. // We can't call getChildOffset/getRelativeChildOffset until we set the measured dimensions.
  81. 71.
  82. // We also wait until we set the measured dimensions before flushing the cache as well, to
  83. 72.
  84. // ensure that the cache is filled with good values.
  85. 73.
  86. invalidateCachedOffsets();
  87. 74.
  88. updateScrollingIndicatorPosition();
  89. 75.
  90. 76.
  91. if (childCount > 0) {
  92. 77.
  93. mMaxScrollX = getChildOffset(childCount - 1) - getRelativeChildOffset(childCount - 1);
  94. 78.
  95. } else {
  96. 79.
  97. mMaxScrollX = 0;
  98. 80.
  99. }
  100. 81.
  101. }

测量完毕之后就可以对子控件进行布局了,这时候Framework层会调用PagedView中重写的onLayout方法。
1.
@Override
2.
protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
3.
if (!mIsDataReady) {
4.
return;
5.
}
6.

  1. 7.
  2. if (DEBUG) Log.d(TAG, "PagedView.onLayout()");
  3. 8.
  4. //竖值方向的Padding
  5. 9.
  6. final int verticalPadding = mPaddingTop + mPaddingBottom;
  7. 10.
  8. final int childCount = getChildCount();
  9. 11.
  10. int childLeft = 0;
  11. 12.
  12. if (childCount > 0) {
  13. 13.
  14. if (DEBUG) Log.d(TAG, "getRelativeChildOffset(): " + getMeasuredWidth() + ", "
  15. 14.
  16. + getChildWidth(0));
  17. 15.
  18. childLeft = getRelativeChildOffset(0);
  19. 16.
  20. //偏移量为0
  21. 17.
  22. if (DEBUG) Log.d(TAG, "childLeft:"+childLeft);
  23. 18.
  24. 19.
  25. // Calculate the variable page spacing if necessary
  26. 20.
  27. // 如果mPageSpacing小于0的话,就重新计算mPageSpacing,并且给它赋值。
  28. 21.
  29. if (mPageSpacing < 0) {
  30. 22.
  31. setPageSpacing(((right - left) - getChildAt(0).getMeasuredWidth()) / 2);
  32. 23.
  33. }
  34. 24.
  35. }
  36. 25.
  37. 26.
  38. for (int i = 0; i < childCount; i++) {
  39. 27.
  40. final View child = getPageAt(i);
  41. 28.
  42. if (child.getVisibility() != View.GONE) {
  43. 29.
  44. final int childWidth = getScaledMeasuredWidth(child);
  45. 30.
  46. final int childchildHeight = child.getMeasuredHeight();
  47. 31.
  48. int childTop = mPaddingTop;
  49. 32.
  50. if (mCenterPagesVertically) {
  51. 33.
  52. childTop += ((getMeasuredHeight() - verticalPadding) - childHeight) / 2;
  53. 34.
  54. }
  55. 35.
  56. 36.
  57. if (DEBUG) Log.d(TAG, "\tlayout-child" + i + ": " + childLeft + ", " + childTop);
  58. 37.
  59. //把5个CellLayout布局到相应的位置,layout的4个参数分别是 左、上、右、下。
  60. 38.
  61. child.layout(childLeft, childTop,
  62. 39.
  63. childLeft + child.getMeasuredWidth(), childTop + childHeight);
  64. 40.
  65. childLeft += childWidth + mPageSpacing;
  66. 41.
  67. }
  68. 42.
  69. }
  70. 43.
  71. //第一次布局完毕之后,就根据当前页偏移量(当前页距离Workspace最左边的距离)滚动到默认的页面去,第一次布局时
  72. 44.
  73. //默认的当前页是3,则它的便宜量就是两个CellLayout的宽度。
  74. 45.
  75. if (mFirstLayout && mCurrentPage >= 0 && mCurrentPage < getChildCount()) {
  76. 46.
  77. setHorizontalScrollBarEnabled(false);
  78. 47.
  79. int newX = getChildOffset(mCurrentPage) - getRelativeChildOffset(mCurrentPage);
  80. 48.
  81. //滚动到指定的位置
  82. 49.
  83. scrollTo(newX, 0);
  84. 50.
  85. mScroller.setFinalX(newX);
  86. 51.
  87. if (DEBUG) Log.d(TAG, "newX is "+newX);
  88. 52.
  89. setHorizontalScrollBarEnabled(true);
  90. 53.
  91. mFirstLayout = false;
  92. 54.
  93. }
  94. 55.
  95. 56.
  96. if (mFirstLayout && mCurrentPage >= 0 && mCurrentPage < getChildCount()) {
  97. 57.
  98. mFirstLayout = false;
  99. 58.
  100. }
  101. 59.

}

首先傻蛋先画了个图来再来阐述一下WorkSpace的结构。如下图:

桌面的左右滑动功能主要是在PagedView类中实现的,而WorkSpace是PagedView类的子类,所以会继承PagedView中的方法。当我们的手指点击WorkSpace时,首先就会触发PageView中的onInterceptTouchEvent()方法,会根据相应的条件来判断是否对Touch事件进行拦截,如果onInterceptTouchEvent()方法返回为true,则会对Touch事件进行拦截,PageView类的onTouch方法会进行响应从而得到调用。如果返回false,就分两钟情况:(1)我们是点击在它的子控键上进行滑动时,比如我们是点击在桌面的图标上进行左右滑动的,workspace则会把Touch事件分发给它的子控件。(2)而如果仅仅是点击到桌面的空白出Touch事件就不会发生响应。
在我们手指第一次触摸到屏幕时,首先会对onInterceptTouchEvent中的事件进行判断,如果是按下事件(MotionEvent.ACTION_DOWN), 则会记录按下时的X坐标、Y坐标等等数据,同时改变现在Workspace的状态为滚动状态(OUCH_STATE_SCROLLING),这时会返回ture,把事件交给onTouchEvent函数来处理,onTouchEvent中同样会对事件类型进行判断,当事件方法为(otionEvent.ACTION_DOWN)的时候,就可以开始显示滚动的指示条了(就是Hotseat上显示第几屏的屏点)。当我们按着屏幕不放进行滑动的时候,又会在onInterceptTouchEvent进行事件拦截,但是现在的事件类型变为了 MotionEvent.ACTION_MOVE,因为是移动的操作,所以会在拦截的时候取消桌面长按的事件的响应,同时转到onTouchEvent中对ACTION_MOVE事件的响应中,判断我们移动了多少距离,使用scrollBy方法来对桌面进行移动,并刷新屏幕。最后我们放开手后会触发onTouchEvent中的MotionEvent.ACTION_UP事件,这时会根据滑动的情况来判断是朝左滑动还是朝右滑动,如果手指只滑动了屏幕宽度的少一半距离,则会弹回原来的页面,滑动多于屏幕宽度的一半则会进行翻页。同时要注意无论在什么情况下触发了WorkSpace滑动的事件,则系统会不断调用computeScroll()方法,我们重写这个方法同时在这个方法中调用刷新界面等操作。
滑动过程中所要注意的主要方法如下,具体见代码注释。
1.
//对Touch事件进行拦截 主要用于在拦截各种Touch事件时,设置mTouchState的各种状态
2.
@Override
3.
public boolean onInterceptTouchEvent(MotionEvent ev) {
4.
/
5.
This method JUST determines whether we want to intercept the motion.
6.
If we return true, onTouchEvent will be called and we do the actual
7.
scrolling there.
8.
这个方法仅仅决定了我们是否愿意去对滑动事件进行拦截,如果返回为true,则会调用onTouchEvent我们将会在那里进行事件处理
9.
/
10.
//对滑动的速率进行跟踪。
11.

  1. 12.
  2. acquireVelocityTrackerAndAddMovement(ev);
  3. 13.
  4. 14.
  5. // Skip touch handling if there are no pages to swipe
  6. 15.
  7. // 如果没有页面,则跳过操作。
  8. 16.
  9. if (getChildCount() <= 0) return super.onInterceptTouchEvent(ev);
  10. 17.
  11. 18.
  12. /*
  13. 19.
  14. * Shortcut the most recurring case: the user is in the dragging
  15. 20.
  16. * state and he is moving his finger. We want to intercept this
  17. 21.
  18. * motion.
  19. 22.
  20. * shortcut最常见的情况是:用户处于拖动的状态下,同时在移动它的手指,这时候我们需要拦截这个动作。
  21. 23.
  22. */
  23. 24.
  24. final int action = ev.getAction();
  25. 25.
  26. //如果是在MOVE的情况下,则进行Touch事件拦截
  27. 26.
  28. if ((action == MotionEvent.ACTION_MOVE) &&
  29. 27.
  30. (mTouchState == TOUCH_STATE_SCROLLING)) {
  31. 28.
  32. return true;
  33. 29.
  34. }
  35. 30.
  36. 31.
  37. switch (action & MotionEvent.ACTION_MASK) {
  38. 32.
  39. case MotionEvent.ACTION_MOVE: {
  40. 33.
  41. /*
  42. 34.
  43. * mIsBeingDragged == false, otherwise the shortcut would have caught it. Check
  44. 35.
  45. * whether the user has moved far enough from his original down touch.
  46. 36.
  47. * 如果mIsBeingDragged==false ,否则快捷方式应该捕获到该事件,检查一下用户从它点击的地方位移是否足够
  48. 37.
  49. */
  50. 38.
  51. if (mActivePointerId != INVALID_POINTER) {
  52. 39.
  53. //根据移动的距离判断是翻页还是移动一段位移,同时设置lastMotionX或者mTouchState这些值。同时取消桌面长按事件。
  54. 40.
  55. determineScrollingStart(ev);
  56. 41.
  57. break;
  58. 42.
  59. }
  60. 43.
  61. // if mActivePointerId is INVALID_POINTER, then we must have missed an ACTION_DOWN
  62. 44.
  63. // event. in that case, treat the first occurence of a move event as a ACTION_DOWN
  64. 45.
  65. // i.e. fall through to the next case (don't break)
  66. 46.
  67. // (We sometimes miss ACTION_DOWN events in Workspace because it ignores all events
  68. 47.
  69. // while it's small- this was causing a crash before we checked for INVALID_POINTER)
  70. 48.
  71. // 如果mActivePointerId 是 INVALID_POINTER,这时候我们应该已经错过了ACTION_DOWN事件。在这种情况下,把
  72. 49.
  73. // 第一次发生移动的事件当作ACTION——DOWN事件,直接进入下一个情况下。

//我们有时候会错过workspace中的ACTION_DOWN事件,因为在workspace变小的时候会忽略掉所有的件。
1.
}
2.

  1. 3.
  2. case MotionEvent.ACTION_DOWN: {
  3. 4.
  4. final float x = ev.getX();
  5. 5.
  6. final float y = ev.getY();
  7. 6.
  8. // Remember location of down touch
  9. 7.
  10. // 记录按下的位置
  11. 8.
  12. mDownMotionX = x;
  13. 9.
  14. mLastMotionX = x;
  15. 10.
  16. mLastMotionY = y;
  17. 11.
  18. mLastMotionXRemainder = 0;
  19. 12.
  20. mTotalMotionX = 0;
  21. 13.
  22. //Return the pointer identifier associated with a particular pointer data index is this event.
  23. 14.
  24. //The identifier tells you the actual pointer number associated with the data,
  25. 15.
  26. //accounting for individual pointers going up and down since the start of the current gesture.
  27. 16.
  28. //返回和这个事件关联的触点数据id,计算单独点的id会上下浮动,因为手势的起始位置挥发声改变。
  29. 17.
  30. mActivePointerId = ev.getPointerId(0);
  31. 18.
  32. mAllowLongPress = true;
  33. 19.
  34. 20.
  35. /*
  36. 21.
  37. * If being flinged and user touches the screen, initiate drag;
  38. 22.
  39. * otherwise don't. mScroller.isFinished should be false when
  40. 23.
  41. * being flinged.
  42. 24.
  43. * 如果被拖动同时用户触摸到了屏幕,就开始初始化拖动,否则便不会。
  44. 25.
  45. * 当拖动完成后mScroller.isFinished就应该设置为false.
  46. 26.
  47. */
  48. 27.
  49. final int xDist = Math.abs(mScroller.getFinalX() - mScroller.getCurrX());
  50. 28.
  51. 29.
  52. final boolean finishedScrolling = (mScroller.isFinished() || xDist < mTouchSlop);
  53. 30.
  54. if (finishedScrolling) {
  55. 31.
  56. //标记为TOUCH_STATE_REST状态
  57. 32.
  58. mTouchState = TOUCH_STATE_REST;
  59. 33.
  60. //取消滚动动画
  61. 34.
  62. mScroller.abortAnimation();
  63. 35.
  64. } else {
  65. 36.
  66. //状态为TOUCH_STATE_SCROLLING
  67. 37.
  68. mTouchState = TOUCH_STATE_SCROLLING;
  69. 38.
  70. }
  71. 39.
  72. 40.
  73. // check if this can be the beginning of a tap on the side of the pages
  74. 41.
  75. // to scroll the current page
  76. 42.
  77. // 检测此事件是不是开始于点击页面的边缘来对当前页面进行滚动。
  78. 43.
  79. if (mTouchState != TOUCH_STATE_PREV_PAGE && mTouchState != TOUCH_STATE_NEXT_PAGE) {
  80. 44.
  81. if (getChildCount() > 0) {
  82. 45.
  83. //根据触点的点位来判断是否点击到上一页,从而更新相应的状态
  84. 46.
  85. if (hitsPreviousPage(x, y)) {
  86. 47.
  87. mTouchState = TOUCH_STATE_PREV_PAGE;
  88. 48.
  89. } else if (hitsNextPage(x, y)) {
  90. 49.
  91. mTouchState = TOUCH_STATE_NEXT_PAGE;
  92. 50.
  93. }
  94. 51.
  95. }
  96. 52.
  97. }
  98. 53.
  99. break;
  100. 54.
  101. }
  102. 55.
  103. 56.
  104. case MotionEvent.ACTION_UP:
  105. 57.
  106. case MotionEvent.ACTION_CANCEL:
  107. 58.
  108. //触点不被相应时,所做的动作
  109. 59.
  110. mTouchState = TOUCH_STATE_REST;
  111. 60.
  112. mAllowLongPress = false;
  113. 61.
  114. mActivePointerId = INVALID_POINTER;
  115. 62.
  116. //释放速率跟踪
  117. 63.
  118. releaseVelocityTracker();
  119. 64.
  120. break;
  121. 65.
  122. 66.
  123. case MotionEvent.ACTION_POINTER_UP:
  124. 67.
  125. onSecondaryPointerUp(ev);
  126. 68.
  127. releaseVelocityTracker();
  128. 69.
  129. break;
  130. 70.
  131. }
  132. 71.
  133. 72.
  134. /*
  135. 73.
  136. * The only time we want to intercept motion events is if we are in the
  137. 74.
  138. * drag mode.
  139. 75.
  140. * 我们唯一会去对移动事件进行拦截的情况时我们在拖动模式下
  141. 76.
  142. */
  143. 77.
  144. if(DEBUG) Log.d(TAG, "onInterceptTouchEvent "+(mTouchState != TOUCH_STATE_REST));
  145. 78.
  146. //只要是mTouchState的状态不为TOUCH_STATE_REST,那么就进行事件拦截
  147. 79.
  148. return mTouchState != TOUCH_STATE_REST;
  149. 80.

}

onTouchEvent方法,详细见代码注释:
1.
@Override
2.
public boolean onTouchEvent(MotionEvent ev) {
3.
// Skip touch handling if there are no pages to swipe
4.
// 如果没有子页面,就直接跳过
5.
if (getChildCount() <= 0) return super.onTouchEvent(ev);
6.

  1. 7.
  2. acquireVelocityTrackerAndAddMovement(ev);
  3. 8.
  4. 9.
  5. final int action = ev.getAction();
  6. 10.
  7. 11.
  8. switch (action & MotionEvent.ACTION_MASK) {
  9. 12.
  10. case MotionEvent.ACTION_DOWN:
  11. 13.
  12. /*
  13. 14.
  14. * If being flinged and user touches, stop the fling. isFinished
  15. 15.
  16. * will be false if being flinged.
  17. 16.
  18. * 如果在滑动的过程中下用户又点击桌面,则取消滑动,从而响应当前的点击。
  19. 17.
  20. * 在滑动的isFinished将返回false.
  21. 18.
  22. */
  23. 19.
  24. if (!mScroller.isFinished()) {
  25. 20.
  26. mScroller.abortAnimation();
  27. 21.
  28. }
  29. 22.
  30. 23.
  31. // Remember where the motion event started
  32. 24.
  33. mDownMotionX = mLastMotionX = ev.getX();
  34. 25.
  35. mLastMotionXRemainder = 0;
  36. 26.
  37. mTotalMotionX = 0;
  38. 27.
  39. mActivePointerId = ev.getPointerId(0);
  40. 28.
  41. //主要用来显示滚动条,表明要开始滚动了,这里可以进行调整,滚动条时逐渐显示还是立刻显示。
  42. 29.
  43. if (mTouchState == TOUCH_STATE_SCROLLING) {
  44. 30.
  45. pageBeginMoving();
  46. 31.
  47. }
  48. 32.
  49. break;
  50. 33.
  51. 34.
  52. case MotionEvent.ACTION_MOVE:
  53. 35.
  54. if (mTouchState == TOUCH_STATE_SCROLLING) {
  55. 36.
  56. // Scroll to follow the motion event
  57. 37.
  58. final int pointerIndex = ev.findPointerIndex(mActivePointerId);
  59. 38.
  60. final float x = ev.getX(pointerIndex);
  61. 39.
  62. final float deltaX = mLastMotionX + mLastMotionXRemainder - x;
  63. 40.
  64. //总共移动的距离
  65. 41.
  66. mTotalMotionX += Math.abs(deltaX);
  67. 42.
  68. 43.
  69. // Only scroll and update mLastMotionX if we have moved some discrete amount. We // keep the remainder because we are actually testing if we've moved from the last
  70. 44.
  71. // scrolled position (which is discrete).
  72. 45.
  73. // 如果我们移动了一小段距离,我们则移动和更新mLastMotionX 。我们保存Remainder变量是因为会检测我们
  74. 46.
  75. 47.
  76. //是否是从最后的滚动点位移动的。
  77. 48.
  78. if (Math.abs(deltaX) >= 1.0f) {
  79. 49.
  80. mTouchX += deltaX;
  81. 50.
  82. mSmoothingTime = System.nanoTime() / NANOTIME_DIV;
  83. 51.
  84. if (!mDeferScrollUpdate) {
  85. 52.
  86. scrollBy((int) deltaX, 0);
  87. 53.
  88. if (DEBUG) Log.d(TAG, "onTouchEvent().Scrolling: " + deltaX);
  89. 54.
  90. } else {
  91. 55.
  92. invalidate();
  93. 56.
  94. }
  95. 57.
  96. mLastMotionX = x;
  97. 58.
  98. mLastMotionXRemainder = deltaX - (int) deltaX;
  99. 59.
  100. } else {
  101. 60.

//Trigger the scrollbars to draw. When invoked this method starts an animation to fade the //scrollbars out after a default delay. If a subclass provides animated scrolling, //the start delay should equal the duration of the scrolling animation.
61.
//触发scrollbar进行绘制。 使用这个方法来启动一个动画来使scrollbars经过一段时间淡出。
62.
//如果子类提供了滚动的动画,则延迟的时间等于动画滚动的时间。
63.
awakenScrollBars();
64.
}
65.
} else {
66.
determineScrollingStart(ev);
67.
}
68.
break;
69.

  1. 70.
  2. case MotionEvent.ACTION_UP:
  3. 71.
  4. if (mTouchState == TOUCH_STATE_SCROLLING) {
  5. 72.
  6. final int activePointerId = mActivePointerId;
  7. 73.
  8. final int pointerIndex = ev.findPointerIndex(activePointerId);
  9. 74.
  10. final float x = ev.getX(pointerIndex);
  11. 75.
  12. final VelocityTracker velocityTracker = mVelocityTracker;
  13. 76.
  14. velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity);
  15. 77.
  16. int velocityX = (int) velocityTracker.getXVelocity(activePointerId);
  17. 78.
  18. final int deltaX = (int) (x - mDownMotionX);
  19. 79.
  20. final int pageWidth = getScaledMeasuredWidth(getPageAt(mCurrentPage));
  21. 80.
  22. // 屏幕的宽度*0.4f
  23. 81.
  24. boolean isSignificantMove = Math.abs(deltaX) > pageWidth *
  25. 82.
  26. SIGNIFICANT_MOVE_THRESHOLD;
  27. 83.
  28. final int snapVelocity = mSnapVelocity;
  29. 84.
  30. 85.
  31. mTotalMotionX += Math.abs(mLastMotionX + mLastMotionXRemainder - x);
  32. 86.
  33. 87.
  34. boolean isFling = mTotalMotionX > MIN_LENGTH_FOR_FLING &&
  35. 88.
  36. Math.abs(velocityX) > snapVelocity;
  37. 89.
  38. 90.
  39. // In the case that the page is moved far to one direction and then is flung
  40. 91.
  41. // in the opposite direction, we use a threshold to determine whether we should // just return to the starting page, or if we should skip one further.

//这钟情况是页面朝一个方向移动了一段距离,然后又弹回去了。我们使用一个阀值来判断是进行翻页还是返回到初始页面
1.
boolean returnToOriginalPage = false;
2.
if (Math.abs(deltaX) > pageWidth * RETURN_TO_ORIGINAL_PAGE_THRESHOLD &&
3.
Math.signum(velocityX) != Math.signum(deltaX) && isFling) {
4.
returnToOriginalPage = true;
5.
}
6.

  1. 7.
  2. int finalPage;
  3. 8.
  4. // We give flings precedence over large moves, which is why we short-circuit our
  5. 9.
  6. // test for a large move if a fling has been registered. That is, a large
  7. 10.
  8. // move to the left and fling to the right will register as a fling to the right.
  9. 11.
  10. //朝右移动
  11. 12.
  12. if (((isSignificantMove && deltaX > 0 && !isFling) ||
  13. 13.
  14. (isFling && velocityX > 0)) && mCurrentPage > 0) {
  15. 14.
  16. finalPage = returnToOriginalPage ? mCurrentPage : mCurrentPage - 1;
  17. 15.
  18. snapToPageWithVelocity(finalPage, velocityX);
  19. 16.
  20. //朝左移动
  21. 17.
  22. } else if (((isSignificantMove && deltaX < 0 && !isFling) ||
  23. 18.
  24. (isFling && velocityX < 0)) &&
  25. 19.
  26. mCurrentPage < getChildCount() - 1) {
  27. 20.
  28. finalPage = returnToOriginalPage ? mCurrentPage : mCurrentPage + 1;
  29. 21.
  30. snapToPageWithVelocity(finalPage, velocityX);
  31. 22.
  32. //寻找离屏幕中心最近的页面移动
  33. 23.
  34. } else {
  35. 24.
  36. snapToDestination();
  37. 25.
  38. }
  39. 26.
  40. }
  41. 27.
  42. //直接移动到前一页
  43. 28.
  44. else if (mTouchState == TOUCH_STATE_PREV_PAGE) {
  45. 29.
  46. // at this point we have not moved beyond the touch slop
  47. 30.
  48. // (otherwise mTouchState would be TOUCH_STATE_SCROLLING), so
  49. 31.
  50. // we can just page
  51. 32.
  52. int nextPage = Math.max(0, mCurrentPage - 1);
  53. 33.
  54. if (nextPage != mCurrentPage) {
  55. 34.
  56. snapToPage(nextPage);
  57. 35.
  58. } else {
  59. 36.
  60. snapToDestination();
  61. 37.
  62. }
  63. 38.
  64. }
  65. 39.
  66. //直接移动到下一页
  67. 40.
  68. else if (mTouchState == TOUCH_STATE_NEXT_PAGE) {
  69. 41.
  70. // at this point we have not moved beyond the touch slop
  71. 42.
  72. // (otherwise mTouchState would be TOUCH_STATE_SCROLLING), so
  73. 43.
  74. // we can just page
  75. 44.
  76. int nextPage = Math.min(getChildCount() - 1, mCurrentPage + 1);
  77. 45.
  78. if (nextPage != mCurrentPage) {
  79. 46.
  80. snapToPage(nextPage);
  81. 47.
  82. } else {
  83. 48.
  84. snapToDestination();
  85. 49.
  86. }
  87. 50.
  88. } else {
  89. 51.
  90. onUnhandledTap(ev);
  91. 52.
  92. }
  93. 53.
  94. mTouchState = TOUCH_STATE_REST;
  95. 54.
  96. mActivePointerId = INVALID_POINTER;
  97. 55.
  98. releaseVelocityTracker();
  99. 56.
  100. break;
  101. 57.
  102. //对事件不响应
  103. 58.
  104. case MotionEvent.ACTION_CANCEL:
  105. 59.
  106. if (mTouchState == TOUCH_STATE_SCROLLING) {
  107. 60.
  108. snapToDestination();
  109. 61.
  110. }
  111. 62.
  112. mTouchState = TOUCH_STATE_REST;
  113. 63.
  114. mActivePointerId = INVALID_POINTER;
  115. 64.
  116. releaseVelocityTracker();
  117. 65.
  118. break;
  119. 66.
  120. 67.
  121. case MotionEvent.ACTION_POINTER_UP:
  122. 68.
  123. onSecondaryPointerUp(ev);
  124. 69.
  125. break;
  126. 70.
  127. }
  128. 71.
  129. 72.
  130. return true;
  131. 73.

}

最后有个小知识点要搞清楚,不少网友都问到过我。就是scrollTo和scrollBy的区别。我们查看View类的源代码如下所示,mScrollX记录的是当前View针对屏幕坐标在水平方向上的偏移量,而mScrollY则是记录的时当前View针对屏幕在竖值方向上的偏移量。
从以下代码我们可以得知,scrollTo就是把View移动到屏幕的X和Y位置,也就是绝对位置。而scrollBy其实就是调用的 scrollTo,但是参数是当前mScrollX和mScrollY加上X和Y的位置,所以ScrollBy调用的是相对于mScrollX和mScrollY的位置。我们在上面的代码中可以看到当我们手指不放移动屏幕时,就会调用scrollBy来移动一段相对的距离。而当我们手指松开后,会调用 mScroller.startScroll(mUnboundedScrollX, 0, delta, 0, duration); 来产生一段动画来移动到相应的页面,在这个过程中系统回不断调用computeScroll(),我们再使用scrollTo来把View移动到当前Scroller所在的绝对位置。
1.
/**
2.

  • Set the scrolled position of your view. This will cause a call to
  1. 3.
  • {@link #onScrollChanged(int, int, int, int)} and the view will be
  1. 4.
  • invalidated.
  1. 5.
  • @param x the x position to scroll to
  1. 6.
  • @param y the y position to scroll to
  1. 7.

/
8.
public void scrollTo(int x, int y) {
9.
if (mScrollX != x || mScrollY != y) {
10.
int oldX = mScrollX;
11.
int oldY = mScrollY;
12.
mScrollX = x;
13.
mScrollY = y;
14.
invalidateParentCaches();
15.
onScrollChanged(mScrollX, mScrollY, oldX, oldY);
16.
if (!awakenScrollBars()) {
17.
invalidate(true);
18.
}
19.
}
20.
}
21.
/*

22.

  • Move the scrolled position of your view. This will cause a call to
  1. 23.
  • {@link #onScrollChanged(int, int, int, int)} and the view will be
  1. 24.
  • invalidated.
  1. 25.
  • @param x the amount of pixels to scroll by horizontally
  1. 26.
  • @param y the amount of pixels to scroll by vertically
  1. 27.

*/
28.
public void scrollBy(int x, int y) {
29.
scrollTo(mScrollX + x, mScrollY + y);
30.
}