Android MVVM使用文档

项目依赖关系

7JY62U9%8${5$%57Y_H$WAN.png

关联关系

1、应用层APP也就是项目当中的宿主
2、组件层则是项目当中的业务组件
3、基础层是一些公共的lib包

宿主依赖业务组件

dependencies {
   //宿主项目中判断组件是否需要独立运行
    if (isBuildModule.toBoolean()) {
        //组件独立运行时，宿主项目直接依赖基础库，避免编译错误
        implementation project(':library-base')
    } else {
        //主业务模块
        implementation project(':module-main')
        //登录模块
        implementation project(':module-sign')
        //首页模块
        implementation project(':module-home')
        //用户模块
        implementation project(':module-user')
        //我的模块
        implementation project(':module-mine')
    }
}

业务组件依赖library-base

dependencies {
   //组件依赖基础库
    api project(':library-base')
    //组件中依赖阿里路由编译框架
    annotationProcessor rootProject.ext.dependencies["arouter_compiler"]
    //按需依赖第三方组件
}

library-base依赖公共库

dependencies {
    //公用的support相关库在base中依赖
    api rootProject.ext.support["design"]
    api rootProject.ext.support["appcompat-v7"]
    api rootProject.ext.support["constraint-layout"]
    api rootProject.ext.support["recyclerview-v7"]
    //公用资源在base中依赖
    api project(':library-soure')
    api project(':network_processor')
    api project(':library-dialog')
    api project(':third-party-pay-login-share')
    //核心基础库(由于这是例子, 所以这里采用远程依赖的方式, 可根据实际情况自行换成源码依赖，源码地址：https://github.com/goldze/MVVMHabit)
    api rootProject.ext.dependencies["MVVMHabit"]
    //阿里路由框架
    api rootProject.ext.dependencies["arouter_api"]
    api rootProject.ext.dependencies["lifecycle-extensions"]
    api rootProject.ext.dependencies["lifecycle-compiler"]
    api rootProject.ext.dependencies["immersionbar"]
    api rootProject.ext.dependencies["alibabajson"]
    api rootProject.ext.dependencies["xxpermissions"]
    api rootProject.ext.dependencies["wechat"]
    //其他公共库，例如图片选择、分享、推送等
}

开启dataBinding

Android MVVM模式离不开DataBinding，每个组件中都需要开启，包括宿主App

android {
    //开启DataBinding
    dataBinding {
        enabled true
    }
}

manifest配置

1、组件在自己的AndroidManifest.xml各自配置activity，application标签无需添加属性，也不需要指定activity的intent-filter。当合并打包时，gradle会将每个组件的AndroidManifest合并到宿主App中。
组件关联到宿主时AndroidManifest.xml示例：
当我们程序的程序需要跳转到组件module-main里面的MainActivity时，就在组件module-main的AndroidManifest.xml里面声明

2、组件独立运行时，就需要单独的一个AndroidManifest.xml作为调试用。可以在src/main文件夹下创建一个alone/AndroidManifest.xml。配置application标签属性，并指定启动的activity。这个跟宿主APP的AndroidManifest.xml配置结构是一样的

    
        
            
                ...
            
        
    

build.gradle中配置

android {
    sourceSets {
        main {
            ...
            if (isBuildModule.toBoolean()) {
                //独立运行
                manifest.srcFile 'src/main/alone/AndroidManifest.xml'
            } else {
                //合并到宿主
                manifest.srcFile 'src/main/AndroidManifest.xml'
                resources {
                    //正式版本时，排除alone文件夹下所有调试文件
                    exclude 'src/main/alone/*'
                }
            }
        }
    }
}

Activity之间跳转与传值

1、在activity里面添加注解@Route(path = RouterActivityPath.Scan.PAGER_SCAN_WIFI_RESULT)
2、通过阿里的ARouter调用执行RouterActivityPath.Scan.PAGER_SCAN_WIFI_RESULT
//示例代码：

ARouter.getInstance().build(RouterActivityPath.Scan.PAGER_SCAN_WIFI_RESULT)
                    .withParcelableArrayList("ipList", ipList).navigation();

Activity接收传值

1、需要再onCreate方法添加
 ARouter.getInstance().inject(this);
2、通过声明获取属性即可获取到值
@Autowired(name = "ipList")
ArrayList ipList;

ARouter传递一个int类型的id，String类型同理

ARouter.getInstance().build(RouterActivityPath.Strategy.PAGER_ARTICLE_ACTIVITY)
                                .withInt("id", videoEntity.getId()).navigation();

Activity接收一个int类型的id值，String类型同理

1、需要再接收值的Activity里面的onCreate方法添加
ARouter.getInstance().inject(this);

@Autowired()
int id;