本文译自Android官方技术文档《Migrating Gradle Projects to version 1.0.0》,原文地址:http://tools.android.com/tech-docs/new-build-system/migrating-to-1-0-0。

本篇文档介绍的是低版本的Gradle项目怎么升级到1.0.0版本。

翻译不易,转载请注明CSDN博客上的出处:

http://blog.csdn.net/maosidiaoxian/article/details/42772727

翻译工作耗时费神,如果你觉得本文翻译得还OK,请点击文末的“顶”;如有错讹,敬请指正。谢谢。

迁移 Gradle 项目到1.0.0 版本

Android 的 Gradle 插件有了迅猛的发展,作为进化的特征,API 和构建文件的描述语言也经过了一些不兼容的更改。如果你正在试图加载用旧版本的 Gradle 插件构建的项目,它可能无法通过 1.0.0 版本正确构建。

本文档描述了大部分常见的变动,以帮助您迁移到 1.0.0。从1.0.0 及以后的版本起,我们将尽力不进行不兼容的更改。如果我们做到了,我们将打算编写 IDE 支持,以帮助自动迁移项目。

更新插件和 Gradle 版本号

构建系统知道要使用哪一个版本的 Gradle 插件,以及哪一个版本的 Gradle 。因为它们都在您的项目文件中显式列出。当您使用 Android Studio 1.0 并打开一个旧的项目时,它将主动提出自动查找和更新这些版本号。您也可以对这些版本号进行手动编辑。

Android Gradle 插件版本通常是在项目中顶级的build.gradle文件内列出,并可以更新为如下内容:

     dependencies {
-        classpath 'com.android.tools.build:gradle:0.8.+'
+        classpath 'com.android.tools.build:gradle:1.0.0'
     }

你的项目所用的 Gradle 版本还应该更新为2.2.1或更新的版本。你可以通过编辑gradle/wrapper/gradle-wrapper.properties文件来完成:
 zipStorePath=wrapper/dists
-distributionUrl=http\://services.gradle.org/distributions/gradle-1.11-all.zip
+distributionUrl=http\://services.gradle.org/distributions/gradle-2.2.1-all.zip

再说,当你打开一个旧项目时Android Studio应该有提供自动执行此编辑:

从 0.9.x 迁移到 1.0.0

runProguard

对用户产生影响的最常见的问题是runProguard属性名称改为了minifyEnabled。如果您遇到以下这种构建错误
    Gradle DSL method not found: 'runProguard()'
那么这就是你构建错误的原因。

会突然出现很多这样的问题,是因为那个属性在 0.14.0 版本之前会被插入到由 Android Studio 创建的所有项目中。

如果要升级您的项目,请编辑您的 build.gradle 文件,如下所示:
         }
         release {
-            runProguard true
+            minifyEnabled true
             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'

在构建类型(build types)和product flavors中,还有其他一些属性也被重命名了。

类库项目中的 ApplicationId

你不能使用 applicationId 来自定义一个项目的包名。这个包名称必须在库项目里是固定的(并且在清单中以packageName指定)。在早些时候,Gradle 插件并不强制这个约束条件。

在 BuildTypes 中重命名的属性

runProguard => minifyEnabled
zipAlign => zipAlignEnabled
jniDebugBuild => jniDebuggable
renderscriptDebug => renderscriptDebuggable

在 ProductFlavors 中重命名的属性

flavorGroups => flavorDimensions
packageName => applicationId
testPackageName => testApplicationId
renderscriptSupportMode => renderscriptSupportModeEnabled
ProductFlavor.renderscriptNdkMode => renderscriptNdkModeEnabled

其他名称更改

InstrumentTest was renamed to androidTest.

从 0.8.x 迁移到 0.9.x


Gradle 的 Android 插件(Gradle plugin for Android)的 0.9 版本统做了一些不兼容的更改,这些修改需要您的项目也进行更新。这一页文档介绍了如何更新您的项目。请注意这不是这个插件的 0.9 版本中的所作更改的完整列表;它只是涵盖需要了你的源文件需要进行更新的那些更改。有关这些修改的完整的列表,请参见. 用户指南


Instrumentation Tests
如果您在您的项目中已经有了instrumentation 测试 (或其他类型的测试),请注意我们把名称和文件夹从 instrumentation 测试改为了 android 测试,以反映出一个事实。这个事实是,这种功能不只是instrumentation测试,也包含着普通的 JUnit 测试(在一个设备上运行)和最终的 UI automator测试。

如果要更新您的项目
  • 将您的 instrumentTest 文件夹重命名为 androidTest,例如git
    mv app/src/instrumentTest app/src/androidTest。

    或者,你也可以通过重新设置你的 sourcesets 告诉 gradle 继续使用旧的文件夹。
  • 把所有的测试依赖从 instrumentTestCompile 更新为 androidTestCompile :

    dependencies {

    -    instrumentTestCompile 'com.jayway.android.robotium:robotium-solo:4.3.1'

    +    androidTestCompile 'com.jayway.android.robotium:robotium-solo:4.3.1'

    }

库项目

用于库项目的 DSL 现在应用程序项目是一样的了。这意味着您可以创建更多的构建类型,和创建flavors。
  • 你可以在buildTypes { ... }容器里创建或配置更多的构建类型。
  • 您可以通过productFlavors { ... }容器创建
    product flavors。
  • 你可以通过signingConfigs { ... }容器创建
    signingConfigs。
例如,如果在你的库项目中有如下的配置:

android {
    debug {
    }
    release {
    }
    debugSigningConfig {
    }

}


你将要把它替换为:

android {
    buildTypes {
        debug {
        }
        release {
        }
    }

signingConfigs {

        debug {
        }

}

}

Android官方技术文档翻译——迁移 Gradle 项目到1.0.0 版本的更多相关文章

  1. Android官方技术文档翻译——Gradle 插件用户指南(5)

    昨晚把第五章未译完的几句话攻克了.只是第六章没怎么译,明后天又是周末,假设周一前第六章翻译完的话,周一再发第六章. 本文译自Android官方技术文档<Gradle Plugin User Gu ...

  2. Android官方技术文档翻译——Gradle 插件用户指南(4)

    最近赶项目,白天基本没时间,只有晚上在家的时候才能看一看.昨天晚上只翻译完了第四章,今天就只发第四章吧. 本文译自Android官方技术文档<Gradle Plugin User Guide&g ...

  3. Android官方技术文档翻译——Gradle 插件用户指南(7)

    本文译自Android官方技术文档<Gradle Plugin User Guide>,原文地址:http://tools.android.com/tech-docs/new-build- ...

  4. Android官方技术文档翻译——Gradle 插件用户指南(6)

    没想到翻译这篇<Gradle 插件用户指南>拖了差不多一个月,还跨年了.不过还好,在2号时终于一口气把剩下的给翻译完了(其实那天剩下的也就不到一章). 今天先发一下第六章,明天再发第七章. ...

  5. Android官方技术文档翻译——IntelliJ 项目迁移

    本文译自Android官方技术文档<Migrating from IntelliJ Projects>,原文地址:http://tools.android.com/tech-docs/ne ...

  6. Android官方技术文档翻译——Eclilpse项目迁移

    本文译自Android官方技术文档<Migrating From Eclipse Projects>,原文地址:http://tools.android.com/tech-docs/new ...

  7. Android官方技术文档翻译——Gradle 插件用户指南(1-3)

    不知道是什么网络问题,上午一直发不了博客,其它页面基本正常,就是在写博客这里,每次打开都是响应超时.刚才用了VPN,顺便试了一下,竟然能够编辑.想是CDN之类的问题吧. 这次翻译的是Gradle 插件 ...

  8. Android官方技术文档翻译——新构建系统概述

    本文译自Android官方技术文档<New Build System>,原文地址:http://tools.android.com/tech-docs/new-build-system. ...

  9. Android官方技术文档翻译——开发工具的构建概述

    本文译自Android官方技术文档<Build Overview>,原文地址:http://tools.android.com/build. 因为<Android Lint Chec ...

随机推荐

  1. Bootstrap3 代码-内联代码

    通过 <code> 标签包裹内联样式的代码片段. For example, <section> should be wrapped as inline. For example ...

  2. Redis之(七)主从同步与集群管理

    8.1 主从同步原理 像MySQL一样,Redis是支持主从同步的,而且也支持一主多从以及多级从结构. 主从结构,一是为了纯粹的冗余备份,二是为了提升读性能,比如很消耗性能的SORT就可以由从服务器来 ...

  3. linux中probe函数中传递的参数来源(上)

    点击打开链接 上一篇中,我们追踪了probe函数在何时调用,知道了满足什么条件会调用probe函数,但probe函数中传递的参数我们并不知道在何时定义,到底是谁定义的,反正不是我们在驱动中定义的(当然 ...

  4. Android初级教程:RatingBar的使用

    记得淘宝里面买家给卖家评分的时候会有一个星星状的评分条,其实就是基于RatingBar做了自定义使用了.那么本篇文章就对RatingBar的使用做一个基本的认识. 接下来就是正题,那就是对于Ratin ...

  5. [Vim]vim学习笔记--多个文件打开,切换,关闭

    一种情况是在shell中用vim打开多个文件,另一种是在vim编辑器中打开多个文件 同时打开多个文件 vim file1 file2  打开文件并水平窗口显示 vim -o file1 file2 打 ...

  6. tomcat中http与https协议socket工厂

  7. 侧滑面板(对viewGroup的自定义)

    额,好吧,最近一直在做侧滑的事情,到目前为止一共是学了三种方法了,一个是直接加第三方开源框架SlidingMenu,第二给是用DrawerLayout,今天这个是用谷歌官方提供的在新的support- ...

  8. java中抽象类的定义和使用

    java虽然比较简单,但是细节的知识点还是很多的,现在,介绍一下抽象类的定义和实现基础. 指的是在类中定义方法,而不去实现它,而在它的子类中去具体实现,继承抽象类的子类必须实现父类的抽象方法,除非子类 ...

  9. Android初级教程:Android中解析方式之pull解析

    在安卓中有很多种解析方式.按照大方向有xml解析和json解析.而,细致的分,xml和json解析各有自己的很多解析方式.今天这一篇主要介绍xml解析中的pull解析.对于xml的解析方式,我之前在j ...

  10. UNIX网络编程——客户/服务器程序设计示范(八)

        TCP预先创建线程服务器程序,主线程统一accept 最后一个使用线程的服务器程序设计示范是在程序启动阶段创建一个线程池之后只让主线程调用accept并把每个客户连接传递给池中某个可用线程.  ...