Android 事件傳遞機制
有很多部落格寫過Android 事件傳遞機制,但是我看了一大圈,沒有讓我滿意的,或版本老舊,或過於複雜,或直接是有內在邏輯錯誤
參考內容: 《Android 開發藝術探索》
Android事件分發機制 詳解攻略,您值得擁有
本部落格只分析單指情況下,ACTION_DOWN,ACTION_MOVE,ACTION_UP,ACTION_CANCEL事件相關
在這裡分析的原始碼,部分在官方原始碼的基礎上,進行了簡化改寫,以便於分析
關於 MotionEvent 基礎,請參考:Android MotionEvent詳解
事件在哪些物件之間進行傳遞?
答:Activity、ViewGroup、View
當一個點選事件發生時,事件最先傳到Activity
的dispatchTouchEvent()
進行事件分發
// 原始碼分析:Activity.dispatchTouchEvent() public boolean dispatchTouchEvent(MotionEvent ev) { if (ev.getAction() == MotionEvent.ACTION_DOWN) { onUserInteraction();// 一個空的hook方法,不用管 } if (getWindow().superDispatchTouchEvent(ev)) { // 若getWindow().superDispatchTouchEvent(ev)的返回true,事件已經被處理了 // getWindow()返回的為PhoneWindow物件(Activity#attach方法中建立) return true; } // 若getWindow().superDispatchTouchEvent(ev)的返回false,呼叫Activity.onTouchEvent return onTouchEvent(ev); } // PhoneWindow#superDispatchTouchEvent() @Override public boolean superDispatchTouchEvent(MotionEvent event) { // mDecor是window中的頂層View,型別為DecorView,繼承自FrameLayout return mDecor.superDispatchTouchEvent(event); } // DecorView#superDispatchTouchEvent() public boolean superDispatchTouchEvent(MotionEvent event) { // 也即呼叫了ViewGroup#dispatchTouchEvent() return super.dispatchTouchEvent(event); } // 回到最初的呼叫原處 // Activity#onTouchEvent() public boolean onTouchEvent(MotionEvent event) { if (mWindow.shouldCloseOnTouch(this, event)) { finish(); return true; } // 預設返回false return false; } // Window#shouldCloseOnTouch public boolean shouldCloseOnTouch(Context context, MotionEvent event) { if (mCloseOnTouchOutside && event.getAction() == MotionEvent.ACTION_DOWN && isOutOfBounds(context, event) && peekDecorView() != null) { return true; } return false; }
總結: activity 將時間分發給 window,window 將事件給到自己的 DecorView,DecorView 事件分發的的流程為 ViewGroup 的事件分發流程
對 activity 來說,如果交給 window 的事件分發沒有消費掉事件(返回 false),將呼叫自己的 onTouchEvent 方法.
ViewGroup的事件分發
// ViewGroup#dispatchTouchEvent() // 這裡只分析 MOTION_DOWN,MOTION_MOVE,MOTION_UP,MOTION_CANCEL事件相關,其他的都被過濾掉了 // 只分析單指情況,多指觸控情況也被過濾掉 // 這裡對官方原始碼做了改寫,便於理解 // mFirstTouchTarget,實際上為一個連結串列,但是這裡分析單指情況,一個事件只能給一個 View 處理,所以這裡可以認為就是一個物件 public boolean dispatchTouchEvent(MotionEvent ev) { boolean handled = false;// 方法最終返回的值 final int action = ev.getAction(); final int actionMasked = action & MotionEvent.ACTION_MASK; // Handle an initial down. // 收到 ACTION_DOWN,清除掉 mFirstTouchTarget 和 disallowIntercept 標識 if (actionMasked == MotionEvent.ACTION_DOWN) { cancelAndClearTouchTargets(ev);// 分析 1 resetTouchState();// 分析 2 } // Check for interception. 處理攔截 // 這裡根據為了便於理解,對原始碼進行了一定的改寫,簡化程式碼,便於理解 boolean intercepted = true;// There are no touch targets and this action is not an initial down so this view group continues to intercept touches. if (actionMasked == MotionEvent.ACTION_DOWN) { // ACTION_DOWN 時,一定會呼叫 onInterceptTouchEvent intercepted = onInterceptTouchEvent(ev); } else if (mFirstTouchTarget != null) { // 不是 ACTION_DOWN 時,如果 mFirstTouchTarget 連結串列不為空(這個事件序列之前被子 view 處理過), // 就需要通過 onInterceptTouchEvent 判斷是否需要攔截了 final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0; intercepted = disallowIntercept ? false : onInterceptTouchEvent(ev); } // Check for cancelation. 處理取消事件 final boolean canceled = resetCancelNextUpFlag(this) || actionMasked == MotionEvent.ACTION_CANCEL; // Update list of touch targets for pointer down, if needed. TouchTarget newTouchTarget = null; boolean alreadyDispatchedToNewTouchTarget = false; if (actionMasked == MotionEvent.ACTION_DOWN && !canceled && !intercepted) { // 這裡既然指定了 ACTION_DOWN,那麼 mFirstTouchTarget 肯定是空的(之前進行過清除) // 不攔截 ACTION_DOWN 的話,那麼事件需要分發給子 view,如果子view 消費掉 ACTION_DOWN,那麼該子view 將會被用來構建 mFirstTouchTarget final int actionIndex = ev.getActionIndex(); // always 0 for down final int childrenCount = mChildrenCount; if (childrenCount != 0) { final float x = ev.getX(actionIndex); final float y = ev.getY(actionIndex); final View[] children = mChildren; // 倒序遍歷子 view(後新增的 view 位置在上面) for (int i = childrenCount - 1; i >= 0; i--) { final View child = getAndVerifyPreorderedView(preorderedList, children, childIndex); // 不可見的|| 觸控點不在子view 範圍內 的,直接過濾掉 if (!canViewReceivePointerEvents(child)/*分析 3*/ || !isTransformedTouchPointInView(x, y, child, null)/*分析 4*/) { continue; } // 將該事件分發給子view if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign) /*分析 6*/) { // 子view 將該事件消費掉,跳出迴圈,不再分發,給mFirstTouchTarget 賦值 newTouchTarget = addTouchTarget(child, idBitsToAssign);// 分析 5 alreadyDispatchedToNewTouchTarget = true; break; } } } } // 沒有子 view 要這個事件,這裡可能是 ACTION_DOWN 事件分發給子 view 不要,或者 ACTION_MOVE 事件被攔截,給那個子view 傳送過 CANCEL 事件,將 mFirstTouchTarget 複製為 null 了 if (mFirstTouchTarget == null) { // 分發給自己(這裡傳入的 child 為 null) 分析 6 handled = dispatchTransformedTouchEvent(ev, canceled, null, TouchTarget.ALL_POINTER_IDS); } else { TouchTarget target = mFirstTouchTarget; // 已經分發了,返回結果為 true,這裡對應於 ACTION_DOWN 事件 if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) { handled = true; } else { final boolean cancelChild = resetCancelNextUpFlag(target.child) || intercepted; // 傳送事件給 子view,如果被攔截,向子view 傳送 CANCEL 事件(這裡傳入的 cancel 引數為 true) handled = dispatchTransformedTouchEvent(ev, cancelChild, target.child, target.pointerIdBits); if (cancelChild) { // 如果是向子view 傳送 CANCEL 事件,這個事件序列以後不需要傳送給子view 了 mFirstTouchTarget = null; } } } return handled; } // ->分析1 ViewGroup#cancelAndClearTouchTargets() private void cancelAndClearTouchTargets(MotionEvent event) { // 之前 mFirstTouchTarget 連結串列不為空 if (mFirstTouchTarget != null) { // 給 mFirstTouchTarget 連結串列中的 view 傳送 CANCEL事件 for (TouchTarget target = mFirstTouchTarget; target != null; target = target.next) { resetCancelNextUpFlag(target.child); dispatchTransformedTouchEvent(event, true, target.child, target.pointerIdBits); } // 清空 mFirstTouchTarget 連結串列 clearTouchTargets(); } } // ->分析2 ViewGroup#resetTouchState() private void resetTouchState() { clearTouchTargets(); resetCancelNextUpFlag(this); // 清除 disallowIntercept 標誌,這個標誌可以通過viewGroup#requestDisallowInterceptTouchEvent(boolean)來進行設定 mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT; mNestedScrollAxes = SCROLL_AXIS_NONE; } // ->分析 3 子view 是可見的或者正在執行動畫 private static boolean canViewReceivePointerEvents(@NonNull View child) { return (child.mViewFlags & VISIBILITY_MASK) == VISIBLE || child.getAnimation() != null; } // ->分析 4 觸控點是否子view 範圍內 protected boolean isTransformedTouchPointInView(float x, float y, View child, PointF outLocalPoint) { final float[] point = getTempPoint(); point[0] = x; point[1] = y; transformPointToViewLocal(point, child); final boolean isInView = child.pointInView(point[0], point[1]); if (isInView && outLocalPoint != null) { outLocalPoint.set(point[0], point[1]); } return isInView; } // -> 分析 5 構建 mFirstTouchTarget 連結串列 private TouchTarget addTouchTarget(@NonNull View child, int pointerIdBits) { final TouchTarget target = TouchTarget.obtain(child, pointerIdBits); target.next = mFirstTouchTarget; mFirstTouchTarget = target; return target; } // ->分析 6,重要,事假分發的核心 private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel, View child, int desiredPointerIdBits) { final boolean handled; // 取消 處理 final int oldAction = event.getAction(); if (cancel || oldAction == MotionEvent.ACTION_CANCEL) { // 分發 ACTION_CANCEL event.setAction(MotionEvent.ACTION_CANCEL); if (child == null) { // 把 ViewGroup 當做一個普通的 View,自己處理 handled = super.dispatchTouchEvent(event); } else { handled = child.dispatchTouchEvent(event); } // 事件型別還的還原回去 event.setAction(oldAction); return handled; } if (child == null) { // 把 ViewGroup 當做一個普通的 View,自己處理 handled = super.dispatchTouchEvent(event); } else { // 給子view 處理 final float offsetX = mScrollX - child.mLeft; final float offsetY = mScrollY - child.mTop; // 把觸控點的X,Y座標改為在子view中的 X,Y 座標 event.offsetLocation(offsetX, offsetY); // 交給子view 處理 handled = child.dispatchTouchEvent(event); // 把觸控點的 X,Y座標改回來 event.offsetLocation(-offsetX, -offsetY); } return handled; }
上述的分析非常複雜,需要花很多時間才能完全看懂,這裡直接提供一些結論,在上面的額程式碼和註釋中都能找到相應的依據:
- 一個 View 如果不消耗 ACTION_DOWN 事件,那麼同一個事件序列的其他事件都不會交給他來處理;從上面原始碼可以看出,ACTION_DOWN 事件時,只有返回 true 時,才會使用該子view 構造 mFirstTouchTarget;
- 如果非 ACTION_DOWN 事件被攔截,且該事件序列之前被子view 處理過,那麼向該子 view 傳送 CANCEL 事件,且會重置mFirstTouchTarget;
- 一個 View 一旦決定攔截,那麼這個事件序列都由他來處理(如果事件序列能傳遞到的話,dispatchTransformedTouchEvent傳入的 child 引數為 null),並且其 onInterceptTouchEvent 方法不會再被呼叫(mFirstTouchTarget != null 不成立).
- 使用 ViewGroup 的 requestDisallowInterceptTouchEvent 方法可以請求父view 不攔截事件,但是 MOTION_DOWN 事件除外(MOTION_DOWN時會清除FLAG_DISALLOW_INTERCEPT)
- 如果View 樹事件分發返回了 false,最終Acitivity的onTouchEvent 方法會被呼叫;
從上面可以看出,view 的事件分發最終都會呼叫View 的 dispatchTouchEvent 方法:
View的事件分發
// View#dispatchTouchEvent()
public boolean dispatchTouchEvent(MotionEvent event) {
boolean result = false;
ListenerInfo li = mListenerInfo;
if (li != null && li.mOnTouchListener != null// 設定了mOnTouchListener(通過 setOnTouchListener())
&& (mViewFlags & ENABLED_MASK) == ENABLED// 處於 enalbed 狀態
&& li.mOnTouchListener.onTouch(this, event)) {// 優先觸發mOnTouchListener.onTouch
result = true;
}
// mOnTouchListener.onTouch返回 false,呼叫自身的 onTouchEvent
if (!result && onTouchEvent(event)) {
result = true;
}
return result;
}
// 這裡忽略了 longClick,tap等情況
public boolean onTouchEvent(MotionEvent event) {
final float x = event.getX();
final float y = event.getY();
final int viewFlags = mViewFlags;
final int action = event.getAction();
final boolean clickable = ((viewFlags & CLICKABLE) == CLICKABLE // CLICKABLE
|| (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) // LONG_CLICKABLE
|| (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE;
// view 的 enabled 狀態為 DISABLED
if ((viewFlags & ENABLED_MASK) == DISABLED) {
// disabled 狀態的 view,仍然會消費事件,只是不會響應而已
return clickable;
}
if (!clickable) {
return false;
}
switch (action) {
case MotionEvent.ACTION_UP:
mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
boolean prepressed = (mPrivateFlags & PFLAG_PREPRESSED) != 0;
if ((mPrivateFlags & PFLAG_PRESSED) != 0 || prepressed) {
boolean focusTaken = false;
if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
// 拿到焦點,如果這裡返回 true,那麼後面不會呼叫 onClick 方法,但是我們現在已經有了焦點了
focusTaken = requestFocus();
}
// Only perform take click actions if we were in the pressed state
if (!focusTaken) {
if (mPerformClick == null) {
mPerformClick = new PerformClick();
}
if (!post(mPerformClick)) {
// 點選事件觸發
performClick();
}
}
}
break;
}
// 只要cliclable,就返回 true
return true;
}
public boolean performClick() {
final ListenerInfo li = mListenerInfo;
final boolean result = li != null && li.mOnClickListener != null;
if (result) {
li.mOnClickListener.onClick(this);// 觸發 onClick 方法
}
return result;
}
根據上述程式碼,有以下結論:
View 的 dispatchTouchEvent 優先觸發mOnTouchListener.onTouch 方法(在enabled 時),在其返回 false 時,觸發onTouchEvent 方法;
onTouchEent 預設返回可點選狀態值, clickable || longClickable,view的 enabled 狀態與返回值無關,只是 disabled 情況下,不會響應(mOnTouchListener.onTouch也不會呼叫);
事件分發機制大概原始碼分析就是這樣,其實簡化一些,也不是很複雜,就是一些細節容易遺忘,而且目前也沒有比較好的方式能夠講好這個原始碼(網路上的那些圖形,其實都忽略了一些細節,有些細節甚至很重要),如果開發過程中有什麼不清楚的再來檢視一下吧,比直接重新分析官方原始碼和看別人部落格方便些;