您當前位置：首頁 > php開源 > 綜合技術 > Android官方技術文檔翻譯――遷移 Gradle 項目到1.0.0 版本

Android官方技術文檔翻譯――遷移 Gradle 項目到1.0.0 版本

來源：程序員人生發布時間：2015-02-27 08:33:44 閱讀次數：3418次

本文譯自Android官方技術文檔《Migrating Gradle Projects to version 1.0.0》,原文地址：http://tools.android.com/tech-docs/new-build-system/migrating-to⑴-0-0。

本篇文檔介紹的是低版本的Gradle項目怎樣升級到1.0.0版本。

翻譯不容易，轉載請注明CSDN博客上的出處：

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

翻譯工作耗時費神，如果你覺得本文翻譯得還OK，請點擊文末的“頂”；如有錯訛，敬請指正。謝謝。

遷移 Gradle 項目到1.0.0 版本

Android 的 Gradle 插件有了迅猛的發展，作為進化的特點，API 和構建文件的描寫語言也經過了1些不兼容的更改。如果你正在試圖加載用舊版本的 Gradle 插件構建的項目，它可能沒法通過 1.0.0 版本正確構建。

本文檔描寫了大部份常見的變動，以幫助您遷移到 1.0.0。從1.0.0 及以后的版本起，我們將盡力不進行不兼容的更改。如果我們做到了，我們將打算編寫 IDE 支持，以幫助自動遷移項目。

更新插件和 Gradle 版本號

構建系統知道要使用哪個版本的 Gradle 插件，和哪個版本的 Gradle 。由于它們都在您的項目文件中顯式列出。當您使用 Android Studio 1.0 并打開1個舊的項目時，它將主動提出自動查找和更新這些版本號。您也能夠對這些版本號進行手動編輯。

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⑴.11-all.zip

+distributionUrl=http://services.gradle.org/distributions/gradle⑵.2.1-all.zip

再說，當你打開1個舊項目時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中，還有其他1些屬性也被重命名了。

類庫項目中的 ApplicationId

你不能使用 applicationId 來自定義1個庫項目的包名。這個包名稱必須在庫項目里是固定的（并且在清單中以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 版本統做了1些不兼容的更改，這些修改需要您的項目也進行更新。這1頁文檔介紹了如何更新您的項目。請注意這不是這個插件的 0.9 版本中的所作更改的完全列表；它只是涵蓋需要了你的源文件需要進行更新的那些更改。有關這些修改的完全的列表，請參見. 用戶指南

Instrumentation Tests

如果您在您的項目中已有了instrumentation 測試（或其他類型的測試），請注意我們把名稱和文件夾從 instrumentation 測試改成了 android 測試，以反應出1個事實。這個事實是，這類功能不只是instrumentation測試，也包括著普通的 JUnit 測試（在1個裝備上運行）和終究的 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'
}