Android开发技巧——实现可复用的ActionSheet菜单

在上一篇《Android开发技巧——使用Dialog实现仿QQ的ActionSheet菜单》中，讲了这种菜单的实现过程，接下来将把它改成一个可复用的控件库。

本文原创，转载请注明出处：

http://blog.csdn.net/maosidiaoxian/article/details/46324941

对于要实现的可复用的控件库，我需要它具备以下两点：

1. 可添加远程依赖（不考虑Eclipse中的使用）
2. 可灵活配置

分离库的实现代码

对于第一点，需要做的就是在Android Studio中新建一个library的module，然后把相关的实现代码，资源分离出来拖过去，并且把library中如图标，一些字符串等没有用到的资源删掉，保持AndroidManifest.xml的干净（仅保留会用到的权限，声明等）。在这里，我们library的AndroidManifest最终只剩下了：

<manifest
    package="com.githang.android.actionsheet">

    <application/>

</manifest>

注意，application节点里 的allowBackup属性要去掉，不然会让一些不知道怎么用tools中的几个属性来解决冲突的人，面对AndroidManifest.xml的合并冲突不知所措。label和icon属性在这里也不需要，所以也去掉了。

然后把一开始创建的app module的包名加上.demo后缀，把com.githang.andorid.actionsheet仅作为我们的library的包名（这个是纯属个人习惯，你也可以不这么做。我是觉得在包名上把library和demo区分来比较好，而我又不想给library加多一个.library的包。

分离完之后的项目是这样的：

https://github.com/msdx/ActionSheet/commit/934b73bc3e2d1504c9b13e87649ce388c59f4613

分离之后，就可以把我们的库打包成aar，并上传到jcenter，让别人能以添加远程依赖的方式来使用了。如何发布到jcenter，可以见我这篇博客：《使用Gradle发布Android开源项目到JCenter》。

但是现在，我们仅完成的最基本的工作，因为，你不能要求每个人对一个库的要求都和你完全一样，可能有些人的需求中，需要改一下UI上的一些属性什么的。所以接下来，我们需要让我们的库能够灵活配置。

可自由配置的属性

我们的大部分属性是定义在xml中的。要改动这些属性，方法主要有两种：

1. 在Java代码中提供一些View的UI上的接口，让第三方通过调用它来设置。

2. 布局文件中使用属性的引用，而不是直接使用它的值。

如果你写的是自定义控件（通过继承View），那么你可能还需要自定义一些属性，让别人在使用的时候可以在xml中添加。由于这里我们写的不是这类控件，不需要用到它，在这里就不赘述了。

继续说上面的两种方法。Android中，采用xml定义布局，就是想让布局代码与逻辑代码相分离，所以第一种方式我是尽量少用的（在需要动态设置，或者是在Java代码中设置更简单时使用，）。下面先说一下第二种的方式的实现过程。

我们在xml中定义到的控件有三个，一是ListView，二是Button，三是ListView的Item。所以首先，在values文件夹里新建一个attrs.xml的属性文件，在里面分别定义三个属性，format是reference。如下：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <attr name="ActionSheetList" format="reference"/>
    <attr name="ActionSheetCancel" format="reference"/>
    <attr name="ActionSheetItem" format="reference"/>
</resources>

接着，把之前写的布局文件改为使用?attr的方式声明属性。

menu_item.xml

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
          android:id="@android:id/text1"
          style="?attr/ActionSheetItem" />

dialog_action_sheet.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:orientation="vertical">

    <ListView
        android:id="@+id/menu_items"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        style="?attr/ActionSheetList"
        android:listSelector="@android:color/transparent"/>

    <Button
        android:id="@+id/menu_cancel"
        style="?attr/ActionSheetCancel"/>
</LinearLayout>

然后在我们的style中声明这几个属性的style：

    <style name="ActionSheetList">
        <item name="android:divider">#c9dddddd</item>
        <item name="android:dividerHeight">1px</item>
    </style>
    <style name="ActionSheetItem">
        <item name="android:layout_width">match_parent</item>
        <item name="android:layout_height">45dp</item>
        <item name="android:textSize">18sp</item>
        <item name="android:gravity">center</item>
        <item name="android:textColor">@color/menu_text</item>
    </style>
    <style name="ActionSheetCancel" parent="ActionSheetItem">
        <item name="android:layout_marginTop">8dp</item>
        <item name="android:layout_marginBottom">8dp</item>
        <item name="android:background">@drawable/menu_item_single</item>
    </style>

注意，这里的style的名称并不要求与attr中声明的名称一致，这里我只是懒得想其他名字，真的。

这样做了之后，其他人在使用的时候，会需要多一个步骤：在他的styler中的AppTheme（具体视androidmanifest中指定的theme而定）节点中，需要添加以下几项：

    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="ActionSheetList">@style/ActionSheetList</item>
        <item name="ActionSheetItem">@style/ActionSheetItem</item>
        <item name="ActionSheetCancel">@style/ActionSheetCancel</item>
    </style>

如果他想自己修改属性的值，只需要写对应的style，然后把上面的item里的值改为他写的style即可。

对于菜单的改动，我们就改到这里。

接下来是对ActionSheetDialog的重构，让它提供可以进行以下设置的API：

• 设置显示与隐藏时的动画
• 设置菜单的背景

首先是菜单的背景，上文已经说过它一共有四个背景。所以定义一个菜单背景的类：

    /**
     * 菜单背景
     */
    public static class MenuBackground {
        public int top;
        public int middle;
        public int bottom;
        public int single;

        public MenuBackground() {}

        public MenuBackground(int top, int middle, int bottom, int single) {
            this.top = top;
            this.middle = middle;
            this.bottom = bottom;
            this.single = single;
        }
    }

然后定义一个菜单背景的对象，给它初始值，并定义一个设置背景的方法：

    private MenuBackground mMenuBg = new MenuBackground(R.drawable.menu_item_top,
            R.drawable.menu_item_middle, R.drawable.menu_item_bottom, R.drawable.menu_item_single);

    public void setMenuBackground(int top, int middle, int bottom, int single) {
        mMenuBg.top = top;
        mMenuBg.middle = middle;
        mMenuBg.bottom = bottom;
        mMenuBg.single = single;
    }

最后剩下动画的配置的。定义分别设置显示及隐藏动画的两个方法，注意，对隐藏动画的方法中，要设置动画结束的回调，在这里隐藏我们的菜单。

动画设置的代码重构如下：

    private void initAnim(Context context) {
        setShowAnimation(AnimationUtils.loadAnimation(context, R.anim.translate_up));
        setDismissAnimation(AnimationUtils.loadAnimation(context, R.anim.translate_down));
    }

    /**
     * @param animation Showing animation.
     * @since 0.2
     */
    public void setShowAnimation(Animation animation) {
        mShowAnim = animation;
    }

    /**
     * @param animation Dismissing animation.
     * @since 0.2
     */
    public void setDismissAnimation(Animation animation) {
        mDismissAnim = animation;
        mDismissAnim.setAnimationListener(new Animation.AnimationListener() {
            @Override
            public void onAnimationStart(Animation animation) {

            }

            @Override
            public void onAnimationEnd(Animation animation) {
                dismissMe();
            }

            @Override
            public void onAnimationRepeat(Animation animation) {

            }
        });
    }

现在我们的库已经重构完了，它暴露了适当的API，以让其他人可以自定义一些属性。它也对布局文件的配置提供了方法，即通过style来进行配置。

最后就是升版本号，改README，发布新版本了，打TAG了。

项目最后如下：

https://github.com/msdx/ActionSheet/tree/0.2