前言:好多 Android 开发者都在说Android Studio
太坑了,老是出错,导致开发进度变慢,出错了又不知道怎么办,网上去查各种解决方案五花八门,有些可以解决问题,有些就是转来转去的写的很粗糙,让人看了云里雾里。我就很不爽这种做法,要么就不写,要写就写出让人一目了然的东西,所以在这里我就详细了总结了一下Android Studio2.X的那些坑。
【tips】如果这里没有你遇到的难题,欢迎留言提出来,我能解决的就一定帮你搞定。
本文同步在github发布,有兴趣的可以去看看。https://github.com/AweiLoveAndroid/The-pit-of-the-Android-Studio
这篇博客大体上分为以下几个方面的内容:
1)关于sdk 点击此处链接: 1
2)关于jdk 点击此处链接: 7、8、26、27、28
3)关于加速器(Intel HAXM)和启动问题 点击此处链接: 2、 3、 4、 5、 29
4)关于gradle 点击此处链接:9、 15、 19、 23、25
5)关于混淆打包编译 点击此处链接:10、 22
6)关于依赖库和插件 点击此处链接:6、 11、 12、 13、 18
7)关于配置和源码关联 点击此处链接:14、 16、 20、 21、 24
8)关于模拟器 点击此处链接:17
1. Android Studio第一次启动时出现 unable to access android sdk add-on list
出现原因:电脑没有sdk,studio也没有自带sdk;
解决办法:在安装studio的目录下找到bin\idea.properties,打开这个文件,在末尾加上一行
disable.android.first.run=true就行了,如果打不开这个文件就用editplus或者sublime text打开
2. 在安装了新的 Android Studio 之后,AVD 新建并启动模拟器的时候报以下错误:
emulator:ERROR:x86 emulation currently requires hardware acceleration!
Please ensure Intel HAXM is properly installed and usable.
CPU acceleration status: HAX kernel module is not installed!
出现原因:原来新的 Android SDK 在运行虚拟机的时候,需要安装 Intel HAXM:一个硬件加速器,为的是在x86平台上加快安卓虚拟机的运行。
解决方法:
(1) 在安装之前首先到 SDK 的安装目录下打开SDK Manager:
找到 Inter....(中间的很多单词就不写了,重点看到 Inter 和 HAXM 就可以了点击下载) HAXM 点击install
(2) 然后进入到你SDK的目录下,再进入extras —> intel —> Hardware_Accelerated_Execution_Manager,
可以看到HAXM的安装文件:interhaxm-android.exe
(3) 但是在安装之前还有一个步骤,就是重启计算机,进入开机界面前按F2进入到计算机的BIOS下,
切换到 Configuration 找到下面的 Intel Virtual Technology。设置为Enable状态(即允许虚拟机技术),
然后再双击interhaxm-android.exe安装,一直next就可以了
3. Intel 加速器 HAXM ,安装过程中可以会出现如下错误:
"Failed to configure driver: unknown error. Failed to open driver"
有以下几个步骤可以解决该问题:
(1) 下载haxm_extra_workaround.zip 附件
(2) 解压后提取hax_extract.cmd 文件到 HAXM 的解压文件路径中
(3) hax_extract.cmd 右键用管理员权限运行。
执行以上步骤后,基本可以解决以上提示的安装异常问题。
4. 因为电脑卡死,结束了qemu-system-i386.exe这个倒霉的进程,导致我开启模拟器的时候一直提示我没有安装Intel HAXM,只好再安装一遍,然后出现了以下问题:
This computer meets the requirements for HAXM,but IntelVirtualization Technology(VT-x) is not turned on.
HAXM can be installed,but will not work until VT-x is enabled.
Please refer to the Inter HAXM documentation for more infomation.
解决办法:
如果在安装过程中出现Intel virtualization technology (vt,vt-x) is not enabled的错误,需要进
入的电脑的BIOS中修改,重启电脑,进入BIOS页面(一般在开机时按Del或F2,根据电脑不同,进入方式不
同),找到Advanced Mode –> Advanced –> CPU Configuration –> Intel Virtual Technology设置为
Enabled(表示开启虚拟化)就可以了。重启Android studio就可以了。
5. 关于intelhaxm-android.exe安装的坑:不管是双击还是右键以管理员身份运行都没用,怎么解决?
解决办法:
在SDK\extras\intel\Hardware_Accelerated_Execution_Manager中
找到intelhaxm-android.exe,右键解压,双击setup.exe安装就好了
6. Failed to resolve: junit:junit:4.12
出现原因:项目中引用了junit库中的代码,但是却没有相关的junit的依赖库
解决办法:添加相关的依赖库引用,在项目的Module的build.gradle中添加如下代码就OK了
repositories {
maven { url 'http://repo1.maven.org/maven2' }
}
7. 只要是API24以上的Android Studio,如果JDK低于1.8都会出现这个问题,比如我列举两个:
(1)Error:Execution failed for task':app:compileOrangeDevDebugJavaWithJavac'.compileSdkVersion 'android-24' requires JDK 1.8 or later to compile.
(2)Android N requires the IDE to be running with Java 1.8 or later
解决办法:把1.8以前的jdk都卸载掉,然后把环境变量配置成1.8的,就可以了.
8. Error:(1, 1) A problem occurred evaluating project ':app'.com/android/jack/api/ConfigNotSupportedException :Unsupported major.minor version 52.0
解决办法:
(1)把1.8以前的jdk都卸载掉,使用1.8版本的jdk
(2)File - Project Structure - SDK Location - JDK location,这里面有个选项,
可以选择"use embedded JDK(recommended)",使用AS内置的JDK。(不推荐这样做)
9. Unknown host 'downloads.gradle.org' 这个问题的解决:
使用android studio的gradle新建项目时候出现:
Error:Unknown host 'downloads.gradle.org'.Enable Gradle 'offline mode' and sync project.
Learn about configuring HTTP proxies in Gradle
或者出现 Error:No cached version listing for com.android.tools.build:gradle:0.12.+ av
解决方法如下:
不是第一次的话以后就可以点这里的clean了。
或者更直接点,打开cmd,找到你的项目根目录,输入gradle clean(前提是下载gradle,并且设置环境变量)
如果还是下载不了的话,请看下文介绍:
具体的android studio 配置
安装步骤:
1.先下载as,下载地址:https://developer.android.google.cn/studio/index.html 下载完直接安装,安装完打开它,然后会出现下载gradle-XXX-bin.zip,根据Android Studio版本下载对应的Gradle版本,下载这个一般都会卡死,不过不要紧,把as关掉。
2.下载gradle-XXX-bin.zip,下载地址:http://services.gradle.org/distributions/,下载完之后,找到目录: C:\Users\用户名.gradle\wrapper\dists\gradle-XXX-bin\vruqmccc8532n7gr46qavsii8\ 把下载的gradle-XXX-bin.zip放到该目录下,并且把gradle-XXX-bin.zip解压到该目录(解压得到的文件为gradle-XXX)。
3.最关键的来了,把该目录下的gradle-XXX-bin.zip.part文件删除,然后复制gradle-XXX-bin.zip.lck,把它改为gradle-XXX-bin.zip
4.到此你就可以运行Android Studio开发了。
另附: Android Studio和gradle版本对照图请参考我的github Android Studio版本、Gradle版本、Build Tools版本三者之间对照详细解答
10. 关于混淆出现的问题:
(详细请看 http://www.open-open.com/lib/view/open1490252413493.html)
问题一:出现 Unknown verification type [95] in stack map frame 错误
Error:Execution failed for task
‘:app:transformClassesWithMultidexlistForNiannianDebug’.Java .io.IOException:
Can’t read [
E:SVNbroondontrunkcodebroodon_androidappbuildintermediatestransformsjarMergingnianniandebugjars11fcombined.jar]
(Can’t process class [com/tencent/wxop/stat/al.class] (Unknown verification type [95] in stack map frame))
原因分析:引用的第三方库已经混淆过,再在本地进行编译混淆的时候就会报出这个错误。
解决办法: 则修改混淆器,重新进行编译,将新的混淆器覆盖原来的混淆器,则可以解决。
问题二:
Error:Execution failed for task ‘:app:transformClassesWithMultidexlistForNiannianDebug’.
proguard.KeepClassSpecification.(ZZZZZZLproguard/ClassSpecification;)V
原因分析:升级 Android studio 以后,使用的混淆器版本不一致
解决办法: 根据 Android studio版本选择与之对应的混淆器版本
11. 这是什么原因?是因为65535问题?还是因为v7包重复了? 【待解决。。。】
Error:Execution failed for task ':app:transformClassesWithDexForDebug'.
com.android.build.api.transform.TransformException: java.lang.RuntimeException:
java.lang.RuntimeException: com.android.ide.common.process.ProcessException:java.util.concurrent.ExecutionException:
com.android.ide.common.process.ProcessException: Return code 1 for dex process
12. non-zero exit value 1; 和 non-zero exit value 2; 和 non-zero exit value 3 问题的解决:
Error:Execution failed for task ':app:transformClassesWithDexForDebug'
com.Android.build.api.transform.TransformException:
com.android.ide.common.process.ProcessException:
org.gradle.process.internal.ExecException:Process 'command 'F:\Program Files (x86)
\Java\jdk1.8.0_31\bin\java.exe'' finished with non-zero exit value 1
问题一: non-zero exit value 1原因分析:
原因分析:这个是因为依赖包重复了 (像v4和nineoldandroids),app中实现了对easeUI的依赖,但是app和easeUI都添加了对v4这个包的依赖。
解决办法:
把v4包注释修改之后,clean,rebuild一下,OK
问题二: non-zero exit value 2
解决办法:
这个错误在app的build.gradle里面添加下面这句就好了。
android {
defaultConfig {
...
multiDexEnabled true
}
}
问题三: non-zero exit value 3
解决办法:
这个错误就在app的bulid.gradle里面加上这句,再rebuild ,之后再运行就行了。4g可以看电脑配置修改(2g,3g,6g,8g)。
dexOptions {
javaMaxHeapSize "4g"
}
13. 打开Android Studio报错
Plugin Error: required plugin “Android Support” is disabled
更详细的错误信息如下:
Problems found loading plugins:
Plugin "Google Analytics Uploader" was not loaded: required plugin "Android Support" is disabled.
Plugin "SDK Updater" was not loaded: required plugin "Android Support" is disabled.
Plugin "Android NDK Support" was not loaded: required plugin "Android Support" is disabled.
Plugin "Google App Indexing" was not loaded: required plugin "Android Support" is disabled.
Plugin "Google Cloud Tools For Android Studio" was not loaded: required plugin "Android Support" is disabled.
Plugin "Google Cloud Testing" was not loaded: required plugin "Android Support" is disabled.
Plugin "Google Services" was not loaded: required plugin "Android Support" is disabled.
解决办法:
打开File-Settings-Plugins,把报红色的插件全部取消勾选,在把Android Support勾选,然后Apply-Save,重启下studio 就可以了。
14. 自定义android studio的配置文件目录后,无法正常安装和卸载插件(貌似2.0版本之后的插件安装卸载就有问题了)是何原因?详情看知乎 https://www.zhihu.com/question/38604486
解决方法:
方法(1):将idea.system.path/plugins下的文件移动到{idea.config.path}/plugins下(如果是压缩包,则需要先解压)。
然后重启一下AS就可以了。删除也是,貌似也得手动去文件夹下删除)
方法(2):修改AS安装目录下的idea.properties文件:
idea.config.path=D:/.AndroidStudio2.0/config
idea.system.path=D:/.AndroidStudio2.0/system
idea.plugins.path=${idea.system.path}/plugins
15. 导入android studio项目,出现的问题:
Error:Failed to open zip file.
Gradle's dependency cache may be corrupt (this sometimes occurs after a network connection timeout.)
Re-download dependencies and sync project (requires network)
Re-download dependencies and sync project (requires network)
这个错误提示意思是:Gradle's dependency cache may be corrupt:(Gradle的依赖缓存可能是损坏的。)
原因分析:我们要导入别人写好的工程时,一般不需要更改什么,as智能判断会提示我们是否需要对build gradle setting之类的文件进行修改。针对gradle个版本工具来说,如果不选择更新直接原来的Gradle Version中的Gradle工具,再加上.gradle库中没用该版本时,as会创建这样的库,有时候这样的库会下载不完整,导致上面的问题。
-
解决办法:
1.下载 gradle
下载地址很简单,以 下载gradle-3.5-all.zip为例子。不要去网上找这样那样的网站下载gradle工具了。浏览器输入以下链接快速下载:
services.gradle.org/distributions/gradle-3.5-all.zip2.复制替换
下载完成后替换 C:\Users\Administrator.gradle\wrapper\dists\gradle-3.3-all
exhrs6ca08n232b14ue48lbye中对应的gradle-3.5-all.zip文件。
正确解压后的的文件如下图所示:
3.重新打开项目,对工程中做一些配置如下,重新编译一下,就没问题了:
16. Android studio 源码无法关联,提示Souces for android api 25 platform not found:
解决方法:
1)找到jdk.table.xml这个文件
jdk.table.xml文件路径:(以win7为例,Administrator是电脑的用户名,我当前开发工具版本号是Android Studio2.3)
C:\Users\Administrator\.AndroidStudio2.3\config\options\jdk.table.xml
2)在<sourcePath>节点下添加这一句<root type="simple" url="file://E:/android/sdk/sources/android-25" />
修改后的部分配置文件如下:注意红色方框部分,找到对应的编译版本,再添加对应的源码位置
17. com.android.ddmlib.SyncException: No space left on device
解决方法:
把模拟器里没用的应用或者demo卸载卸载。如果还不行,就重启或者重新创建一个模拟器
18. app:transformClassesWithJarMergingForDebug
原因:重复依赖导致的.
解决办法:
找到报错的那个提示,看上面报错的是哪个类,双击shift搜索一下,看这个报错的类在哪个依赖库里面用到了。
在AS中,选择以project显示项目,找到最下面的External Libraries,然后继续找,找到相对应的类库。
点开之后发现了一个pom.xml,这里面就是关于这个jar的一些配置文件,往下找,发现了一个依赖库的引用,
复制里面groupId,到你的app的build.gradle里,找到那个依赖,添加{exclude group: 'XXX'} XXX换成刚才复制的groupId,这样就
把这个groudId的引用去除掉。
19. processdebugresources
原因:build.gradle的兼容包和compileSdkVersion配置不对引起的
解决办法:让兼容包和compileSdkVersion匹配就OK了。关于这个版本匹配,请查看上面的第9点那张表格。
20. Android Studio配置androidannotations出现 Error:Execution failed for task ':app:compileDebugJavaWithJavac'
原因: androidannotations配置环境对SDKtools, Build Tools, Platform Tools 以及 SDK Platform有要求,不匹配的话就会报错
解决办法:打开SDK Manager,更新SDKtools, Build Tools, Platform Tools 以及 SDK Platform到最新版本
21. Error:com.android.builder.internal.aapt.AaptException: Failed to crunch
原因: 项目路径太长,导致有的资源文件整个路径长度超过了240个字符。这是Android Studio的一个坑。
解决办法:
(1)重命名项目名,重新运行一下。
(2)如果以上方法不行,就缩短路径深度,减少路径层级,每一级路径名字尽可能的缩短。
22. Android Studio编辑时发生的错误
Error:warning: Ignoring InnerClasses attribute for an anonymous inner class
原因:有3种情况可以导致这种错误发生:
(1)导了重复jar包,或者导入了不同版本的同名jar包。
(2)AndroidStudio打签名包时android.keystore 的密码输入错了
(3)有可能是Dex的方法数超过上限导致的。
解决办法:
(1)把重复的jar包删除掉,Rebuild Project,就OK了,如果,还有其他问题,那证明你的app下的build.gradle依赖配置就有问题。
(2)重新打包一个正式包,重新输入签名账号密码。
(3)在项目的build.gradle文件中添加multiDexEnabled true 搞定。
示例:
之前是在win7电脑的工程运行在mac电脑,打开就出了这样的错误。解决这个问题的方式,给大家分析一下:
1.第一考虑是不是可以直接忽略第三方的属性的错误警告.找到项目下对应的proguard-rules.pro文件,在proguard-rules.pro文件中
添加如下代码
-keepattributes EnclosingMethod
2.查看第三方jar有没有重复利用的,发现并没有。继续下一步。
3.看看是不是Dex越界引起的问题。在项目的build.gradle文件中添加以下代码:
multiDexEnabled true
重新编译之后,项目成功移植了。
23. Android Studio版本更新后Gradle版本不匹配问题
Error:(1, 0) The android gradle plugin version 2.3.0-beta1 is too old, please update to the latest version.
To override this check from the command line please set the ANDROID_DAILY_OVERRIDE environment variable to "xxxxxxx"
问题截图如下:
解决办法:升级Gradle到合适版本,具体操作如下:
【特别说明】Android Studio版本和gradle版本是相匹配的,不是随意匹配的,版本不匹配就会出错。具体的Android Studio和gradle版本对照请看 Android Studio和gradle版本对照
(1)访问 Gradle官网下载地址 来下载与之匹配的Gradle版本或者最新的Gradle工具包;
(2)解压到Android Studio的gradle目录下;
(3)File->Setting->Build,Exection,Deployment->Gradle->Use local gradle distribution,修改Gradle home为AS安装
目录下最新的gradle版本;(4)修改对应Project的build.gradle中的com.android.tools.build:gradle:版本号为提示版本(如修改classpath 'com.android.tools.build:gradle:2.3.0-beta1'为classpath 'com.android.tools.build:gradle:2.3.0-beta3');
(5)修改gradle-wrapper.properties中distributionUrl上的版本号与当前Gradle版本号一致(如修改
distributionUrl=https\://services.gradle.org/distributions/gradle-3.2-all.zip
为distributionUrl=https\://services.gradle.org/distributions/gradle-3.5-all.zip)
;(6)重新同步。
图解如下所示:
24.AppConfig.java文件中文乱码,log也乱码问题的解决。
解决办法:找到对应的module或者lib,打开里面的build.gradle,输入以下代码:
新版gradle用这个:
tasks.withType(JavaCompile) { options.encoding = "UTF-8" }
旧版gradle用这个:
tasks.withType(JavaCompile) { options.encoding = "UTF-8" }
【另外】:上述方法如果不管用,试着点击Android studio右下角的文件编码按钮,图中红色区域,然后选择UTF-8改选为GBK。
此时会弹出窗口提示是否重载文件,选择“Reload”,基本也可以搞定。
如果设置之后还是不行,建议clean一下,重启一下Android Studio。
25. failed to complete gradle execution问题
使用Android Studio创建新项目后,一直出现 “Failed to complete Gradle execution. Cause: A fatal exception has occurred. Program will exit”这个问题。
解决方法有2个(2种方式实质上还是一样的)
-
方法1:打开工程的gradle.properties文件,添加如下配置项,这个问题应该就不会出现了。
org.gradle.jvmargs=-Xmx512m -XX:MaxPermSize=512m
如下图所示:
-
方法2:在Android Studio中,选择File -> Settings -> Compiler -> 在VM options选项中填写:
-Xmx512m -XX:MaxPermSize=512m
如下图所示:
26. 控制台乱码的解决方式:
旧版本的gradle
tasks.withType(Compile) {
options.encoding = "UTF-8"
}
新版本的gradle
tasks.withType(JavaCompile) {
options.encoding = "UTF-8"
}
27. AS 2.X如何支持java8?
AS 2.X最高是支持java7的环境,要想支持java8,可以做以下设置:
如果是安卓的module,可以做以下配置:
android {
compileSdkVersion 25
buildToolsVersion "25.0.3"
defaultConfig {
applicationId "com.lzw.java8demo"
minSdkVersion 25
targetSdkVersion 25
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
// 这个别忘记加上去
jackOptions {
enabled true
}
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
// 指定java8编译
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
如果是创建的java的module,在gradle最后加上以下配置:
sourceCompatibility = "1.8"
targetCompatibility = "1.8"
28. Error:Execution failed for task':apptransformClassesWithDesugarForDebug'
我看报错那里说的是注解报的错,我怀疑是jdk不一致导致的。我是打开IDE报的错,我把as的配置导入到了IDE,打开项目就报错了,as用的是jdk1.8,不知道这个IDE是不是要用jdk1.7?
目前还没找到原因。。
29.AS打开速度慢如何解决?
在Android Studio的bin目录里,打开idea.prooperties
文件,添加
disable.android.first.run=true
这里没提到的可以参考: https://my.oschina.net/Jieth/blog/489014,以后会逐渐补充进去。