Gradle 適用的 Android 外掛程式,修訂版本 1.3.0 (2015 年 7 月)

依附元件:

最低版本 預設版本 附註
Gradle 2.2.1 2.2.1 詳情請參閱「更新 Gradle」一節。
SDK 版本工具 21.1.1 21.1.1 安裝設定 SDK 版本工具。

一般注意事項:

  • 新增對 com.android.build.threadPoolSize 屬性的支援功能,以便控制 gradle.properties 檔案或指令列的 Android 工作執行緒集區大小。以下範例將這項屬性設為 4。

            
            -Pcom.android.build.threadPoolSize=4
            
          
  • 設定預設建構行為,藉此從 APK 中排除 LICENSELICENSE.txt 檔案。如要將這些檔案納入 APK,請從 build.gradle 檔案的 packagingOptions.excludes 屬性中移除這些檔案。例如:
    android {
          packagingOptions.excludes = []
        }
          
    android {
          packagingOptions.excludes.clear()
        }
        
  • 新增 sourceSets 工作,以便檢查所有可用的來源集。
  • 加強單元測試支援,識別多個變種版本和建構變化版本的來源資料夾。舉例來說,如果想測試有多個變種版本 flavor1flavorA,建構類型為 Debug 的應用程式,測試來源集為:
    • test
    • testFlavor1
    • testFlavorA
    • testFlavor1FlavorA
    • testFlavor1FlavorADebug

    Android 測試已辨識到多個變種版本的來源資料夾。

  • 改善單元測試支援,以便執行以下作業:
    • 對主要和測試來源執行 javac,即使建構檔案中的 useJack 屬性設為 true 也一樣。
    • 正確識別每種建構類型的依附元件。
  • 新增透過指令列指定檢測設備測試執行工具引數的支援功能。例如:
    ./gradlew connectedCheck 
    -Pandroid.testInstrumentationRunnerArguments.size=medium
    -Pandroid.testInstrumentationRunnerArguments.class=TestA,TestB
  • 新增對 build.gradle 檔案內任意 Android 資產封裝工具 (AAPT) 參數的支援功能。例如:

    android {
        aaptOptions {
          additionalParameters "--custom_option", "value"
        }
    }
          
    android {
        aaptOptions {
          additionalParameters += listOf("--custom_option", "value")
        }
    }
          
  • 新增支援測試 APK 模組做為獨立的測試模組,同時使用 targetProjectPathtargetVariant 屬性設定 APK 路徑和目標變化版本。

    注意:測試 APK 模組不支援變種版本,且只能指定單一變化版本為目標。此外,系統也尚未支援 Jacoco。

  • 新增在合併資源之前進行資源名稱驗證的功能。
  • 為程式庫模組建構 AAR (Android ARchive) 套件時,請勿在資訊清單合併工具設定中提供 @{applicationId} 自動預留位置。如要在封存程式庫中加入應用程式 ID,請改用 @{libApplicationId} 等其他預留位置,並提供相關的值。