[移动开发]GitHub标星4，Android架构师成长路线

或

下载例子程序，在主项目app的build.gradle中依赖例子程序中的mvvmhabit：

dependencies {  

    ...

    implementation project(':mvvmhabit')

} 

1.3、配置config.gradle

如果不是远程依赖，而是下载的例子程序，那么还需要将例子程序中的config.gradle放入你的主项目根目录中，然后在根目录build.gradle的第一行加入：

apply from: "config.gradle" 

注意： config.gradle中的

android = [] 是你的开发相关版本配置，可自行修改

support = [] 是你的support相关配置，可自行修改

dependencies = [] 是依赖第三方库的配置，可以加新库，但不要去修改原有第三方库的版本号，不然可能会编译不过

1.4、配置AndroidManifest

添加权限：

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

配置Application：

继承mvvmhabit中的BaseApplication，或者调用

BaseApplication.setApplication(this); 

来初始化你的Application

可以在你的自己AppApplication中配置

//是否开启日志打印

KLog.init(true);

//配置全局异常崩溃操作

CaocConfig.Builder.create()

    .backgroundMode(CaocConfig.BACKGROUND_MODE_SILENT) //背景模式,开启沉浸式

    .enabled(true) //是否启动全局异常捕获

    .showErrorDetails(true) //是否显示错误详细信息

    .showRestartButton(true) //是否显示重启按钮

    .trackActivities(true) //是否跟踪Activity

    .minTimeBetweenCrashesMs(2000) //崩溃的间隔时间(毫秒)

    .errorDrawable(R.mipmap.ic_launcher) //错误图标

    .restartActivity(LoginActivity.class) //重新启动后的activity

    //.errorActivity(YourCustomErrorActivity.class) //崩溃后的错误activity

    //.eventListener(new YourCustomEventListener()) //崩溃后的错误监听

    .apply(); 

2、快速上手

2.1、第一个Activity

以大家都熟悉的登录操作为例：三个文件LoginActivty.java、LoginViewModel.java、activity_login.xml

2.1.1、关联ViewModel

在activity_login.xml中关联LoginViewModel。

<layout>

    <data>

        <variable

            type="com.goldze.mvvmhabit.ui.login.LoginViewModel"

            name="viewModel"

        />

    </data>

    .....



</layout> 

variable - type：类的全路径

variable - name：变量名

2.1.2、继承BaseActivity

LoginActivity继承BaseActivity

public class LoginActivity extends BaseActivity<ActivityLoginBinding, LoginViewModel> {

    //ActivityLoginBinding类是databinding框架自定生成的,对activity_login.xml

    @Override

    public int initContentView(Bundle savedInstanceState) {

        return R.layout.activity_login;

    }



    @Override

    public int initVariableId() {

        return BR.viewModel;

    }



    @Override

    public LoginViewModel initViewModel() {

        //View持有ViewModel的引用，如果没有特殊业务处理，这个方法可以不重写

        return ViewModelProviders.of(this).get(LoginViewModel.class);

    }

} 

保存activity_login.xml后databinding会生成一个ActivityLoginBinding类。（如果没有生成，试着点击Build->Clean Project）

BaseActivity是一个抽象类，有两个泛型参数，一个是ViewDataBinding，另一个是BaseViewModel，上面的ActivityLoginBinding则是继承的ViewDataBinding作为第一个泛型约束，LoginViewModel继承BaseViewModel作为第二个泛型约束。

重写BaseActivity的二个抽象方法

initContentView() 返回界面layout的id

initVariableId() 返回变量的id，对应activity_login中name=“viewModel”，就像一个控件的id，可以使用R.id.xxx，这里的BR跟R文件一样，由系统生成，使用BR.xxx找到这个ViewModel的id。

选择性重写initViewModel()方法，返回ViewModel对象

@Override

public LoginViewModel initViewModel() {

    //View持有ViewModel的引用，如果没有特殊业务处理，这个方法可以不重写

    return ViewModelProviders.of(this).get(LoginViewModel.class);

} 

注意： 不重写initViewModel()，默认会创建LoginActivity中第二个泛型约束的LoginViewModel，如果没有指定第二个泛型，则会创建BaseViewModel

2.1.3、继承BaseViewModel

LoginViewModel继承BaseViewModel

public class LoginViewModel extends BaseViewModel {

    public LoginViewModel(@NonNull Application application) {

        super(application);

    }

    ....

} 

BaseViewModel与BaseActivity通过LiveData来处理常用UI逻辑，即可在ViewModel中使用父类的showDialog()、startActivity()等方法。在这个LoginViewModel中就可以尽情的写你的逻辑了！

BaseFragment的使用和BaseActivity一样，详情参考Demo。

2.2、数据绑定

拥有databinding框架自带的双向绑定，也有扩展

2.2.1、传统绑定

绑定用户名：

在LoginViewModel中定义

//用户名的绑定

public ObservableField<String> userName = new ObservableField<>(""); 

在用户名EditText标签中绑定

android:text="@={viewModel.userName}" 

这样一来，输入框中输入了什么，userName.get()的内容就是什么，userName.set("")设置什么，输入框中就显示什么。 注意： @符号后面需要加=号才能达到双向绑定效果；userName需要是public的，不然viewModel无法找到它。

点击事件绑定：

在LoginViewModel中定义

//登录按钮的点击事件

public View.OnClickListener loginOnClick = new View.OnClickListener() {

    @Override

    public void onClick(View v) {



    }

}; 

在登录按钮标签中绑定

android:onClick="@{viewModel.loginOnClick}" 

这样一来，用户的点击事件直接被回调到ViewModel层了，更好的维护了业务逻辑

这就是强大的databinding框架双向绑定的特性，不用再给控件定义id，setText()，setOnClickListener()。

但是，光有这些，完全满足不了我们复杂业务的需求啊！MVVMHabit闪亮登场：它有一套自定义的绑定规则，可以满足大部分的场景需求，请继续往下看。

2.2.2、自定义绑定

还拿点击事件说吧，不用传统的绑定方式，使用自定义的点击事件绑定。

在LoginViewModel中定义

//登录按钮的点击事件

public BindingCommand loginOnClickCommand = new BindingCommand(new BindingAction() {

    @Override

    public void call() {



    }

}); 

在activity_login中定义命名空间

xmlns:binding="http://schemas.android.com/apk/res-auto" 

在登录按钮标签中绑定

binding:onClickCommand="@{viewModel.loginOnClickCommand}" 

这和原本传统的绑定不是一样吗？不，这其实是有差别的。使用这种形式的绑定，在原本事件绑定的基础之上，带有防重复点击的功能，1秒内多次点击也只会执行一次操作。如果不需要防重复点击，可以加入这条属性

binding:isThrottleFirst="@{Boolean.TRUE}" 

那这功能是在哪里做的呢？答案在下面的代码中。

//防重复点击间隔(秒)

public static final int CLICK_INTERVAL = 1;



/**

* requireAll 是意思是是否需要绑定全部参数, false为否

* View的onClick事件绑定

* onClickCommand 绑定的命令,

* isThrottleFirst 是否开启防止过快点击

*/

@BindingAdapter(value = {"onClickCommand", "isThrottleFirst"}, requireAll = false)

public static void onClickCommand(View view, final BindingCommand clickCommand, final boolean isThrottleFirst) {

    if (isThrottleFirst) {

        RxView.clicks(view)

        .subscribe(new Consumer<Object>() {

            @Override

            public void accept(Object object) throws Exception {

                if (clickCommand != null) {

                    clickCommand.execute();

                }

            }

        });

    } else {

        RxView.clicks(view)

        .throttleFirst(CLICK_INTERVAL, TimeUnit.SECONDS)//1秒钟内只允许点击1次

        .subscribe(new Consumer<Object>() {

            @Override

            public void accept(Object object) throws Exception {

                if (clickCommand != null) {

                    clickCommand.execute();

                }

            }

        });

    }

} 

onClickCommand方法是自定义的，使用@BindingAdapter注解来标明这是一个绑定方法。在方法中使用了RxView来增强view的clicks事件，.throttleFirst()限制订阅者在指定的时间内重复执行，最后通过BindingCommand将事件回调出去，就好比有一种拦截器，在点击时先做一下判断，然后再把事件沿着他原有的方向传递。

是不是觉得有点意思，好戏还在后头呢！

2.2.3、自定义ImageView图片加载

绑定图片路径：

在ViewModel中定义

public String imgUrl = "http://img0.imgtn.bdimg.com/it/u=2183314203,562241301&fm=26&gp=0.jpg"; 

在ImageView标签中

binding:url="@{viewModel.imgUrl}" 

url是图片路径，这样绑定后，这个ImageView就会去显示这张图片，不限网络图片还是本地图片。

如果需要给一个默认加载中的图片，可以加这一句

binding:placeholderRes="@{R.mipmap.ic_launcher_round}" 

R文件需要在data标签中导入使用，如：<import type="com.goldze.mvvmhabit.R" />

BindingAdapter中的实现

@BindingAdapter(value = {"url", "placeholderRes"}, requireAll = false)

public static void setImageUri(ImageView imageView, String url, int placeholderRes) {

    if (!TextUtils.isEmpty(url)) {

        //使用Glide框架加载图片

        Glide.with(imageView.getContext())

            .load(url)

            .placeholder(placeholderRes)

            .into(imageView);

    }

} 

很简单就自定义了一个ImageView图片加载的绑定，学会这种方式，可自定义扩展。

如果你对这些感兴趣，可以下载源码，在binding包中可以看到各类控件的绑定实现方式

2.2.4、RecyclerView绑定

RecyclerView也是很常用的一种控件，传统的方式需要针对各种业务要写各种Adapter，如果你使用了mvvmhabit，则可大大简化这种工作量，从此告别setAdapter()。

在ViewModel中定义：

//给RecyclerView添加items

public final ObservableList<NetWorkItemViewModel> observableList = new ObservableArrayList<>();

//给RecyclerView添加ItemBinding

public final ItemBinding<NetWorkItemViewModel> itemBinding = ItemBinding.of(BR.viewModel, R.layout.item_network); 

ObservableList<>和ItemBinding<>的泛型是Item布局所对应的ItemViewModel

在xml中绑定

<android.support.v7.widget.RecyclerView

    android:layout_width="match_parent"

    android:layout_height="match_parent"

    binding:itemBinding="@{viewModel.itemBinding}"

    binding:items="@{viewModel.observableList}"

    binding:layoutManager="@{LayoutManagers.linear()}"

    binding:lineManager="@{LineManagers.horizontal()}" /> 

layoutManager控制是线性(包含水平和垂直)排列还是网格排列，lineManager是设置分割线

网格布局的写法：binding:layoutManager="@{LayoutManagers.grid(3)}

水平布局的写法：binding:layoutManager="@{LayoutManagers.linear(LinearLayoutManager.HORIZONTAL,Boolean.FALSE)}"

使用到相关类，则需要导入该类才能使用，和导入Java类相似

<import type="me.tatarka.bindingcollectionadapter2.LayoutManagers" />

<import type="me.goldze.mvvmhabit.binding.viewadapter.recyclerview.LineManagers" />

<import type="android.support.v7.widget.LinearLayoutManager" />

这样绑定后，在ViewModel中调用ObservableList的add()方法，添加一个ItemViewModel，界面上就会实时绘制出一个Item。在Item对应的ViewModel中，同样可以以绑定的形式完成逻辑

可以在请求到数据后，循环添加observableList.add(new NetWorkItemViewModel(NetWorkViewModel.this, entity));详细可以参考例子程序中NetWorkViewModel类。

注意： 在以前的版本中，ItemViewModel是继承BaseViewModel，传入Context，新版本3.x中可继承ItemViewModel，传入当前页面的ViewModel

更多RecyclerView、ListView、ViewPager等绑定方式，请参考 https://github.com/evant/binding-collection-adapter

2.3、网络请求

网络请求一直都是一个项目的核心，现在的项目基本都离不开网络，一个好用网络请求框架可以让开发事半功倍。

2.3.1、Retrofit+Okhttp+RxJava

现今，这三个组合基本是网络请求的标配，如果你对这三个框架不了解，建议先去查阅相关资料。

square出品的框架，用起来确实非常方便。MVVMHabit中引入了

api "com.squareup.okhttp3:okhttp:3.10.0"

api "com.squareup.retrofit2:retrofit:2.4.0"

api "com.squareup.retrofit2:converter-gson:2.4.0"

api "com.squareup.retrofit2:adapter-rxjava2:2.4.0" 

构建Retrofit时加入

Retrofit retrofit = new Retrofit.Builder()

    .addConverterFactory(GsonConverterFactory.create())

    .addCallAdapterFactory(RxJavaCallAdapterFactory.create())

    .build(); 

或者直接使用例子程序中封装好的RetrofitClient

2.3.2、网络拦截器

LoggingInterceptor： 全局拦截请求信息，格式化打印Request、Response，可以清晰的看到与后台接口对接的数据，

LoggingInterceptor mLoggingInterceptor = new LoggingInterceptor

    .Builder()//构建者模式

    .loggable(true) //是否开启日志打印

    .setLevel(Level.BODY) //打印的等级

    .log(Platform.INFO) // 打印类型

    .request("Request") // request的Tag

    .response("Response")// Response的Tag

    .addHeader("version", BuildConfig.VERSION_NAME)//打印版本

    .build() 

构建okhttp时加入

OkHttpClient okHttpClient = new OkHttpClient.Builder()

    .addInterceptor(mLoggingInterceptor)

    .build(); 

CacheInterceptor： 缓存拦截器，当没有网络连接的时候自动读取缓存中的数据，缓存存放时间默认为3天。

创建缓存对象

//缓存时间

int CACHE_TIMEOUT = 10 * 1024 * 1024

//缓存存放的文件

File httpCacheDirectory = new File(mContext.getCacheDir(), "goldze_cache");

//缓存对象

Cache cache = new Cache(httpCacheDirectory, CACHE_TIMEOUT); 

构建okhttp时加入

OkHttpClient okHttpClient = new OkHttpClient.Builder()

    .cache(cache)

    .addInterceptor(new CacheInterceptor(mContext))

    .build(); 

2.3.3、Cookie管理

MVVMHabit提供两种CookieStore：PersistentCookieStore (SharedPreferences管理)和MemoryCookieStore (内存管理)，可以根据自己的业务需求，在构建okhttp时加入相应的cookieJar

OkHttpClient okHttpClient = new OkHttpClient.Builder()

    .cookieJar(new CookieJarImpl(new PersistentCookieStore(mContext)))

    .build(); 

或者

OkHttpClient okHttpClient = new OkHttpClient.Builder()

    .cookieJar(new CookieJarImpl(new MemoryCookieStore()))

    .build(); 

2.3.4、绑定生命周期

请求在ViewModel层。默认在BaseActivity中注入了LifecycleProvider对象到ViewModel，用于绑定请求的生命周期，View与请求共存亡。

RetrofitClient.getInstance().create(DemoApiService.class)

    .demoGet()

    .compose(RxUtils.bindToLifecycle(getLifecycleProvider())) // 请求与View周期同步

    .compose(RxUtils.schedulersTransformer())  // 线程调度

    .compose(RxUtils.exceptionTransformer())   // 网络错误的异常转换

    .subscribe(new Consumer<BaseResponse<DemoEntity>>() {

        @Override

        public void accept(BaseResponse<DemoEntity> response) throws Exception {



        }

    }, new Consumer<ResponseThrowable>() {

        @Override

        public void accept(ResponseThrowable throwable) throws Exception {



        }

    }); 

在请求时关键需要加入组合操作符.compose(RxUtils.bindToLifecycle(getLifecycleProvider()))

注意： 由于BaseActivity/BaseFragment都实现了LifecycleProvider接口，并且默认注入到ViewModel中，所以在调用请求方法时可以直接调用getLifecycleProvider()拿到生命周期接口。如果你没有使用 mvvmabit 里面的BaseActivity或BaseFragment，使用自己定义的Base，那么需要让你自己的Activity继承RxAppCompatActivity、Fragment继承RxFragment才能用RxUtils.bindToLifecycle(lifecycle)方法。

2.3.5、网络异常处理

网络异常在网络请求中非常常见，比如请求超时、解析错误、资源不存在、服务器内部错误等，在客户端则需要做相应的处理(当然，你可以把一部分异常甩锅给网络，比如当出现code 500时，提示：请求超时，请检查网络连接，此时偷偷将异常信息发送至后台(手动滑稽))。

在使用Retrofit请求时，加入组合操作符.compose(RxUtils.exceptionTransformer())，当发生网络异常时，回调onError(ResponseThrowable)方法，可以拿到异常的code和message，做相应处理。

mvvmhabit中自定义了一个ExceptionHandle，已为你完成了大部分网络异常的判断，也可自行根据项目的具体需求调整逻辑。

注意： 这里的网络异常code，并非是与服务端协议约定的code。网络异常可以分为两部分，一部分是协议异常，即出现code = 404、500等，属于HttpException，另一部分为请求异常，即出现：连接超时、解析错误、证书验证失等。而与服务端约定的code规则，它不属于网络异常，它是属于一种业务异常。在请求中可以使用RxJava的filter(过滤器)，也可以自定义BaseSubscriber统一处理网络请求的业务逻辑异常。由于每个公司的业务协议不一样，所以具体需要你自己来处理该类异常。

3、辅助功能

一个完整的快速开发框架，当然也少不了常用的辅助类。下面来介绍一下MVVMabit中有哪些辅助功能。

3.1、事件总线

事件总线存在的优点想必大家都很清楚了，android自带的广播机制对于组件间的通信而言，使用非常繁琐，通信组件彼此之间的订阅和发布的耦合也比较严重，特别是对于事件的定义，广播机制局限于序列化的类（通过Intent传递），不够灵活。

3.3.1、RxBus

RxBus并不是一个库，而是一种模式。相信大多数开发者都使用过EventBus，对RxBus也是很熟悉。由于MVVMabit中已经加入RxJava，所以采用了RxBus代替EventBus作为事件总线通信，以减少库的依赖。

使用方法：

在ViewModel中重写registerRxBus()方法来注册RxBus，重写removeRxBus()方法来移除RxBus

//订阅者

private Disposable mSubscription;

//注册RxBus

@Override

public void registerRxBus() {

    super.registerRxBus();

    mSubscription = RxBus.getDefault().toObservable(String.class)

        .subscribe(new Consumer<String>() {

            @Override

            public void accept(String s) throws Exception {



            }

        });

    //将订阅者加入管理站

    RxSubscriptions.add(mSubscription);

}



//移除RxBus

@Override

public void removeRxBus() {

    super.removeRxBus();

    //将订阅者从管理站中移除

    RxSubscriptions.remove(mSubscription);

} 

在需要执行回调的地方发送

RxBus.getDefault().post(object); 

3.3.2、Messenger

Messenger是一个轻量级全局的消息通信工具，在我们的复杂业务中，难免会出现一些交叉的业务，比如ViewModel与ViewModel之间需要有数据交换，这时候可以轻松地使用Messenger发送一个实体或一个空消息，将事件从一个ViewModel回调到另一个ViewModel中。

使用方法：
如果你进阶的路上缺乏方向，可以点击我的【CodeChina开源项目】加入我们的圈子和安卓开发者们一起学习交流！

• Android进阶学习全套手册

  

• Android对标阿里P7学习视频

  

• BATJ大厂Android高频面试题

  

最后，借用我最喜欢的乔布斯语录，作为本文的结尾：

人这一辈子没法做太多的事情，所以每一件都要做得精彩绝伦。
你的时间有限，所以不要为别人而活。不要被教条所限，不要活在别人的观念里。不要让别人的意见左右自己内心的声音。
最重要的是，勇敢的去追随自己的心灵和直觉，只有自己的心灵和直觉才知道你自己的真实想法，其他一切都是次要。

        @Override

        public void accept(String s) throws Exception {



        }

    });

//将订阅者加入管理站

RxSubscriptions.add(mSubscription);

}

//移除RxBus

@Override

public void removeRxBus() {

super.removeRxBus();

//将订阅者从管理站中移除

RxSubscriptions.remove(mSubscription);

}

在需要执行回调的地方发送

RxBus.getDefault().post(object);

#### []( )3.3.2、Messenger



Messenger是一个轻量级全局的消息通信工具，在我们的复杂业务中，难免会出现一些交叉的业务，比如ViewModel与ViewModel之间需要有数据交换，这时候可以轻松地使用Messenger发送一个实体或一个空消息，将事件从一个ViewModel回调到另一个ViewModel中。



使用方法：
**如果你进阶的路上缺乏方向，可以[点击我的【CodeChina开源项目】](https://codechina.csdn.net/m0_60958482/android_p7)加入我们的圈子和安卓开发者们一起学习交流！**

- Android进阶学习全套手册

  

  [外链图片转存中...(img-2OF2eMaT-1630846574522)]

- Android对标阿里P7学习视频

  

  [外链图片转存中...(img-XNgASAwd-1630846574524)]

- BATJ大厂Android高频面试题

  

  [外链图片转存中...(img-kbX7JmSz-1630846574525)]

最后，借用我最喜欢的乔布斯语录，作为本文的结尾：

> 人这一辈子没法做太多的事情，所以每一件都要做得精彩绝伦。
> 你的时间有限，所以不要为别人而活。不要被教条所限，不要活在别人的观念里。不要让别人的意见左右自己内心的声音。
> 最重要的是，勇敢的去追随自己的心灵和直觉，只有自己的心灵和直觉才知道你自己的真实想法，其他一切都是次要。