首页 > 代码库 > Gradle的奇妙之处
Gradle的奇妙之处
转载请注明出处:http://blog.csdn.net/crazy1235/article/details/50465885
Google I/O 2013大会上公布了AS,现在已经发展到2.0-beta版本号。相信已经大部分人做Android开发的都已经由Eclipse IDE转为AS IDE。
随着AS版本号的更迭,也带来不少为为开发人员提供便利的工具。比方这篇blog所描写叙述的:http://blog.csdn.net/crazy1235/article/details/49747141
本人从AS1.2版本号開始使用,现在也用了大半年了。现将使用过程中的一些经验分享给大家。
- gradle的基本配置
- gradle的签名配置
- 配置buildTypes
- 配置productFlavor
- manifest占位符
- 加入自己定义字段
- 自己定义导出APK的名称
- Demo下载
gradle的基本配置
apply plugin: ‘com.android.application‘
android {
compileSdkVersion 23
buildToolsVersion "23.0.2"
defaultConfig {
applicationId "com.jacksen.multichannel"
minSdkVersion 14
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.1.1‘
compile ‘com.android.support:design:23.1.1‘
}
上面的就是一个项目gradle的基本配置。
apply plugin: ‘com.android.application‘
表示该module是一个app module。应用了com.android.application插件,也就是主程序。
假设是一个第三方library,则应该是app plugin: ‘com.android.library’
buildTypes { } 表示构建类型。包含release和debug两种。
能够在这里面配置启用混淆、zipAlign、签名信息等。
dependencies { } 里面是项目的依赖信息,包含jar包和第三方库等信息。
ApplicationId与PackageName的差别:
此前使用eclipse进行开发的时候,应用程序的包名是由manifest文件的package属性决定的:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.xxx.xxxx"
android:versionCode="1"
android:versionName="1.0" >
然而在使用gradle构建的时候却多了一个applicationId。通常gradle中的applicationId和Manifest中的package是一样的。事实上能够使二者一致。
官方解释说是:applicationId是你的应用在商店的唯一标识。
而package是引用资源的路径名,也就是R文件的包名。
上面我们说到二者能够不一致,我们能够通过对不同的Flavor设置不同的applicationId,从而能够导出不同“包名”的apk。而不须要改动其它的代码。后面会细致说明。
gradle的签名配置
关于签名的概念不懂得,能够參考这篇blog:Android从零单排之签名打包
我们通常执行项目都是使用debug的签名。只是有些使用到第三方sdk的时候,须要用到正式版的签名,通过打包正式签名的方式又不好调试。只是我们能够在gradle里面配置正式版的签名。
android {
signingConfigs {
config_release {
keyAlias ‘releaseKey‘
keyPassword ‘123456‘
storePassword ‘123456‘
storeFile file(‘key/releaseKey.jks‘)
}
config_debug {
keyAlias ‘debugKey‘
keyPassword ‘123456‘
storePassword ‘123456‘
storeFile file(‘key/debugKey.jks‘)
}
}
......//省略其它配置
}
这里配置了两个签名。jsk都放在app以下的key目录中。所以使用的是相对路径。
之前有人问我是怎么知道keyAlias 、keyPassword这些语法的。
事实上在项目的【Project Structure】中都能够找到。
配置buildTypes
一般在buildTypes{ }里面配置两个(release和debug):
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile(‘proguard-android.txt‘), ‘proguard-rules.pro‘
shrinkResources true //移除无效的resource文件,必须同意ProGuard才干生效
zipAlignEnabled true
buildConfigField "boolean", "APP_TYPE", "true"
manifestPlaceholders = [APP_NAME: "@string/app_name_release"]
signingConfig signingConfigs.config
}
debug {
buildConfigField "boolean", "APP_TYPE", "false"
// manifestPlaceholders = [APP_NAME: "@string/app_name_debug"]
applicationIdSuffix ‘debug‘
}
}
这里可配置的信息非常多,比方:能否够是debug模式、签名配置、混淆文件等。
配置productFlavor
多渠道打包。关键就在于定义多个productFlavor。
在一个flavor里面可配置的信息非常多。
productFlavors {
flavor_release {
buildConfigField "boolean", "APP_TYPE", "false"
applicationId ‘com.jacksen.multichannel.release‘
signingConfig signingConfigs.config_release
minSdkVersion 9
targetSdkVersion 15
versionCode 2
versionName ‘2.0.1‘
}
flavor_debug {
minSdkVersion 10
applicationId ‘com.jacksen.multichannel.debug‘
signingConfig signingConfigs.config_debug
versionCode 5
versionName ‘5.0‘
}
}
最基本的是能够在这里配置applicationId,就是我们上面一開始说的打包多个不同“包名”的apk。
这样有一个应用场景就是,我们一般通过debug版本号进行測试之后,在进行release版本号的測试。
只是同一个applicationId的apk在一个測试机上仅仅能存在一个。现在我们通过配置多个flavor相应多个applicationId。就能够在測试机上执行測试版和正式版两个apk了。
productFlavors{ } 与 buildTypes{ }里面的配置是多对多的关系。
比方:
buildTypes {
release {...}
debug {...}
}
productFlavors {
flavor_1 {...}
flavor_2 {...}
}
此时的配置能够打包出四个apk,各自是:
我们在使用as的打包工具时,能够选择打包某一个Build type的某一个或多个Flavors:
假设在gradle里面配置了签名信息,那么在【Generate Signed APK】的第一步填写的签名信息是以在gradle里面配置并引用的为准。
我们还能够借助gradlew命令来打包:
比方打包flavor_1相应的release和debug版本号:
打包flavor_2相应的release版本号:
实际上。我们不用再记住这些命令。
AS里面的gradle插件就能够实现。
在AS的右側会有【Gradle】tab页面。打开之后。先刷新一下。
会看到例如以下图示:
通过双击右边的命令打包不同的版本号。
除了build以下的命令,还有其它的命令。大家都能够尝试一下。依据名字应该就能知道什么意思,这里不多介绍了。
manifest占位符
在打包多个版本号的时候,会遇到改动应用名称等需求。不同的flavor有要求不通的名称。此时能够在Manifest文件里使用占位符,然后在build.gradle中替换占位符即可了。
首先定义占位符:
application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="${APP_NAME}"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity
android:name=".LoginActivity"
android:label="${APP_NAME}">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
在build.gradle中替换:
buildTypes {
release {
manifestPlaceholders = [APP_NAME: "@string/app_name1"]
}
debug {
manifestPlaceholders = [APP_NAME: "@string/app_name1"]
}
}
productFlavors {
flavor_1 {
manifestPlaceholders = [APP_NAME: "@string/app_name1"]
}
flavor_2 {
manifestPlaceholders = [APP_NAME: "@string/app_name2"]
}
}
假设在productFlavors和buildTypes里面都进行了替换,那么是以productFlavors里面的为准。
假设不区分productFlavors和buildTypes的话,也能够在defaultConfig里进行替换:
defaultConfig {
manifestPlaceholders = [APP_NAME: "@string/app_name_release"]
}
事实上defaultConfig也是productFlavors的一个子集。
加入自己定义字段
Gradle在generateSources阶段为每个flavor生成两个BuildConfig.java文件(相应在release和debug目录下)。
BuildConfig类默认会提供一些常量字段。
public final class BuildConfig {
public static final boolean DEBUG = Boolean.parseBoolean("true");
public static final String APPLICATION_ID = "com.jacksen.multichannel";
public static final String BUILD_TYPE = "debug";
public static final String FLAVOR = "";
public static final int VERSION_CODE = 1;
public static final String VERSION_NAME = "1.0";
}
尽管通过上面的操作,我们能够同一时候打包出一个debug版本号和一个release版本号。
可是我们还须要执行的时候有不同的表现。比方。release版本号不显示一些控件。
令人惊奇的是,我们能够通过buildConfigField在gradle里面自己定义一些字段。
buildConfigField "String", "APP_TYPE", "debug"
我们能够查看buildConfigField的源代码:
/**
* Adds a new field to the generated BuildConfig class.
*
* <p>The field is generated as: <code><type> <name> = <value>;</code>
*
* <p>This means each of these must have valid Java content. If the type is a String, then the
* value should include quotes.
*
* @param type the type of the field
* @param name the name of the field
* @param value the value of the field
*/
public void buildConfigField(
@NonNull String type,
@NonNull String name,
@NonNull String value) {
ClassField alreadyPresent = getBuildConfigFields().get(name);
if (alreadyPresent != null) {
logger.info(
"BuildType(${getName()}): buildConfigField ‘$name‘ value is being replaced: ${alreadyPresent.value} -> $value");
}
addBuildConfigField(AndroidBuilder.createClassField(type, name, value));
}
凝视写的非常具体。该方法就是加入一个field到BuildConfig类中。
三个參数都是不可为空的。
加入完成之后,就能够在代码中使用了:
textView.setText("BuildConfig.APP_TYPE : " + BuildConfig.APP_TYPE);
自己定义导出APK的名称
我直接上代码吧。
/*applicationVariants.all {
variant ->
variant.outputs.each {
output ->
def outputFile = output.outputFile
if (outputFile != null && outputFile.name.endsWith(‘.apk‘)) {
// def fileName = outputFile.name.replace(".apk", "-${defaultConfig.versionName}.apk")
def apkType = ""
if (variant.flavorName.equals("releaseFlavor")){
apkType = "release"
}else if(variant.flavorName.equals("debugFlavor")){
apkType = "debug"
}
def fileName = new File(output.outputFile.getParent(), "app-" + apkType + "-${variant.versionName}.apk")
// output.outputFile = new File(outputFile.parent, fileName)
output.outputFile = fileName
}
}
}*/
applicationVariants.all {
variant ->
variant.outputs.each {
output ->
def outputFile = output.outputFile
if (outputFile != null && outputFile.name.endsWith(‘.apk‘)) {
def fileName = outputFile.name.replace(".apk", "-${defaultConfig.versionCode}-${defaultConfig.versionName}.apk")
output.outputFile = new File(outputFile.parent, fileName)
}
}
}
这里有两种方式,大家执行一下測试一下就明确了。
以上就是我对gradle的一些认识~~~
Demo下载
https://github.com/crazy1235/MultiChannel
欢迎star~~
參考:
http://tech.meituan.com/mt-apk-adaptation.html
http://www.jayfeng.com/2015/11/07/Android%E6%89%93%E5%8C%85%E7%9A%84%E9%82%A3%E4%BA%9B%E4%BA%8B/
http://www.jcodecraeer.com/a/anzhuokaifa/Android_Studio/2015/0810/3281.html
此篇blog到此结束~
感谢大家支持!
如有错误,请指出~
谢谢~
Gradle的奇妙之处