Android build.gradle文件

2019-11-06 10:01:06

字体：大中小

来源：转载

供稿：网友

1. 常见的参数意义

compiledSdkVersion

应用将要编译的目标Android版本，此处默认为你的SDK已安装的最新Android版本，我们仍然可以使用较老的版本编译项目，但把该值设为最新版本，可以使用Android的最新特性，同时可以在最新的设备上优化应用来提高用户体验。

buildToolsVersion

使用什么版本的编译工具。使用SDK Manager安装多个版本的编译工具。

applicationId

创建新项目时指定的包名。

minSdkVersion

创建项目时指定的最低SDK版本，是新建应用支持的最低SDK版本。

targetSdkVersion

表示你测试过你的应用支持的最高Android版本(同样用API level表示)，当Android发布最新版本后，我们应该在最新版本的Android测试自己的应用同时更新target sdk到Android最新版本，以便充分利用Android新版本的特性。举例来说，设置这个值为11或更高，当你的应用运行在Android3.0或更高的系统上时，系统会为你的应用使用新的默认主题（Holo主题），并且当运行在大屏幕的设备上时会禁用屏幕兼容模式（screen compatibility mode），因为支持了 API level 11就暗示了支持大屏幕

2. 基本配置

Gradle是一种基于Groovy的动态DSL，而Groovy语言是一种基于jvm的动态语言

2.1 项目 gradle结构

这里写图片描述

2.2 app/build.gradle 解析

apply plugin: 'com.android.application'android { compileSdkVersion 23 buildToolsVersion "23.0.2" defaultConfig { applicationId "com.wuxiaolong.gradle4android" minSdkVersion 15 targetSdkVersion 23 versionCode 1 versionName "1.0" } buildTypes { release { minifyEnabled false PRoguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } }}dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) testCompile 'junit:junit:4.12' compile 'com.android.support:appcompat-v7:23.2.1' compile 'com.android.support:design:23.2.1'}apply plugin: ‘com.android.application’，表示该module是一个app module，应用了com.android.application插件，如果是一个android library，那么这里写apply plugin: ‘com.android.library’compileSdkVersion：基于哪个SDK编译，这里是API LEVELbuildToolsVersion：基于哪个构建工具版本进行构建的。defaultConfig：默认配置，如果没有其他的配置覆盖，就会使用这里的。applicationId：配置包名的versionCode：版本号versionName：版本名称buildTypes是构建类型，常用的有release和debug两种，可以在这里面启用混淆，启用zipAlign以及配置签名信息等。dependencies：不属于Android专有的配置了，它定义了该module需要依赖的jar，aar，jcenter库信息。

2.3 gradle-wrapper.properties

声明了gradle的目录与下载路径以及当前项目使用的gradle版本，这些默认的路径我们一般不会更改的

#Mon Dec 28 10:00:20 PST 2015distributionBase=GRADLE_USER_HOMEdistributionPath=wrapper/distszipStoreBase=GRADLE_USER_HOMEzipStorePath=wrapper/distsdistributionUrl=https/://services.gradle.org/distributions/gradle-2.14.1-all.zip

2.4 根目录的build.gradle

定义在这个工程下的所有模块的公共属性

buildscript { repositories { jcenter() } dependencies { classpath 'com.android.tools.build:gradle:2.2.3' // NOTE: Do not place your application dependencies here; they belong // in the individual module build.gradle files }}allprojects { repositories { jcenter() //下面是conggithub 上有的 compile 需要的 maven { url "https://jitpack.io" } }}task clean(type: Delete) { delete rootProject.buildDir}

2.5 setting.gradle

include ':app', ':app_demo', ':p2pinvest', ':bilibili', ':MPChartLib', ':P2PInvest_Demo', ':ViewPagerIndicator', ':GestureLock', ':easeui', ':GG_IM', ':alipay_demo', ':MPChartExample', ':OkGo-master', ':okserver', ':okrx', ':okgo'

3. 依赖管理

3.1 jar

默认情况下，新建的Android项目会有一个lib文件夹（没有就自己写）dependencies { compile fileTree(dir: 'libs', include: ['*.jar'])//即添加所有在libs文件夹中的jar //compile files('libs/WuXiaolong.jar')//不需要这样一个个去写了}

3.2 aar文件

library库输出文件是.aar文件，包含了Android 资源文件，在library工程build/output/aar/下 - 这里写图片描述

直接依赖library库这里写图片描述

依赖.aar文件

创建一个aars文件夹，然后把.aar文件拷贝到该文件夹里面，然后添加该文件夹作为依赖库： app/bulid.gradle 这里写图片描述

3.3 远程仓库（最简单的 dependencies）

- `compile 'com.squareup.okhttp3:okhttp:3.4.1'`

3.4 so包

app ├── AndroidManifest.xml └── jniLibs ├── armeabi │ └── WuXiaolong.so ├── armeabi-v7a │ └── WuXiaolong.so ├── mips │ └── WuXiaolong.so └── x86 └── WuXiaolong.so

4. 全局设置

如果有很多项目，可以设置全局来统一管理版本号或依赖库，根目录下build.gradle下：

ext { compileSdkVersion = 23 buildToolsVersion = "23.0.2" minSdkVersion = 14 targetSdkVersion = 23}

app/build.gradle

android { compileSdkVersion rootProject.ext.compileSdkVersion buildToolsVersion rootProject.ext.buildToolsVersion defaultConfig { applicationId "com.wuxiaolong.gradle4android" minSdkVersion rootProject.ext.minSdkVersion targetSdkVersion rootProject.ext.targetSdkVersion versionCode 1 versionName "1.0" }

可以在根目录下建个config.gradle，然后只需在根目录下build.gradle最顶部加上下面一行代码，然后同步下，意思就是所有的子项目或者所有的modules都可以从这个配置文件里读取内容

apply from: "config.gradle"

config.gradle

ext { android = [ compileSdkVersion: 23, buildToolsVersion: "23.0.2", minSdkVersion : 14, targetSdkVersion : 22, ] dependencies = [ appcompatV7': 'com.android.support:appcompat-v7:23.2.1', design : 'com.android.support:design:23.2.1' ]}

app/build.gradle

android { compileSdkVersion rootProject.ext.android.compileSdkVersion buildToolsVersion rootProject.ext.buildToolsVersion defaultConfig { applicationId "com.wuxiaolong.gradle4android" minSdkVersion rootProject.ext.android.minSdkVersion targetSdkVersion rootProject.ext.android.targetSdkVersion versionCode 1 versionName "1.0" }...dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) testCompile 'junit:junit:4.12' compile rootProject.ext.dependencies.appcompatV7 compile rootProject.ext.dependencies.design}

5. 自定义BuildConfig

实际开发中服务器可能有正式环境和测试环境，gradle可以通过buildConfigField来配置

defaultConfig { buildConfigField 'String','API_SERVER_URL','"http://wuxiaolong.me/"' }

buildConfigField 一共有3个参数，第一个是数据类型，和java的类型是对等的；第二个参数是常量名，这里是API_SERVER_URL；第三个参数就是你要配置的值

这里写图片描述

如图路径下就有个常量API_SERVER_URL，如何在代码取得这个常量值：

Log.d("wxl", "API_SERVER_URL=" + BuildConfig.API_SERVER_URL);

6. 启用proguard混淆

一般release发布版本是需要启用混淆的，这样别人反编译之后就很难分析你的代码，而我们自己开发调试的时候是不需要混淆的，所以debug不启用混淆。对release启用混淆的配置如下：

android { buildTypes { release { minifyEnabled true//是否启动混淆 shrinkResources true //是否移除无用资源文件，shrinkResources依赖于minifyEnabled，必须和minifyEnabled一起用 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } }}

minifyEnabled为true表示启用混淆，proguardFile是混淆使用的配置文件，这里是module根目录下的proguard-rules.pro文件

7. gradle 多渠道打包

我更喜欢 Python 多渠道打包，蛮快的，这个以后有机会再补充

8. 配置签名信息

8.1 Android Studio设置默认的签名文件

新浪微博SSO登录，微信分享这些都需要签名打包，才能看到效果，设置默认签名文件为自己的签名jks，这样就不需要打包了，直接运行起来就是正式的签名。

在android.signingConfigs{}下定义一个或者多个签名信息，然后在buildTypes{}配置使用即可。

在app目录下添加你的.jks，然后app的build.gradle文件中的增加以下内容：

第一种：

android { signingConfigs { debug { storeFile file("appkey.jks") storePassWord 'android' keyAlias 'android' keyPassword 'android' } } }

buildTypes没有配置，也是直接取得debug，是不是不配置默认取得是debug呢？

第二种：

android { signingConfigs { release { storeFile file("WuXiaolong.jks") storePassword 'android' keyAlias 'android' keyPassword 'android' } } buildTypes { debug { signingConfig signingConfigs.release } }}

gradle签名和打包的链接

上一篇：android的多渠道打包

下一篇：简单的获取Android手机屏幕的像素