Android 事件傳遞機制

時間 2020-02-02

標籤 android 事件傳遞機制欄目 Android 简体版

原文原文鏈接

有不少博客寫過Android 事件傳遞機制,可是我看了一大圈,沒有讓我滿意的,或版本老舊,或過於複雜,或直接是有內在邏輯錯誤java

參考內容: 《Android 開發藝術探索》網絡

Android事件分發機制詳解攻略，您值得擁有ide

本博客只分析單指狀況下,ACTION_DOWN,ACTION_MOVE,ACTION_UP,ACTION_CANCEL事件相關源碼分析

在這裏分析的源代碼,部分在官方源碼的基礎上,進行了簡化改寫,以便於分析post

關於 MotionEvent 基礎,請參考:Android MotionEvent詳解動畫

事件在哪些對象之間進行傳遞？

答：Activity、ViewGroup、Viewthis

當一個點擊事件發生時，事件最早傳到Activity的dispatchTouchEvent()進行事件分發spa

// 源碼分析：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 的事件分發流程.net

對 activity 來講,若是交給 window 的事件分發沒有消費掉事件(返回 false),將調用本身的 onTouchEvent 方法.code

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也不會調用);

事件分發機制大概源碼分析就是這樣,其實簡化一些,也不是很複雜,就是一些細節容易遺忘,並且目前也沒有比較好的方式可以講好這個源碼(網絡上的那些圖形,其實都忽略了一些細節,有些細節甚至很重要),若是開發過程當中有什麼不清楚的再來查看一下吧,比直接從新分析官方源碼和看別人博客方便些;

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。