美文网首页
gradle tool升级到3.0注意事项

gradle tool升级到3.0注意事项

作者: fomin | 来源:发表于2018-09-14 14:03 被阅读129次
    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

    4、修改script的build脚本

    原来
    cp -rf $project_path/app/build/outputs/apk/host_release_hytest_com.huaying.lesaifootball_*.apk $out_put/
    改为
    cp -rf $project_path/app/build/outputs/apk/hytest/release/host_release_hytest_com.huaying.lesaifootball_*.apk $out_put/
    

    需要增加渠道名称hytest和release名称

    相关文章

      网友评论

          本文标题:gradle tool升级到3.0注意事项

          本文链接:https://www.haomeiwen.com/subject/mtjogftx.html