Android Gradle全局配置

最新推荐文章于 2024-05-17 16:06:38 发布

AND_YOU_with_ME

最新推荐文章于 2024-05-17 16:06:38 发布

阅读量973

点赞数

分类专栏： Android 文章标签： android gradle 管理

Android 专栏收录该内容

64 篇文章 0 订阅

订阅专栏

Gradle是一个优秀的构建系统和构建工具，它允许通过插件创建自定义的构建逻辑。基于Gradle以下的一些特点而选择了它：
1、采用了Domain Specific Language(DSL语言)来描述和控制构建逻辑。
2、构建文件基于Groovy，并且允许通过混合声明DSL元素和使用代码来控制DSL元素以控制自定义的构建逻辑。
3、支持Maven或者Ivy的依赖管理。
4、非常灵活。允许使用最好的实现，但是不会强制实现的方式。
5、插件可以提供自己的DSL和API以供构建文件使用。

6、良好的API工具供IDE集成。

Gradle全局配置：

一般我们各个module的build.gradle中都有这一段配置：

android {
    compileSdkVersion 25
    buildToolsVersion '25.0.0'
    defaultConfig {
        minSdkVersion 15
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"
    }
}

假如我们项目中有多个module，如果升级targetSdk、buildTool等，那么每个module都需要改值，不仅麻烦，还有可能导致module之间的版本不统一而出现问题，解决方法是Gradle配置全局变量供各个module使用，在你的Project的根目录下的build.gradle定义ext全局变量：

ext {
    compileSdkVersion = 25
    buildToolsVersion = '25.0.0'
    minSdkVersion = 15
    targetSdkVersion = 25
    versionCode = 1
    versionName = "1.0"
}

然后在各module中的build.gradle中引用如下：

android {
    compileSdkVersion rootProject.ext.compileSdkVersion
    buildToolsVersion rootProject.ext.buildToolsVersion
    defaultConfig {
        minSdkVersion rootProject.ext.minSdkVersion
        targetSdkVersion rootProject.ext.targetSdkVersion
        versionCode rootProject.ext.versionCode
        versionName rootProject.ext.versionName
    }
}

这样每次修改Project的build.gradle配置就可以实现全局配置了。

在release版本中关闭Log

我们在调试代码的时候希望显示Log日志信息，但是当我们发布到应用市场的时候我们又不希望我们的应用显示Log信息，因为这样会拖慢应用的运行速度甚至是暴露关键信息，那么该怎么办呢？可以通过配置buildTypes来达到在release版本中自动关闭Log的效果：

buildTypes {
        release {
            minifyEnabled false
            buildConfigField "boolean", "IS_SHOW_LOG", NOT_SHOW_LOG
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            minifyEnabled false
            buildConfigField "boolean", "IS_SHOW_LOG", SHOW_LOG
        }
    }

配置的buildConfigField参数，编译后会在..\app\build\generated\source\buildConfig文件夹下会自动生成对应版本对应module的BuildConfig.java文件，该文件可以在代码中直接使用，上面配置信息中的NOT_SHOW_LOG和SHOW_LOG是在Project的gradle.properties中定义的值：

org.gradle.jvmargs=-Xmx1536m
SHOW_LOG true
NOT_SHOW_LOG false

先来解释下buildConfigField的用法， buildConfigField 使用示例：

buildConfigField "boolean", "IS_SHOW_LOG", NOT_SHOW_LOG

buildConfigField 各参数含义：

buildConfigField	备注
String type	要创建的字段类型，如上面的boolean
String name	要创建的字段名，如上面的IS_SHOW_LOG
String value	创建此字段的值，如上面的NOT_SHOW_LOG(false)

配置好上面的信息后，在项目中编写一个LogUtil.java类如下：

public class LogUtil {
    public static int v(String tag, String msg) {
        if (BuildConfig.IS_SHOW_LOG) {
            return Log.v(tag, msg);
        } else {
            return -1;
        }
    }
---------其他方法----------
}

上面对Log类做了一层封装，根据BuildConfig.IS_SHOW_LOG的值来决定是否打印Log，我们在buildTypes 的release 里面配置的IS_SHOW_LOG是false，在debug 里面配置的IS_SHOW_LOG是true，这样当我们调试的时候会显示log日志，而当我们打的是release 包的时候就会自动屏蔽了Log。

Build Variant 管理，多渠道打包

BuildTypes：定义了编译类型，针对每个类型可以有不同的编译配置（通常在混淆代码、可调试、资源压缩上做一些区分）。默认的有debug、release 类型，除了这两种外还可以手动添加编译类型（如preview）。
ProductFlavors：如果针对同一个BuildType还想编译出多个版本（如友盟多渠道打包，根据不同的meta-data中的值来区分不同的渠道），这时候就需要ProductFlavors了。
所以最后可以编出的APK的个数 = BuildTypes x ProductFlavors，即：

Build Variant = BuildTypes x ProductFlavors

友盟多渠道打包示例：

1、首先在AndroidManifest.xml中定义meta-data：

<meta-data
    android:name="UMENG_CHANNEL"
    //占位符，在build.gradle中赋值
    android:value="${UMENG_CHANNEL_VALUE}" />

2、配置buildTypes

可以手写，也可以让Gradle自动生成，步骤：在app上点右键->Open Module Settings->点击Build Types 按钮，即可配置不同的buildType了，如下所示又加了一个preview ：

buildTypes {
        release {
            minifyEnabled false
            buildConfigField "boolean", "IS_SHOW_LOG", NOT_SHOW_LOG
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            minifyEnabled false
            buildConfigField "boolean", "IS_SHOW_LOG", SHOW_LOG
        }
        preview {
            minifyEnabled false
            buildConfigField "boolean", "IS_SHOW_LOG", SHOW_LOG
        }
    }

3、配置 productFlavors，可以手写，也可以让Gradle自动生成，步骤：在app上点右键->Open Module Settings->点击Flavors按钮，即可配置不同的Flavors了：

最后在生成的productFlavors中给UMENG_CHANNEL_VALUE赋值：

//给AndroidManifest.xml中的UMENG_CHANNEL_VALUE赋值
  productFlavors {
        market_meizu {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "meizu"]
        }
        market_xiaomi {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "meizu"]
        }
        market_huawei {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "huawei"]
        }
        market_wandoujia {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"]
        }
        market_yingyongbao {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "yingyongbao"]
        }
        market_360 {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "360"]
        }
    }

4、修改生成的APK名称

//获取时间戳
def getDate() {
    def date = new Date()
    def formattedDate = date.format('yyyyMMddHHmm')
    return formattedDate
}

//修改APK生成名字  通过android.applicationVariants索引来遍历所有的 build variant
    applicationVariants.all { variant ->
        variant.outputs.each { output ->

            def timeNow = getDate()
            def newName
            if (variant.buildType.name.equals('debug')) {
                newName = "android-" + timeNow + "_v${variant.versionName}-debug.apk"
            } else {
                newName = "android_${variant.flavorName}_" + timeNow + "_v${variant.versionName}.apk"
            }
            output.outputFile = new File(output.outputFile.parent, newName)
        }
    }

如现在想生成 preview版本，在buildtypes中选择preview，选择我们要打的渠道包，点击finish

最后生成的渠道包，名字即是按我们想要的命名的

完整的build.gradle

apply plugin: 'com.android.application'

//获取时间戳
def getDate() {
    def date = new Date()
    def formattedDate = date.format('yyyyMMddHHmm')
    return formattedDate
}

android {
    compileSdkVersion rootProject.ext.compileSdkVersion
    buildToolsVersion rootProject.ext.buildToolsVersion
    defaultConfig {
        applicationId "org.ninetripods.mq.study"
        minSdkVersion rootProject.ext.minSdkVersion
        targetSdkVersion rootProject.ext.targetSdkVersion
        versionCode rootProject.ext.versionCode
        versionName rootProject.ext.versionName
        vectorDrawables.useSupportLibrary = true
        buildConfigField "boolean", "IS_SHOW_LOG", "false"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
//        ndk {
//            abiFilters 'armeabi-v7a', 'armeabi'
//        }

    }
    sourceSets {
        main {
            java.srcDirs = ['src/main/java', 'src/main/aidl']
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            buildConfigField "boolean", "IS_SHOW_LOG", NOT_SHOW_LOG
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            minifyEnabled false
            buildConfigField "boolean", "IS_SHOW_LOG", SHOW_LOG
        }
        preview {
            minifyEnabled false
            buildConfigField "boolean", "IS_SHOW_LOG", SHOW_LOG
        }
    }
    productFlavors {
        market_meizu {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "meizu"]
        }
        market_xiaomi {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "meizu"]
        }
        market_huawei {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "huawei"]
        }
        market_wandoujia {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"]
        }
        market_yingyongbao {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "yingyongbao"]
        }
        market_360 {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "360"]
//            ndk {
//                abiFilters 'armeabi'
//            }
        }
    }

    //修改APK生成名字  通过android.applicationVariants索引来遍历所有的 build variant
    applicationVariants.all { variant ->
        variant.outputs.each { output ->

            def timeNow = getDate()
            def newName
            if (variant.buildType.name.equals('debug')) {
                newName = "android-" + timeNow + "_v${variant.versionName}-debug.apk"
            } else {
                newName = "android_${variant.flavorName}_" + timeNow + "_v${variant.versionName}_${variant.buildType.name}.apk"
            }
            output.outputFile = new File(output.outputFile.parent, newName)
        }
    }
//    externalNativeBuild {
//        cmake {
//            path 'CMakeLists.txt'
//        }
//    }
}

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    //汉字转拼音，通讯录 https://github.com/promeG/TinyPinyin
    // TinyPinyin核心包，约80KB
    // 可选，适用于Android的中国地区词典
    compile 'com.android.support:design:25.2.0'
    compile 'com.android.support:appcompat-v7:25.2.0'
    compile 'com.android.support:recyclerview-v7:25.2.0'
    compile 'com.android.support.constraint:constraint-layout:1.0.2'
    compile 'com.android.support:support-v4:25.3.1'
    compile 'com.github.promeg:tinypinyin:2.0.3'
    compile 'com.github.promeg:tinypinyin-lexicons-android-cncity:2.0.3'
    testCompile 'junit:junit:4.12'
}