使用Android Studio 遇到的坑爹问题及解决方法(持续更新中)

Android Studio(以下均简称为AS)是Google在2013年5月16日的I/0大会上推出的Android开发环境。

从最初的AS 1.5(我是从这个版本开始使用) 到现在的AS 2.1,这款开发工具有了很大的进步,而且更新频率也是非常高。相较于Eclipse+ADT的开发环境;在某些方面,对开发者来说的确是方便了许多。

我待AS如初恋,AS虐我千百遍

但是,这样一个开发环境,毕竟还很“年轻”,所以自身也会存在很多或大或小的bug,加上我们对它不是很熟悉(尤其是Gradle语法),给我们日常开发带来了很多坑爹的问题,在此做个记录,方便以后遇到时可以快速找到解决方法,同时分享给遇到同样问题的同学一些解决思路。

操作环境:Windows10 + Android Studio 2.1

这里只列举解决方有共性的问题,有时候会遇到一种AS重启(或者电脑重启)之后就没有问题的问题,这里不再列出。重启大法,真是时时刻刻都有用啊。

Gradle sync/building/refreshing 很长时间##

相信大部分人和我一样,第一次使用AS的体验并不是很好,一方面它很占内存,导致自己电脑特别卡,尤其是在构建过程中,另一方面,对Gradle构建方式及其语法的陌生,导致初次用AS创建工程费了很大劲,所以对他并不是很看好。

我们选择的AS的原因无非就是几乎所有的人都开始用了,你在Github或者是一些论坛上找到的源码,几乎都是AS版本的。而且有些很棒的三方库,在AS上引入也许就是一行代码的事情,可是在Eclipse上几乎是无法实现的,即便实现也得费很大的功夫。

有时候,我们从github上clone了一份大神的源码,想去解读一下,结果导入AS后就一直在哪里building,也许等待很长一段时间后,可以building完成,但是我们完全可以省下这部分时间。

AS长时间的building,一般来说是去下载gradle文件,也许你会说,我电脑文件里有gradle啊,就在下面这个目录。

C:\Users\username\.gradle\wrapper\dists

的确,如果我们用AS正常的构建并编译运行过一个工程的话,那么这个文件夹下至少会有一个gradle-xx-all或gradle-xx-bin的文件夹,这个文件下的内容其实就是AS用来构建工程所用到的东西。

所以,当我们clone到一份AS版本的源码时,不应该急着打开,而是应该先去预览一下两个文件:

build.gradle(这个是整个项目的gradle文件)####

这个文件里有一行很重要的配置代码:


dependencies {

        classpath 'com.android.tools.build:gradle:2.1.2'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }

这个指定了我们整个项目要构建所需的Android Plugin版本。

这个地方我的经验是,如果你clone到的源码里所使用到的版本比这里低,建议改成当前最新的版本。当然,如果你使用AS2.0及以上版本,它会自动提示你将Plugin版本升级为最新的。

gradle-wrapper.properties####

这个文件,位于你所创建项目

XXApplication\gradle\wrapper

这个目录下,我们可以看一下这个文件

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.10-all.zip

最重要的就是最后一行配置,他决定了你整个项目构建时所需要用到的gradle文件的版本,到这里你应该明白了,当我们使用AS打开clone到的源码时,他会按照这里的配置gradle-2.10-all.zip,去之前所说的

C:\Users\username\.gradle\wrapper\dists

这个目录下寻找gradle文件,如果刚好找到了,那么很幸运,你的项目不会build很长时间。如果没有找到,那么就得去下载gradle-wrapper.properties里所配置的gradle版本了,这就解释了我们第一次用AS创建Hello Wrold时为什么等待了那么长时间,因为要去下载一个文件(而且得是翻墙)。

明白这些,这个问题就很好解决了。第一种办法,很简单,提前从这里下载gradle-wrapper.properties里所指定的gradle版本文件,解压后放在\dists\目录下;这也是一种比较乖的方法,因为大神总是走在我们之前,他们当时写下这些源码时候,所使用的gradle文件版本可能比较老,所以为了保持源码不被更改,只能这样做了。

第二种,比较讨巧,你可以修改gradle-wrapper.properties的配置内容,将最后一行gradle版本修改为.gradle\wrapper\dists这个目录下包含的版本,或者是你可以打开你手头正常运行的项目文件,看看它的这个gradle-wrapper.properties是如何配置的,可做参考。

对于gradle-wrapper.properties里所用到的gradle文件和build.gradle中所依赖的gradle版本是否有严格的对于关系,尚不明确。

关于Instant Run的使用##

Instant Run 是AS 2.0之后提供的一种一边修改代码,一边在模拟器或者实际设备上看到 修改代码后的结果的高大上功能。

说白了,就是Activity可以不用重新启动,而你代码修改的内容就可以直接呈现出来,就是最近很火的热更新。关于他的运行原理,可以看看这篇文章,已经做了很详细的解释。

其实,对于这个功能来说真是又爱又恨。爱是因为,这种Instant Run的确是可以节省一点时间,毕竟AS 编译运行速度还是有点长,即便你的电脑是8G内存,i5处理器也是枉然。而恨,也恰恰是因为这种所谓的Instant Run,在刚开始使用AS 2.0的那段时间,常常有这样一种体验,代码明明改了为什么不生效,TextView的颜色明明代码里已经改成了绿色,为什么一运行还是黑色。甚至,有时候导致我们开始怀疑自己代码的逻辑性,所以在很长一段时间里都不能适应这个所谓的Instant Run,觉得完全就是添乱的。

但是,用的时间久了,当你渐渐熟悉了他的规律,理解了他的原理,你还是会觉得这个功能挺好的。

你可以通过设置,开启或者关闭这个功能

instant run.png

布局文件无法预览Exception raised during rendering##

有时候,我们会遇到layout下xml 布局文件无法查看的情况,而出现的提示也是很简单,就是一句话Exception raised during rendering。

这种AS无法渲染出视图,而且xml代码没有错误,无论怎样修改,就是绘制不出布局文件的视图。
这个一般是由于选择的Android SDK 版本不稳定所导致的问题 ,切换成低版本即可。

xml无法渲染.png

Element layer-list must be declared问题##

这个问题的解决方法源自网络

项目从Eclipse转到Android Studio。项目中使用了环信demo中的一些xml资源,转换后发现color资源文件夹下诸如layer-list或者shape等标签报Element xxx must be declared错误,大意就是layer-list或者shape这些标签没有定义。
layer-list或者shape等这些标签是常用的标签,Android Studio居然报没有定义错误,在Eclipse中却没有这个问题。网上不少人说这是Android Studio的一个bug,事实正相反,这是Android Studio的优点。

对于这个问题,首先要了解layer-list、shape等这些标签是什么东西。每一种标签都有对应的资源类,layer-list、shape等等标签代表的其实是个drawable资源。layer-list最终会解析为LayerDrawable,shape会解析为ShapeDrawable,其它的标签类似。由此可以看出layer-list或者shape等资源是drawable资源,应该放到drawable资源文件夹下。color资源不包括drawable资源,当然没有定义drawable类型的标签。
Eclipse不像Android Studio,对资源类型的检查没有那么严格,所以没有报错误。我觉得这倒是Android Studio的优点,是什么资源就应该放到什么位置,不容易让人产生疑惑。

所以在Android Studio下的解决方法就是把这些资源文件移动到drawable资源文件夹下

Duplicate file copy in apk##

出现这个问题,一般是由于引用了重复的jar包,而且会在报错日志中提示两个重复类的路径。这种情况在引用了外部工程(在Android Studio中就是新建了Module),或者是导入的第三方(如友盟)的SDK时很容易出现,因为外部引用的工程,一般是Github 上大神们写的一些库,方便我们使用。不同的外部工程中,使用了相同的jar包,这个情况时很有肯能发生的,列如support-v4的jar包,这个jar包几乎成了应用的标配,这个时候我们只需删掉其中的一个工程中的jar包即可。

Error:failed to find Build Tools revision xx.x.x##

我们从网络上clone一份源码,Sync时会提示这种问题。这个问题,其实很简单就是app的
build.gradle 所声明的编译项目的SDK 版本我们没有通过SDK Manager 下载,这个时候,你当然可以按照他给出的提示
Install Build Tools xx.x. and sync project 安装所需的SDK版本,进行下载安装,但这样一般都会耗时,所以最简单的方法就是修改app的build.gradle 中的buildToolsVersion 的内容,改成我们已经安装过的SDK版本,如果不知道怎么写具体的版本号,完全可以参考电脑里可以正常运行项目的这个配置信息。

或者是如图所示,在Project Structure 菜单中选择可用的SDK.

build tool select.png

2016年7月27日更新

SSL peer shut down incorrectly##

这个问题的原因也很简单,和之前提到的第一种情况是一样的,就是下载gradle.xxx.zip文件失败了,这个时候,如果条件允许的话,就直接翻墙下载,如果条件不允许,可以考虑之前的办法,从这里手动下载gradle-wrapper.properties里所指定的gradle版本文件,解压后放在\dists\目录下,或者是直接修改gradle-wrapper.properties的内容。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,126评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,254评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,445评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,185评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,178评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,970评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,276评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,927评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,400评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,646评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,213评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2 345

推荐阅读更多精彩内容