Android官方技术文档翻译——Gradle 插件用户指南(4)
最近赶项目,白天基本没时间,只有晚上在家的时候才能看一看。昨天晚上只翻译完了第四章,今天就只发第四章吧。
本文译自Android官方技术文档《Gradle Plugin User Guide》,原文地址:http://tools.android.com/tech-docs/new-build-system/user-guide。
翻译不易,转载请注明CSDN博客上的出处:
http://blog.csdn.net/maosidiaoxian/article/details/41955809
前三章见《Android官方技术文档翻译——Gradle 插件用户指南(1-3)》。
翻译工作耗时费神,如果你觉得本文翻译得还OK,请点一下“顶”,我在精神上会倍受鼓励的,谢谢。翻译如有错讹,敬请指正。
依赖、 Android Library和多项目设置
dependencies {compile files(‘libs/foo.jar‘)}
android {...}
注意:dependencies DSL 元素是标准的 Gradle API 的一部分,不属于android 元素内。
compile配置用于编译主应用程序。里面的所有内容都会被添加到编译类路径,并且打包到最终生成的 apk 当中。
下面是添加依赖时其他可能用到的配置:
- compile: 主应用程序
- androidTestCompile: 测试的应用程序
- debugCompile: debug Build Type
- releaseCompile: release Build Type.
创建一个新的Build Type会基于它的名字自动创建一个新的配置。
这可能会有用,比如debug版本需要使用一个自定义库(例如报告崩溃的信息),而release版本则不需要,或者是他们依赖于同一个库的不同版本的情况下。
远程文件
首先,这个仓库必须添加到列表当中,然后必须用Maven 或 Ivy 声明文件的方式声明这个依赖。
repositories {mavenCentral()}
dependencies {compile ‘com.google.guava:guava:11.0.2‘}
android {...}
注: mavenCentral()是指定maven中央仓库的URL的快捷方法。Gradle支持远程和本地仓库。
注:Gradle 将遵循所有依赖关系的传递性。这意味着,如果一个依赖有它自己的依赖关系,这些依赖也会被拉取。
有关设置依赖关系的更多信息,请参阅 Gradle 用户指南(这里),和DSL文档(这里)。
多项目设置
一个多项目设置通常是通过让所有的项目作为给定根项目的子文件夹来实现。
例如,给定以下项目结构:
MyProject/+ app/+ libraries/+ lib1/+ lib2/
:app:libraries:lib1:libraries:lib2
每一个项目都有其自己的build.gradle文件,定义自己如何构建。
此外,在根路径下还将有一个叫settings.gradle的文件用于声明所有的项目。
这些文件的结构如下:
MyProject/| settings.gradle+ app/| build.gradle+ libraries/+ lib1/| build.gradle+ lib2/| build.gradle
settings.gradle的内容很简单:
include ‘:app‘, ‘:libraries:lib1‘, ‘:libraries:lib2‘
该:app项目可能依赖于libraries,这是通过声明如下的依赖关系来配置的:
dependencies {compile project(‘:libraries:lib1‘)}
但是,如果你想共享访问了 Andr??oid API或使用了 Android-style的资源的代码,这些库项目就不能是普通的Java项目,而应该是 Andr??oid Library 项目。
创建库项目
由于构建库项目与构建应用程序有些不同不同,所以使用的是不同的插件。这两个插件内部共享了大部分的相同的代码,并且它们都由同样的com.android.tools.build.gradle jar 包提供。
buildscript {repositories {mavenCentral()}
dependencies {classpath ‘com.android.tools.build:gradle:0.5.6‘}}
apply plugin: ‘android-library‘
android {compileSdkVersion 15}
库项目用着同样的锚任务(assembleDebug, assembleRelease),所以构建这样一个项目的命令也没有任何区别。
引用一个库项目
dependencies {compile project(‘:libraries:lib1‘)compile project(‘:libraries:lib2‘)}
android {defaultPublishConfig "debug"}
android {defaultPublishConfig "flavor1Debug"}
android {publishNonDefault true}
compile project(‘:libraries:lib2‘)
dependencies {flavor1Compile project(path: ‘:lib1‘, configuration: ‘flavor1Release‘)flavor2Compile project(path: ‘:lib1‘, configuration: ‘flavor2Release‘)}
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。