Android Studio组件化方案——多module编译常见问题

android组件化开发中,工程通常被拆分为多个module。开发中可以根据需要来选择组件开发或者集成开发。

背景知识

Android Studio中一个project可由多个module组成,其中module主要有两种属性:

  • 1、application属性,即该module为可独立运行的app程序
apply plugin: ‘com.android.application’
  • 2、library属性,一般作为app编译运行依赖的库文件,不可独立运行
apply plugin: ‘com.android.library’

注:module的属性在各自的build.gradle文件中配置。

module组件开发和集成开发模式切换

在多个团队进行各自组件的开发时,业务组件应处于application属性,方便开发人员的独立开发、运行及调试。当组件开发完毕需要转为集成模式,业务组件应处于library属性,便于宿主app依赖各业务组件,构造一个具备完整功能app。
为了便于各业务组件在两种属性之间切换,我们可以利用gradle构建工具,在项目根目录的gradle.properties中定义一个属性isModule,true表示当前处于组件开发模式,false表示当前处于集成开发模式。其他业务组件的build.gradle中可以读取gradle.properties中定义的isModule常量,根据需要在两种开发模式间切换。

注:程序员一定要‘懒’,避免重复性的体力劳动。

一、在根目录gradle.properties中添加定义

# 每次更改“isModule”的值后,需要主动 "Sync Project" 
isModule=false

二、在各业务组件的builde.gradle中读取isModule,设置运行属性。其中isModule是String类型,需要进行转换。

if (isModule.toBoolean()) {
    apply plugin: 'com.android.application'  //组件开发模式,独立运行
} else {
    apply plugin: 'com.android.library'  //集成开发模式
}

三、在各业务组件的builde.gradle中读取isModule,设置不同的Manifest文件。
每个业务组件都会有各自的AndroidManifest.xml文件,其中配置了业务组件使用的四大组件、权限、Application等信息。在组件开发模式中,AndroidManifest.xml应该声明组件作为app独立运行所需要的全部属性,e.g.Application信息和桌面启动的Activity。在集成开发模式中,每个业务组件的AndroidManifest.xml都会合并到宿主app中,此时不需要声明Application和桌面启动的Activity等信息。综上,业务组件在切换开发模式的同时,需要切换对应的AndroidManifest.xml。
可以通过创建两个AndroidManifest.xml文件位于不同的路径,并由gradle提供的sourceSets属性来配置不同开发模式使用的AndroidManifest文件路径,来解决上述的冲突问题。

sourceSets {
        main {
            if (isModule.toBoolean()) {
                manifest.srcFile 'src/main/module/AndroidManifest.xml'
            } else {
                manifest.srcFile 'src/main/AndroidManifest.xml'
            }
        }
}

首先是集成开发模式下的 AndroidManifest.xml,不能拥有自己的 Application 和 桌面启动的 Activity,也不能声明APP名称、图标等属性,只能声明自己业务组件独有的东西。示例如下:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.moudlea">

    <application android:theme="@style/AppTheme">
        <activity
            android:name=".AActivity"
            android:screenOrientation="portrait" />
    </application>

</manifest>

然后是组件开发模式下的表单文件,和常见的app的AndroidManifest.xml一致:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.moudlea">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity
            android:name=".AActivity"
            android:screenOrientation="portrait">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

compileSdkVerstion、targetSdkVersion、support-library版本的统一

多moudle开发时,建议统一各个module的compileSdkVerstion、targetSdkVersion、support-library等的版本号,否则容易出现编译问题或者warn。

以下图为例,我将compileSdkVerstion、targetSdkVersion版本号设置为23,但是引入的com.android.support:appcompat-v7包版本号为25.3.1,二者不一致引入了该问题。

compileSdkVersion和support版本不一致引入.png

compile 'com.android.support:appcompat-v7:25.3.1' 改为23后解决
compile 'com.android.support:appcompat-v7:23.2.1'

多moudle编译配置的统一

工程中有多moudle时,每个moudle都有独自的build.gradle文件,可配置各自的编译信息。当buildToolsVersion与其他的编译依赖版本号不一致时,可能出现下图中的错误。这个时候需要更新每个moudle的build.gradle文件。
为了避免上述繁琐的步骤,必须将各moudle的编译依赖信息统一配置,方便后续的更新维护。

buildToolsVersion与其他版本不一致问题.png

解决方案是通过在gradle.properties文件中定义常用的编译配置,然后在各moudle中引用该配置。步骤如下:

一、gradle.properties中定义如下,示例中定义了compileSdkVerstion、targetSdkVersion、support-library等信息

//gradle.properties
MIN_SDK_VERSION=14
COMPLIE_SDK_VERSION=25
TARGET_SDK_VERSION=25

BUILDTOLLS_VERSION=25.0.0
SUPPORT_LIB_VERSION=25.2.0

二、在moudle的build.gradle中引入配置。示例如下:

//build.gradle
android {
    compileSdkVersion Integer.parseInt(COMPLIE_SDK_VERSION)
    buildToolsVersion BUILDTOLLS_VERSION

    defaultConfig {
        minSdkVersion Integer.parseInt(MIN_SDK_VERSION)
        targetSdkVersion Integer.parseInt(TARGET_SDK_VERSION)
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }

    dependencies {
        compile "com.android.support:appcompat-v7:${SUPPORT_LIB_VERSION}"
    }
}

参考:http://blog.csdn.net/cai_iac/article/details/51850291

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,670评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,928评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,926评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,238评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,112评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,138评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,545评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,232评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,496评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,596评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,369评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,226评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,600评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,906评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,185评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,516评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,721评论 2 335

推荐阅读更多精彩内容