模块化完整方案

存在原因

之前的模块化方案中存在几个重要的问题。

1. 编译数据较慢
2. 编译的包变大

存在原因

1. 模块化方案没有完整的实施。
2. 代码结构不够合理
3. 循环编译存在的问题

目前的解决结果

单模块的编译在10s内！

调研解决方案

完整的模块化编译方案

配置的步骤如下：

-1. Project File

此步也只需要配置一次。
如果需要实现自己的Application可以选择，再继承一份，或者在该文件下重写一个Application

在Project目录下添加我们需要的公共的假数据。
如下图所示的是，在编译circle这个module为Application时，自动会在文件夹位置，添加对应module的标识

QQ图片20170822175411.png

0. Module Gradle

这步只需要配置一次。
注意:

1. 打完整包的时候，需要按照module来编译，将其修改成false。
2. 平时自己开发对应模块时，将其修改成true

在Project下的gradle.properties文件中，添加变量。用来控制模块化编译的代码

isBuildAsModule=false

1. Module Gradle

对于模块化项目，每个单独的 Business Module 都可以单独编译成 APK。在开发阶段需要单独打包编译，项目发布的时候又需要它作为项目的一个 Module 来整体编译打包。简单的说就是开发时是 Application，发布时是 Library。
因此需要在 Business Module 的 build.gradle 头部中,加入如下代码：

if (isBuildAsModule.toBoolean()) {
    apply plugin: 'com.android.library'
} else {
    apply plugin: 'com.android.application'
}

因为我们的App需要使用multidex.所以还需要添加

defaultConfig {
//...
  if (isBuildAsModule.toBoolean()) {

        } else {
            multiDexEnabled true //important
        }

2. Manifest.xml的配置

• 在两边module下，分别创建debug.release包。对应两种方式的Manifest文件。

  
  QQ图片20170822172151.png
  

  创建的步骤是：是将原来的manifest文件。分别复制到对应的两个包名内。然后再对debug包下的manifest做一下自定义的操作。

QQ图片20170822161453.png

三个Manifest之间的关系

QQ图片20170822161448.png

• 同时，需要在Module 的build.gradle文件内，配置好sourceSets

 sourceSets {
        main {
            if (isBuildAsModule.toBoolean()) {
                manifest.srcFile 'src/main/release/AndroidManifest.xml'
                assets.srcDirs = ['src/main/assets']
            } else {
                manifest.srcFile 'src/main/debug/AndroidManifest.xml'
              //在这里添加最先开始的 assets目录
               assets.srcDirs += ['../debug_assets']
                //这里添加我们公用初始化的Application的代码位置
                java.srcDirs+=['../debug_java']
            }
        }

    }

• debug 模式下的 AndroidManifest.xml :
  因为很多内容需要初始化，所以需要配置上初始化的Application名称。和对应的主题。并且将当前书写的Activity设置为launcher

<application
...
    android:name="app.DebugApplication"
        android:allowBackup="true"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/ActivityAnimaTheme"
   >
   >   <activity
 android:name="com.baronzhang.android.newhouse.NewHouseMainActivity"
       android:label="@string/new_house_label_home_page">
       <intent-filter>
           <action android:name="android.intent.action.MAIN" />
           <category android:name="android.intent.category.LAUNCHER" />
       </intent-filter>
   </activity>
</application>

这里需要在对应的文件夹下面创建对应的文件。文件钟的内容。除了manifest外，其他的可以各个模块复用

3. App下的配置

这步也不需要重复配置。
因为依赖关系的原因。如果module当做Application来编译的话，App就不能再引用该module了。所有同样需要在app下的build.gralde文件内配置如下代码:(根据编译方式，去掉依赖)

   if (isBuildAsModule.toBoolean()) {    //如果下面的module还是按照这样编译的话，是需要编译这些的
        //    compile project(':api')

        compile project(':account')
        compile project(path: ':api')
        compile project(':app-hybrid')
        compile project(':app-circle')
        compile project(':app-school')
        compile project(':app-course')
        compile project(':app-resource')
        compile project(':app-shelf')
//    compile project(':app-mine')
        compile project(':app-chat')
//    compile project(':app-growing')
        compile project(path: ':app-mine')
    } else {

    }
    //hbase作为基准。还是需要进行编译
    compile project(':app-hbase')

4.gradle.properties配置

最后还需要在gralde.properties内配置对应的参数。

#这个字段内标识的必须编译的module
NECESSARY_MODULE=... 
# 编译的目标module.改参数，只有在 isBuildAsModule=false时才会生效。
# 如果有多个，直接使用,隔开。这具体需要写什么。具体请见改模块下gradle文件编译的内容
TARGET_MODULE=:app-circle

5. setting.gradle文件

同样是一次配置，得益终生

配置的方式如下：

def includeString = new ArrayList()
//添加必备的module
String nec = NECESSARY_MODULE.toString()
String[] necStringArrays = nec.split(',')
includeString.addAll(necStringArrays)
//添加编译属性的module
if (isBuildAsModule.toBoolean()) {
    //allModule
    includeString.add(':app')
    includeString.add(':app-circle')
    includeString.add(':app-shelf')
    includeString.add(':account')
    includeString.add(':app-school')
    includeString.add(':app-mine')
    includeString.add(':app-course')
    includeString.add(':nim-uikit')
    includeString.add(':app-chat')
    includeString.add(':ffmpegkit')
} else {
    //targetModule
    def target = TARGET_MODULE.toString()
    String[] targetList = target.split(',')
    includeString.addAll(targetList)
}

//写入函数
String[] stockArr = new String[includeString.size()];
String[] includeResult = includeString.toArray(stockArr);
for (int i = 0; i < includeResult.size(); i++) {
    println 'includeResult=' + includeResult[i]
}
include(includeResult)

6. 代码提交。

最后还会涉及到代码提交。代码提交时，请保证提交的代码内的isBuildAsModule=true
保证在持续集成环境下，编译出完整的app包。

可能存在的问题记录

• 当做Application的module需要配置Application的主题
• 资源id冲突
  在合并多个组件到主工程中时,可能会出现资源引用冲突,
  最简单的方式是通过实现约定资源前缀名(resourcePrefix)来避免,需要在组件的gradle脚本中配置:

andorid{
    ...

    buildTypes{
        ...
    }

    resourcePrefix "moudle_prefix"

}

*一旦配置resourcePrefix,所有的资源必须以该前缀名开头.比如上面配置了前缀名为moudle_prefix,那么所有的资源名都要加上该前缀,如:mouble_prefix_btn_save.