Android精选Android技术知识Android

Android Studio 3.0正式版填坑之路

2017-10-31  本文已影响9571人  翻译不了的声响
Android Studio 3.0启动图

序言

总看别人的文章，今天尝试着自己来写一篇。在逛论坛时候，无意间发现Android Studio 3.0正式版本推送更新了，早听说AS 3.0添加了许多新功能，然后手贱迫不及待地想先睹为快，结果正中下怀。下载和更新Gradle，半天无响应，只好结束进程强制关闭AS，手动离线下载安装。本以为不会有太大问题，谁知太高估了，进来各种的报错，各种的配置问题，填坑之路就此开始。

更新内容

Ver：v1.3.171031

Ver：v2.2.171111

Ver：v3.2.171231

Ver：v4.3.180416

正文

下面就来看看升级到 AS 3.x（3.0 ~ 3.1.2）之后，遇到的一些问题：

1. Gradle版本不匹配

修改项目下 gradle/wrapper/gradle-wrapper.propertie 文件中的distributionUrl
AS 3.0 ~ 3.0.1改为：
distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip
AS 3.1.1 ~3.1.2 改为：
distributionUrl=https\://services.gradle.org/distributions/gradle-4.4-all.zip

2. Gradle插件不匹配

1）项目根目录下的 build.gradle文件中两个repositories节点都添加google()

buildscript{
   repositories {
      google() //新增
   }
   dependencies {
      classpath'com.android.tools.build:gradle:3.0'//与AS版本一致
     //classpath'com.android.tools.build:gradle:3.0.1'
     //classpath'com.android.tools.build:gradle:3.1.1'
    }
}
allprojects {
   repositories{   
        google() //新增      
   }
}

2）项目app下 build.gradle文件中，修改相关支持库版本

AS 3.0 ~ 3.0.1：

android {
   compileSdkVersion 26
   buildToolsVersion "26.0.2"
   ...
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])  
    implementation 'com.android.support:appcompat-v7:26.1.0'    
    implementation 'com.android.support:design:26.1.0'  
    testImplementation  'junit:junit:4.12'
    ...
}

AS 3.1.1 ~ 3.1.2：

android {
   compileSdkVersion 27
   buildToolsVersion "27.0.3"
   ...
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])  
    implementation 'com.android.support:appcompat-v7:27.1.1'    
    implementation 'com.android.support:design:27.1.1'  
    testImplementation  'junit:junit:4.12'
    ...
}
3. Gradle编译报flaovr配置错误

Error:A problem occurred configuring project ':app'.> All flavors must now belong to a named flavor dimension.

android {
   ...
   flavorDimensions "tier","minApi"
   productFlavors{
     fees{
        dimension"tier"
        ...
     }
     minApi23{
       dimension"minApi"
        ...
     }
   }
}

如果不需要多版本控制只需添加：flavorDimensions "code"（随意定义）

android {
   ...
   defaultConfig {
       ...
      flavorDimensions "code"
   }
   ...
}
4. Gradle自定义apk名称报错（Cannot set the value of read-only property 'outputFile' ）
applicationVariants.all { variant ->
    variant.outputs.each { output ->
    def fileName = "${variant.versionName}_release.apk"
    def outFile = output.outputFile
    if (outFile != null && outFile.name.endsWith('.apk')) {
        output.outputFile =newFile(outFile.parent, fileName)
    }  
}

AS 3.0之后，同样代码自定义apk名称却会报错：

Error:(56, 0) Cannot set the value of read-only property 'outputFile' for ApkVariantOutputImpl_Decorated{apkData=Main{type=MAIN, fullName=debug, filters=[]}} of type com.android.build.gradle.internal.api.ApkVariantOutputImpl.

applicationVariants.all { variant ->
    variant.outputs.all { output ->  // each 改为 all
    def fileName = "${variant.versionName}_release.apk"
    def outFile = output.outputFile
    if (outFile != null && outFile.name.endsWith('.apk')) {
        outputFileName = fileName  //  output.outputFile 改为 outputFileName 
    }    
}

把each修改为all，然后通过outputFileName修改生成apk的名称。此外，AS 3.0后打包完，除了apk包文件，还会多一个 output.json 参数文件。

5. AS 3.0后关键字依赖变化
dependencies {    
    compile fileTree(include: ['*.jar'], dir: 'libs')    
    compile 'com.android.support:appcompat-v7:26.1.0'
    compile files('libs/gson-2.3.1.jar')
    compile project(':mylibrary')
    ...
}

AS 3.0之后依赖关键字：implementation

dependencies {  
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation 'com.android.support:appcompat-v7:26.1.0'
    implementation files('libs/gson-2.3.1.jar')
    implementation project(':mylibrary')
    ...
}

AS 3.0后Gradle关键字依赖发生变化：
compile(implementation/api),provided(compileOnly),apk(runtimeOnly)

AS 3.0后，在使用新依赖配置项时，引用本地库使用implementation指令时，若出现找不到导包或资源问题报错，可以更换依赖指令为api重新编译。关于implementation和api的区别，请移驾：AS Gradle依赖项配置

6. AAPT2编译报错

Error: java.util.concurrent.ExecutionException: com.android.tools.aapt2.Aapt2Exception: AAPT2 error: check logs for details

在项目根目录下gradle.properties文件中关闭APPT2编译：

...
android.enableAapt2 = false
7. PNG 图片错误，AAPT err(Facade for):Unable to open PNG file

AAPT err(Facade for):……Unable to open PNG file

android{
    ...
    aaptOptions{
        cruncherEnabled = false
        useNewCruncher = false
    }
    ...
}

用来关闭AS图片PNG合法性检查的，直接不让它检查。

1 ) .9.png图片放在res/drawable文件夹下
2 ) .9.png图片四边都要有黑线，确保图片是标准的.9.png图片

8. 输入法中文状态下无法选词

1 ) 如果你还在2.3.x的环境下开发，为了避免输入法问题，建议你暂时不要升级到3.x；
2 ) 如果你想2.3.x升级使用3.x，那么不建议你使用2.x的jre替换3.x的jre方式去处理输入法问题，虽然暂时可以解决输入问题，但是后面升级的时候你还得把2.x 的jre换回3.x的jre，否则升级后将无法正常使用AS；
3 ) 最简单最有效的解决办法就是在使用 AS的时候，切换到 windows自带的中文输入法就可以正常输入中文筛选词语了，相对而言，这样方便很多。虽然没有第三方输入法用起来那么顺手，但是可以有效解决输入法问题和避免以后升级的问题；
4 ) 终极方案：升级到 AS 3.1.1即可解决，AS 3.1.1已经修复了输入法中文状态下无法选词的BUG。

9. 移除无用资源问题

Error: Removing unused resources requires unused code shrinking to be turned on.

android {
  ...
  buildTypes {
    debug {
        signingConfig signingConfigs.release
        debuggable true
        zipAlignEnabled true
        minifyEnabled true //是否混淆
        shrinkResources true //是否去除无效的资源文件
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }

    release {
        signingConfig signingConfigs.release      
        zipAlignEnabled true
        debuggable true
        minifyEnabled true //是否混淆
        shrinkResources true //是否去除无效的资源文件
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
  }
  ...
}

AS 3.0.1后，如果使用shrinkResources来移除未引用资源，必须要先开启混淆minifyEnabled，才能通过资源压缩器将它们移除，否则编译会报错。

10. 软件升级安装冲突

参考

Google官方文档
https://developer.android.google.cn/studio/build/gradle-plugin-3-0-0-migration
https://developer.android.com/studio/releases/

下载

Android Studio下载
https://developer.android.google.cn/studio/archive.html
Android Gradle下载
http://services.gradle.org/distributions

结语

上述就是AS 2.x升级AS 3.x所遇到的问题，可能每个人情况不一样，遇到的问题也不尽相同。希望有类似经历和问题的小伙伴，可以帮助你们少走一些弯路。

初次写，如有不对和欠妥当地方，请大家帮忙指正，有疑问和补充的小伙伴请留言告知，万分感谢！文章会持续更新。

上一篇下一篇

猜你喜欢

热点阅读