Gradle 渠道定制

当一个项目集成许多渠道时候,不知道你们有没有遇到,每上一个渠道的时候,往往需要完成渠道方的要求,比如说集成支付,账号,更改包名等等,如果你使用git分支的话,随着你的版本升级和渠道的增加,你维护的成本就会越来越高。

好在Android Studio使用Gradle构建项目,熟悉Android gradle DSL(领域定义语言)的话,Gradle实现多渠道打包,已经是信手拈来。这里提供一个场景,我们要使用Gradle构建来实现定制化渠道。

很多渠道方接入的需求:1.指定包名 2.指定图标 3.接入账号或支付(引入jar或工程方式) 4.指定界面和申请appkey(Manifest中处理) 等等...下面我们通过Gradle的构建,实现Build Variants,在一个工程中构建起来。

查看Android Studio 用户指南,这里面有关Gradle构建的文档,这里先设定好我们要接入的渠道名是special,这个渠道需要实现上面的需求,首先在主工程gradle中创建我们special的flavor

android {
    ...
    defaultConfig {...}
    buildTypes {...}
    productFlavors {
        normal {
            applicationId "com.example.testdemo.normal"
            versionName "1.0"
        }
        special {
            applicationId "com.example.testdemo.special"
            versionName "1.0"
        }
    }
}

我们修改了我们的包名,那么修改包名的需求就已经完成了。也许有些同学会问,我怎么知道哪些参数可以写呢?可以通过查看文档Android-gradle-DSL-ProductFlavor。DSL(领域特定语言)这种语言你必须要了解其定义你才知道怎么用,查看文档是少不了的了。

使用manifestPlaceholders,把我们flavors与渠道绑定。在使用友盟的话,可能在在manifest中有这样的定义

<meta-data
            android:name="UMENG_CHANNEL"
            android:value="{$CHANNEL}" />

然后在gradle中配置,这样渠道跟flavor就关联起来了

productFlavors {
        normal {
            applicationId "com.example.testdemo.normal"
            versionName "1.0"
            manifestPlaceholders = [ "CHANNEL": "normal"]
        }
        special {
            applicationId "com.example.testdemo.special"
            versionName "1.0"
            manifestPlaceholders = [ "CHANNEL": "special"]
        }
    }

其实我们可以在gradle文件设置默认配置,这样flavor中没有配置的就会使用默认配置,配置了则会覆盖默认的

defaultConfig {
        applicationId "com.example.testdemo.normal"
        minSdkVersion 14
        targetSdkVersion 21
        versionCode 1
        versionName "1.0"
    }

接下来,我的special渠道方要求我们导入一个special.jar的jar包,来接入他的账户系统或者支付,怎样做到渠道依赖独立呢?在gradle中我们可以通过flavorCompile的方式来进行渠道依赖

dependencies {
        compile files('libs/commom.jar')
        specialCompile('libs/special.jar') 
}

注意:flavorCompile这个方式,在productFlavors的flavor必须首字母小写才能生效。例如flavor是Special的话SpecialCompile编译都过不了

选择自己想要flavor运行,打开Build,选择Selcet Build Variant


在Build Variant中有选择specialDebug,运行即是debug的special渠道包。


接入渠道方账号或者支付,就无法避免要引用到jar包的代码,这样就需要把代码也根据渠道来区分开来。我们可以创建flavor文件夹来区别渠道渠道独立的代码,在src创建flavor名字一直的文件夹,文件夹结构跟main的一致即可

这里需要注意的是,flavor跟main的文件是会合并的,合并存在一定的规则。
java中代码合并,如果有相同的文件是会报错重复错误的,所以main文件夹中,应该存放共有的代码,而flavor文件夹中存放自己所需要的独立的代码。
res中资源的合并,优先级是flavor高于main,即flavor中资源会加入或覆盖main中资源。如果special渠道要求指定的icon和appName,则在special中res中替换到默认的icon,在string.xml中改正相应的appName即可。
AndroidManifest.xml合并,其实也是增加和覆盖,但是往往我们合并的时候会遇到Merge failed的情况,例如:

这个是因为我在main的Manifest中MainActivity设置了竖屏,而在special的Manifest中设置了横屏,从而报错。那么遇到这种情况怎么处理呢?查看Android Studio 用户指南manifest-merge文段,我们可以使用manifest marker解决这个问题,在special的Manifest中使用tools:node="replace"就可以解决这个问题啦。


申请的appkey,如果在manifest中声明也会根据Manifest的规则合并进去。

总结一下,通过上面的方式,我们实现了应用包名不同,资源代码根据渠道分离。而且包体中不包含其他渠道所需的jar包,精简了包体大小,代码也是在同一的分支上,不需要切换分支和版本升级合并维护的繁琐。

Gradle功能强大,我目前对于gradle的语言的学习,也仅仅是查文档的阶段,发现Android Studio 用户指南Android-gradle-DSL-Reference真的非常好用,熟悉这两个文档一般都可以完成项目的多渠道定制化需求。而关于Gradle 定制task,关于grovvy相关我自己还不是很清楚,以后学习了有机会再分享给大家。

关于Gradle认知,这篇文章很全面,有时间一定多看几遍Gradle详解

参考:
https://developer.android.com/studio/build/index.html
http://google.github.io/android-gradle-dsl/current/index.html
http://www.infoq.com/cn/articles/android-in-depth-gradle/

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,046评论 25 707
  • 1.介绍 如果你正在查阅build.gradle文件的所有可选项,请点击这里进行查阅:DSL参考 1.1新构建系统...
    Chuckiefan阅读 12,094评论 8 72
  • 转载注明出处:http://www.jianshu.com/p/5255b100930e 0. 前言 完全由个人翻...
    王三的猫阿德阅读 2,483评论 0 4
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,494评论 18 139
  • 每当看到一些人在因为某某骗子落入法网而欢欣雀跃的时候,我都忍不住在想,当别人骗我们的时候一定会有高大的警察叔叔来帮...
    张春天阅读 338评论 0 0