從原始碼看 Android 事件分發

QuincySx發表於2019-03-26

Android 事件分發是安卓中一個很精妙的地方,很多開發人員有些不解,為什麼呢?因為不知道怎麼去運用,其實這個地方理解起來比較簡單,我寫這麼一篇文章就是為了串一串這個知識點。

脫離原始碼淺談分發

  1. 事件分發是在最上層 View 一直往下層傳遞事件,並通過 onTouchEvent(MotionEvent ev) 這個方法來分發的,如果某個 View 想處理這個事件就需要重寫這個 onTouchEvent() 並且返回 True ,然後寫自己的邏輯處理事件。
  2. 如果是 ViewGroup 想處理這個事件呢,那麼他就要重寫 onInterceptTouchEvent(MotionEvent ev) 方法並返回 True ,來攔截這個事件並交給 ViewGroup 的 onTouchEvent() 來處理這個事件。
  3. 如果 ViewGroup 裡面的子 View 想處理這個事件怎麼辦,不要擔心 Android 給我們提供了 requestDisallowInterceptTouchEvent(boolean b) 方法然後傳入 True 就會阻止上一級 ViewGroup 攔截事件,然後子 View 自己來處理這個事件。
  4. 上面三條結論我們怎麼得出的呢?這就是 dispatchTouchEvent(MotionEvent ev) 方法的具體實現
  5. 處理 ACTION_DOWN 事件的 View 就是事件分發的目標,剩餘的事件會直接分發到當前 View

滑動衝突有兩種辦法

  1. 如果兩個上下級 View 衝突,那麼給上級 View 設定 setOnTouchListener() 然後先把 ACTION_DOWN 分發給子 View ,然後在 ACTION_MOVE 中去判斷具體的業務邏輯,確定到底那個 View 去處理本次事件。根據業務決定返回 True,False。
  2. 如果兩個上下級 View 衝突,那麼在下級 View 重寫 onTouchEvent() ,然後先把 ACTION_DOWN 用 requestDisallowInterceptTouchEvent(true) 把上層事件處理攔截掉 ,然後在 ACTION_MOVE 中去判斷具體的業務邏輯,確定那個 View 去處理本次事件,如果確定是上層 View 處理事件,則用 requestDisallowInterceptTouchEvent(false) 讓上層 View 繼續處理事件。

從原始碼看待事件分發

本次原始碼基於 Android 8.0 API 27

首先我們要知道事件分發的事件先發到 window 然後呼叫 Activity 或 Dialog 等元件的事件分發,然後分發到 window 再分發到 DecorView,再往我們自己的佈局分發,這個流程我們將到 window 解析的時候講,我們現在就當他是在 Activity 直接分發到我們自己的佈局

1. 我們先從 ViewGroup 的 dispatchTouchEvent() 方法來說起

public boolean dispatchTouchEvent(MotionEvent ev) {
        ...
        boolean handled = false;
        //檢查點選是否合法
        if (onFilterTouchEventForSecurity(ev)) {
            final int action = ev.getAction();
            final int actionMasked = action & MotionEvent.ACTION_MASK;

            if (actionMasked == MotionEvent.ACTION_DOWN) {
                //如果之前有未處理完的事件則取消掉,具體實現看方法裡面的原始碼,本質是往下分發 ACTION_CANCEL 事件
                cancelAndClearTouchTargets(ev);
                //清除 requestDisallowInterceptTouchEvent() 方法的標誌,也就是每次 ACTION_DOWN 的時候這個標誌都會取消
                resetTouchState();
            }

            //檢查是否攔截事件
            final boolean intercepted;
            if (actionMasked == MotionEvent.ACTION_DOWN
                    || mFirstTouchTarget != null) {
                final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
                if (!disallowIntercept) {
                    // 如果 onInterceptTouchEvent 返回 True 則攔截事件,系統控制元件一般情況都是 False
                    intercepted = onInterceptTouchEvent(ev);
                    ev.setAction(action); // restore action in case it was changed
                } else {
                    intercepted = false;
                }
            } else {
                //沒有觸控目標預設為攔截掉事件
                intercepted = true;
            }

            if (intercepted || mFirstTouchTarget != null) {
                ev.setTargetAccessibilityFocus(false);
            }

            // 檢查是否取消事件
            final boolean canceled = resetCancelNextUpFlag(this)
                    || actionMasked == MotionEvent.ACTION_CANCEL;

            final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
            TouchTarget newTouchTarget = null;
            boolean alreadyDispatchedToNewTouchTarget = false;
            //沒有取消沒有攔截
            if (!canceled && !intercepted) {
                View childWithAccessibilityFocus = ev.isTargetAccessibilityFocus()
                        ? findChildWithAccessibilityFocus() : null;

                if (actionMasked == MotionEvent.ACTION_DOWN
                        || (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
                        || actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
                    final int actionIndex = ev.getActionIndex(); // always 0 for down
                    final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex)
                            : TouchTarget.ALL_POINTER_IDS;

                    removePointersFromTouchTargets(idBitsToAssign);

                    final int childrenCount = mChildrenCount;
                    if (newTouchTarget == null && childrenCount != 0) {
                        final float x = ev.getX(actionIndex);
                        final float y = ev.getY(actionIndex);
                       
                        final ArrayList<View> preorderedList = buildTouchDispatchChildList();
                        final boolean customOrder = preorderedList == null
                                && isChildrenDrawingOrderEnabled();
                        final View[] children = mChildren;
                        //查詢點選的 View
                        for (int i = childrenCount - 1; i >= 0; i--) {
                            ...
                            resetCancelNextUpFlag(child);
                            if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
                                mLastTouchDownTime = ev.getDownTime();
                                ...
                                //把新找到的觸控物件放到連結串列裡
                                newTouchTarget = addTouchTarget(child, idBitsToAssign);
                                alreadyDispatchedToNewTouchTarget = true;
                                break;
                            }
                            ev.setTargetAccessibilityFocus(false);
                        }
                        if (preorderedList != null) preorderedList.clear();
                    }

                    if (newTouchTarget == null && mFirstTouchTarget != null) {
                        //沒有找到接受事件的 View,交給最近處理事件的 View
                        newTouchTarget = mFirstTouchTarget;
                        while (newTouchTarget.next != null) {
                            newTouchTarget = newTouchTarget.next;
                        }
                        newTouchTarget.pointerIdBits |= idBitsToAssign;
                    }
                }
            }
            
            if (mFirstTouchTarget == null) {
                //沒有觸控目標
                handled = dispatchTransformedTouchEvent(ev, canceled, null,
                        TouchTarget.ALL_POINTER_IDS);
            } else {
                //尋找到或已經有觸控目標
                TouchTarget predecessor = null;
                TouchTarget target = mFirstTouchTarget;
                while (target != null) {
                    final TouchTarget next = target.next;
                    if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
                        handled = true;
                    } else {
                        final boolean cancelChild = resetCancelNextUpFlag(target.child)
                                || intercepted;
                        //分發事件
                        if (dispatchTransformedTouchEvent(ev, cancelChild,
                                target.child, target.pointerIdBits)) {
                            handled = true;
                        }
                        if (cancelChild) {
                            if (predecessor == null) {
                                mFirstTouchTarget = next;
                            } else {
                                predecessor.next = next;
                            }
                            target.recycle();
                            target = next;
                            continue;
                        }
                    }
                    predecessor = target;
                    target = next;
                }
            }

            if (canceled
                    || actionMasked == MotionEvent.ACTION_UP
                    || actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
                // 遇到事件取消、手指抬起、滑鼠移過取消按鈕狀態
                resetTouchState();
            } else if (split && actionMasked == MotionEvent.ACTION_POINTER_UP) {
                final int actionIndex = ev.getActionIndex();
                final int idBitsToRemove = 1 << ev.getPointerId(actionIndex);
                removePointersFromTouchTargets(idBitsToRemove);
            }
        }

        if (!handled && mInputEventConsistencyVerifier != null) {
            mInputEventConsistencyVerifier.onUnhandledEvent(ev, 1);
        }
        return handled;
    }
複製程式碼

mFirstTouchTarget 是記錄點選的一個連結串列 我們再看一下分發事件的方法 dispatchTransformedTouchEvent()

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) {
            event.setAction(MotionEvent.ACTION_CANCEL);
            if (child == null) {
                handled = super.dispatchTouchEvent(event);
            } else {
                handled = child.dispatchTouchEvent(event);
            }
            event.setAction(oldAction);
            return handled;
        }
        ...
        //繼續放下分發
        final MotionEvent transformedEvent;
        if (newPointerIdBits == oldPointerIdBits) {
            if (child == null || child.hasIdentityMatrix()) {
                if (child == null) {
                    handled = super.dispatchTouchEvent(event);
                } else {
                    ...
                    handled = child.dispatchTouchEvent(event);
                    event.offsetLocation(-offsetX, -offsetY);
                }
                return handled;
            }
            transformedEvent = MotionEvent.obtain(event);
        } else {
            transformedEvent = event.split(newPointerIdBits);
        }
        
        // Perform any necessary transformations and dispatch.
        if (child == null) {
            //如果沒有子 View 則呼叫 View 的 dispatchTouchEvent() 方法,注意 View 和 ViewGroup 的 dispatchTouchEvent() 不一樣,具體看下面
            handled = super.dispatchTouchEvent(transformedEvent);
        } else {
            ...
            //往下分發,呼叫子 View/ViewGroup 的 dispatchTouchEvent() 方法
            handled = child.dispatchTouchEvent(transformedEvent);
        }

        // Done.
        transformedEvent.recycle();
        return handled;
    }
複製程式碼

歐克,到此為止 ViewGroup 的兩個主要的方法就差不多分析完了,我感覺我的註釋打的也很全,有人會問了為什麼沒有 onTouchEvent() 方法,因為 ViewGroup 沒有這個方法,等會我們分析 View 會將這個方法。

2. 接下來我們再看一下 View 的 dispatchTouchEvent() 方法

public boolean dispatchTouchEvent(MotionEvent event) {
        ...
        final int actionMasked = event.getActionMasked();
        if (actionMasked == MotionEvent.ACTION_DOWN) {
            // 如果開始 ACTION_DOWN 事件則取消當前的滑動
            stopNestedScroll();
        }

        if (onFilterTouchEventForSecurity(event)) {
            if ((mViewFlags & ENABLED_MASK) == ENABLED && handleScrollBarDragging(event)) {
                result = true;
            }
            //這個物件的作用就如他的名字,儲存各種監聽介面
            ListenerInfo li = mListenerInfo;
            //首先 ListenerInfo 不為空(則裡面有監聽物件),並且有 TouchListener 不為空,
            //並且控制元件的狀態是啟用的,
            //並且 TouchListener 的 onTouch 返回 true 說明事件被外面的 TouchListener 處理了,
            //這就說明了外面設定監聽介面優先順序高於自己本身的 onTouchEvent() 方法,
            //這就是我們解決滑動衝突第一種方法的依據
            if (li != null && li.mOnTouchListener != null
                    && (mViewFlags & ENABLED_MASK) == ENABLED
                    && li.mOnTouchListener.onTouch(this, event)) {
                result = true;
            }
            
            //如果上述沒有處理事件,則呼叫自身的 onTouchEvent() 方法
            if (!result && onTouchEvent(event)) {
                result = true;
            }
        }
        ...
        if (actionMasked == MotionEvent.ACTION_UP ||
                actionMasked == MotionEvent.ACTION_CANCEL ||
                (actionMasked == MotionEvent.ACTION_DOWN && !result)) {
            //如果手指抬起、時間取消、手指按下並由本 View 處理了事件,則停止 View 的滑動
            stopNestedScroll();
        }

        return result;
    }
複製程式碼

接下來我們再看一看我們心心念唸的 onTouchEvent() 方法

public boolean onTouchEvent(MotionEvent event) {
        ...
        //判斷事件點選
        final boolean clickable = ((viewFlags & CLICKABLE) == CLICKABLE
                || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
                || (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE;
        
        //如果當前 View 沒有啟用則不處理該事件
        if ((viewFlags & ENABLED_MASK) == DISABLED) {
            if (action == MotionEvent.ACTION_UP && (mPrivateFlags & PFLAG_PRESSED) != 0) {
                setPressed(false);
            }
            mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
            return clickable;
        }
        //代理物件
        if (mTouchDelegate != null) {
            if (mTouchDelegate.onTouchEvent(event)) {
                return true;
            }
        }

        if (clickable || (viewFlags & TOOLTIP) == TOOLTIP) {
            switch (action) {
                case MotionEvent.ACTION_UP:
                    mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
                    if ((viewFlags & TOOLTIP) == TOOLTIP) {
                        handleTooltipUp();
                    }
                    if (!clickable) {
                        removeTapCallback();
                        //取消長按點選的延時操作
                        removeLongPressCallback();
                        mInContextButtonPress = false;
                        mHasPerformedLongPress = false;
                        mIgnoreNextUpEvent = false;
                        break;
                    }
                    boolean prepressed = (mPrivateFlags & PFLAG_PREPRESSED) != 0;
                    if ((mPrivateFlags & PFLAG_PRESSED) != 0 || prepressed) {
                        boolean focusTaken = false;
                        if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
                            focusTaken = requestFocus();
                        }

                        if (prepressed) {
                            setPressed(true, x, y);
                        }

                        if (!mHasPerformedLongPress && !mIgnoreNextUpEvent) {
                            removeLongPressCallback();
                            if (!focusTaken) {
                                if (mPerformClick == null) {
                                    mPerformClick = new PerformClick();
                                }
                                if (!post(mPerformClick)) {
                                    //處理點選事件
                                    performClick();
                                }
                            }
                        }

                        if (mUnsetPressedState == null) {
                            mUnsetPressedState = new UnsetPressedState();
                        }

                        if (prepressed) {
                            postDelayed(mUnsetPressedState,
                                    ViewConfiguration.getPressedStateDuration());
                        } else if (!post(mUnsetPressedState)) {
                            mUnsetPressedState.run();
                        }

                        removeTapCallback();
                    }
                    mIgnoreNextUpEvent = false;
                    break;

                case MotionEvent.ACTION_DOWN:
                    if (event.getSource() == InputDevice.SOURCE_TOUCHSCREEN) {
                        mPrivateFlags3 |= PFLAG3_FINGER_DOWN;
                    }
                    mHasPerformedLongPress = false;

                    if (!clickable) {
                        //處理長按點選,此處是用延時佇列實現的,所有很多不符合的條件下要刪除掉這個延時事件
                        checkForLongClick(0, x, y);
                        break;
                    }

                    if (performButtonActionOnTouchDown(event)) {
                        break;
                    }
                    //能否在容器內滾動
                    boolean isInScrollingContainer = isInScrollingContainer();

                    if (isInScrollingContainer) {
                        mPrivateFlags |= PFLAG_PREPRESSED;
                        if (mPendingCheckForTap == null) {
                            mPendingCheckForTap = new CheckForTap();
                        }
                        mPendingCheckForTap.x = event.getX();
                        mPendingCheckForTap.y = event.getY();
                        postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
                    } else {
                        setPressed(true, x, y);
                        checkForLongClick(0, x, y);
                    }
                    break;
                case MotionEvent.ACTION_CANCEL:
                    ...
                    //清除各種狀態
                    break;
                case MotionEvent.ACTION_MOVE:
                    if (clickable) {
                        drawableHotspotChanged(x, y);
                    }

                    if (!pointInView(x, y, mTouchSlop)) {
                        //如果手指移動到 View 的外部則停止長按等事件
                        removeTapCallback();
                        removeLongPressCallback();
                        if ((mPrivateFlags & PFLAG_PRESSED) != 0) {
                            setPressed(false);
                        }
                        mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
                    }
                    break;
            }
            return true;
        }
        return false;
    }
複製程式碼

我們事件分發的內容基本也就這麼多了,其實光講事件分發的話 onTouchEvent() 這個方法將的有點多餘了,其實與我們當前內容也沒有多大的關係。

歡迎關注我的公眾號

相關文章