Launcher3--抽屉

抽屉是用来放置安卓手机中所有需要显示到Launcher上的(当然也可以进行过滤，将不想显示的隐藏起来)应用和小部件，启动应用、添加快捷方式到桌面、卸载等。之前也提到过，有些Launcher是没有抽屉的，如MIUI的Launcher。在Launcher3中，默认是有的，当然，也提供了不显示抽屉的方法，这个后面会说到，在此先了解下抽屉。

一、布局

抽屉的布局文件是apps_customize_pane.xml，被include在launcher.xml中， launcher.xml

        <include layout="@layout/apps_customize_pane"
            android:id="@+id/apps_customize_pane"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:visibility="invisible" />

apps_customize_pane.xml

<com.android.launcher3.AppsCustomizeTabHost
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:launcher="http://schemas.android.com/apk/res-auto"
    android:clipChildren="false">
 
    <LinearLayout
        android:id="@+id/content"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:clipChildren="false"
        android:orientation="vertical">
 
        <FrameLayout
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"
            android:clipChildren="false">
            <FrameLayout
                android:id="@+id/fake_page_container"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:clipChildren="false"
                android:clipToPadding="false">
                <FrameLayout
                    android:id="@+id/fake_page"
                    android:layout_width="match_parent"
                    android:layout_height="match_parent"
                    android:visibility="invisible"
                    android:clipToPadding="false" />
            </FrameLayout>
            <com.android.launcher3.AppsCustomizePagedView
                android:id="@+id/apps_customize_pane_content"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                launcher:widgetCountX="@integer/apps_customize_widget_cell_count_x"
                launcher:widgetCountY="@integer/apps_customize_widget_cell_count_y"
                launcher:maxGap="@dimen/workspace_max_gap"
                launcher:pageIndicator="@+id/apps_customize_page_indicator" />
        </FrameLayout>
        <include
            android:id="@+id/apps_customize_page_indicator"
            layout="@layout/page_indicator"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center" />
    </LinearLayout>
</com.android.launcher3.AppsCustomizeTabHost>

这个就是抽屉的树形结构， AppsCustomizeTabHost 是根视图， id/content 是内容区域，包含一个 FrameLayout和页面指示器indicator，这个 FrameLayout也包含两块，上面一块是用作过渡页面，下面是 AppsCustomizePagedView，就是用来显示app列表或小部件的，是最核心的部分。

二、数据加载和显示

首先需要弄清楚的是，并不是我们点击了抽屉按钮进入抽屉页才开始加载数据的，我们之前分析了<<Launcher3的加载流程>>，知道这些数据在Launcher启动过程中就加载了。这个也很好理解，Android系统中安装了很多应用，如果每次打开抽屉都要加载数据，那可想而知是多么糟糕的体验。 这部分的数据加载就是在<<Launcher3的加载流程>>中分析的loadAndBindAllApps过程，此过程已将应用数据保存到数据库中，并且设置到AppsCustomizePagedView中，详细过程就不在介绍了。很明显，这个时候要做的就是将其显示，并将Workspace隐藏。 进入抽屉的途径一个是点击桌面抽屉按钮图标，另一个是长按桌面选择小部件按钮，这两个操作其实进入的是同一个界面，只不过是根据操作的不同选择加载应用还是小部件，那我们就以显示应用列表来分析。

    public void onClick(View v) {
        .............
        } else if (v == mAllAppsButton) {// 抽屉按钮
            onClickAllAppsButton(v);
        } else if (tag instanceof AppInfo) {// 应用列表中的应用
         ............
    }

    protected void onClickAllAppsButton(View v) {
        if (LOGD) Log.d(TAG, "onClickAllAppsButton");
        // copy db
        CommonUtil.copyDBToSDcard();
        // end
        if (isAllAppsVisible()) {// 抽屉页面是否可见，实际情况在抽屉页时，不会显示按钮
            showWorkspace(true);
        } else {
            showAllApps(true, AppsCustomizePagedView.ContentType.Applications, false);
        }
        if (mLauncherCallbacks != null) {
            mLauncherCallbacks.onClickAllAppsButton(v);
        }
    }

这里根据抽屉页是否可见来确定是显示Workspace还是抽屉，但在实际情况中抽屉中不会显示抽屉按钮，所以也就不可能执行到 showWorkspace 这个方法中。直接看 showAllApps 方法，

    void showAllApps(boolean animated, AppsCustomizePagedView.ContentType contentType,
                     boolean resetPageToZero) {
        if (mState != State.WORKSPACE) return;
 
        if (resetPageToZero) {// 是否需要恢复到首页
            mAppsCustomizeTabHost.reset();
        }
        showAppsCustomizeHelper(animated, false, contentType);
        mAppsCustomizeTabHost.post(new Runnable() {
            @Override
            public void run() {
                // We post this in-case the all apps view isn't yet constructed.
                mAppsCustomizeTabHost.requestFocus();// 给抽屉界面焦点
            }
        });
 
        // Change the state *after* we've called all the transition code
        mState = State.APPS_CUSTOMIZE;// 更新页面状态未APPS_CUSTOMIZE
 
        // Pause the auto-advance of widgets until we are out of AllApps
        mUserPresent = false;
        updateRunning();
        closeFolder();// 关闭文件夹
 
        // Send an accessibility event to announce the context change
        getWindow().getDecorView().sendAccessibilityEvent(AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED);
    }

这里面调用了 showAppsCustomizeHelper方法， 这是显示抽屉的的一个帮助方法，与此方法对应的是 hideAppsCustomizeHelper 方法，很显然使用隐藏抽屉时调用的，这两个方法实现很相似，我们这里只分析showAppsCustomizeHelper。

        if (mStateAnimation != null) {// 重置mStateAnimation
            mStateAnimation.setDuration(0);
            mStateAnimation.cancel();
            mStateAnimation = null;
        }

重置 AnimatorSet，其实这个方法里面最主要就是实现各种动画效果，Workspace上的动画、抽屉上的动画。

        boolean material = Utilities.isLmpOrAbove();// sdk版本是否大于等于21
 
        final Resources res = getResources();
 
        // 定义了一些动画时长
        final int duration = res.getInteger(R.integer.config_appsCustomizeZoomInTime);
        final int fadeDuration = res.getInteger(R.integer.config_appsCustomizeFadeInTime);
        final int revealDuration = res.getInteger(R.integer.config_appsCustomizeRevealTime);
        final int itemsAlphaStagger = res.getInteger(R.integer.config_appsCustomizeItemsAlphaStagger);
 
        final float scale = (float) res.getInteger(R.integer.config_appsCustomizeZoomScaleFactor);//缩放大小
        // 从Workspace切换到AppsCustomizeTabHost
        final View fromView = mWorkspace;
        final AppsCustomizeTabHost toView = mAppsCustomizeTabHost;
 
        final ArrayList<View> layerViews = new ArrayList<View>();// DragLayer上的View列表

定义了一些变量， material来判断sdk版本，后面会根据这个布尔变量来进行不同的动画设置，在Android L及以上采用了material design，所有在较高的版本上可以有一些更好的动画效果。然后还定义动画时长，缩放比例等。

        Workspace.State workspaceState = contentType == AppsCustomizePagedView.ContentType.Widgets ?
                Workspace.State.OVERVIEW_HIDDEN : Workspace.State.NORMAL_HIDDEN;
        Animator workspaceAnim = mWorkspace.getChangeStateAnimation(workspaceState, animated, layerViews);// 定义切换时Workspace上的动画
        // 设置加载的数据类型
        if (!LauncherAppState.isDisableAllApps() || contentType == AppsCustomizePagedView.ContentType.Widgets) {
            // Set the content type for the all apps/widgets space
            mAppsCustomizeTabHost.setContentTypeImmediate(contentType);
        }

设置加载内容的类型，有两种类型：application和widget，这里是application类型。

        // If for some reason our views aren't initialized, don't animate
        boolean initialized = getAllAppsButton() != null;// 是否初始化完成

    animated && initialized

来判断是否实现动画效果，我们直接看动画是怎么实现的。

            mStateAnimation = LauncherAnimUtils.createAnimatorSet();// 创建AnimatorSet
            final AppsCustomizePagedView content = (AppsCustomizePagedView)
                    toView.findViewById(R.id.apps_customize_pane_content);// 抽屉内容组件
 
            final View page = content.getPageAt(content.getCurrentPage());// 抽屉当前页
            final View revealView = toView.findViewById(R.id.fake_page);// 一个过渡页面，用来实现动画
 
            final boolean isWidgetTray = contentType == AppsCustomizePagedView.ContentType.Widgets;
            // 设置过渡页面的背景，根据类型分别设置
            if (isWidgetTray) {
                revealView.setBackground(res.getDrawable(R.drawable.quantum_panel_dark));
            } else {
                revealView.setBackground(res.getDrawable(R.drawable.quantum_panel));
            }

初始化抽屉页面的组件，其中 revealView 是一个过渡页，用来实现动画效果的，动画结束后将其隐藏。

            // 先隐藏真实页面，显示过渡页面
            // Hide the real page background, and swap in the fake one
            content.setPageBackgroundsVisible(false);
            revealView.setVisibility(View.VISIBLE);
            // We need to hide this view as the animation start will be posted.
            // alpha置为0
            revealView.setAlpha(0);
 
            int width = revealView.getMeasuredWidth();
            int height = revealView.getMeasuredHeight();
            float revealRadius = (float) Math.sqrt((width * width) / 4 + (height * height) / 4);
 
            // 偏移量置为0
            revealView.setTranslationY(0);
            revealView.setTranslationX(0);
 
            // Get the y delta between the center of the page and the center of the all apps button
            int[] allAppsToPanelDelta = Utilities.getCenterDeltaInScreenSpace(revealView,
                    getAllAppsButton(), null);
 
            float alpha = 0;
            float xDrift = 0;
            float yDrift = 0;
            if (material) {// sdk > 21 ?
                alpha = isWidgetTray ? 0.3f : 1f;
                yDrift = isWidgetTray ? height / 2 : allAppsToPanelDelta[1];
                xDrift = isWidgetTray ? 0 : allAppsToPanelDelta[0];
            } else {
                yDrift = 2 * height / 3;
                xDrift = 0;
            }
            final float initAlpha = alpha;

动画设置之前的一些初始化工作，将过渡页面的透明度、偏移量都先置0，然后设置动画时的透明度初始值和偏移量的初始值。

            revealView.setLayerType(View.LAYER_TYPE_HARDWARE, null);
            layerViews.add(revealView);
            PropertyValuesHolder panelAlpha = PropertyValuesHolder.ofFloat("alpha", initAlpha, 1f);
            PropertyValuesHolder panelDriftY = PropertyValuesHolder.ofFloat("translationY", yDrift, 0);
            PropertyValuesHolder panelDriftX = PropertyValuesHolder.ofFloat("translationX", xDrift, 0);
 
            ObjectAnimator panelAlphaAndDrift = ObjectAnimator.ofPropertyValuesHolder(revealView,
                    panelAlpha, panelDriftY, panelDriftX);
 
            panelAlphaAndDrift.setDuration(revealDuration);
            panelAlphaAndDrift.setInterpolator(new LogDecelerateInterpolator(100, 0));
 
            mStateAnimation.play(panelAlphaAndDrift);

定义了动画的类型、时长和变化速率等。这是一个组合动画，很明显动画效果是透明度的变化和偏移量的变化。

            // 抽屉当前页的动画
            if (page != null) {
                page.setVisibility(View.VISIBLE);
                page.setLayerType(View.LAYER_TYPE_HARDWARE, null);
                layerViews.add(page);
 
                ObjectAnimator pageDrift = ObjectAnimator.ofFloat(page, "translationY", yDrift, 0);
                page.setTranslationY(yDrift);
                pageDrift.setDuration(revealDuration);
                pageDrift.setInterpolator(new LogDecelerateInterpolator(100, 0));
                pageDrift.setStartDelay(itemsAlphaStagger);
                mStateAnimation.play(pageDrift);
 
                page.setAlpha(0f);
                ObjectAnimator itemsAlpha = ObjectAnimator.ofFloat(page, "alpha", 0f, 1f);
                itemsAlpha.setDuration(revealDuration);
                itemsAlpha.setInterpolator(new AccelerateInterpolator(1.5f));
                itemsAlpha.setStartDelay(itemsAlphaStagger);
                mStateAnimation.play(itemsAlpha);
            }

这一段是抽屉当前页的动画效果，也是用属性动画来实现的，关于属性动画的使用可参考<<属性动画之ObjectAnimator>>。 然后是页面指示器和sdk>21的动画，这个就不再细说了，到动画监听，

            mStateAnimation.addListener(new AnimatorListenerAdapter() {
                @Override
                public void onAnimationEnd(Animator animation) {
                    dispatchOnLauncherTransitionEnd(fromView, animated, false);
                    dispatchOnLauncherTransitionEnd(toView, animated, false);
 
                    // 隐藏过渡页面
                    revealView.setVisibility(View.INVISIBLE);
                    revealView.setLayerType(View.LAYER_TYPE_NONE, null);
                    if (page != null) {
                        page.setLayerType(View.LAYER_TYPE_NONE, null);
                    }
                    // 显示抽屉
                    content.setPageBackgroundsVisible(true);
 
                    // Hide the search bar
                    // 隐藏搜索栏
                    if (mSearchDropTargetBar != null) {
                        mSearchDropTargetBar.hideSearchBar(false);
                    }
 
                    // This can hold unnecessary references to views.
                    mStateAnimation = null;
                }
 
            });

动画结束后：隐藏过渡页面；显示抽屉内容；隐藏搜索栏。

            // Workspace动画效果
            if (workspaceAnim != null) {
                mStateAnimation.play(workspaceAnim);
            }

这个是Workspace的动画，该动画定义在Workspace.java的getChangeStateAnimation方法中，该方法定义了多种情况下的动画效果，如Workspace到桌面缩略图、桌面缩略图到Workspace、Workspace到抽屉等等，进行alpha、scale等设置。 最后定义一个runnable执行块，用于动画播放，

            final Runnable startAnimRunnable = new Runnable() {
                public void run() {
                    // Check that mStateAnimation hasn't changed while
                    // we waited for a layout/draw pass
                    if (mStateAnimation != stateAnimation)
                        return;
                    dispatchOnLauncherTransitionStart(fromView, animated, false);
                    dispatchOnLauncherTransitionStart(toView, animated, false);
 
                    revealView.setAlpha(initAlpha);
                    if (Utilities.isLmpOrAbove()) {// sdk > 21 ?
                        for (int i = 0; i < layerViews.size(); i++) {
                            View v = layerViews.get(i);
                            if (v != null) {
                                if (Utilities.isViewAttachedToWindow(v)) v.buildLayer();
                            }
                        }
                    }
                    mStateAnimation.start();// 执行动画
                }
            };

这样动画结束后，抽屉就显示出来，该隐藏的也隐藏了。如果是没有动画的情况，直接设为可见就行了，但会显得比较突兀，体验差了点。 另外，在该方法中，多次调用了 dispatchOnLauncherTransitionXXX方法，最终调用View中实现了 LauncherTransitionable页面过渡接口的方法，在切换的不同阶段做相应的处理。

interface LauncherTransitionable {
    View getContent();
    void onLauncherTransitionPrepare(Launcher l, boolean animated, boolean toWorkspace);
    void onLauncherTransitionStart(Launcher l, boolean animated, boolean toWorkspace);
    void onLauncherTransitionStep(Launcher l, float t);
    void onLauncherTransitionEnd(Launcher l, boolean animated, boolean toWorkspace);
}

三、自定义修改

1、如何更换抽屉背景？ Launcher3中，抽屉内容的背景默认是白色的，如果想改成透明的，该怎么修改？ 一般情况下，我们首先想到的是在布局文件中找到AppsCustomizePagedView的布，然后将背景设为透明的，

            <com.android.launcher3.AppsCustomizePagedView
                android:id="@+id/apps_customize_pane_content"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                launcher:widgetCountX="@integer/apps_customize_widget_cell_count_x"
                launcher:widgetCountY="@integer/apps_customize_widget_cell_count_y"
                launcher:maxGap="@dimen/workspace_max_gap"
                launcher:pageIndicator="@+id/apps_customize_page_indicator" />

这个方法显然是不能实现的，因为 在 AppsCustomizePagedView中还有一层 AppsCustomizeCellLayout ，一个列表页就是一个AppsCustomizeCellLayout，在<<Launcher3的加载流程>>中，有提到过对每一页的设置，直接找出这部分代码， launcher3\src\main\java\com\android\launcher3\AppsCustomizePagedView.java

    // 设置page的表格、背景色
    private void setupPage(AppsCustomizeCellLayout layout) {
        layout.setGridSize(mCellCountX, mCellCountY);// 设置页面表格数
 
        // Note: We force a measure here to get around the fact that when we do layout calculations
        // immediately after syncing, we don't have a proper width.  That said, we already know the
        // expected page width, so we can actually optimize by hiding all the TextView-based
        // children that are expensive to measure, and let that happen naturally later.
        setVisibilityOnChildren(layout, View.GONE);
        int widthSpec = MeasureSpec.makeMeasureSpec(mContentWidth, MeasureSpec.AT_MOST);
        int heightSpec = MeasureSpec.makeMeasureSpec(mContentHeight, MeasureSpec.AT_MOST);
        layout.measure(widthSpec, heightSpec);
 
        // 设置page背景色
        Drawable bg = getContext().getResources().getDrawable(R.drawable.quantum_panel);
        if (bg != null) {
            bg.setAlpha(mPageBackgroundsVisible ? 255: 0);
            layout.setBackground(bg);
        }
 
        setVisibilityOnChildren(layout, View.VISIBLE);
    }

这里设置了 AppsCustomizeCellLayout 的背景色，我们将其设置透明背景，看能否达到效果。

        // 设置page背景色
//        Drawable bg = getContext().getResources().getDrawable(R.drawable.quantum_panel);
//        if (bg != null) {
//            bg.setAlpha(mPageBackgroundsVisible ? 255: 0);
//            layout.setBackground(bg);
//        }
        layout.setBackgroundColor(Color.TRANSPARENT);

这样就满足了效果，但是文字是灰色的有些不协调，我们改成白色的，这个在 syncAppsPageItems 方法中，做如下修改，

        for (int i = startIndex; i < endIndex; ++i) {// 循环添加items
            AppInfo info = mApps.get(i);
            BubbleTextView icon = (BubbleTextView) mLayoutInflater.inflate(R.layout.apps_customize_application, layout, false);
            icon.applyFromApplicationInfo(info);
            icon.setOnClickListener(mLauncher);
            icon.setOnLongClickListener(this);
            icon.setOnTouchListener(this);
            icon.setOnKeyListener(this);
            icon.setOnFocusChangeListener(layout.mFocusHandlerView);
            icon.setTextColor(Color.WHITE); // modify text color
 
            .................................
        }

2、如何改变行和列数？ 可能已经注意到了，在布局文件中通过launcher:widgetCountX，launcher:widgetCountY来设置小部件没有显示数量，之所以可以这么设置，是因为在AppsCustomizePagedView中定义了这两个属性。

        // Save the default widget preview background
        TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.AppsCustomizePagedView, 0, 0);
        mWidgetCountX = a.getInt(R.styleable.AppsCustomizePagedView_widgetCountX, 2);
        mWidgetCountY = a.getInt(R.styleable.AppsCustomizePagedView_widgetCountY, 2);

但对于application而言，并没有定义类似的属性，那如何来改变行列数呢?首先得知道行和列是怎么得到的。mCellCountX和mCellCountY这两个变量分别代表行数和列数，它们的值是怎么得到的呢？

    protected void onDataReady(int width, int height) {
        // Now that the data is ready, we can calculate the content width, the number of cells to
        // use for each page
        LauncherAppState app = LauncherAppState.getInstance();
        DeviceProfile grid = app.getDynamicGrid().getDeviceProfile();
        mCellCountX = (int) grid.allAppsNumCols;
        mCellCountY = (int) grid.allAppsNumRows;
        .....................................
    }

跟allAppsNumCols和allAppsNumRows相关，这两个值在DeviceProfile.java中定义的，

    private void updateIconSize(float scale, int drawablePadding, Resources resources,
                                DisplayMetrics dm) {
        ...................
        // All Apps
        allAppsCellWidthPx = allAppsIconSizePx;
        allAppsCellHeightPx = allAppsIconSizePx + drawablePadding + iconTextSizePx;
        int maxLongEdgeCellCount =
                resources.getInteger(R.integer.config_dynamic_grid_max_long_edge_cell_count);
        int maxShortEdgeCellCount =
                resources.getInteger(R.integer.config_dynamic_grid_max_short_edge_cell_count);
        int minEdgeCellCount =
                resources.getInteger(R.integer.config_dynamic_grid_min_edge_cell_count);
        int maxRows = (isLandscape ? maxShortEdgeCellCount : maxLongEdgeCellCount);
        int maxCols = (isLandscape ? maxLongEdgeCellCount : maxShortEdgeCellCount);
 
        if (allAppsShortEdgeCount > 0 && allAppsLongEdgeCount > 0) {
            allAppsNumRows = isLandscape ? allAppsShortEdgeCount : allAppsLongEdgeCount;
            allAppsNumCols = isLandscape ? allAppsLongEdgeCount : allAppsShortEdgeCount;
        } else {
            allAppsNumRows = (availableHeightPx - pageIndicatorHeightPx) /
                    (allAppsCellHeightPx + allAppsCellPaddingPx);
            allAppsNumRows = Math.max(minEdgeCellCount, Math.min(maxRows, allAppsNumRows));
            allAppsNumCols = (availableWidthPx) /
                    (allAppsCellWidthPx + allAppsCellPaddingPx);
            allAppsNumCols = Math.max(minEdgeCellCount, Math.min(maxCols, allAppsNumCols));
        }
    }

我们可以看到行列数并不是固定的，是根据配置的行列数、图标大小、表格间距等计算出来的。如果我们想增加行列数，可以把图标缩小、间距加大，反之可以减小行列数。

Launcher3根据不同的型号的手机加载不同的配置项，launcher3\src\main\java\com\android\launcher3\DynamicGrid.java，

        deviceProfiles.add(new DeviceProfile("Nexus 4",
                335, 567,  4, 4,  DEFAULT_ICON_SIZE_DP, 13, (hasAA ? 5 : 5), 56, R.xml.default_workspace_4x4));
        deviceProfiles.add(new DeviceProfile("Nexus 5",
                359, 567,  4, 4,  DEFAULT_ICON_SIZE_DP, 13, (hasAA ? 5 : 5), 56, R.xml.default_workspace_4x4));

我用的测试机是Nexus 5，但实际使用的配置却是上面那个，这个我们就不管了。一共有十个参数，分别表示：设备名、最小宽度Dps、最小高度Dps、行数、列数、图标大小、图标字体大小、固定热键数目(Hotseat)、固定热键图标大小、默认Workspace布局。

我们先将四列改成五列，

        deviceProfiles.add(new DeviceProfile("Nexus 4",
                335, 567,  4, 5,  DEFAULT_ICON_SIZE_DP, 13, (hasAA ? 5 : 5), 56, R.xml.default_workspace_4x4));

测试后好像没什么变化，我们把图标再改小点，默认60，改成48，

static float DEFAULT_ICON_SIZE_DP = 48;

我们可以看到变成5列了，但是也变成6行了，我们在把最大行数设为5，原来是6，launcher3\src\main\res\values\config.xml，

<integer name="config_dynamic_grid_max_long_edge_cell_count">6</integer>

这样就变成5行5列了，但是看上去不大协调，目前我的测试机还是适合5*4，这里我们只是了解下怎么修改。

当然，除了背景、行列数可以改变外，我们也可以更改动画效果，这里就不在赘述了。

原文链接：blog.csdn.net/dingfengnup…