（二）Android事件分发机制 - ViewGroup篇

本文适用于对Android事件分发机制有一定基础的开发者阅读，主要是通过对ViewGroup类中的事件分发、事件拦截的源代码进行解析以达到完全理解其原理的目的

• （一）Android事件分发机制 - View篇
• （二）Android事件分发机制 - ViewGroup篇
• （三）Android事件分发机制 - Activity篇
• （四）Android事件分发机制 - 总结篇

我们知道ViewGroup中包含dispatchTouchEvent、onInterceptTouchEvent和onTouchEvent方法，接下来我们通过源代码（基于Android6.0）看看这些方法内部到底做了哪些事情。

ViewGroup#dispatchTouchEvent源码解析

初始化ACTION_DOWN事件

@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
    ...
    if (actionMasked == MotionEvent.ACTION_DOWN) {
            // 这里会将mFirstTouchTarget置为 null
            cancelAndClearTouchTargets(ev);
            resetTouchState();
    }
    ...
}

• 由于一个完整的事件序列是以ACTINON_DOWN开始，以ACTINON_UP结束，所以如果是ACTINON_DOWN事件，那么说明是一个新的事件序列，所以需要初始化之前的状态。

检查ViewGroup是否要拦截事件

@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
    ...
    final boolean intercepted;
    if (actionMasked == MotionEvent.ACTION_DOWN
            || mFirstTouchTarget != null) {
        final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
        if (!disallowIntercept) {
            intercepted = onInterceptTouchEvent(ev);
            ev.setAction(action); // restore action in case it was changed
        } else {
            intercepted = false;
        }
    } else {
        // There are no touch targets and this action is not an initial down
        // so this view group continues to intercept touches.
        intercepted = true;
    }
    ...
    // Check for cancelation.
    final boolean canceled = resetCancelNextUpFlag(this)
            || actionMasked == MotionEvent.ACTION_CANCEL;
    // ...
}

public boolean onInterceptTouchEvent(MotionEvent ev) {
    return false;
}

• 定义了一个布尔值intercept来记录是否要进行拦截；
• 如果事件是ACTION_DOWN或者mFirstTouchTatget值不为空才有可能执行到onInterceptTouchEvent方法，否则intercept = true；
  那么为什么要有这个判断呢？
  如果子View消耗了ACTION_DOWN事件，那么mFirstTouchTarget将指向该子View，而后ViewGroup继续判断是否要拦截接下来的ACTION_MOVE等事件；
  如果子View没有消耗ACTION_DOWN事件，那么mFirstTouchTarget将为null，后续事件到来时，会直接把intercept设置为true，并将事件交由ViewGroup处理。
• FLAG_DISALLOW_INTERCEPT这个标志位特别有用，它可以用来禁止或允许ViewGroup拦截除了DOWN之外的事件，一般通过子View调用requestDisallowInterceptTouchEvent来设置；
• ViewGroup#onInterceptTouchEvent()方法是默认返回false的，即ViewGroup默认不拦截任何事件，如果想要让ViewGroup拦截事件，那么应该在自定义的ViewGroup中重写这个方法。

对ACTION_DWON事件的特殊处理

接下来是一个If判断语句，内部还有若干if语句，以下先省略所有if体的内容，我们从大体上认识这块代码的作用：

@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
    ...
    TouchTarget newTouchTarget = null;
    boolean alreadyDispatchedToNewTouchTarget = false;
    if (!canceled && !intercepted) {
        ...// IF体1
        if (actionMasked == MotionEvent.ACTION_DOWN
                    || (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
                    || actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
            ...// IF体2
        }
    }
    ...
}

• 将newTouchTarget置为null，alreadyDispatchedToNewTouchTarget置为false；

• 如果事件是未被取消（!canceled）并且ViewGroup不拦截事件（!intercepted）则进入IF体1；

• 接下来继续判断如果(actionMasked == MotionEvent.ACTION_DOWN...)则进入IF体2：

    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;
  
        // Clean up earlier touch targets for this pointer id in case they
        // have become out of sync.
        removePointersFromTouchTargets(idBitsToAssign);
  
        final int childrenCount = mChildrenCount;
        if (newTouchTarget == null && childrenCount != 0) {
        ...// IF体3
        }
        if (newTouchTarget == null && mFirstTouchTarget != null) {
        ...
        }
    }
  

• 如果ViewGroup内部子View的数量childrenCount != 0进入IF体3：

    if (newTouchTarget == null && childrenCount != 0) {
        ...
        for (int i = childrenCount - 1; i >= 0; i--) {
            final int childIndex = customOrder
                    ? getChildDrawingOrder(childrenCount, i) : i;
            final View child = (preorderedList == null)
                    ? children[childIndex] : preorderedList.get(childIndex);
            ...
            if (!canViewReceivePointerEvents(child)
                    || !isTransformedTouchPointInView(x, y, child, null)) {
                ev.setTargetAccessibilityFocus(false);
                continue;
            }
            ...
            if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
                ...
            }
            ...
        }
        if (preorderedList != null) preorderedList.clear();
    }
  

• 对ViewGroup内部的子View进行倒序遍历，即从最上层的View开始往下层遍历，一个个地找到能接受事件的子View；

• 如果子View不能接受触碰事件 - View不可见或者有动画效果（!canViewReceivePointerEvents(child)）或者触摸点位置不在子View的范围内（!isTransformedTouchPointInView(x, y, child, null)），则continue，表示这个子View不符合条件，开始遍历下一个子View；

• 找到符合条件的子View后调用dispatchTransformedTouchEvent()方法：

    private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel,
        View child, int desiredPointerIdBits) {
        final boolean handled;
        ...
        if (child == null) {
            handled = super.dispatchTouchEvent(event);
        } else {
            handled = child.dispatchTouchEvent(event);
        }
        event.setAction(oldAction);
        return handled;
    ...
    }
  

• 当传递进来的的child != null时，就会调用子View的dispatchTouchEvent(event)方法，表示把事件交给子View处理，完成了ViewGroup到子View的事件传递，当事件处理完毕，就会返回一个布尔值handled，该值表示子View是否消耗了事件。

• 当传递进来的的child == null时，就会调用ViewGroup的dispatchTouchEvent(event)方法，表示把事件交给父View处理；

• dispatchTransformedTouchEvent方法返回true时，表示子View消耗了事件：

    if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
        ...
        newTouchTarget = addTouchTarget(child, idBitsToAssign);
        alreadyDispatchedToNewTouchTarget = true;
        ...
        break;
    }
  
    private TouchTarget addTouchTarget(View child, int pointerIdBits) {
        TouchTarget target = TouchTarget.obtain(child, pointerIdBits);
        target.next = mFirstTouchTarget;
        mFirstTouchTarget = target;
        return target;
    }
  

• 此时把mFirstTouchTarget指向child，同时把newTouchTarget也指向child，alreadyDispatchedToNewTouchTarget置为true，也即是说，如果有子View消耗掉了事件，那么mFirstTouchTarget就会指向该子View。

---

小结：

• 整个if(!canceled && !intercepted){ … }代码块所做的工作就是对ACTION_DOWN事件的特殊处理；
• 因为ACTION_DOWN事件是一个事件序列的开始，所以我们要先找到能够处理这个事件序列的一个子View；
• 如果一个子View能够消耗事件，那么mFirstTouchTarget会指向该子View；
• 如果所有的子View都不能消耗事件，那么mFirstTouchTarget将为null。

---

对除了ACTION_DOWN之外的其他事件的处理

@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
    ...
    // Dispatch to touch targets.
    if (mFirstTouchTarget == null) {
        // No touch targets so treat this as an ordinary view.
        handled = dispatchTransformedTouchEvent(ev, canceled, null,
                TouchTarget.ALL_POINTER_IDS);
    } else {
        // Dispatch to touch targets, excluding the new touch target if we already
        // dispatched to it.  Cancel touch targets if necessary.
        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;
        }
    }
    ...
    return handled;
    }
}

• 首先mFirstTouchTarget为null就调用dispatchTransformedTouchEvent(ev, canceled, null, ...)方法，这里第三个参数为null，在这个方法的内部会执行super.dispatchTouchEvent(event) - 也就是说，如果找不到子View来处理事件，那么最后会交由ViewGroup来处理事件；
• 如果mFirstTouchTarget不为null，说明在ACTION_DOWN事件时已经找到了一个子View来消耗事件，接下来往下执行if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget)，这里就是区分了ACTION_DOWN事件和别的事件的关键：
  如果为true那就说明是ACTION_DOWN事件，并且子View消耗了事件，那么直接置handled为true并返回；
  如果为false那就说明不是ACTION_DOWN事件，即是ACTION_MOVE、ACTION_UP等别的事件。

---

小结：

• 最后这段代码处理除了ACTION_DOWN事件之外的其他事件；
• 如果ViewGroup拦截了事件或者所有子View均不消耗事件那么在这里交由ViewGroup处理事件；
• 如果有子View已经消耗了ACTION_DOWN事件，那么在这里继续把其他事件分发给子View处理。

---

我们总结一下：

• Android事件分发是先传递到ViewGroup，再由ViewGroup传递到View的；
• 在ViewGroup中可以通过onInterceptTouchEvent方法对事件传递进行拦截，返回true代表不允许事件继续向子View传递，返回false代表不对事件进行拦截，默认返回false；
• 当ViewGroup决定拦截事件后，onInterceptTouchEvent方法将不会被调用，并且同一序列中的其他事件都会默认交给它处理；
• 如果事件能够传递到当前的ViewGroup，且我们要提前处理所有点击事件，应该选择dispatchTouchEvent方法，因为只有这个方法能确保每次都会被调用，而onInterceptTouchEvent方法却无法保证每次事件都会被调用；
• 子View可以通过调用getParent().requestDisallowInterceptTouchEvent(true) 阻止ViewGroup对其ACTION_MOVE或者ACTION_UP事件进行拦截，它通常用于解决滑动冲突问题；
• 子View不能通过调用getParent().requestDisallowInterceptTouchEvent(true) 阻止ViewGroup对其ACTION_DOWN事件进行拦截，因为父View在每次接收到ACTION_DOWN事件时都会重置这个标志；
• 子View中如果将传递的事件消费掉，ViewGroup就不再对该事件进行处理了；
• ViewGroup的dispatchTouchEvent是真正在执行“分发”工作，而View的dispatchTouchEvent方法，并不执行分发工作，或者说它分发的对象就是自己，决定是否把touch事件交给自己处理，而处理的方法，便是onTouchEvent事件；
• 一般情况下，我们不该在普通View内重写dispatchTouchEvent方法，因为它并不执行分发逻辑。当Touch事件到达View时，我们该做的就是是否在onTouchEvent事件中处理它；
• ViewGroup的onTouchEvent事件是什么时候处理的呢？当ViewGroup所有的子View都返回false时，onTouchEvent事件便会执行。由于ViewGroup是继承于View的，它其实也是通过调用View的dispatchTouchEvent方法来执行onTouchEvent事件；
• 当某个子View返回true时，会中止ACTION_DOWN事件的分发，同时在ViewGroup中记录该子View。接下去的ACTION_MOVE和ACTION_UP事件将由该子View直接进行处理。由于子View是保存在ViewGroup中的，多层ViewGroup的节点结构时，上级ViewGroup保存的会是真实处理事件的View所在的ViewGroup对象：如ViewGroup0-ViewGroup1-TextView的结构中，TextView返回了true，它将被保存在ViewGroup1中，而ViewGroup1也会返回true，被保存在ViewGroup0中。当ACTION_MOVE和ACTION_UP事件来时，会先从ViewGroup0传递至ViewGroup1，再由ViewGroup1传递至TextView;
• 当ViewGroup中所有子View都不捕获ACTION_DOWN事件时，将触发ViewGroup自身的onTouch事件。触发的方式是调用super.dispatchTouchEvent函数，即父类View的dispatchTouchEvent方法。在所有子View都不处理的情况下，触发Acitivity的onTouchEvent方法；