Android---gradle全局配置config.build

概念

Gradle的官方定义:

Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化构建开源工具。它使用一种基于Groovy的特定领域语言(DSL)来声明项目设置,抛弃了基于XML的各种繁琐配置。

个人通俗的理解为:

Gradle是一个构建工具,是用来帮我们执行编译、打包APP等过程的,并且我们可以自己配置构建规则,Gradle便可以根据我们的命令为我们自动构建出apk包

以下内容基于Android Studio编译器进行初建的APP工程进行示例说明

全局配置文件

随着APP项目的模块化开发、组件化开发以及插件化开发等模式的出现,为了能方便在不同的module中进行统一管理公共配置信息,全局的gradle配置文件显得有必要,其中下列方式只是其中的一种配置方式
在项目的根目录下创建config.gradle文件,用来统一定义并管理公共配置信息部分
在这里插入图片描述
统一定义并管理的config.gradle内容

/**
 * ext:扩展内容,固定格式(即只能用ext{}),并且是一个闭包的内容
 */
ext {
    //appcompatV7Version:自定义的属性,下同
    appcompatV7Version = "26.+"
    junitVersion = "4.12"
    //appId:自定义的一个map映射集合,key-value
    appId = [
            "app": "app的包名"
    ]
    android = [
            compileSdkVersion: 26,
            buildToolsVersion: "26.0.2",
            minSdkVersion    : 19,
            targetSdkVersion : 26,
            versionCode      : 1,
            versionName      : "1.0"
    ]

    dependencies = [
            //shell语言语法:${变量名}
            "appcompat-v7": "com.android.support:appcompat-v7:${appcompatV7Version}",
            "junit"       : "junit:junit:${junitVersion}"

    ]
}

config.gradle文件的使用
在这里插入图片描述
其实上图的写法与以下内容的写法是一样的,区别只是做了两个配置文件的整合而已

// Top-level build file where you can add configuration options common to all sub-projects/modules.

/**
 * ext:扩展内容,固定格式(即只能用ext{}),并且是一个闭包的内容
 */
ext {
    //appcompatV7Version:自定义的属性,下同
    appcompatV7Version = "26.+"
    junitVersion = "4.12"
    //appId:自定义的一个map映射集合,key-value
    appId = [
            "app": "app的包名"
    ]
    android = [
            compileSdkVersion: 26,
            buildToolsVersion: "26.0.2",
            minSdkVersion    : 19,
            targetSdkVersion : 26,
            versionCode      : 1,
            versionName      : "1.0"
    ]

    dependencies = [
            //shell语言语法:${变量名}
            "appcompat-v7": "com.android.support:appcompat-v7:${appcompatV7Version}",
            "junit"       : "junit:junit:${junitVersion}"

    ]
}

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.3.3'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

全局配置的使用

以app模块为例(参照配置中的注释进行理解)
在这里插入图片描述

apply plugin: 'com.android.application'

//赋值与引用,def 类型 相当于java中的Object类型,如config是一个map集合对象
def config = rootProject.ext.android
def appId = rootProject.ext.appId
println("config内容:${config}")//输出内容-》config内容:[compileSdkVersion:26, buildToolsVersion:26.0.2, minSdkVersion:19, targetSdkVersion:26]
println("appId内容:${appId}")//输出内容-》appId内容:[app:com.itsdf07.appnotes]

android {
    compileSdkVersion config.compileSdkVersion //map集合取值方式一
    buildToolsVersion config.buildToolsVersion
    defaultConfig {
        applicationId appId["app"]//map集合取值方式二
        minSdkVersion config.minSdkVersion
        targetSdkVersion config.targetSdkVersion
        versionCode config.versionCode
        versionName config.versionName
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:26.+'
    compile 'com.android.support.constraint:constraint-layout:1.0.2'
    testCompile 'junit:junit:4.12'
}

其中上面内容使用到了println打印就相当于java中的system.out.println一样,打印结果与查看内容位置如下图展示
在这里插入图片描述
基于上述的统一管理方式以及对Groovy语言的深入了解,我们可以进一步进行复杂内容的配置,比如渠道多渠道打包等等

### 正确配置 Android Studio 项目中的 `build.gradle` 文件 #### 1. 理解 `build.gradle` 的作用 Android Studio 使用 Gradle 构建工具来管理项目。Gradle 脚本通常分为两种:一种是 **项目级**的 `build.gradle`,另一种是 **模块级**的 `build.gradle`。 - 项目级 `build.gradle` 主要定义全局依赖和插件设置[^3]。 - 模块级 `build.gradle` 则具体描述该模块的构建逻辑、依赖库以及编译选项。 --- #### 2. 配置项目级 `build.gradle` 以下是典型的项目级 `build.gradle` 配置: ```groovy // 定义插件及其版本 plugins { id 'com.android.application' version '7.4.0' apply false id 'com.android.library' version '7.4.0' apply false id 'org.jetbrains.kotlin.android' version '1.8.0' apply false } // 所有子项目的依赖项集中管理 allprojects { repositories { google() // 添加 Google Maven 库支持 mavenCentral() // 添加中央仓库支持 jcenter() // 已废弃但仍可能被部分旧项目使用 } } ``` 上述代码中: - 插件声明了 Android 和 Kotlin 支持,并设置了适用范围 (`apply false`),表示这些插件仅在特定模块中启用。 - `repositories` 块列出了所有可用的远程存储库地址,供下载依赖库使用[^1]。 --- #### 3. 配置模块级 `build.gradle` 模块级 `build.gradle` 更加细化,涉及应用的具体属性和依赖关系。以下是一个完整的例子: ```groovy plugins { id 'com.android.application' id 'kotlin-android' } android { compileSdkVersion 33 // 设置目标 API 版本 defaultConfig { applicationId "com.example.myapp" minSdkVersion 21 // 最低兼容设备版本 targetSdkVersion 33 // 推荐的目标 SDK 版本 versionCode 1 // APK 内部版本号 versionName "1.0" // 用户可见的应用程序版本名 } buildTypes { release { // 发布模式配置 minifyEnabled true // 是否开启 ProGuard/DexGuard 混淆 proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' // 自定义混淆规则文件路径[^5] } debug { // 调试模式配置 minifyEnabled false // 不进行代码混淆 } } } dependencies { implementation 'androidx.core:core-ktx:1.9.0' // 导入核心功能库 implementation 'com.google.android.material:material:1.8.0' // Material Design 组件 testImplementation 'junit:junit:4.+' // 单元测试框架 androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.0-alpha06' // UI 测试框架 } ``` 说明如下: - `compileSdkVersion`, `minSdkVersion`, 和 `targetSdkVersion` 控制应用程序与不同 Android 设备的兼容性和行为。 - `defaultConfig` 提供默认构建参数,如包名(`applicationId`)、最低/最高 SDK 版本等。 - `buildTypes` 定义不同的构建变体(如调试版和发布版),并允许自定义每种类型的特性。 - `dependencies` 块列举了所需的所有外部库或组件。 --- #### 4. 如果使用 Kotlin DSL (`.gradle.kts`) 对于现代项目,推荐使用 `.gradle.kts` 格式的脚本替代传统的 Groovy 脚本。Kotlin DSL 可以提供更强的静态类型检查和支持 IDE 编辑器的功能提示。 下面展示了一个简单的 `.gradle.kts` 示例: ```kotlin plugins { id("com.android.application") version "7.4.0" apply false id("org.jetbrains.kotlin.android") version "1.8.0" apply false } allprojects { repositories { google() mavenCentral() } } ``` 注意,在这种情况下,版本号可以通过单独维护的 `libs.versions.toml` 文件统一管理[^4]。 --- #### 5. 关键注意事项 - **保持最新版本**:定期更新 Gradle Wrapper 和插件版本至官方建议的稳定版本。 - **清理缓存**:如果遇到奇怪错误,尝试执行命令 `./gradlew clean --refresh-dependencies` 清理本地缓存[^2]。 - **合理命名空间划分**:确保多个模块间的依赖清晰分离,避免循环依赖问题。 --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值