近段时间有机会接触到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出现错误,错误的位置等。如果可以看懂,直接根据位置修改,看不懂,则可根据错误的关键词在工程中或者网上搜索,一般都能找到解决方法。