欢迎使用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~25 targetBlurView为需要被模糊的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方法开始倒计时

反馈与建议

• 邮箱：jeissie@jeissie.com