当前位置: 代码迷 >> Android >> Android开发技艺——实现可复用的ActionSheet菜单
  详细解决方案

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

热度:30   发布时间:2016-04-28 00:39:18.0
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的合并冲突不知所措。labelicon属性在这里也不需要,所以也去掉了。

然后把一开始创建的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的属性文件,在里面分别定义三个属性,formatreference。如下:

<?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

  相关解决方案