一、项目结构选择
当新建项目时,我们所看到的是默认的Android模式的项目结构,这是被android studio转换过的,适合进行快速开发。
但为了易于理解,我们将它切换为Project模式,这就是真实的目录结构。
看到这里是一堆陌生的目录和文件,可能会让你觉得吃力,但在接下的逐步讲解后,相信你能够开始认识它们。
二、目录解析
在介绍各个目录内容之前我们先了解一下gradle,
Gradle是一个构建工具,它是用来帮助我们构建app的,构建包括编译、打包等过程。我们可以为Gradle指定构建规则,然后它就会根据我们的“命令”自动为我们构建app。Android Studio中默认就使用Gradle来完成应用的构建。
(一)外层目录解析
1、.gradle和.idea
这两个目录下放置的都是Android Studio自动生成的一些文件,我们无须关心,也不要去手动编辑。
2、app
项目中的代码、资源等内容几乎都是放置在这个目录下的,我们后面的开发工作也基本都是在这个目录下进行的,待会儿还会对这个目录单独展开进行讲解。
3、build
这个目录你也不需要过多关心,它主要包含了一些在编译时自动生成的文件。
4、gradle
这个目录下包含了gradle wrapper的配置文件,使用gradle wrapper的方式不需要提前将gradle下载好,而是会自动根据本地的缓存情况决定是否需要联网下载gradle。Android Studio默认没有启动gradle wrapper的方式,如果需要打开,可以点击Android Studio导航栏 –> File –> Settings –> Build,Execution,Deployment –> Gradle,进行配置更改。
5、.gitignore
这个文件是用来将指定的目录或文件排除在版本控制之外的。
6、build.gradle
这是项目全局的gradle构建脚本,通常这个文件中的内容是不需要修改的。下面会详细分析gradle构建脚本中的具体内容。
7、gradle.properties
这个文件是全局的gradle配置文件,在这里配置的属性将会影响到项目中所有的gradle编译脚本。
8、gradlew和gradlew.bat
这两个文件是用来在命令行界面中执行gradle命令的,其中gradlew是在Linux或Mac系统中使用的,gradlew.bat是在Windows系统中使用的。
9、HelloWorld.iml
iml文件是所有IntelliJ IDEA项目都会自动生成的一个文件(Android Studio是基于IntelliJ IDEA开发的),用于标识这是一个IntelliJ IDEA项目,我们不需要修改这个文件中的任何内容。
10、local.properties
这个文件用于指定本机中的Android SDK路径,通常内容都是自动生成的,我们并不需要修改。除非你本机中的Android SDK位置发生了变化,那么就将这个文件中的路径改成新的位置即可。
11、settings.gradle
这个文件用于指定项目中所有引入的模块。由于HelloWorld项目中就只有一个app模块,因此该文件中也就只引入了app这一个模块。通常情况下模块的引入都是自动完成的,需要我们手动去修改这个文件的场景可能比较少。
(二)app目录解析
1、build
这个目录和外层的build目录类似,主要也是包含了一些在编译时自动生成的文件,不过它里面的内容会更多更杂,我们不需要过多关系。
2、libs
如果你的项目中使用到了第三方jar包,就需要把这些jar包都放在libs目录下,放在这个目录下的jar包都会被自动添加到构建路径里去。
3、AndroidTest
此处是用来编写Android Test测试用例的,可以对项目进行一些自动化测试。
4、java
毫无疑问,java目录是放置我们所有java代码的地方,展开该目录,你将看到我们刚才创建的HelloWorldActivity文件就在里面。
5、res
这个目录下的内容就有点多了。简单点说,就是你在项目中使用到的所有图片,布局,字符串等资源都要存放在这个目录下。当然这个目录下还有很多子目录,图片放在drawable目录下,布局放在layout目录下,字符串放在values目录下,所以你不用担心会把整个res目录弄得乱糟糟的。
6、AndroidManifest.xml
这是你整个Android项目的配置文件,你在程序中定义的所以四大组件都需要在这个文件里注册,另外还可以在这个文件中给应用程序添加权限声明。
7、test
此处是用来编写Unit Test测试用例的,是对项目进行自动化测试的另一种方式。
8、.gitignore
这个文件用于将app模块内的指定的目录或文件排除在版本控制之外,作用和外层的.gitignore文件类似。
9、app.iml
IntelliJ IDEA项目自动生成的文件,我们不需要关心或修改这个文件中的内容。
10、build.gradle
这是app模块的gradle构建脚本,这个文件中会指定很多项目构建相关的配置。
11、proguard-rules.pro
这个文件用于指定项目代码的混淆规则,当代码开发完成后打成安装包文件,如果不希望代码被别人破解,通常会将代码混淆,从而让破解者难以阅读。
注意:你会发现在app下面会出现和project外层相同命名的文件,这是由于每一个project之中可以创建多个模块(module),而此时app是project中的唯一模块,app中的这些同名文件是只作用于app模块,而在project的直接目录下的文件是作用于整个项目的。
(三)build.gradle详解
首先我们来看一下工程目录下的build.gradle,它指定了真个整个项目的构建规则,它的内容如下:
buildscript { repositories { jcenter() //构建脚本中所依赖的库都在jcenter仓库下载 } dependencies { //指定了gradle插件的版本 classpath 'com.android.tools.build:gradle:1.5.0' } } allprojects { repositories { //当前项目所有模块所依赖的库都在jcenter仓库下载 jcenter() } }
我们再来简单介绍下app模块的build.gradle的内容:
//加载用于构建Android项目的插件 apply plugin: 'com.android.application' android { //构建Android项目使用的配置 compileSdkVersion 23 //指定编译项目时使用的SDK版本 buildToolsVersion "23.0.1" //指定构建工具的版本 defaultConfig { applicationId "com.absfree.debugframwork" //包名 minSdkVersion 15 //指定支持的最小SDK版本 targetSdkVersion 23 //针对的目标SDK版本 versionCode 1 versionName "1.0" } buildTypes { //针对不同的构建版本进行一些设置 release { //对release版本进行的设置 minifyEnabled false //是否开启混淆 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' //指定混淆文件的位置 } } } dependencies { //指定当前模块的依赖
首先我们来看一下工程目录下的build.gradle,它指定了真个整个项目的构建规则,它的内容如下:
buildscript { repositories { jcenter() //构建脚本中所依赖的库都在jcenter仓库下载 } dependencies { //指定了gradle插件的版本 classpath 'com.android.tools.build:gradle:1.5.0' } } allprojects { repositories { //当前项目所有模块所依赖的库都在jcenter仓库下载 jcenter() } }
我们再来简单介绍下app模块的build.gradle的内容:
//加载用于构建Android项目的插件 apply plugin: 'com.android.application' android { //构建Android项目使用的配置 compileSdkVersion 23 //指定编译项目时使用的SDK版本 buildToolsVersion "23.0.1" //指定构建工具的版本 defaultConfig { applicationId "com.absfree.debugframwork" //包名 minSdkVersion 15 //指定支持的最小SDK版本 targetSdkVersion 23 //针对的目标SDK版本 versionCode 1 versionName "1.0" } buildTypes { //针对不同的构建版本进行一些设置 release { //对release版本进行的设置 minifyEnabled false //是否开启混淆 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' //指定混淆文件的位置 } } } dependencies { //指定当前模块的依赖 implementation fileTree(dir: 'libs', include: ['*.jar']) testImplementation 'junit:junit:4.12' implementation 'com.android.support:appcompat-v7:23.1.1' implementation 'com.android.support:design:23.1.1' }
当我们需要用到一些第三方库时,只要在app模块下的dependencies块加入 implementation ‘xxxx’ 的语句可使gradle自动从jcenter仓库下载我们所需的第三方库并导入到项目中。
注意
:在使用android studio3.0之前的版本,依赖第三方库所用的关键词为
compile
而现在更改为了
implementation