【原创】【ViewFlow+GridView】Parameter must be a descendant of this view问题分析

关于ViewFlow和GridView嵌套导致Parameter must be a descendant of this view问题的解决方案

【关于ViewFlow】

 

ViewFlow是一款基于ViewGroup实现的可以水平滑动的开源UI Widget，可以从 https://code.google.com/p/andro-views/ 下载。

它使用Adapter进行条目绑定，主要用于不确定数目的视图间的切换，和ViewPager功能类似，但是可扩展性更强。

 

本例就是使用ViewFlow来实现页面水平切换。

 

【关于文章所用源码】

 

本文所属异常由于是从Android 4.2设备上抛出，所以文章内出现的所有源码都是Android 4.2源码，具体地址如下：http://grepcode.com/snapshot/repository.grepcode.com/java/ext/com.google.android/android/4.2.1_r1.2/

 

一、功能描述

采用ViewFlow+GridView的方式实现手势切屏功能，每屏以九宫格模式显示。

长按GridView里的Item切换到编辑模式，可以对Item进行删除。

 

二、复现场景

2.1 复现环境

本人拿了多款Android 4.2系列手机进行测试，目前只在两部手机上必现，在其他非 4.2 手机上偶尔出现。

华为Ascend P6，Android 4.2.2

联想K900，Android 4.2.1

 

2.2 复现步骤

进入应用后，以下三种操作都会导致所述问题：

1、Home到后台，再切换回来，Crash

2、长按Item，待切换到编辑模式后，Home到后台，再切换回来，Crash

3、左右切换几次屏幕，Home到后台，再切换回来，Crash

 

三、Crash Stack Info

 java.lang.IllegalArgumentException: parameter must be a descendant of this view
     at android.view.ViewGroup.offsetRectBetweenParentAndChild(ViewGroup.java:4295)
     at android.view.ViewGroup.offsetDescendantRectToMyCoords(ViewGroup.java:4232)
     at android.view.ViewRootImpl.scrollToRectOrFocus(ViewRootImpl.java:2440)
     at android.view.ViewRootImpl.draw(ViewRootImpl.java:2096)
     at android.view.ViewRootImpl.performDraw(ViewRootImpl.java:2045)
     at android.view.ViewRootImpl.performTraversals(ViewRootImpl.java:1854)
     at android.view.ViewRootImpl.doTraversal(ViewRootImpl.java:989)
     at android.view.ViewRootImpl$TraversalRunnable.run(ViewRootImpl.java:4351)
     at android.view.Choreographer$CallbackRecord.run(Choreographer.java:749)
     at android.view.Choreographer.doCallbacks(Choreographer.java:562)
     at android.view.Choreographer.doFrame(Choreographer.java:532)
     at android.view.Choreographer$FrameDisplayEventReceiver.run(Choreographer.java:735)
     at android.os.Handler.handleCallback(Handler.java:725)
     at android.os.Handler.dispatchMessage(Handler.java:92)
     at android.os.Looper.loop(Looper.java:137)
     at android.app.ActivityThread.main(ActivityThread.java:5041)
     at java.lang.reflect.Method.invokeNative(Native Method)
     at java.lang.reflect.Method.invoke(Method.java:511)
     at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:793)
     at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:560)
     at dalvik.system.NativeStart.main(Native Method)

四、问题分析

4.1 异常描述

首先让我们看一下这个Exception是如何抛出的。参考：http://grepcode.com/file/repository.grepcode.com/java/ext/com.google.android/android/4.2.1_r1.2/android/view/ViewGroup.java#ViewGroup

Android 4.2.1_r1.2中ViewGroup的offsetRectBetweenParentAndChild方法如下：

     /**
      * Helper method that offsets a rect either from parent to descendant or
      * descendant to parent.
      */
     void offsetRectBetweenParentAndChild(View descendant, Rect rect,
             boolean offsetFromChildToParent, boolean clipToBounds) {

         // already in the same coord system :)
         if (descendant == this) {
             return;
         }

         ViewParent theParent = descendant.mParent;

         // search and offset up to the parent
         while ((theParent != null)
                 && (theParent instanceof View)
                 && (theParent != this)) {

             if (offsetFromChildToParent) {
                 rect.offset(descendant.mLeft - descendant.mScrollX,
                         descendant.mTop - descendant.mScrollY);
                 if (clipToBounds) {
                     View p = (View) theParent;
                     rect.intersect(0, 0, p.mRight - p.mLeft, p.mBottom - p.mTop);
                 }
             } else {
                 if (clipToBounds) {
                     View p = (View) theParent;
                     rect.intersect(0, 0, p.mRight - p.mLeft, p.mBottom - p.mTop);
                 }
                 rect.offset(descendant.mScrollX - descendant.mLeft,
                         descendant.mScrollY - descendant.mTop);
             }

             descendant = (View) theParent;
             theParent = descendant.mParent;
         }

         // now that we are up to this view, need to offset one more time
         // to get into our coordinate space
         if (theParent == this) {
             if (offsetFromChildToParent) {
                 rect.offset(descendant.mLeft - descendant.mScrollX,
                         descendant.mTop - descendant.mScrollY);
             } else {
                 rect.offset(descendant.mScrollX - descendant.mLeft,
                         descendant.mScrollY - descendant.mTop);
             }
         } else {
             throw new IllegalArgumentException("parameter must be a descendant of this view");
         }
     }

在方法最后可以看到该异常。那么该异常到底表示什么意思呢？若想知道答案，我们需要从该方法的实现入手。

通过注释可知，offsetRectBetweenParentAndChild方法的功能有两个：

1、计算一个Rect在某个Descendant View所在坐标系上所表示的区域或者是在该坐标系上和该Descendant View重叠的区域；

2、计算一个Rect从某个Descendant View所在坐标系折回到Parent View所在坐标系所表示的区域，即与功能1相反。

分析实现代码可以看出，它是通过所给Descendant View逐级向上寻找Parent View，同时将Rect转换到同级坐标系。在方法末尾处指出：如果最后寻找的Parent View和当前View（即调用offsetRectBetweenParentAndChild方法的View）不一致，则会抛出 IllegalArgumentException("parameter must be a descendant of this view")异常，亦即该文所指异常。

说白了，就是所给Descendant View必须是当前View的子孙.

 

那么，什么时候最后的Parent View和当前View不一致呢？请看下节分析。

 

4.2 原因探究

4.2.1 异常条件

我们来看offsetRectBetweenParentAndChild里的这段代码：

 ViewParent theParent = descendant.mParent;

 // search and offset up to the parent
 while ((theParent != null)
         && (theParent instanceof View)
         && (theParent != this)) {

当Descendant View的Parent为null、非View实例、当前View时，会跳出循环进入最后的判断。排除当前View，就只剩下两个原因：null和非View实例。

 

这就需要探究View的Parent是如何被赋值的。

 

4.2.2 View内Parent的赋值入口

首先，我们从最根本的View入手。

在View源码里找到mParent的声明和赋值代码分别如下：

声明：

     /**
      * The parent this view is attached to.
      * {@hide}
      *
      * @see #getParent()
      */
     protected ViewParent mParent;

赋值：

     /*
      * Caller is responsible for calling requestLayout if necessary.
      * (This allows addViewInLayout to not request a new layout.)
      */
     void assignParent(ViewParent parent) {
         if (mParent == null) {
             mParent = parent;
         } else if (parent == null) {
             mParent = null;
         } else {
             throw new RuntimeException("view " + this + " being added, but"
                     + " it already has a parent");
         }
     }

透过上述代码，我们可以猜测mParent的赋值方式有两种：直接赋值和调用assignParent方法赋值。

4.2.3 ViewGroup为Descendant指定Parent

接下来查看ViewGroup的addView方法，并最终追踪到addViewInner方法内，注意下图红框所示代码：

 

红框内的代码验证了我们的猜想，即：一旦一个View被添加进ViewGroup内，其mParent所指向的就是该ViewGroup实例。很显然，ViewGroup是View的实例。这样异常条件就只剩下一种可能：Descendant View的Parent为null。

 

但是，什么情况下为null呢？

 

4.2.4 ViewGroup如何移除Descendant

查找并筛选ViewGroup内所有确定最后将Parent设置为null的方法，最后找到四个方法：

• removeFromArray(int index)------------------移除指定位置的Child
• removeFromArray(int start, int count)-------移除指定位置开始的count个Child
• removeAllViewsInLayout()---------------------移除所有Child
• detachAllViewsFromParent--------------------把所有Child从Parent中分离

从上述四个方法中不难看出，当View从ViewGroup中移除的时候，其Parent将被设为null。

由此可以断定，ViewGroup使用了一个已经被移除的Descendant View来通过offsetRectBetweenParentAndChild方法计算坐标。

 

那么，既然使用被移除的Descendant View必定会导致该异常，ViewGroup又为何要使用它呢？

 

4.3 原因深究

4.3.1 ViewGroup为何使用被移除的Descendant

我们根据Crash Stack Info追溯到ViewRootImpl类的boolean scrollToRectOrFocus(Rect rectangle, boolean immediate)方法，注意图片中红框所圈代码：

 

由标记1、3处代码可知，ViewGroup使用的Descendant View其实就是焦点当前真正所在的View，即Focused View。

问题就出在这里，如果Focused View是一个正常的View倒是可以，但是如果它是一个已经被移除的View，根据我们在4.2的分析可知，它的Parent为null，势必会导致所述异常。

但是，Focused View是为什么会被移除呢？

 

4.3.2 Focused View为什么会被移除

4.2提到的四个方法中，第三个方法removeAllViewsInLayout在移除Child Views的同时清除了Focused View的标记，排除。第四个方法detachAllViewsFromParent在Activity Destory后才调用，排除。方法一和方法二是重载方法，实现类似，可以断定Focused View肯定是在这两个方法中被移除的。

 

分析ViewFlow移除Child的操作，一共有两处，分别在recycleView(View v)和resetFocus()方法内。

resetFocus方法内调用了removeAllViewsInLayout方法，根据上一段分析可以安全排除。那么就剩下recycleView(View v)方法，我们来看代码：

      protected void recycleView(View v) {
          if (v == null)
              return ;

         mRecycledViews.add(v);
         detachViewFromParent(v);
     }

该方法是把ViewFlow的Child移除，并回收到循环利用列表。注意最后一行，调用了detachViewFromParent(View v)方法，代码如下：

     /**
      * Detaches a view from its parent. Detaching a view should be temporary and followed
      * either by a call to {@link #attachViewToParent(View, int, android.view.ViewGroup.LayoutParams)}
      * or a call to {@link #removeDetachedView(View, boolean)}. When a view is detached,
      * its parent is null and cannot be retrieved by a call to {@link #getChildAt(int)}.
      *
      * @param child the child to detach
      *
      * @see #detachViewFromParent(int)
      * @see #detachViewsFromParent(int, int)
      * @see #detachAllViewsFromParent()
      * @see #attachViewToParent(View, int, android.view.ViewGroup.LayoutParams)
      * @see #removeDetachedView(View, boolean)
      */
     protected void detachViewFromParent(View child) {
         removeFromArray(indexOfChild(child));
     }

很明显，直接调用了removeFromArray(int index)方法，正是在4.2.4节中指出的第一个方法，而该方法已经在本节开头被确定为真凶！

设想一下，如果recycleView(View v)的参数v正是Focused View的话，Focused View就会从ViewFlow中被移除，但是当前焦点仍然在其上边。这时候offsetRectBetweenParentAndChild方法使用它必定会导致本文所指异常，这正是症结所在！

 

五、解决方案

5.1 普通方案与文艺方案

经过上述分析，不难想到解决方案：在ViewFlow的recycleView(View v)方法内移除View的时候，判断如果恰好是Focused View，则将焦点一并移除。

详细代码如下：

 protected void recycleView(View v) {
     if (v == null)
         return;

     // 方法一：普通方案，已验证可行
     // 如果被移除的View恰好是ViewFlow内当前焦点所在View
     // 则清除焦点(clearChildFocus方法在清除焦点的同时
     // 也把ViewGroup内保存的Focused View引用清除)
     if (v == findFocus()) {
         clearChildFocus(v);
     }

     // 方法二：文艺方案，请自行验证！
     // 下面这个方法也是把View的焦点清除，但是其是否起作用
     // 这里不讲，请读者自行验证、比较。
     // v.clearFocus();

     mRecycledViews.add(v);
     detachViewFromParent(v);
 }

注意代码内的注释。

 

下面附上ViewGroup.clearChildFocus(View v)和View.clearFocus()这两个方法的源码以供参考：

ViewGroup.clearChildFocus(View v):

 /**
 * {@inheritDoc}
 */
 public void clearChildFocus(View child) {
     if (DBG) {
         System.out.println(this + " clearChildFocus()");
     }

     mFocused = null;
     if (mParent != null) {
         mParent.clearChildFocus(this);
     }
 }

View.clearFocus():

 /**
 * Called when this view wants to give up focus. This will cause
 * {@link #onFocusChanged(boolean, int, android.graphics.Rect)} to be called.
 */
 public void clearFocus() {
     if (DBG) {
         System.out.println(this + " clearFocus()");
     }

     if ((mPrivateFlags & FOCUSED) != 0) {
         mPrivateFlags &= ~FOCUSED;

         if (mParent != null) {
             mParent.clearChildFocus(this);
         }

         onFocusChanged(false, 0, null);
         refreshDrawableState();
     }
 }

当然，解决问题方法不止一种！

5.2 2B方案

注意，该方案仅适用于ViewGroup的Child不需要获取焦点的情况，其他情况下请使用上一节介绍的方案。

 

既然是ViewGroup内的Focused View惹的祸，那干脆把这家伙斩草除根一了百了！

 

ViewGroup内的Child在获取焦点的时候会调用requestChildFocus(View child, View focused)方法，代码如下：

 /**
 * {@inheritDoc}
 */
 public void requestChildFocus(View child, View focused) {
     if (DBG) {
         System.out.println(this + " requestChildFocus()");
     }
     if (getDescendantFocusability() == FOCUS_BLOCK_DESCENDANTS) {
         return;
     }

     // Unfocus us, if necessary
     super.unFocus();

     // We had a previous notion of who had focus. Clear it.
     if (mFocused != child) {
         if (mFocused != null) {
             mFocused.unFocus();
         }

         mFocused = child;
     }
     if (mParent != null) {
         mParent.requestChildFocus(this, focused);
     }
 }

注意第二个判断条件：如果ViewGroup当前的焦点传递策略是不向下传递，则不指定Focused View。

 

So，下面该如何做，你懂的！整个世界清静了~