欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

Android Studio教程01-的工程和目录结构解析

程序员文章站 2022-04-09 18:53:51
[TOC] 1.主目录 1. .gradle和.idea 这两个目录下放置的都是Android Studio自动生成的一些文件,我们无须关心,也不要去手动编辑。 2. app: 项目中的代码、资源等内容几乎都是放置在这个目录下的,我们后面的开发工作也基本都是在这个目录下进行的,待会儿还会对这个目录单 ......

目录

1.主目录

Android Studio教程01-的工程和目录结构解析

  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. app1.iml
    iml文件是所有intellij idea项目都会自动生成的一个文件(android studio是基于intellij idea开发的),用于标识这是一个intellij idea项目,我们不需要修改这个文件中的任何内容。
  10. local.properties
    这个文件用于指定本机中的android sdk路径,通常内容都是自动生成的,我们并不需要修改。除非你本机中的android sdk位置发生了变化,那么就将这个文件中的路径改成新的位置即可。
  11. settings.gradle
    这个文件用于指定项目中所有引入的模块。由于helloworld项目中就只有一个app模块,因此该文件中也就只引入了app这一个模块。通常情况下模块的引入都是自动完成的,需要我们手动去修改这个文件的场景可能比较少。

1.1. app目录

Android Studio教程01-的工程和目录结构解析

  1. build
    这个目录和外层的build目录类似,主要也是包含了一些在编译时自动生成的文件,不过它里面的内容会更多更杂,我们不需要过多关系。
  2. libs
    如果你的项目中使用到了第三方jar包,就需要把这些jar包都放在libs目录下,放在这个目录下的jar包都会被自动添加到构建路径里去
  3. androidtest
    此处是用来编写android test测试用例的,可以对项目进行一些自动化测试
  4. java
    毫无疑问,java目录是放置我们所有java代码的地方,展开该目录,你将看到我们刚才创建的mainactivity文件就在里面
  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
    这个文件用于指定项目代码的混淆规则,当代码开发完成后打成安装包文件,如果不希望代码被别人破解,通常会将代码混淆,从而让破解者难以阅读。

1.2.项目资源文件夹res

Android Studio教程01-的工程和目录结构解析

  • drawable开头的文件夹都是用来放图片的,
  • mipmap开头的文件夹都是用来放应用图标的,
  • values开头的文件夹都是用来放字符串、样式、颜色等配置的,
  • layout文件夹是用来放布局文件的。

以下资源需要手动添加:在res上右击新建-android resource directory

  • anim目录:存放定义补间动画的xml文件
  • animator目录:存放定义属性动画的xml文件
  • color目录:存放定义不同状态下颜色列表的xml文件
  • font目录:存放定义字体xml文件
  • menu目录:存放应用程序定义各种菜单资源,包括选项菜单、子菜单、上下文菜单资源
  • raw目录:存放任意类型的原生资源(比如音频文件、视频文件等)

2. 理解build.gradle文件

2.1. 外部build.gradle

根目录下的build.gradle用于添加子工程或模块共用的配置项。

Android Studio教程01-的工程和目录结构解析

  • buildscriipt: buildscript里是gradle脚本执行所需依赖,分别是对应的maven库和插件
  • allproject:allprojects里是项目本身需要的依赖,比如要添加maven中的的common-util库,那么应该将maven {url ‘https://raw.githubusercontent.com/geroff/maventest/master‘}写在这里,而不是buildscript中,不然找不到。
  • repositories: 资料库
  • jcenter:很多android开源项目都会选择将代码托管到jcenter上,声明了这行配置之后,我们就可以在项目中轻松引用任何jcenter上的开源项目了
  • dependencies: 闭包中使用classpath声明了一个gradle插件。为什么要声明这个插件呢?因为gradle并不是专门为构建android项目而开发的,java,c++等很多项目都可以使用gradle来构建。因此如果我们要想使用它来构建android项目,则需要声明com.android.tools.build:gradle:2.2.2这个插件。其中,最后面的部分是插件的版本号。
  • 通常情况下你并不需要修改这个文件中的内容,除非你想添加一些全局的项目构建配置。
  • take clean:
    • 运行gradle clean时,执行此处定义的task。
    • 该任务继承自delete,删除根目录中的build目录。
    • 相当于执行delete.delete(rootproject.builddir)。
    • gradle使用groovy语言,调用method时可以不用加()。

2.2. app文件下的build.gradle

Android Studio教程01-的工程和目录结构解析

  • apply:应用插件,有两个选择
    • com.android.application:这是一个应用程序模块,可以直接运行
    • com.android.library: 这是一个库模块,需要依赖于其他应用程序模块来运行
  • android闭包: 配置项目构造的各种属性
    • compilesdkversion:指定项目的编译版本
    • defaultconfig闭包:项目的更多细节进行配置
      • applicationid: 指定项目的包名
      • minsdkversion: 最低兼容的android系统版本
      • targetsdkversion: 目标版本
      • versioncode: 指定项目的版本号
      • versionname: 指定项目的版本名
      • testinstrumentationrunner: 自动调试
    • buildtype: 用于指定生成安装文件的相关配置
      • debug : 用于指定生成测试版安装文件的配置
      • release: 用于指定生成正式版安装文件的配置
        • minifyenabled: 指定是否对项目的代码进行混淆
        • proguardfiles: 指定混淆时使用的规则文件
  • dependecies: androidstudio项目一共有3种依赖方式:本地依赖、库依赖和远程依赖。
    • implementation filetree: 一个本地依赖声明,它表示将libs目录下所有.jar后缀的文件都添加到项目的构建路径当中

参考资源: