Android Studio常用配置及使用技巧

近段时间有机会接触到iOS开发,但是光Xcode上配置证书,描述文件,上真机调试等就费了挺大劲。结合看到很多Android开发新手问的简单问题,忽然有了更多的理解。

总需要有人引一下,别被开头的困难束缚了前进的步伐。另外也算是继续未完成的《一个三年Android开发的总结》。

AndroidStudio常用配置及使用技巧分两篇写,将详细讲述从导入开源工程,配置gradle编译,到使用各种快捷键浏览分析源代码,高效的编译、开发、调试程序,监测应用运行状态。

本篇先整体介绍一个android studio工程的基本配置文件和android应用的编译流程,再实际的导入一个开源工程,将可能遇到的问题一一分析,提供解决方法的同时,也能了解如何更好的定位问题和搜索解决方案。

一、Android Studio工程基本构成

Google基于Intellij IDEA社区版提供了Android Studio。IDEA工程结构由工程(Project)、模块(Module)、库(Library)、SDK和方面配置(Facet,翻译的不好,完整说明请看文末参考链接)构成。在Android Studio中我们主要理解工程、模块、库和SDK,Facet则可以简化为Gradle配置。典型工程目录如图所示:


在一个工程中可以有多个模块,这两个概念只是将相关的文件聚合到一起,并不强制要求工程与模块之间的关系。

模块的生成会依赖于库和SDK。从Android工程上说,就是模块既可以生成APK文件,也可以作为库模块提供aar包供其他模块使用。模块中也依赖Android SDK和各种第三方库,通过在build.gradle中的配置可见。

这里先介绍自动生成的.iml文件和.idea目录下的配置文件,第二部分再详细说明跟gradle工程相关的目录。

到具体的工程目录中,可以看到相关的配置文件,涉及根目录的*.iml文件和.idea目录。iml文件中定义了工程的相关配置信息,有Facet为Java-gradle,编译路径为build目录等。

在.idea目录下,包括了compiler.xml,encodings.xml,modules.xml,gradle.xml等等,设置编译哪些文件,文件编码,包含哪些模块,gradle信息。但是这里的workspace.xml则记录了你的个人设置,包括哪些窗口显示哪些文件,工程显示方式是Android还是Project形式等等。

其实不必太关心这里的配置,当你导入一个开源工程时,Studio会从已有的gradle文件完成这些文件和目录的创建。

开篇讲了大段的工程配置文件,其目的是了解工程目录中和代码不直接相关的目录和文件,平时也不要太在意。而编译生成APK安装包最应该关心的是使用Gradle编译。

二、Gradle工程编译

1. 工程结构

Android最初是在Eclipse中配合ADT完成开发的,而构建工具(打包生成apk文件)是Ant。在切换到Android Studio后,构建工具也换成了Gradle。一般的Android应用工程都是Android Gradle(Gradle的Android插件)目录结构,如上图所示。

工程中的模块都有自己单独的目录,目录中都有build.gradle文件。

具体的模块目录中:

build:编译中产生的临时文件,最终生成的apk文件在build/outputs/apk目录下

libs:模块依赖的动态库(so文件)或者jar包文件等

src:源码目录,包括Java源代码、资源文件、AndroidManifest文件等

proguard-rules.pro:混淆配置文件

build.gradle:模块配置文件,描述模块采用的SDK,Build Tools版本,最终是库文件还是生成apk文件等信息

*.iml:文件中定义了模块的相关配置信息,有Facet依然为java-gradle,编译路径为build目录,源码路径,依赖库路径信息

外层工程目录中:

gradle:gradle版本信息,包括下载地址

gradle.properties:gradle运行配置,包括代理设置,内存大小设置等

gradlew和gradlew.bat:封装好的gradle命令,指定用gradle目录下的gradle版本

local.properties:Android SDK和NDK目录配置信息

settings.gradle:gradle工程中包含哪些模块

这样的目录结构也是秉承于Gradle的build-by-convention特点,做了大量的默认设置的结果。如果想改变可以在build.gradle中单独设置源码目录,AndroidManifest.xml文件路径等。

2.编译流程

详细的描述Gradle的编译可以点击原文链接,查看《理解使用Gradle编译打包Androidapk》《使用Ant打包Android应用——apk生成过程》(虽然也没有具体的一个个Task的运行流程,但是能对APK文件的构成和Gradle编译有一个初步理解。)

这里从工程配置的角度简单将用到的这些配置文件串联起来。

在Android Studio中打开一个工程的时候,可以选择最外层目录的build.gradle,里面设置好了要用到的Android Gradle插件的版本和外部库文件的下载地址(一般是jcenter)

(1)settings.gradle:搜索并读取settings.gradle配置,将所有模块都加载到当前Studio的工程目录中。

(2)模块(Module)中的build.gradle:配置了使用的android gradle插件,指定生成aar还是apk,

作为库:apply plugin: ‘com.android.library’

生成apk:apply plugin: ‘com.android.application’

(3)local.properties:根据设置的使用的Build Tools和SDK版本,从local.properties指定的SDK目录中查找是否有匹配的版本,没有的话会报错,提示安装SDK等。

当然,实际的加载顺序是预先加载好了使用的gradle版本,SDK的目录,这里方便理解流程而这样说。

一般生成APK文件时,首先是在加载好相关配置,生成主模块与子模块之间的Task依赖图,然后依次执行各个Task。一般生成调试APK文件都是assembleDebug的Task,先是调用依赖库Task依次执行,其实都跑不了《使用Ant打包Android应用——apk生成过程》提到的资源处理,class文件生成等。

三、导入开源工程FlexboxLayout

FlexboxLayout时Google开源的一个简单灵活的布局库,类似于CSSFlexibleBoxLayout,这里不具体介绍FlexboxLayout的使用,只是从讲述如何导入并使用开源工程。

0.测试环境

操作系统:Mac OS X、Ubuntu 14.04、Windows 7

Android Studio 2.2 Build #AI-145.3276617, built on September 15, 2016

JRE: 1.8.0_76-release-b03 x86_64

JVM: OpenJDK 64-Bit Server VM by JetBrains s.r.o

1.下载代码

Gitclonehttps://github.com/google/flexbox-layout.git

也可以直接下载ZIP包或者从android Studio中直接Check Out出来

2.打开工程前配置

如果你的网络能够非常快的下载到不同版本的Gradle和SDK等,请简单看下这里的配置即可,不用实际操作。

对于网络不好的同学,我们可以先确定下自己的Gradle版本和已有的SDK信息,简单的方式是在Android Studio的欢迎页面,点击最下方的Configure->SDK Manager(或者先打开一个以前运行良好的工程,在Studio的设置页面查看),可以看到如图所示页面:


(1)SDK Platforms:显示了从Android2.2到Android7.1.1,关心你installed的API Level就行(有些显示Update available),数字从8到25

(2)SDK Tool:切换到SDK Tools的Tab页,查看Build-Tool和Android Support Library的Version信息,显示不详细的话,勾选又下角的“Show Package Detail”

(3)Gradle插件:查看Android Gradle插件版本信息,在新建的测试工程中的build.gradle里,查看“ classpath ‘com.android.tools.build:gradle:xxx”,或者从Studio的设置搜索Gradle查看。记下自己的版本信息,我这里是2.14.1。

(4)Support Library:需要此库的在已打开的测试工程设置中查看,平时配置模块工程也会用到,如图所示:


3.打开FlexboxLayout工程

现在可以进入下载下来的FlexboxLayout目录中

(1)以文本文件方式查看最外层build.gradle文件

Gradle插件版本: classpath ‘com.android.tools.build:gradle:2.2.3’,改成和自己的一致版本

compileSdkVersion的数字是否在自己的已安装的SDK Platforms里

buildToolsVersion和supportLibVersion也和compileSdkVersion一样

(记住这样做有时会有风险,但是一般查看开源工程源码和别人的Demo还行,真出现编译运行异常的话,那只能老老实实保留人家的版本配置)

有些工程不在此文件中,而是在具体模块的build.gradle文件中设置,名称变为com.android.support:support-v4,com.android.support:appcompat-v7等版本,他这里统一使用了supportLibVersion

(2)以文本文件方式查看模块中的build.gradle文件,看是否还有不一致的

(3)打开工程:从已经打开的工程中 File->Open选择build.gradle ,或者在欢迎页面Open an existing Android Studio project

得等待一些时间来下载依赖的库。如果你不想等,那看错误分析,不下载这么多库的也可以。

四、打开别人工程可能遇到的问题

如果没有按照上述方法做类似修改,可能会有些错误

1.引入旧工程,导致Gradle版本和Android Gradle插件版本不一致

如error:Gradle version 2.2 is required. Current version is 2.14.1

当classpath ‘com.android.tools.build:gradle:1.3.0’版本低时,会有如是提示,如果不强制要求可改成自己Studio已有的版本

一般Android Studio是2.2,则插件版本也是2.2.0;Android Studio是2.3,插件版本也是2.3.0

gradle和插件对应关系查看https://developer.android.com/studio/releases/gradle-plugin.html

2.Build Tools和依赖库不一致,又无法下载到

如Error:Failed to resolve: com.android.support:support-compat:25.3.0

其实就是修改build.gradle中的compile “com.android.support:appcompat-v7:版本信息

3.发现一直在不停的Gradle Sync, Gradle Build或者刷新等

其实很有可能上上面提到的Gradle版本,SDK等始终下载不下来,可以强制停止,修改后重新打开。

4.做到几乎不下载

因为只是看代码和测试功能,因此得想办法减少大量下载的配置:

(1)其实也可以通过注释外层工程build.gradle里的如下代码,使打开的更快,但是会有其他问题,这里还不建议新手直接如此修改。

//classpath ‘com.github.dcendents:android-maven-gradle-plugin:1.5’

//classpath ‘com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6’

(2)出现Gradle Sync错误

Error:Plugin with id ‘com.github.dcendents.android-maven’ not found.

搜索com.github.dcendents.android-maven哪里用到了,发现时在flexbox模块中的maven.gradle使用了此插件

这些gradle文件的使用,都是在build.gradle中apply方式加入,因此在该模块的build.gradle中注释如下

//apply from: ‘maven.gradle’

//apply from: ‘bintray.gradle’

(3)再尝试编译出现

Error:(29, 0) Could not get unknown property ‘mavenVersion’ for ProductFlavor_Decorated{name=main, dimension=null, minSdkVersion=DefaultApiVersion{mApiLevel=9, mCodename=’null’},

搜索mavenVersion,发现定义了一些常量在constants.gradle中,因此在build.gradle中apply此文件即可,修改后如下

apply plugin: ‘com.android.library’

apply from: ‘constants.gradle’

五、解决思路总结

打开、导入工程的常见问题如上述一般都能解决,但是碰到一个具体问题时,该如何解决呢,在《一个三年Android开发的总结》里说过一些常用的网站。另外一定要仔细看AndroidStudio报的错误信息,不要只看在MessageGradleBuild里显示的最后错误信息,还可以看看AndroidStudio界面右下角的GradleConsole信息,里面给出了Tasks运行的信息,比如当前运行到哪个Task出现错误,错误的位置等。如果可以看懂,直接根据位置修改,看不懂,则可根据错误的关键词在工程中或者网上搜索,一般都能找到解决方法。

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

推荐阅读更多精彩内容