android launcher folder功能详解

AndroidICS4.0的文件夹和2.3的文件夹区别比较大，主要区别有：
       一、android2.3的文件夹大小是固定的，4.0的文件夹大小是按照里面的元素大小决定的。

       二、android2.3的文件夹图标是固定的文件夹的形式展示的，而4.0是从文件中取前3个的缩略图垂直展示在屏幕上的。估计谷歌怕侵犯苹果文件夹的知识产权，所以没有做成和苹果一样的效果。

       三、android2.3的文件中可以放多于16的应用程序的快捷方式，而4.0最多只能放16个快捷方式。

       四、android2.3的文件夹中的图标不可以交换位置，而4.0的文件夹中的图标可以相互交换位置。

转载请标明出处：http://blog.csdn.net/love_xsq/article/details/51376334

 对比图如下：

                      android2.3的文件夹                                                                android4.0的文件夹

                   

                         


 

下面来看看4.0的代码怎么实现文件夹的：

 

Step 1：如果系统一开始有fold，一启动launcher的时候，在Launcher.Java类中bindFolders回调方法中：

[java]
view plain
copy
print?

/** 
    * Implementation of the method from LauncherModel.Callbacks. 
    */  
   public void bindFolders(HashMap<Long, FolderInfo> folders) {  
       setLoadOnResume();  
       sFolders.clear();  
       sFolders.putAll(folders);  
   }  

绑定所有fold的对象交给sFolders，去处理。

private static HashMap<Long, FolderInfo> sFolders = new HashMap<Long, FolderInfo>();

 

Step 2：如果是把一个图标拖放到另一图标上面，也形成folder。具体流程如下：

1、首先在workspace中的onDrop（）方法中会判断是否会形成一个fold。代码如下：

[java]
view plain
copy
print?

public void onDrop(DragObject d) {  
  
    ...  ...   
  
    // If the item being dropped is a shortcut and the nearest drop  
                // cell also contains a shortcut, then create a folder with the two shortcuts.  
                if (!mInScrollArea && createUserFolderIfNecessary(cell, container,  
                        dropTargetLayout, mTargetCell, false, d.dragView, null)) {  
                    return;  
                }  
  
    ... ...  
}  

2、在Workspace.java类的createUserFolderIfNecessary（）方法中来增加fold，具体代码如下：

[java]
view plain
copy
print?

boolean createUserFolderIfNecessary(View newView, long container, CellLayout target,  
            int[] targetCell, boolean external, DragView dragView, Runnable postAnimationRunnable) {  
  
    。。。 。。。  
 FolderIcon fi =  
                mLauncher.addFolder(target, container, screen, targetCell[0], targetCell[1]);  
            destInfo.cellX = -1;  
            destInfo.cellY = -1;  
            sourceInfo.cellX = -1;  
            sourceInfo.cellY = -1;  
  
  。。。 。。。  
}  

通过mLauncher.addFolder来传递folder的信息，包含一些位置信息绑定哪个屏幕的。

 

3、在Launcher.java类的addFolder（）这个方法是真正形成folder的，以及在launcher的数据库中插入一条信息，代码如下：

[java]
view plain
copy
print?

FolderIcon addFolder(CellLayout layout, long container, final int screen, int cellX,  
           int cellY) {  
       final FolderInfo folderInfo = new FolderInfo();  
       folderInfo.title = getText(R.string.folder_name);  
  
       // Update the model  
       LauncherModel.addItemToDatabase(Launcher.this, folderInfo, container, screen, cellX, cellY,  
               false);  
       sFolders.put(folderInfo.id, folderInfo);  
  
       // Create the view  
       FolderIcon newFolder =  
           FolderIcon.fromXml(R.layout.folder_icon, this, layout, folderInfo, mIconCache);  
       mWorkspace.addInScreen(newFolder, container, screen, cellX, cellY, 1, 1,  
               isWorkspaceLocked());  
       return newFolder;  
   }  

FolderIcon.fromXml（）这个方法是从xml中形成folder，addInScreen（），把相应的信息插入数据库。

 

4、在FolderIcon.java中fromXml（）方法中的代码如下：

 

[java]
view plain
copy
print?

static FolderIcon fromXml(int resId, Launcher launcher, ViewGroup group,  
            FolderInfo folderInfo, IconCache iconCache) {  
  
        if (INITIAL_ITEM_ANIMATION_DURATION >= DROP_IN_ANIMATION_DURATION) {  
            throw new IllegalStateException("DROP_IN_ANIMATION_DURATION must be greater than " +  
                    "INITIAL_ITEM_ANIMATION_DURATION, as sequencing of adding first two items " +  
                    "is dependent on this");  
        }  
  
        FolderIcon icon = (FolderIcon) LayoutInflater.from(launcher).inflate(resId, group, false);  
  
        icon.mFolderName = (BubbleTextView) icon.findViewById(R.id.folder_icon_name);  
        icon.mFolderName.setText(folderInfo.title);  
        icon.mPreviewBackground = (ImageView) icon.findViewById(R.id.preview_background);  
  
        icon.setTag(folderInfo);  
        icon.setOnClickListener(launcher);  
        icon.mInfo = folderInfo;  
        icon.mLauncher = launcher;  
        icon.setContentDescription(String.format(launcher.getString(R.string.folder_name_format),  
                folderInfo.title));  
        Folder folder = Folder.fromXml(launcher);  
        folder.setDragController(launcher.getDragController());  
        folder.setFolderIcon(icon);  
        folder.bind(folderInfo);  
        icon.mFolder = folder;  
  
        icon.mFolderRingAnimator = new FolderRingAnimator(launcher, icon);  
        folderInfo.addListener(icon);  
  
        return icon;  
    }  

     Folder folder = Folder.fromXml(launcher);是真正产生了一个folder对象。代码如下：

[java]
view plain
copy
print?

/** 
    * Creates a new UserFolder, inflated from R.layout.user_folder. 
    * 
    * @param context The application's context. 
    * 
    * @return A new UserFolder. 
    */  
   static Folder fromXml(Context context) {  
       return (Folder) LayoutInflater.from(context).inflate(R.layout.user_folder, null);  
   }  

 

并且给folder设置拖拽的控制器，绑定folderInfo设置folderInfo.addListener(icon)图标改变的监听。

这个接口 interface  FolderListener定义了一个方法---->如下：

[java]
view plain
copy
print?

interface FolderListener {  
     public void onAdd(ShortcutInfo item);  
     public void onRemove(ShortcutInfo item);  
     public void onTitleChanged(CharSequence title);  
     public void onItemsChanged();  
 }  

 

在folder.bind(folderInfo);方法中的操作如下：

 

[java]
view plain
copy
print?

void bind(FolderInfo info) {  
    mInfo = info;  
    ArrayList<ShortcutInfo> children = info.contents;  
    ArrayList<ShortcutInfo> overflow = new ArrayList<ShortcutInfo>();  
    setupContentForNumItems(children.size());  
    int count = 0;  
    for (int i = 0; i < children.size(); i++) {  
        ShortcutInfo child = (ShortcutInfo) children.get(i);  
        if (!createAndAddShortcut(child)) {  
            overflow.add(child);  
        } else {  
            count++;  
        }  
    }  
  
    // We rearrange the items in case there are any empty gaps  
    setupContentForNumItems(count);  
  
    // If our folder has too many items we prune them from the list. This is an issue   
    // when upgrading from the old Folders implementation which could contain an unlimited  
    // number of items.  
    for (ShortcutInfo item: overflow) {  
        mInfo.remove(item);  
        LauncherModel.deleteItemFromDatabase(mLauncher, item);  
    }  
  
    mItemsInvalidated = true;  
    updateTextViewFocus();  
    mInfo.addListener(this);  
  
    if (!sDefaultFolderName.contentEquals(mInfo.title)) {  
        mFolderName.setText(mInfo.title);  
    } else {  
        mFolderName.setText("");  
    }  
}  

主要的操作是：给拖拽进来的快捷方式安排位置，判断Folder是否已经放满，设置监听，设置folder的Name；

 

5、folder桌面的缩略图怎么形成的，是在第2步Workspace.java的createUserFolderIfNecessary（）方法中

[java]
view plain
copy
print?

// If the dragView is null, we can't animate  
            boolean animate = dragView != null;  
            if (animate) {  
                fi.performCreateAnimation(destInfo, v, sourceInfo, dragView, folderLocation, scale,  
                        postAnimationRunnable);  
            } else {  
                fi.addItem(destInfo);  
                fi.addItem(sourceInfo);  
            }  

fi.performCreateAnimation（）这个方法是给folder添加个动画。

 

6、在FolderIcon.java中的performCreateAnimation（）方法中：

[java]
view plain
copy
print?

public void performCreateAnimation(final ShortcutInfo destInfo, final View destView,  
           final ShortcutInfo srcInfo, final View srcView, Rect dstRect,  
           float scaleRelativeToDragLayer, Runnable postAnimationRunnable) {  
  
       Drawable animateDrawable = ((TextView) destView).getCompoundDrawables()[1];  
       computePreviewDrawingParams(animateDrawable.getIntrinsicWidth(), destView.getMeasuredWidth());  
  
       // This will animate the dragView (srcView) into the new folder  
       onDrop(srcInfo, srcView, dstRect, scaleRelativeToDragLayer, 1, postAnimationRunnable);  
  
       // This will animate the first item from it's position as an icon into its  
       // position as the first item in the preview  
       animateFirstItem(animateDrawable, INITIAL_ITEM_ANIMATION_DURATION);  
  
       postDelayed(new Runnable() {  
           public void run() {  
               addItem(destInfo);  
           }  
       }, INITIAL_ITEM_ANIMATION_DURATION);  
   }  

computePreviewDrawingParams（）这个方法是计算绘制folder图标的方法；

 

7、在FolderIcon.java类中的computePreviewItemDrawingParams（）方法中:

[java]
view plain
copy
print?

private PreviewItemDrawingParams computePreviewItemDrawingParams(int index,  
           PreviewItemDrawingParams params) {  
       index = NUM_ITEMS_IN_PREVIEW - index - 1;  
       float r = (index * 1.0f) / (NUM_ITEMS_IN_PREVIEW - 1);  
       float scale = (1 - PERSPECTIVE_SCALE_FACTOR * (1 - r));  
  
       float offset = (1 - r) * mMaxPerspectiveShift;  
       float scaledSize = scale * mBaselineIconSize;  
       float scaleOffsetCorrection = (1 - scale) * mBaselineIconSize;  
  
       // We want to imagine our coordinates from the bottom left, growing up and to the  
       // right. This is natural for the x-axis, but for the y-axis, we have to invert things.  
       float transY = mAvailableSpaceInPreview - (offset + scaledSize + scaleOffsetCorrection);  
       float transX = offset + scaleOffsetCorrection;  
       float totalScale = mBaselineIconScale * scale;  
       final int overlayAlpha = (int) (80 * (1 - r));  
  
       if (params == null) {  
           params = new PreviewItemDrawingParams(transX, transY, totalScale, overlayAlpha);  
       } else {  
           params.transX = transX;  
           params.transY = transY;  
           params.scale = totalScale;  
           params.overlayAlpha = overlayAlpha;  
       }  
       return params;  
   }  

主要工作是：计算图标的排列，每一个相对上一个有点偏移的距离；效果图如下：
                                                 


以上基本是把Step 2流程大致过了一遍。

 

Step 3：folder类中的长按事件的传递，以及Fold中长按交换位置的流程过一下：

1、先来说给Folder设置长按监听的地方，因为Folder.java类是继承了View.OnClickListener,

        View.OnLongClickListener事件，所以，长按事件就交给自己的onLongClick（）事件来处理。

 

2、所以Folder中的长按事件，被自己的public boolean onLongClick(View v) {}时间捕获，代码如下：

[java]
view plain
copy
print?

public boolean onLongClick(View v) {  
  
  ...  ...  
   mLauncher.getWorkspace().onDragStartedWithItem(v);  
            mLauncher.getWorkspace().beginDragShared(v, this);  
            mIconDrawable = ((TextView) v).getCompoundDrawables()[1];  
  
            mCurrentDragInfo = item;  
            mEmptyCell[0] = item.cellX;  
            mEmptyCell[1] = item.cellY;  
            mCurrentDragView = v;  
  
            mContent.removeView(mCurrentDragView);  
            mInfo.remove(mCurrentDragInfo);  
            mDragInProgress = true;  
            mItemAddedBackToSelfViaIcon = false;  
  
   ...  ...  
}  

同样拖拽事件是交给Workspace来处理，最后也是统一交给DragController.java类处理和分发相应的事件。这个过程在
Android-->Launcher拖拽事件详解【androidICS4.0--Launcher系列二】中做了详细的介绍，这里就不做赘述了。

 

3、主要看Folder.java类中的onDragOver（）这个方法，当在文件夹中拖拽到另一个快捷方式的上面的时候，发生交换，

来看代码如下：

[java]
view plain
copy
print?

public void onDragOver(DragObject d) {  
       float[] r = getDragViewVisualCenter(d.x, d.y, d.xOffset, d.yOffset, d.dragView, null);  
       mTargetCell = mContent.findNearestArea((int) r[0], (int) r[1], 1, 1, mTargetCell);  
       if (mTargetCell[0] != mPreviousTargetCell[0] || mTargetCell[1] != mPreviousTargetCell[1]) {  
           mReorderAlarm.cancelAlarm();  
           mReorderAlarm.setOnAlarmListener(mReorderAlarmListener);  
           mReorderAlarm.setAlarm(150);  
           mPreviousTargetCell[0] = mTargetCell[0];  
           mPreviousTargetCell[1] = mTargetCell[1];  
       }  
   }  

这个方法主要做的操作是：判断拖拽的是哪个对象mContent.findNearestArea((int) r[0], (int) r[1], 1, 1, mTargetCell);判断在

哪个目标的附近，然后判断和是否是正在拖拽的对象的坐标，设置mReorderAlarmListener来进行交换，设置150毫秒用来处理动画的。

 

4、在ReorderAlarmListener内部类的代码如下：

[java]
view plain
copy
print?

OnAlarmListener mReorderAlarmListener = new OnAlarmListener() {  
      public void onAlarm(Alarm alarm) {  
          realTimeReorder(mEmptyCell, mTargetCell);  
      }  
  };  

 

5、在realTimeReorder（）方法中传递这个快捷方式在屏幕x轴，y轴上的为止，进行交换,代码如下：

[java]
view plain
copy
print?

private void realTimeReorder(int[] empty, int[] target) {  
       boolean wrap;  
       int startX;  
       int endX;  
       int startY;  
       int delay = 0;  
       float delayAmount = 30;  
       if (readingOrderGreaterThan(target, empty)) {  
           wrap = empty[0] >= mContent.getCountX() - 1;  
           startY = wrap ? empty[1] + 1 : empty[1];  
           for (int y = startY; y <= target[1]; y++) {  
               startX = y == empty[1] ? empty[0] + 1 : 0;  
               endX = y < target[1] ? mContent.getCountX() - 1 : target[0];  
               for (int x = startX; x <= endX; x++) {  
                   View v = mContent.getChildAt(x,y);  
                   if (mContent.animateChildToPosition(v, empty[0], empty[1],  
                           REORDER_ANIMATION_DURATION, delay)) {  
                       empty[0] = x;  
                       empty[1] = y;  
                       delay += delayAmount;  
                       delayAmount *= 0.9;  
                   }  
               }  
           }  
       } else {  
           wrap = empty[0] == 0;  
           startY = wrap ? empty[1] - 1 : empty[1];  
           for (int y = startY; y >= target[1]; y--) {  
               startX = y == empty[1] ? empty[0] - 1 : mContent.getCountX() - 1;  
               endX = y > target[1] ? 0 : target[0];  
               for (int x = startX; x >= endX; x--) {  
                   View v = mContent.getChildAt(x,y);  
                   if (mContent.animateChildToPosition(v, empty[0], empty[1],  
                           REORDER_ANIMATION_DURATION, delay)) {  
                       empty[0] = x;  
                       empty[1] = y;  
                       delay += delayAmount;  
                       delayAmount *= 0.9;  
                   }  
               }  
           }  
       }  
   }  

readingOrderGreaterThan（）这个方法的作用是判断是从上往下拖动，还是从下往上拖动，这两种情况的交换方式不一样。循环也就不一样。交换的过程中通过animateChildToPosition（）；这个方法设置了一个动画。

 

6、在放下的时候会触发Folder.java的onDrop（）方法，

[java]
view plain
copy
print?

public void onDrop(DragObject d) {  
       ShortcutInfo item;  
  
  。。。  。。。  
f (d.dragView.hasDrawn()) {  
               mLauncher.getDragLayer().animateViewIntoPosition(d.dragView, mCurrentDragView);  
           } else {  
               mCurrentDragView.setVisibility(VISIBLE);  
           }  
  
 mInfo.add(item); 。。。  。。。   

作用是设置放下的view可见，把当前的这个快捷方式添加到mInfo中。

 

7、当执行完onDrop（）方法后会走onDropCompleted（）方法:

[java]
view plain
copy
print?

public void onDropCompleted(View target, DragObject d, boolean success) {  
  ... ...  
 // Reordering may have occured, and we need to save the new item locations. We do this once  
        // at the end to prevent unnecessary database operations.  
        updateItemLocationsInDatabase();  
  ...  ...  
}  

这个方法的作用是更新item的位置信息在数据库中。

[java]
view plain
copy
print?

private void updateItemLocationsInDatabase() {  
        ArrayList<View> list = getItemsInReadingOrder();  
        for (int i = 0; i < list.size(); i++) {  
            View v = list.get(i);  
            ItemInfo info = (ItemInfo) v.getTag();  
            LauncherModel.moveItemInDatabase(mLauncher, info, mInfo.id, 0,  
                        info.cellX, info.cellY);  
        }  
    }  

好了，folder的大致流程就是这些，更详细的请参考launcher源代码。