Gradle系列(三) Gradle配置构建和渠道包，这份火爆全网的452页Android Framework内核解析

最新推荐文章于 2024-05-16 04:04:16 发布

2401_84148955

最新推荐文章于 2024-05-16 04:04:16 发布

阅读量601

点赞数 10

分类专栏：程序员文章标签： android

本文链接：https://blog.csdn.net/2401_84148955/article/details/137493596

版权

程序员专栏收录该内容

145 篇文章 0 订阅

订阅专栏

kotlin : “org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version”,

leakcanary : [

android : “com.squareup.leakcanary:leakcanary-android:$leakcanary_version”,

android_no_op : “com.squareup.leakcanary:leakcanary-android-no-op:$leakcanary_version”,

support_fragment: “com.squareup.leakcanary:leakcanary-support-fragment:$leakcanary_version”,

]

}

在build.gradle中使用

dependencies {

implementation Config.depConfig.support.recyclerview_androidx

…

}

3. 渠道包

3.1 productFlavors

productFlavors直译为产品风味,Android这边用它来做多渠道.在app的build.gradle中加入如下配置

android {

flavorDimensions “channel”

productFlavors {

free {

dimension “channel”

//程序包名

applicationId “com.xfhy.free”

//替换清单文件中的标签

manifestPlaceholders = [

APP_ICON: “@drawable/ic_launcher”,

APP_NAME: “xx免费版”,

]

//versionName

versionName “2.0.0”

//versionCode

versionCode 2

}

vip {

dimension “channel”

//程序包名

applicationId “com.xfhy.vip”

//替换清单文件中的标签

manifestPlaceholders = [

APP_ICON: “@drawable/ic_launcher”,

APP_NAME: “xxVip版”,

]

//versionName

versionName “3.0.0”

//versionCode

versionCode 3

}

svip {

dimension “channel”

}

如代码所示,我们配置了3种类型的风味,在productFlavors中可以配置包名（applicationId）、版本号（versionCode）、版本名（versionName）、icon、应用名.并且可以在里面配置各种你之前在defaultConfig里面配置的东西.还可以配置src代码目录,res目录之类的.并且这个时候Build Variants里面有了多种类型,比如:freeDebug,freeRelease,vipDebug,vipRelease等.你在Build Variants里面选择freeDebug,则是使用free风味,并且是debug时使用的配置.

<application

xmlns:tools=“http://schemas.android.com/tools”

android:icon=“${APP_ICON}”

android:label=“${APP_NAME}”

android:theme=“@style/AppTheme”

android:largeHeap=“true”

tools:replace=“android:label”>

…

3.2 渠道变量

首先来介绍一个关键词扩展:applicationVariants,它是在AppExtension里面的,它的官方文档,它意思是返回应用程序项目包含的构建变体的集合,是用all关键词进行遍历.我们拿到了这些变体之后,可以根据当前是哪个变体来构建出相应变体所特殊的变量.比如内测和外测它们的地址肯定不一样的,那么通过这种方式可以很方便地整出来.构建的变量会存在于相应的BuildConfig中,然后在java代码中直接引用就行,替换地址时也不需要动java代码,只需在gradle中改一下,然后它编译的时候就会自动构建BuildConfig,自动将地址搞成最新的了.说了这些多,show me the code!

android {

applicationVariants.all { variant ->

//构建变体专属变量

switch (variant.flavorName) {

case ‘free’:

buildConfigField(“String”, “BASE_URL”, "“http://31.13.66.23"”)

buildConfigField(“String”, “TOKEN”, ““dhaskufguakfaskfkjasjhbfree””)

break

case ‘vip’:

buildConfigField(“String”, “BASE_URL”, "“http://31.13.66.24"”)

buildConfigField(“String”, “TOKEN”, ““dhaskfagafkjasjhbvip””)

break

case ‘svip’:

buildConfigField(“String”, “BASE_URL”, "“http://31.13.66.25"”)

buildConfigField(“String”, “TOKEN”, ““dhaskufgufgsdagajasjhbsvip””)

break

}

将上面的代码写在app的build.gradle中,在上面的gradle代码中我们定义了2个变量,不同的变体会构建不同的值,比如上面的BASE_URL我们会在free变体编译的时候就会在BuildConfig生成一个变量,值是http://31.13.66.23.我们来看一下BuildConfig中是些什么内容:

//build\generated\source\buildConfig\free\debug\com\xfhy\gradledemo\BuildConfig.java

public final class BuildConfig {

public static final boolean DEBUG = Boolean.parseBoolean(“true”);

public static final String APPLICATION_ID = “com.xfhy.free”;

public static final String BUILD_TYPE = “debug”;

public static final String FLAVOR = “free”;

public static final int VERSION_CODE = 2;

public static final String VERSION_NAME = “2.0.0”;

// Fields from the variant

public static final String BASE_URL = “http://31.13.66.23”;

public static final String TOKEN = “dhaskufguakfaskfkjasjhbfree”;

}

这个文件是gradle构建时自动为我们创建的,不需要去修改.我们构建的变体变量在最下面,这里面的值确实是我们在gradle代码中写的那样.这个里面已经有一些不是我们搞出来的变量了,比如是否是DEBUG,APPLICATION_ID,VERSION_CODE之类的.我们在java代码中使用的时候,直接BuildConfig.BASE_URL这种方式进行使用即可,它就是一个普通的java类,里面定义了一些变量而已.

当然除了上面的渠道变量之外,还有一些变量是公用的,每个变体都是一样的那种.我们可以写到defaultConfig下面.

android {

defaultConfig {

buildConfigField(“String”, “APP_DESCRIPTION”, ““你没有见过的船新版本””)

buildConfigField(“String[]”, “TAB”, “{“首页”,“排行榜”,“我的”}”)

}

3.3 打包文件命名

还是利用上面的applicationVariants,当我们拿到了变体之后,在打包的时候动态的将打包之后的文件名改一下.比如改成下面这种形式

applicationVariants.all { variant ->

variant.outputs.all {

def type = variant.buildType.name

def channel = variant.flavorName

outputFileName = “demo_ $KaTeX parse error: Expected group after '_' at position 22: \dotsnt.versionName}_̲$ {channel}_${type}.apk”

}

最后它打出来的包是这样的demo_2.0.0_free_debug.apk,写完之后可以使用gradlew assembleFreeDebug命令试一下.命令运行之后会在app\build\outputs\apk\free\debug目录下产生相应的apk文件.

3.4 签名

可以在gradle中指定打包时的签名文件,密码啥的

signingConfigs {

debug {

storeFile file(‘…/keys/xfhy.jks’)

storePassword “qqqqqq”

keyAlias “xfhy”

keyPassword “qqqqqq”

v1SigningEnabled true

v2SigningEnabled true

}

release {

storeFile file(‘…/keys/xfhy.jks’)

storePassword “qqqqqq”

keyAlias “xfhy”

keyPassword “qqqqqq”

v1SigningEnabled true

v2SigningEnabled true

}

指定了签名以及密码之后,打包的时候就只需要在命令行执行gradlew assembleVipRelease即可,不用打开Android Studio了.

3.5 资源

Android Studio提供了代码整合功能.只需要创建app/src/xxFlavorName/assets,app/src/xxFlavorName/src,app/src/xxFlavorName/res即可.当在Build Variants中切换切换变体之后,AS就只会编译对应变体的资源+main下面的资源.

可以看到,free下面的文件夹自动变色了,这些是free变体特殊的东西,只有在free编译的时候才会被用到.java代码,res资源等,到时是需要和main下面的一起合并的.

假如我在free变体下创建了Test.java,然后可以在main下面引用到,就和平时使用一样.但是如果相同包名下如果free中有Test.java,main中也有,那么是编译不过的. 还有就是当main里面用到了Test.java的时候,在Build Variants中切换成了vip,而vip中刚好没有Test.java,就会报错的,因为找不到这个文件.

上面这个问题,可以用sourceSets来解决,sourceSets可以指定代码资源文件的位置.虽然上面创建的free,vip等变体文件夹下面也是放这些东西的,但是用sourceSets比他们优先级高.

下面来看它的普通用法,一看就懂.

sourceSets {

main {

manifest.srcFile ‘AndroidManifest.xml’

java.srcDirs = [‘src’]

aidl.srcDirs = [‘src’]

renderscript.srcDirs = [‘src’]

res.srcDirs = [‘res’]

assets.srcDirs = [‘assets’]

}

然后我们除了在src/main/java下有java代码,还可以指定在其他地方有java代码.比如下面这样.可以在src下面创建common/java文件夹,用于存放公共的代码.