天天看点

Android 4.0 Launcher源码分析系列(三)

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

Android 4.0 Launcher源码分析系列(三)

点击查看大图

桌面的左右滑动功能主要是在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.     acquireVelocityTrackerAndAddMovement(ev); 
  12.     // Skip touch handling if there are no pages to swipe 
  13.     // 如果没有页面,则跳过操作。 
  14.     if (getChildCount() <= 0) return super.onInterceptTouchEvent(ev); 
  15.     /* 
  16.      * Shortcut the most recurring case: the user is in the dragging 
  17.      * state and he is moving his finger.  We want to intercept this 
  18.      * motion. 
  19.      * shortcut最常见的情况是:用户处于拖动的状态下,同时在移动它的手指,这时候我们需要拦截这个动作。 
  20.      *  
  21.      */ 
  22.     final int action = ev.getAction(); 
  23.     //如果是在MOVE的情况下,则进行Touch事件拦截 
  24.     if ((action == MotionEvent.ACTION_MOVE) &&               
  25.             (mTouchState == TOUCH_STATE_SCROLLING)) { 
  26.         return true; 
  27.     } 
  28.     switch (action & MotionEvent.ACTION_MASK) { 
  29.         case MotionEvent.ACTION_MOVE: { 
  30.             /* 
  31.              * mIsBeingDragged == false, otherwise the shortcut would have caught it. Check 
  32.              * whether the user has moved far enough from his original down touch. 
  33.              * 如果mIsBeingDragged==false ,否则快捷方式应该捕获到该事件,检查一下用户从它点击的地方位移是否足够 
  34.              */ 
  35.             if (mActivePointerId != INVALID_POINTER) { 
  36.                 //根据移动的距离判断是翻页还是移动一段位移,同时设置lastMotionX或者mTouchState这些值。同时取消桌面长按事件。 
  37.                 determineScrollingStart(ev); 
  38.                 break; 
  39.             } 
  40.             // if mActivePointerId is INVALID_POINTER, then we must have missed an ACTION_DOWN 
  41.             // event. in that case, treat the first occurence of a move event as a ACTION_DOWN 
  42.             // i.e. fall through to the next case (don't break) 
  43.             // (We sometimes miss ACTION_DOWN events in Workspace because it ignores all events 
  44.             // while it's small- this was causing a crash before we checked for INVALID_POINTER) 
  45.             // 如果mActivePointerId 是 INVALID_POINTER,这时候我们应该已经错过了ACTION_DOWN事件。在这种情况下,把 
  46.             // 第一次发生移动的事件当作ACTION——DOWN事件,直接进入下一个情况下。 
  47.             // 我们有时候会错过workspace中的ACTION_DOWN事件,因为在workspace变小的时候会忽略掉所有的事件。                 
  48.         } 
  49.         case MotionEvent.ACTION_DOWN: { 
  50.             final float x = ev.getX(); 
  51.             final float y = ev.getY(); 
  52.             // Remember location of down touch 
  53.             // 记录按下的位置 
  54.             mDownMotionX = x; 
  55.             mLastMotionX = x; 
  56.             mLastMotionY = y; 
  57.             mLastMotionXRemainder = 0; 
  58.             mTotalMotionX = 0; 
  59.             //Return the pointer identifier associated with a particular pointer data index is this event.  
  60.             //The identifier tells you the actual pointer number associated with the data,  
  61.             //accounting for individual pointers going up and down since the start of the current gesture. 
  62.             //返回和这个事件关联的触点数据id,计算单独点的id会上下浮动,因为手势的起始位置挥发声改变。 
  63.             mActivePointerId = ev.getPointerId(0); 
  64.             mAllowLongPress = true; 
  65.             /* 
  66.              * If being flinged and user touches the screen, initiate drag; 
  67.              * otherwise don't.  mScroller.isFinished should be false when 
  68.              * being flinged. 
  69.              * 如果被拖动同时用户触摸到了屏幕,就开始初始化拖动,否则便不会。 
  70.              * 当拖动完成后mScroller.isFinished就应该设置为false. 
  71.              *  
  72.              */ 
  73.             final int xDist = Math.abs(mScroller.getFinalX() - mScroller.getCurrX()); 
  74.             final boolean finishedScrolling = (mScroller.isFinished() || xDist < mTouchSlop); 
  75.             if (finishedScrolling) { 
  76.                 //标记为TOUCH_STATE_REST状态 
  77.                 mTouchState = TOUCH_STATE_REST; 
  78.                 //取消滚动动画 
  79.                 mScroller.abortAnimation(); 
  80.             } else { 
  81.                 //状态为TOUCH_STATE_SCROLLING 
  82.                 mTouchState = TOUCH_STATE_SCROLLING; 
  83.             } 
  84.             // check if this can be the beginning of a tap on the side of the pages 
  85.             // to scroll the current page 
  86.             // 检测此事件是不是开始于点击页面的边缘来对当前页面进行滚动。                 
  87.             if (mTouchState != TOUCH_STATE_PREV_PAGE && mTouchState != TOUCH_STATE_NEXT_PAGE) { 
  88.                 if (getChildCount() > 0) { 
  89.                     //根据触点的点位来判断是否点击到上一页,从而更新相应的状态 
  90.                     if (hitsPreviousPage(x, y)) { 
  91.                         mTouchState = TOUCH_STATE_PREV_PAGE; 
  92.                     } else if (hitsNextPage(x, y)) { 
  93.                         mTouchState = TOUCH_STATE_NEXT_PAGE; 
  94.                     } 
  95.                 } 
  96.             } 
  97.             break; 
  98.         } 
  99.         case MotionEvent.ACTION_UP: 
  100.         case MotionEvent.ACTION_CANCEL: 
  101.             //触点不被相应时,所做的动作 
  102.             mTouchState = TOUCH_STATE_REST; 
  103.             mAllowLongPress = false; 
  104.             mActivePointerId = INVALID_POINTER; 
  105.             //释放速率跟踪 
  106.             releaseVelocityTracker(); 
  107.             break; 
  108.         case MotionEvent.ACTION_POINTER_UP: 
  109.             onSecondaryPointerUp(ev); 
  110.             releaseVelocityTracker(); 
  111.             break; 
  112.     } 
  113.     /* 
  114.      * The only time we want to intercept motion events is if we are in the 
  115.      * drag mode. 
  116.      * 我们唯一会去对移动事件进行拦截的情况时我们在拖动模式下 
  117.      */ 
  118.     if(DEBUG) Log.d(TAG, "onInterceptTouchEvent "+(mTouchState != TOUCH_STATE_REST)); 
  119.     //只要是mTouchState的状态不为TOUCH_STATE_REST,那么就进行事件拦截 
  120.     return mTouchState != TOUCH_STATE_REST; 

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.     acquireVelocityTrackerAndAddMovement(ev); 
  7.     final int action = ev.getAction(); 
  8.     switch (action & MotionEvent.ACTION_MASK) { 
  9.     case MotionEvent.ACTION_DOWN: 
  10.         /* 
  11.          * If being flinged and user touches, stop the fling. isFinished 
  12.          * will be false if being flinged. 
  13.          * 如果在滑动的过程中下用户又点击桌面,则取消滑动,从而响应当前的点击。 
  14.          * 在滑动的isFinished将返回false. 
  15.          */ 
  16.         if (!mScroller.isFinished()) { 
  17.             mScroller.abortAnimation(); 
  18.         } 
  19.         // Remember where the motion event started 
  20.         mDownMotionX = mLastMotionX = ev.getX(); 
  21.         mLastMotionXRemainder = 0; 
  22.         mTotalMotionX = 0; 
  23.         mActivePointerId = ev.getPointerId(0); 
  24.         //主要用来显示滚动条,表明要开始滚动了,这里可以进行调整,滚动条时逐渐显示还是立刻显示。 
  25.         if (mTouchState == TOUCH_STATE_SCROLLING) { 
  26.             pageBeginMoving(); 
  27.         } 
  28.         break; 
  29.     case MotionEvent.ACTION_MOVE: 
  30.         if (mTouchState == TOUCH_STATE_SCROLLING) { 
  31.             // Scroll to follow the motion event 
  32.             final int pointerIndex = ev.findPointerIndex(mActivePointerId); 
  33.             final float x = ev.getX(pointerIndex); 
  34.             final float deltaX = mLastMotionX + mLastMotionXRemainder - x; 
  35.             //总共移动的距离 
  36.             mTotalMotionX += Math.abs(deltaX); 
  37.             // Only scroll and update mLastMotionX if we have moved some discrete amount.  We 
  38.             // keep the remainder because we are actually testing if we've moved from the last 
  39.             // scrolled position (which is discrete). 
  40.             // 如果我们移动了一小段距离,我们则移动和更新mLastMotionX 。我们保存Remainder变量是因为会检测我们 
  41.             //是否是从最后的滚动点位移动的。                
  42.             if (Math.abs(deltaX) >= 1.0f) { 
  43.                 mTouchX += deltaX; 
  44.                 mSmoothingTime = System.nanoTime() / NANOTIME_DIV; 
  45.                 if (!mDeferScrollUpdate) { 
  46.                     scrollBy((int) deltaX, 0); 
  47.                     if (DEBUG) Log.d(TAG, "onTouchEvent().Scrolling: " + deltaX); 
  48.                 } else { 
  49.                     invalidate(); 
  50.                 } 
  51.                 mLastMotionX = x; 
  52.                 mLastMotionXRemainder = deltaX - (int) deltaX; 
  53.             } else { 
  54.             //Trigger the scrollbars to draw. When invoked this method starts an animation to fade the  
  55.             //scrollbars out after a default delay. If a subclass provides animated scrolling,  
  56.             //the start delay should equal the duration of the scrolling animation. 
  57.             //触发scrollbar进行绘制。 使用这个方法来启动一个动画来使scrollbars经过一段时间淡出。如果子类提供了滚动的动画,则 
  58.             //延迟的时间等于动画滚动的时间。 
  59.                 awakenScrollBars(); 
  60.             } 
  61.         } else { 
  62.             determineScrollingStart(ev); 
  63.         } 
  64.         break; 
  65.     case MotionEvent.ACTION_UP: 
  66.         if (mTouchState == TOUCH_STATE_SCROLLING) { 
  67.             final int activePointerId = mActivePointerId; 
  68.             final int pointerIndex = ev.findPointerIndex(activePointerId); 
  69.             final float x = ev.getX(pointerIndex); 
  70.             final VelocityTracker velocityTracker = mVelocityTracker; 
  71.             velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity); 
  72.             int velocityX = (int) velocityTracker.getXVelocity(activePointerId); 
  73.             final int deltaX = (int) (x - mDownMotionX); 
  74.             final int pageWidth = getScaledMeasuredWidth(getPageAt(mCurrentPage)); 
  75.             // 屏幕的宽度*0.4f 
  76.             boolean isSignificantMove = Math.abs(deltaX) > pageWidth * 
  77.                     SIGNIFICANT_MOVE_THRESHOLD; 
  78.             final int snapVelocity = mSnapVelocity; 
  79.             mTotalMotionX += Math.abs(mLastMotionX + mLastMotionXRemainder - x); 
  80.             boolean isFling = mTotalMotionX > MIN_LENGTH_FOR_FLING && 
  81.                     Math.abs(velocityX) > snapVelocity; 
  82.             // In the case that the page is moved far to one direction and then is flung 
  83.             // in the opposite direction, we use a threshold to determine whether we should 
  84.             // just return to the starting page, or if we should skip one further. 
  85.             // 这钟情况是页面朝一个方向移动了一段距离,然后又弹回去了。我们使用一个阀值来判断是进行翻页还是返回到初始页面         
  86.             boolean returnToOriginalPage = false; 
  87.             if (Math.abs(deltaX) > pageWidth * RETURN_TO_ORIGINAL_PAGE_THRESHOLD && 
  88.                     Math.signum(velocityX) != Math.signum(deltaX) && isFling) { 
  89.                 returnToOriginalPage = true; 
  90.             } 
  91.             int finalPage; 
  92.             // We give flings precedence over large moves, which is why we short-circuit our 
  93.             // test for a large move if a fling has been registered. That is, a large 
  94.             // move to the left and fling to the right will register as a fling to the right. 
  95.             //朝右移动 
  96.             if (((isSignificantMove && deltaX > 0 && !isFling) || 
  97.                     (isFling && velocityX > 0)) && mCurrentPage > 0) { 
  98.                 finalPage = returnToOriginalPage ? mCurrentPage : mCurrentPage - 1; 
  99.                 snapToPageWithVelocity(finalPage, velocityX); 
  100.             //朝左移动 
  101.             } else if (((isSignificantMove && deltaX < 0 && !isFling) || 
  102.                     (isFling && velocityX < 0)) && 
  103.                     mCurrentPage < getChildCount() - 1) { 
  104.                 finalPage = returnToOriginalPage ? mCurrentPage : mCurrentPage + 1; 
  105.                 snapToPageWithVelocity(finalPage, velocityX); 
  106.             //寻找离屏幕中心最近的页面移动 
  107.             } else { 
  108.                 snapToDestination(); 
  109.             } 
  110.         } 
  111.          //直接移动到前一页 
  112.          else if (mTouchState == TOUCH_STATE_PREV_PAGE) { 
  113.             // at this point we have not moved beyond the touch slop 
  114.             // (otherwise mTouchState would be TOUCH_STATE_SCROLLING), so 
  115.             // we can just page 
  116.             int nextPage = Math.max(0, mCurrentPage - 1); 
  117.             if (nextPage != mCurrentPage) { 
  118.                 snapToPage(nextPage); 
  119.             } else { 
  120.                 snapToDestination(); 
  121.             } 
  122.         } 
  123.          //直接移动到下一页 
  124.          else if (mTouchState == TOUCH_STATE_NEXT_PAGE) { 
  125.             // at this point we have not moved beyond the touch slop 
  126.             // (otherwise mTouchState would be TOUCH_STATE_SCROLLING), so 
  127.             // we can just page 
  128.             int nextPage = Math.min(getChildCount() - 1, mCurrentPage + 1); 
  129.             if (nextPage != mCurrentPage) { 
  130.                 snapToPage(nextPage); 
  131.             } else { 
  132.                 snapToDestination(); 
  133.             } 
  134.         } else { 
  135.             onUnhandledTap(ev); 
  136.         } 
  137.         mTouchState = TOUCH_STATE_REST; 
  138.         mActivePointerId = INVALID_POINTER; 
  139.         releaseVelocityTracker(); 
  140.         break; 
  141.      //对事件不响应 
  142.     case MotionEvent.ACTION_CANCEL: 
  143.         if (mTouchState == TOUCH_STATE_SCROLLING) { 
  144.             snapToDestination(); 
  145.         } 
  146.         mTouchState = TOUCH_STATE_REST; 
  147.         mActivePointerId = INVALID_POINTER; 
  148.         releaseVelocityTracker(); 
  149.         break; 
  150.     case MotionEvent.ACTION_POINTER_UP: 
  151.         onSecondaryPointerUp(ev); 
  152.         break; 
  153.     } 
  154.     return true; 

最后有个小知识点要搞清楚,不少网友都问到过我。就是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 
  3.    * {@link #onScrollChanged(int, int, int, int)} and the view will be 
  4.    * invalidated. 
  5.    * @param x the x position to scroll to 
  6.    * @param y the y position to scroll to 
  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 
  23.    * {@link #onScrollChanged(int, int, int, int)} and the view will be 
  24.    * invalidated. 
  25.    * @param x the amount of pixels to scroll by horizontally 
  26.    * @param y the amount of pixels to scroll by vertically 
  27.    */ 
  28.   public void scrollBy(int x, int y) { 
  29.       scrollTo(mScrollX + x, mScrollY + y); 
  30.   }