通用库


在开发android应用时,一般会使用一些现有库来缩短开发周期,将代码进行模块化;
使用框架虽然可能会增加最终代码量,但在开发过程中会非常方便。


项目模版：GITHUB地址

android从出生到现在已经很多年了，因此有大量的库可供使用，android使用的技能不会特别多，但比较杂，虽然所有的代码都可以通过手✖完成，但这个过程肯定会相当痛苦。

很多库使用率都很高，通过github上的star数量可以分辨出哪些库比较主流，通过更新频率也可以查看哪些库依然在维护。现整理一些比较好的库，同时通过这些项目来搭建出一般android项目可以直接通用的框架代码。

一、框架需设计的库

虽然说一般框架不需要太多的内容，不过要实现大部分的功能，还是需要引用较多的资源库的，这里进行列举，然后接下来进行简单的说明：

1. 基本通用包（系统自带或者support库提供）：
   
   • multidex：dex分包处理
   • constraint
   • palette：着色
   • cardview：卡片布局
   • design
2. 数据库：
   
   • litepal
3. 自动注入/变量赋值框架：
   
   • dagger：为成员变量等自动赋值
   • butterknife：依据xml自动生成变量并赋值，点击监听
4. 线程任务处理：
   
   • Rxjava（RxAndroid）
5. 网络任务：
   
   • retrofit
   • okhttp：http核心库
6. 数据类型转换：
   
   • Gson：json数据处理
7. 图片处理：
   
   • Glide：图片下载裁剪
   • zxing-library：二维码图片识别或生成
   • takephoto：从设备中选择图片或拍照获得图片
8. 工具类：
   
   • utilcode：这是工具库集合，提供各种常用的操作处理
   • statusbarutil：状态栏工具类
9. 调试时检测优化：
   
   • leakcanary-android
10. 日志工具
    
    • Logger：打印日志
11. 弹出框：
    
    • pickerview：时间选择器、条件选择器
12. 权限处理：
    
    • permissionsdispatcher：无反射动态请求权限
13. 自定义view：
    
    • flowlayout：tag组
    • xrecyclerview：可上拉加载下拉刷新的recyclerview
    • convenientbanner：轮播插件
    • BottomNavigationViewEx：底部导航栏（多tab视图）
    • roundedimageview：圆角头像，可存在border
    • gridPasswordView：密码框
    • badge：角标库
14. 界面跳转：
    
    • ARouter：阿里推出的库，可实现路由跳转、拦击、降级、参数自动注入
15. 其他：
    
    • pushsdk：友盟统计、消息推送（module形式）
    • rxdownload：基于Rxjava的用于软件更新的库
    • logging-interceptor：网络请求时打印信息
    • adapter-rxjava：将网络请求变为Rxjava监听形式
    • converter-gson：网络返回数据（若为gson格式）转为bean

大部分的库都已经列举出来了；
其中一些库如自定义View等内容可以参考github源码，也可以在项目中找到对应使用的位置
对于友盟推送等内容，也已经在代码中集成；同时在BaseApplication类中进行了初始化
动态权限库自身在AndroidStudio中是有插件的，并且源码中启动Activity就是示例；
LocationPickerView也提供了自定义View的模版。

其中有些库功能很强大，但使用起来会进行其他配置，因此单独说明：

二、网络请求模块

该模块由Rxjava、RxAndroid、logging-interceptor、adapter-rxjava、converter-gson、retrofit、okhttp等项目包组成，将网络请求、数据转换、异常处理、日志输出等功能内聚到一起，整个架构可用简图概括（只是草图）：

这样用户只需要将网络请求的字段传入，并定义可以处理的结构以及异常情况下的处理，就可以省略中间的具体的过程。

具体实现如下：

@Provides@SingletonHttpInterface provideHttpInterface() {    //网络请求的Host    String baseUrl = BaseApplication.app.getBaseNetUrl();    //生成JSON转换的库    Gson gson = new GsonBuilder()            .serializeNulls()            .setDateFormat("yyyy:MM:dd HH:mm:ss")            .create();    GsonConverterFactory gsonConverterFactory = GsonConverterFactory.create(gson);    //生成RxJava转换的adapter    RxJava2CallAdapterFactory rxJava2CallAdapterFactory = RxJava2CallAdapterFactory.create();    //生成OkHttp网络传输的客户端    HashMap> cookieStore = new HashMap<>();    OkHttpClient okHttpClient = new OkHttpClient.Builder()            .cookieJar(new CookieJar() {                @Override                public void saveFromResponse(HttpUrl url, List cookies) {                    cookieStore.put(url.host(), cookies);                }                @Override                public List loadForRequest(HttpUrl url) {                    List cookies = cookieStore.get(url.host());                    return cookies != null ? cookies : new ArrayList<>();                }            })            .addInterceptor(chain -> {                Request request = chain.request()                        .newBuilder()                        .addHeader("SDK", String.valueOf(Build.VERSION.SDK_INT ))                        .build();                return chain.proceed(request);            })            .addInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY))            .addNetworkInterceptor(new StethoInterceptor())            .connectTimeout(2000, TimeUnit.MILLISECONDS)            .readTimeout(2000, TimeUnit.MILLISECONDS)            .writeTimeout(2000,TimeUnit.MILLISECONDS)            .build();    //最后组合成Retrofit对象    Retrofit retrofit = new Retrofit.Builder()            .addConverterFactory(gsonConverterFactory)            .addCallAdapterFactory(rxJava2CallAdapterFactory)            .baseUrl(baseUrl)            .client(okHttpClient)            .build();    //将注解后的interface请求接口转换为真正可用的网络请求对象    return retrofit.create(HttpInterface.class);}

可以看到，最后其实是生成了HttpInterface对象。这个HttpInterface对象是自定义的，自身是接口类型，用于定义网络请求所需的参数，以及可以处理的返回数据的类型，如假如需要请求一次网络：

public interface HttpInterface {    /**     * 登录     *     * @param username 用户名     * @param pwd      密码     * @return 登录返回对象     */    @POST("login/doLogin")    @FormUrlEncoded    Observable> doLogin(@Field("username") String username,                                             @Field("pwd") String pwd);                                           }

如上一般，只需要定义参数，以及可解析的数据对象即可。

然后发起网络请求：

/** * 举例请求网络数据 */@OnClick(R.id.fab)public void onViewClicked() {    httpInterface.doLogin("name", "password")            .subscribeOn(Schedulers.io())            .observeOn(AndroidSchedulers.mainThread())            .subscribe(new Consumer>() {                @Override                public void accept(BaseHttpBean