gradle tool升級到3.0注意事項小結

Gradle版本升級

其實當AS升級到3.0之后，Gradle Plugin和Gradle不升級也是可以繼續使用的，但很多新的特性如：Java8支持、新的依賴匹配機制、AAPT2等新功能都無法正常使用。

Gradle Plugin升級到3.0.0及以上，修改project/build.gradle文件：

修改global.gradle(自定義lib管理的gradle)

tools = [
  gradleTools   : 'com.android.tools.build:gradle:3.0.1'
]

修改project/build.gradle文件

buildscript {
  repositories {
    google()
  }
  apply from: 'global.gradle'
  def tools = rootProject.ext.tools
  dependencies {
    classpath tools.gradleTools
  }
}

Gradle升級到4.1及以上，修改project/gradle/gradle-wrapper.properties文件

distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip

生成APK文件名屬性outputFile變為只讀

在app module中修改build.gradle文件之前改apk名字的代碼

variant.outputs.each { output ->
  def outputFile = output.outputFile
  if (outputFile != null && outputFile.name.endsWith('.apk')) {
    def fileName = "host_${variant.buildType.name}_${variant.productFlavors[0].name}_${mApplicationId}_${defaultConfig.versionCode}_v${mVersionName}.apk"
    output.outputFile = new File(outputFile.parent, fileName)
  }
}

由于outputFile屬性變為只讀，需要進行如下修改，直接對outputFileName屬性賦值即可：

variant.outputs.all {
  outputFileName = "host_${variant.buildType.name}_${variant.productFlavors[0].name}_${mApplicationId}_${defaultConfig.versionCode}_v${mVersionName}.apk"
}

依賴關鍵字的改變

• api: 對應之前的compile關鍵字，功能一模一樣。會傳遞依賴，導致gradle編譯的時候遍歷整顆依賴樹
• implementation: 對應之前的compile，與api類似，關鍵區別是不會有依賴傳遞
• compileOnly: 對應之前的provided，依賴僅用于編譯期不會打包進最終的apk中
• runtimeOnly: 對應之前的'apk'，與上面的compileOnly相反

關于implementation與api的區別，主要在依賴是否會傳遞上。如：A依賴B，B依賴C，若使用api則A可以引用C，而implementation則不能引用。

這里更推薦用implementation，一是不會間接的暴露引用，清晰知道目前項目的依賴情況；二是可以提高編譯時依賴樹的查找速度，進而提升編譯速度。 渠道需要聲明flavor dimensions

剛開始Sync的時候應該會報錯：

Error:All flavors must now belong to a named flavor dimension. Learn more at https://d.android.com/r/tools/flavorDimensions-missing-error-message.html

也就是每個flavor渠道都必須歸屬一個dimension維度，若只有一個維度，渠道中可以不寫dimension屬性，默認分配到該維度。直接添加一個默認的維度即可，如：flavorDimensions "dimension"

解決方法是在app.gradle添加flavorDimensions

defaultConfig {
  flavorDimensions getVersion("VERSION_CODE")
}

也可以像官方文檔那樣設置多個維度

// Specifies two flavor dimensions.
flavorDimensions "mode", "minApi"
productFlavors {
  free {
    // Assigns this product flavor to the "tier" flavor dimension. Specifying
    // this property is optional if you are using only one dimension.
    dimension "mode"
    ...
  }
  paid {
    dimension "mode"
    ...
  }
  minApi23 {
    dimension "minApi"
    ...
  }
  minApi18 {
    dimension "minApi"
    ...
  }
}

庫多variant依賴方式的修改

Gradle plugin 3.0.0+之后引入了新的variant自動匹配機制，也就是說app的flavorDebug變體會自動匹配library的flavorDebug變體。

回顧一下舊的方式，如果app在某個variant下需要依賴library相應的類型，需要按照下面的方式聲明依賴：

dependencies {
  hytestCompile project(path: ':main', configuration: 'hytestRelease')
  productionCompile project(path: ':main', configuration: 'productionRelease')
}

新的方式，gradle會自動感知并匹配對應的variant（前提是app與library中有對應的variant類型）：

dependencies {
  implementation project(':main')
}

填坑

1、style attribute ‘@android:attr/windowEnterAnimation' not found. 這是aapt2導致的，3.0默認啟用了aapt2。解決辦法：在project的根目錄下的gradle.properties最后添加關閉aapt2的代碼：

android.enableAapt2=false

2、gradle tool 3.0使用最低SDK buildTool 26.0.2的版本

3、使用了aapt的需要去除掉，改用annotationProcessor

總結

以上所述是小編給大家介紹的gradle tool升級到3.0注意事項小結，希望對大家有所幫助，如果大家有任何疑問歡迎給我留言，小編會及時恢復大家的！