在Android实际项目中的Gradle文件的使用


Android Studio使用Gradle 编译运行Android工程,工程的每个模块以及整个工程都有一个build.gradle文件。通常你只需要关注模块的build.gradle文件。
那先来看看app下面的build.gradle文件(算是整个项目最主要的配置,我用的具体线上项目说说):
在文件开头

apply plugin: 'com.android.application'//表示该module是一个app module,应用了com.android.application插件 ,如果是一个依赖module 则此处为apply plugin: 'com.android.library'
apply plugin: 'me.tatarka.retrolambda'//添加其它插件,具体功能自行查询

接下来看看android{}块里面的配置内容:

dependencies {
    compile fileTree(include: '*.jar', dir: 'libs')
    compile project(':domain')
//依赖library
    releaseCompile project(path: ':data', configuration: 'release')
    debugCompile project(path: ':data', configuration: 'debug')

    def presentationDependencies = rootProject.ext.presentationDependencies
  
    apt presentationDependencies.daggerCompiler
    compile presentationDependencies.zxing
    compile presentationDependencies.dagger
}

//所有渠道不变的key
def unChangedKeyMap() {
    LinkedHashMap<String, Object> map = new LinkedHashMap<String, Object>();
    map.put("UMENG_KEY", "******")
    map.put("TTS_APPKEY", "*****")
    return map
}

//某些渠道公用的key
def commonKeyMap() {
    LinkedHashMap<String, Object> map = new LinkedHashMap<String, Object>();
    map.put("MAP_KEY", "********")
    return map
}
android {
    useLibrary 'org.apache.http.legacy'//如果以前项目使用了apache的网络访问api,在6.0以后不提供而还想继续使用的的话加上这个
    compileSdkVersion 23
    buildToolsVersion '23.0.2'
    defaultConfig {
        minSdkVersion 14
        targetSdkVersion 21
        multiDexEnabled true
        applicationId "com.example.hulixia.airdnbtest"
        versionCode 40
        versionName "4.0"
        //设置默认应用程序的包名
        resValue "string", "app_name", "just test"
        buildConfigField "String", "WXAPPID", "\"*********\""
    }

    sourceSets {// 配置源码路径,sourceSets是java插件引入的
        main {
            manifest.srcFile 'AndroidManifest.xml'//设置清单文件的路径
            java.srcDirs = ['src']//设置java代码的目录
            resources.srcDirs = ['src']//设置资源文件目录
            aidl.srcDirs = ['src']//设置aidl的文件目录
            renderscript.srcDirs = ['src']
            res.srcDirs =
                    [
                            'res/layouts/common',//给layout文件分目录
                            'res/layouts/testui',
                            'res/layouts',
                            'res'
                    ]
            assets.srcDirs = ['assets']//asset文件分目录
            jniLibs.srcDirs = ['libs']//给so文件设置目录
        }

        // Move the build types to build-types/<type>
        // For instance, build-types/debug/java, build-types/debug/AndroidManifest.xml, ...
        // This moves them out of them default location under src/<type>/... which would
        // conflict with src/ being used by the main source set.
        // Adding new build types or product flavors should be accompanied
        // by a similar customization.
        debug.setRoot('build-types/debug')//指定debug模式的路径
        release.setRoot('build-types/release')//指定release模式的路径
    }

    //  debug和release版本的签名
    signingConfigs {
        release {
            storeFile file("publish.keystore")
            storePassword "123456"
            keyAlias "huhuhahei"
            keyPassword "123456"
        }
    }
    buildTypes {//构建类型,通常有release和debug两种
        release {
            buildConfigField "boolean", "IS_DEBUG", "false" //调试开关,正式包关闭
//动态设置变量,release通常和debug不一样
            buildConfigField "String", "SERVER_URL", "\"http://cn.bing.com/\""
            buildConfigField "String", "TRANSLATE_URL", "\"http://www.bing.com/translator/?mkt=zh-CN\""
       

            signingConfig signingConfigs.release //使用上面定义的signingConfigs成员
            minifyEnabled true //开启混淆
            shrinkResources true;//是否移除无用资源文件,shrinkResources依赖于minifyEnabled,必须和minifyEnabled一起用
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'//混淆文件

            applicationVariants.all { variant ->
                variant.outputs.each { output ->
                    def outputFile = output.outputFile
                    ver
                    if (outputFile != null && outputFile.name.endsWith('.apk')) {
                        def fileName = "JustTest${defaultConfig.versionName}_${variant.productFlavors[0].name}.apk"
                        output.outputFile = new File(outputFile.parent, fileName)
                    }
                }
            }
        }
        debug {
            signingConfig signingConfigs.release
            buildConfigField "boolean", "IS_DEBUG", "true" //调试开关,正式包关闭
            buildConfigField "String", "SERVER_URL", "\"http://www.google.com/\""
            buildConfigField "String", "TRANSLATE_URL", "\"https://translate.google.cn/\""
        }
    }


    productFlavors {
       baidu {
           LinkedHashMap<String, Object> map = unChangedKeyMap()
          map.putAll(commonKeyMap())
           map.put("UMENG_CHANNEL_VALUE", "baidu")
            manifestPlaceholders = map
        }
       hw {
            LinkedHashMap<String, Object> map = unChangedKeyMap()
           map.putAll(commonKeyMap())
            map.put("UMENG_CHANNEL_VALUE", "hw")
            manifestPlaceholders = map
        }
    }

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    lintOptions {//程序在buid的时候,会执行lint检查,有任何的错误或者警告提示,都会终止构建,我们可以将其关掉。
        abortOnError false 
        ignoreWarnings true
        checkReleaseBuilds false
    }

    dexOptions {//为dex操作指定JVM的最大内存分配池的选项为
        javaMaxHeapSize "2g"
    }

    packagingOptions {//依赖中认为是不需要的内容,因为多个 jar 包里包含了同样的文件
        exclude 'META-INF/NOTICE.txt'
        exclude 'META-INF/LICENSE.txt'
    }

    splits {
        abi {
            enable true
            reset()
            include 'armeabi'
            universalApk false
        }
    }

}
compileSdkVersion  23:基于SDK 23编译,这里是API LEVEL
buildToolsVersion  '23.0.2'   基于23.0.2构建工具版本进行构建的
defaultConfig 默认配置,如果没有其他的配置覆盖,就会使用这里的。
minSdkVersion 15 创建项目时指定的最低SDK版本为15,是新建应用支持的最低SDK版本。也就是说在低于15的设备上是不能运行的
applicationId 创建新项目时指定的包名。
versionCode 版本号
versionName 版本名称
resValue 动态添加资源
buildConfigField 在BuildConfig文件中生成变量

targetSdkVersion

这里重点讲一下targetSdkVersion,因为它让许多人都感到迷糊。
Google原文是这么说的:

  • targetSdkVersion is the main way Android provides forward compatibility

targetSdkVersion 是 Android 系统提供前向兼容的主要手段。这是什么意思呢?随着 Android 系统的升级,某个系统的 API 或者模块的行为可能会发生改变,但是为了保证老 APK 的行为还是和以前兼容。只要 APK 的 targetSdkVersion 不变,即使这个 APK 安装在新 Android 系统上,其行为还是保持老的系统上的行为,这样就保证了系统对老应用的前向兼容性。
这里举个官方的例子,在 Android 4.4 (API 19)以后,AlarmManager 的 set()和setRepeat()这两个 API 的行为发生了变化。在 Android 4.4 以前,这两个 API 设置的都是精确的时间,系统能保证在 API 设置的时间点上唤醒 Alarm。因为省电原因 Android 4.4 系统实现了 AlarmManager 的对齐唤醒,这两个 API 设置唤醒的时间,系统都对待成不精确的时间,系统只能保证在你设置的时间点之后某个时间唤醒。

这时,虽然 API 没有任何变化,但是实际上 API 的行为却发生了变化,如果老的 APK 中使用了此 API,并且在应用中的行为非常依赖 AlarmManager 在精确的时间唤醒,例如闹钟应用。如果 Android 系统不能保证兼容,老的 APK 安装在新的系统上,就会出现问题。

Android 系统是怎么保证这种兼容性的呢?这时候 targetSdkVersion 就起作用了。APK 在调用系统 AlarmManager 的set()或者setRepeat()的时候,系统首先会查一下调用的APK的targetSdkVersion 信息如果小于 19,就还是按照老的行为,即精确设置唤醒时间,否者执行新的行为。
我们来看一下 Android 4.4 上 AlarmManger 的一部分源代码:

private final boolean mAlwaysExact;  
AlarmManager(IAlarmManager service, Context ctx) {  
    mService = service;

    final int sdkVersion = ctx.getApplicationInfo().targetSdkVersion;
    mAlwaysExact = (sdkVersion < Build.VERSION_CODES.KITKAT);
}

首选获取应用的 targetSdkVersion,判断是否是小于 Build.VERSION_CODES.KITKAT (即 API Level 19),来设置 mAlwaysExact 变量,表示是否使用精确时间模式。
看到这里,发现其实 Android 的 targetSdkVersion 并没有什么特别的,系统使用它也非常直接,甚至很“粗糙”。仅仅是用过下面的 API 来获取 targetSdkVersion,来判断是否执行哪种行为:

getApplicationInfo().targetSdkVersion;  

我们也可以理解原文中说的那句话的含义,明白了为什么修改了 APK 的 targetSdkVersion 行为会发生变化,也明白了为什么修改 targetSdkVersion 需要做完整的测试了。

multiDexEnabled

设置为true表示分成多个dex文件,因为有个方法数65k的限制问题

sourceSets

设置了sourceSets之后的工程目录结构:

applicationVariants 定制生成apk的名称


            applicationVariants.all { variant ->
                variant.outputs.each { output ->
                    def outputFile = output.outputFile
                    ver
                    if (outputFile != null && outputFile.name.endsWith('.apk')) {
                        def fileName = "JustTest${defaultConfig.versionName}_${variant.productFlavors[0].name}.apk"
                        output.outputFile = new File(outputFile.parent, fileName)
                    }
                }
            }

生成的apk名称为(假设是baidu渠道):JustTest4.0_baidu.apk

productFlavors 多渠道打包

国内有太多Android App市场,每次发版几十个渠道包。还好Android Gradle给我们提供了productFlavors,我们可以对生成的APK包进行定制。
在上面的例子中unChangedKeyMap是共用的数据,像什么UMENG,迅飞语音的key。在上面的例子中将数据信息根据不同的渠道传递不同的数据信息到清单文件中,AndroidManifest代码片段:

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

Splits 使用分割ABI 和 屏幕密度的方式来发布多个 apk

apk 瘦身系列④:使用分割ABI 和 屏幕密度的方式来发布多个apk

dependencies

本地依赖,默认情况下,新建的Android项目会有一个lib文件夹

dependencies {
    compile fileTree(include: '*.jar', dir: 'libs')}////即添加所有在libs文件夹中的jar
 //compile files('libs/test.jar')//不需要这样一个个去写了
 compile project(':domain')//编译domain模块

有必要说一下当一个项目下有多个模块,每个模块可能都有自己要依赖的远程库,为了统一管理,这个在根目录建个config.gradle。然后在根目录下build.gradle最顶部加上下面一行代码

apply from: "config.gradle"

config.gradle中代码片段:

ext {
 daggerVersion = '2.0.2'
  zxingVersion = "3.2.1"
}
 presentationDependencies = [
 zxing              : "com.google.zxing:core:${zxingVersion}",
daggerCompiler     : "com.google.dagger:dagger-compiler:${daggerVersion}"
]

在app下的build.gradle文件中使用

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

推荐阅读更多精彩内容