开源软件名称：

开源软件地址：

开源软件介绍：

欢迎使用Jesse Open Assist Frame

####JOAF是一个Android的轻量级辅助应用开发框架，把自己日常反复使用的东西精炼出来，欢迎讨论反馈。

• 集中工具 ：将日常开发中常用的系统的繁琐方法进行了二次封装，以达到简易使用的目的。并且增加了一部分拓展功能。当然这都是基于我日前的工作进行的封装，简单但局限。
• 开源拓展 ：集合了非常优秀的国内外常用的开源工具，并且在不断丰富，以便满足一个lib包，就包含所有资源，不用再去网上找来找去浪费时间

####本框架集合了以下优秀资源，在此向这些优秀的开发者致敬！作者：Jeremy Feinstein：JazzyViewPager一个ViewPager切换特效的开源控件，效果很丰富很好用

SlidingMenu提供侧滑打开侧边栏的开源控件，功能超级强大，很出名，很多人用，这里不就多介绍了。

作者：Chris Banes:PullToRefresh提供多种刷新，可以嵌套只几乎所有控件中使用，四个方向都可以滑动刷新，其中有几个控件有小bug

JOAF总体简介

JOAF总体思想是保持代码的最大简洁与复用。

####一、Util包

1.将所有与试图有关的常用操作全部至于ViewUtill类中。该类集中了Toast，Log，弹窗，Activity跳转 ，等待提示，退出应用一系列功能。该类中的所有方法均为静态，可以在任何地方调用，并且不需要手动传入Context。

2.将常用的与App有关的方法放入AppUtil中，目前包含了获取通过Context获取版本号，版本名称，APPIcon, 是否在前台运行 等功能。

####二、Base包

1、目前包含3个base类，使用该框架前提是所有Activity（包括FragmentActivity）必须继承自该包中的BaseActivity或者BaseFragmentActivity。主要是在这两个Base类中，重写了onCreate，onResume，onDestroy方法，来记录或删除当前交互的Activity的Context。

代码块

@Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);		setContentView(R.layout.activity_base);		ViewUtil.setContext(this);		registerReceiver();	}		@Override    public void onResume() {        super.onResume();        checkGuider();        ViewUtil.setCurrentContext(this);    }        	@Override    protected void onDestroy() {		ViewUtil.removeContext(this);        ViewUtil.hideKeyBoard();        this.unregisterReceiver(mReceiver);        super.onDestroy();    }

当然，如果没有继承Base也没关系，可以手动在自己的Activity中，向ViewUtil添加context,以保证ViewUtil的正常使用。Base类还提供了手势右滑返回功能，和网络状态监视功能。

2、ManagerBase,继承自Observable。该类为单例使用，所有单例、管理类继承ManagerBase后，重写其中releaseManager，与resetPool方法，用来清除单例保存对象。清除操作在调用ViewUtil的exitSystem方法后进行。

####三、通知总线

ObserverBus. 该通知总线是观察者的集合。具体使用方法见代码注释

JOAF自定义模块

####一、AsyncImage 异步网络图片读取并换成

1.AsyncImageView该类是用来代替系统ImageView的自定义组件，提供了通过Url，或指定Key值，直接下载，缓存，存储，读取图片的功能，通过AsyncImageLoader类实现。需要注意的是，在首次调用该方法前应使用initPatch方法初始化缓存文件路径，或者使用setPatchDefine自定义路径，其他具体使用方法见代吗注释

AsyncImageLoader.getInstance().initPatch(this);

2.AsyncImageLoader为图片读取，下载，缓存读写类，使用了LruCache作为内存换成，与本地SD卡缓存，多线程操作。默认本地缓存目录为/Android/data/包名，默认图片单独下载地址为/Photo/包名。当然，按照需求可以自定义路径，继承AsyncImagePathDefine，并重写就可以完成。

3.AsyncImagePathDefine配合AsyncImageLoader使用的路径定义类，继承重写可更改路径

4.AsyncImageScale为图片缩放类只需要传入图片和需要缩放的宽高既可以完成（完善中）

5.AsyncImageviewSetviewComplete配合AsyncImageView使用的图片读取状态接口

####二、SuperButton 多功能状态按钮

多功能按钮，无须使用或者<style>即可使用基本的按下效果，支持纯文字按钮，矩形按钮，矩形缩放按钮，图形背景按钮。和系统Button使用方法基本相同，不同的是在findViewById之后，在使用前，按照需求使用不同的init方法初始化按钮类型。

####三、CustomDialog 自定义对话框

替代系统丑陋的黑色白健对话框，提供单键和双键显示，支持图片显示。统一风格，简洁大方。

####四、SwipeListView 横向滑动列表

提供类似于IOS中最早出现的列表Item横向滑动展开功能，滑动展开view可以自定义，使用非常方便，只需要按照规则创建就好了

####五、VerticalViewPager 纵向滑动ViewPager (摘自网络具体是谁做的，传说是台湾人)

可以纵向滑动的Viewpage,支持view和Fragemnt，使用方法和系统自带的一模一样，无须多言。不一样的地方就是我加入了过度动画的速度修正,在FixedSpeedScroller中直接定义就好了

	private int mDuration = 750;

####六、PullToRefreshView 上下啦刷新

一个上下啦刷新控件，可以自定义刷新提示，title等，如果不需要底部上啦刷新也可以关掉，可以嵌套至多种空间外层使用。

自定义提示语

public void setHeadText(String refreshPullText, String refreshPullReleaseText, 			String refreshingText, String refreshPullDesc) {		this.refreshPullText = refreshPullText;		this.refreshPullReleaseText = refreshPullReleaseText;		this.refreshingText = refreshingText;		this.refreshPullDesc = refreshPullDesc;	}		public void setFootText(String refreshFootText, String refreshFootReleaseText, 			String footRefreshingText, String refreshFootDesc) {		this.refreshFootText = refreshFootText;		this.refreshFootReleaseText = refreshFootReleaseText;		this.footRefreshingText = footRefreshingText;		this.refreshFootDesc = refreshFootDesc;		}	

/**	 * 取消底部刷新	 */	public void withOutFootRefresh() {		footRefresh = false;		}

####七、BlurView 动态模糊

类似于IOS和Windows7 中使用的经典的模糊特效（毛玻璃效果）可以是整个界面立马显得高大上起来。使用方法如下：

    BlurView blurView = new BlurView(context, 13);	blurView.updateBlurView(targetBlurView, backgroundView);

其中数字13表示模糊的效果值范围0~25targetBlurView为需要被模糊的view，backgroundView为背景view。如果是list或者任何滚动的view中需要使用模糊，则需要在Scoller监听器中去不断调用updateBlurView方法。

JOAF更新日志

V1.0初始版本

V1.1增加BlurView动态模糊类修复ViewLoader中读取缓存数量异常的bug

V1.1.1删除Base中的无用布局，以便在其子类中可以使用requestWindowFeature来更改窗口模式修复SuperButton中Onclick方法

V1.1.2增加了activity进入时，原本activity的渐变过渡动画。不再是黑漆漆的了。Popup可以传入自定义的View，原本的ImagePopup增加了一组自定义方法。修复收回键盘有时崩溃的Bug。优化代码结构，为BaseActivity以及BaseFragmentActivity增加了3个钩子函数.以下方法会在 onResume 中依次被调用，请注意View的初始化顺序，以免出错。

	public void initLayout() {			}		public void initActionBar() {			}		public void initData() {			}		public void checkGuider() {			}

V1.1.3修复了BaseActivit与BaseFragmentActivity中对于初始化方法的反复调用（实在是太粗心了啊）将BaseActivit与BaseFragmentActivity中的共用方法（手势判断、网络状态监听与context的维护）移动到了新类中--ActivityUtil。今后，所有的共用方法都可以继续在ActivityUtil中扩展了，而不用去影响Base类。

V1.1.4

1.SuperButton增加了自定义的属性。可以直接在xml中定义背景、图片、文字、缩放。使用时需要写明命名空间例如：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:button="http://schemas.android.com/apk/res/自己的包名"    xmlns:tools="http://schemas.android.com/tools"    <com.jesse.custom.component.SuperButton            android:layout_width="match_parent"            android:layout_height="40dp"            button:button_color_focus="#ffa89076"            button:button_color_normal="@ffa84938"            button:button_text="@string/activity_login"            button:button_type="color_button"            button:text_size="18px" />

具体属性包含：

<declare-styleable name="SuperButton">        <attr name="button_type" />        <attr name="text_size" format="dimension"/>        <attr name="text_color" format="color"/>        <attr name="text_color_normal" format="color"/>        <attr name="text_color_focus" format="color"/>        <attr name="button_text" format="string"/>        <attr name="button_color_bg" format="color"/>        <attr name="button_color_normal" format="color"/>        <attr name="button_color_focus" format="color"/>        <attr name="button_img" format="reference"/>        <attr name="button_img_normal" format="reference"/>        <attr name="button_img_focus" format="reference"/>    </declare-styleable>

2.ViewUtil 新增了几个方法（1）新增 exchangeActivityWithDefultAnimation 方法。跳转时调用默认动画（2）PopupWindow 属性更加具体。

3.BaseActivity以及BaseFragmentActivity中新增finishAnimation方法。该方法在finish中调用。复写此方法可以控制activity动画。

4.新增加TimerButton控件:

使用initTimeButton(Context context, String buttonText, int timeLength)初始化调用startSub方法开始倒计时

反馈与建议

• 邮箱：[email protected]