说说Android桌面(Launcher应用)背后的故事(三)——CellLayout的秘密

时间:2022-11-24 17:52:49
CellLayout的设计主要为了存放大小不一的控件。为了更好的控制item的添加和删除,选择直接继承ViewGroup来实现该控件。

我们长按桌面的时候,有两种情况,一种是我们按的是一个item,还有一种是我们按的是一个空的位置。这里,就有一个问题。

1、我怎么知道当前按下的位置上是空白区域还是item呢?

2、就算我知道了当前的位置坐标,我又如何知道当前的坐标属于哪个单元格呢?

3、如果上面两个问题都解决了,当我选择了某个要添加的item,这个item怎么样才能添加到指定的单元格呢,怎么根据当前item的大小来分配大小合适的空间呢?

为了处理单元格和item占据的空间问题,CellLayout按照如下图示进行布局:

说说Android桌面(Launcher应用)背后的故事(三)——CellLayout的秘密

下面就来看看CellLayout中是如何表示上面的CellInfo的:

  1. public static final class CellInfo implements ContextMenu.ContextMenuInfo{  
  2.     public View view; //当前这个item对应的View   
  3.       
  4.     public int cellX; //该item水平方向上的起始单元格   
  5.     public int cellY;   //该item垂直方向上的起始单元格   
  6.     public int cellHSpan; //该item水平方向上占据的单元格数目   
  7.     public int cellVSpan; //该item垂直方向上占据的单元格数目   
  8.       
  9.     public boolean valid; //是否有效   
  10.       
  11.     public int screen; //所在的屏幕   
  12.       
  13.     Rect current = new Rect(); //用于递归寻找连续单元格,当前连续区域的大小   
  14.       
  15.     final ArrayList<VacantCell> vacantCells = new ArrayList<UorderCellLayout.CellInfo.VacantCell>();  
  16.       
  17.       
  18.     public void clear(){  
  19.         final ArrayList<VacantCell> list = vacantCells;  
  20.         final int count = list.size();  
  21.         for(int i=0; i<count; i++){  
  22.             list.get(i).release();  
  23.         }  
  24.           
  25.         list.clear();  
  26.     }  
  27.       
  28.     public String toString(){  
  29.           
  30.         return "cellinfo:[cellX="+cellX+",cellY="+cellY+",cellHSpan="+cellHSpan+",cellVSpan="+cellVSpan+"]";  
  31.     }  
  32.     /** 
  33.      *  
  34.      * VacantCell:代表空的cells,由多个cell组成,将其实现为一个cell池,减少对象的创建 
  35.      * 
  36.      */  
  37.     static final class VacantCell{  
  38.           
  39.         private static final int POOL_SIZE = 100//池最多缓存100个VacantCell   
  40.         private static final Object mLock = new Object(); //用作同步锁   
  41.           
  42.         private static VacantCell mRoot;  
  43.         private static int count;  
  44.           
  45.         private VacantCell mNext;  
  46.   
  47.         //VacantCell的大小信息   
  48.         private int cellX;  
  49.         private int cellY;  
  50.         private int cellHSpan;  
  51.         private int cellVSpan;  
  52.           
  53.         public static VacantCell acquire(){  
  54.             synchronized (mLock) {  
  55.                 if(mRoot == null){  
  56.                     return new VacantCell(); //一开始没有的时候,一直新创建再返回   
  57.                 }  
  58.                 //如果池存在,则从池中取   
  59.                 VacantCell info = mRoot;  
  60.                 mRoot = info.mNext;  
  61.                 count--; //记得将统计更新   
  62.                   
  63.                 return info;  
  64.             }  
  65.         }  
  66.           
  67.         //release这个对象自身   
  68.         public void release(){  
  69.             synchronized(mLock){  
  70.                 if(count < POOL_SIZE){  
  71.                     count++;  
  72.                     mNext = mRoot;  
  73.                     mRoot = this;  
  74.                 }  
  75.             }  
  76.         }  
  77.     }  
  78. }  


其用一个CellInfo保存当前位置上的View信息和其位置信息,但是注意到其还定义了一个VancantCell类,这个主代表某个空的“区域”,这个区域可能有多个单元格。同时,其实现为一个链表结构的单元格池,这样主要不用每次都来创建新对象,优化性能。

对CellLayout的大概结构有所了解后,我们就可以接着去寻找开始提到的三个问题的答案了。

一、如何标识当前位置上的信息

为了可以知道某个位置是空还是已经被占用了,CellLayout用一个二维布尔数组boolean[水平单元格数][竖直单元格数]来保存每个单元格的占用信息,被占用的为true,空的为false。

为了判断当前长按事件的位置是否在item上,可以在onInterceptTouchEvent方法中如下判断当前长按事件的位置是否在某个item的位置里。如下:

  1. final Rect frame = mRect;  
  2. final int x = (int)ev.getX();   
  3. final int y = (int)ev.getY();  
  4.   
  5. Log.v(TAG, "MotionEvent.getX,getY:[x,y]=["+x+","+y+"]");  
  6.   
  7. final int count = getChildCount();  
  8. boolean found = false;  
  9. Log.v(TAG, "CellLayout Child count:"+count);  
  10. for(int i=count-1; i>=0; i--){  
  11.     final View child = getChildAt(i);  
  12.       
  13.     if(child.getVisibility() == VISIBLE || child.getAnimation() != null){  
  14.           
  15.         child.getHitRect(frame); //获取child的尺寸信息,相对于CellLayout   
  16.           
  17.         Log.v(TAG, "View.getHitRect:"+frame.toString());  
  18.           
  19.         if(frame.bottom<=frame.top || frame.right<= frame.left){  
  20.             Log.v(TAG, "The rectangle of the view is incorrect");  
  21.             continue;  
  22.         }  
  23.           
  24.         if(frame.contains(x,y)){  
  25.             //如果当前事件正好落在该child上   
  26.             final LayoutParams lp = (LayoutParams)child.getLayoutParams();  
  27.             cellInfo.view = child;  
  28.             cellInfo.cellX = lp.cellX;  
  29.             cellInfo.cellY = lp.cellY;  
  30.             cellInfo.cellHSpan = lp.cellHSpan;  
  31.             cellInfo.cellVSpan = lp.cellVSpan;  
  32.             cellInfo.valid = true;  
  33.             found = true;  
  34.             Log.v(TAG, "YES,Found!");  
  35.             break;  
  36.         }  
  37.     }  
  38. }  


上面我们记录了如果落在某个item上,我们记录下当前的位置信息和view信息。那么如果当前长按的是一块空的区域呢?

  1. if(!found){  
  2.     /** 
  3.      * 如果点击的位置是空白区域,则也需要保存当前的位置信息 
  4.      * 点击空白区域的时候,是需要做更多的处理,在外层弹出对话框添加应用,文件夹,快捷方式等,然后在桌面该 
  5.      * 位置处创建图标 
  6.      */  
  7.     int cellXY[] = mCellXY;  
  8.     pointToCellExact(x,y,cellXY); //得到当前事件所在的单元格   
  9.     Log.v(TAG, "Not Found the cellXY is =["+cellXY[0]+","+cellXY[1]+"]");  
  10.     //然后保存当前位置信息   
  11.     cellInfo.view = null;  
  12.     cellInfo.cellX = cellXY[0];  
  13.     cellInfo.cellY = cellXY[1];  
  14.     cellInfo.cellHSpan = 1;  
  15.     cellInfo.cellVSpan = 1;  
  16.       
  17.     //这里需要计算哪些单元格被占用了   
  18.     final int xCount = mHCells; //TODO:没有考虑横竖屏的情况   
  19.     final int yCount = mVCells;  
  20.     final boolean[][] occupied = mOccupied;  
  21.     findOccupiedCells(xCount, yCount, occupied);  
  22.       
  23.     //判断当前位置是否有效,这里不用再判断cellXY是否越界,因为在pointToCellExact已经进行了处理   
  24.     cellInfo.valid = !occupied[cellXY[0]][cellXY[1]];  
  25.       
  26.     //这里其实我们需要以当前的cellInfo表示的单元格为中心,向四周递归开辟连续的最大空间   
  27.     //但是,这里还并不需要,只有当getTag()方法被调用的时候,才说明需要一块区域去放一个View   
  28.     //所以,将这个开辟的方法放在getTag()中调用   
  29.     //这里标记一下   
  30.     mTagFlag = true;  
  31. }  
  32.   
  33. //将位置信息保存在CellLayout的tag中   
  34. setTag(cellInfo);  


长按某个区域,我们记录下当前的位置信息,注意,我们是记录下当前事件所在的单元格,然后保存的是该单元格的信息,所以,上面调用了pointToCellExact这个方法来计算当前事件坐标落在哪个单元格内,并且调用了findOccupiedCells方法计算整个CellLayout上所有单元格的被占用情况。关于事件坐标到单元格的对应,计算并不困难,因为我们知道每个单元格的宽度和高度,同时知道当前的事件坐标,那么简单的除法就可以计算得到。

 

二、我们添加的item如何被添加到CellLayout上面

我们知道,要想绘制每个孩子自然在onLayout中调用每个孩子的layout方法,下面就看看这个方法的实现:

  1. protected void onLayout(boolean changed, int l, int t, int r, int b) {  
  2.     int count = getChildCount();  
  3.     for(int i=0; i<count; i++){  
  4.         View child = getChildAt(i);  
  5.         if(child.getVisibility() != GONE){  
  6.             LayoutParams lp = (LayoutParams)child.getLayoutParams();  
  7.             child.layout(lp.x, lp.y, lp.x+lp.width, lp.y+lp.height);  
  8.         }  
  9.     }  
  10. }  

注意,在该方法中每个孩子的布局,是按照他们自身的LayoutParams对象中保存的信息来布局到具体的位置的。那么接下来,我们就要分析下CellLayout中每个孩子的LayoutParams的结构。CellLayout中有个自定义的LayoutParams类,该类保存了该孩子所在的单元格信息和其真实的坐标位置,其含有一个set方法,在这个方法中计算了孩子的width,height,起始坐标x和y。

  1. public void set(int cellWidth, int cellHeight, int hStartPadding, int vStartPadding, int widthGap, int heightGap){  
  2.     //计算item的宽和高   
  3.     //这里计算的时候,注意是width,height是需要排除掉margin的   
  4.     this.width = cellHSpan*cellWidth+(cellHSpan-1)*widthGap-leftMargin-rightMargin;  
  5.     this.height = cellVSpan*cellHeight + (cellVSpan-1)*heightGap - topMargin - bottomMargin;  
  6.       
  7.     Log.v(TAG, "The width and height of the view are:"+this.width+","+this.height);  
  8.     //同时计算item的真实坐标   
  9.     //除去item的margin和padding,view开始的位置   
  10.     this.x = cellX*(cellWidth+widthGap)+leftMargin+hStartPadding;  
  11.     this.y = cellY*(cellHeight+heightGap)+topMargin+vStartPadding;  
  12.       
  13.     Log.v(TAG, "The x and y of the view are:"+this.x+","+this.y);  
  14. }  


这个时候,也就知道了,每个孩子的宽度和高度,以及如何在布局的时候根据其所在单元格信息,转换为其真实坐标。我们知道,控件的布局需要经过两个阶段,一个是measure,接下来就是layout。measure主要完成控件的测绘工作,计算每个控件绘制需要的空间信息,所以,在onMeasure中,自然可以看到给每个孩子测量大小的时候,就同时为其调用了set方法。如下:

  1. int count = getChildCount();  
  2. Log.v(TAG, "onMeasure 开始。。。");  
  3. for(int i=0; i<count; i++){  
  4.     //对每个子控件进行测量了   
  5.     View child = getChildAt(i);  
  6.     LayoutParams lp = (LayoutParams)child.getLayoutParams();  
  7.     //这里需要将我们计算的结果封装进LayoutParams中,供CellLayout在布局子控件的时候使用   
  8.     //这里横竖屏需要不同对待   
  9.     //TODO:暂时不考虑   
  10.     lp.set(mCellWidth, mCellHeight, mHStartPadding, mVStartPadding, mHCellGap, mVCellGap);  
  11.       
  12.     //下面将获取子控件的宽度和高度,并用MeasureSpec编码   
  13.     int cWidth = lp.width;  
  14.     int cHeight = lp.height;  
  15.     int cWidthSpec = MeasureSpec.makeMeasureSpec(cWidth, MeasureSpec.EXACTLY);  
  16.     int cHeightSpec = MeasureSpec.makeMeasureSpec(cHeight, MeasureSpec.EXACTLY);  
  17.     child.measure(cWidthSpec, cHeightSpec);  
  18. }  


到这里,关于CellLayout上面孩子的绘制工作就介绍完毕了。但是还没有说到,我们长按桌面的时候,怎样将我们选择的item给添加到桌面上来。这个就得再回到Launcher的onLongClick方法中,我们看下:

  1. if(!(v instanceof UorderCellLayout)){  
  2.     v = (View)v.getParent(); //如果当前点击的是item,得到其父控件,即UorderCellLayout   
  3. }  
  4.   
  5. CellInfo cellInfo = (CellInfo)v.getTag(); //这里获取cellInfo信息   
  6.   
  7. if(cellInfo == null){  
  8.     Log.v(TAG, "CellInfo is null");  
  9.     return true;  
  10. }  
  11.   
  12. //Log.v(TAG, ""+cellInfo.toString());   
  13.   
  14. if(cellInfo.view == null){  
  15.     //说明是空白区域   
  16.     //ActivityUtils.alert(getApplication(), "空白区域");   
  17.     Log.v(TAG, "onLongClick,cellInfo.valid:"+cellInfo.valid);  
  18.     if(cellInfo.valid){  
  19.         //如果是有效的区域   
  20.         //ActivityUtils.alert(getApplication(), "有效区域");   
  21.         addCellInfo = cellInfo;  
  22.         showPasswordDialog(REQUEST_CODE_SETUP, null);     
  23.     }  
  24. }else{  
  25.     mWorkspace.startDrag(cellInfo);  
  26. }  
  27. return true;  


我们看到在onLongClick中有CellInfo cellInfo = (CellInfo)v.getTag(); 这样,我们就知道,在上面onInterceptTouchEvent方法中我们将cellInfo放入tag是为了在CellLayout的getTag方法中,返回cellInfo信息。有了cellInfo信息,我们就可以调用CellLayout.addView方法将我们所选择的控件添加到桌面了。在Workspace类中,调用addInScreen方法设置其单元格信息,然后直接调用CellLayout.addView方法添加到CellLayout。

  1. public void addInScreen(View child, int screen, int cellX, int cellY, int spanX, int spanY, boolean insertFirst){  
  2.     if(screen<0 || screen >= getChildCount()){  
  3.         throw new IllegalArgumentException("The screen must be >= 0 and <"+getChildCount());  
  4.     }  
  5.     final UorderCellLayout group = getCellLayout(screen);  
  6.     UorderCellLayout.LayoutParams lp = (UorderCellLayout.LayoutParams)child.getLayoutParams();  
  7.       
  8.     //初始化当前需要添加的View在CellLayout中的布局参数   
  9.     if(lp == null){  
  10.         lp = new UorderCellLayout.LayoutParams(cellX, cellY, spanX, spanY);  
  11.     }else{  
  12.         lp.cellX = cellX;  
  13.         lp.cellY = cellY;  
  14.         lp.cellHSpan = spanX;  
  15.         lp.cellVSpan = spanY;  
  16.     }  
  17.       
  18.     Log.v(TAG, "Before add view on the screen");  
  19.     group.addView(child, insertFirst?0:-1, lp);  
  20.       
  21.     child.setOnLongClickListener(mOnLongClickListener);  
  22.     //child的onClickListener在创建出View的时候设置的,在Uorderlauncher中   
  23.       
  24. }  


上面,我们看到直接调用了group.addView方法,但是之前我们仅仅设置了child的LayoutParams中单元格信息,至于怎么根据这些信息得到其真实坐标,怎么布局,上面已经介绍了。

至此,CellLayout的大致就介绍完了。但是CellLayout还不至于如此简单。当我们添加的控件不止一个单元格那么大的时候,如何分配其空间,如果空间不够怎么处理等问题都是CellLayout需要考虑的问题。但是,我想有了上面的理解,这个也不是什么难题了...