《第一行代码》阅读笔记（三）—— 一个Android程序的体系结构

一个简单的项目结构

——第一行代码

  1. .gradle和.idea
    这两个目录下放置的都是Android Studio自动生成的一些文件，我们无须关心，也不要去手动编辑。
    Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化构建工具。顾名思义，.gradle就是使用这个工具自动生成的东西了。因为Android Studio是谷歌基于IDEA开发的编辑器，所以.idea就是IDEA自动生成的一些东西。
  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
    看名字也很好理解，就是不git的东西，一般像build里面的内容都是不需要保存的。了解git的朋友应该很快就能理解。不理解的可以先去学习下如果使用Git。
    Git使用教程 
    Git安装及使用教程
  6. build.gradle——非常重要
    这是项目全局的gradle构建脚本，通常这个文件中的内容是不需要修改的。稍后我们将会详细分析gradle构建脚本中的具体内容。
    相当于整个程序的脉络。需要注意的就是一般项目会有多个build.gradle，注意区分。

7-11都是几乎很少用到的
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
这个文件用于指定本机中的AndroidSDK路径,通常内容都是自动生成的,我们并不需要修改。除非你本机中的AndroidSDK位置发生了变化，那么就将这个文件中的路径改成新的位置即可。
11. settings.gradle
这个文件用于指定项目中所有引入的模块。由于HelloWorld项目中就只有一个app模块，因此该文件中也就只引入了app这一个模块。通常情况下模块的引入都是自动完成的，需要我们手动去修改这个文件的场景可能比较少。

App

——第一行代码

  1. build
    这个目录和外层的build目录类似，主要也是包含了一些在编译时自动生成的文件，不过它里面的内容会更多更杂，我们不需要过多关心。
    这个文件一般会非常大，如果想要传递项目，可以清空build再发送给需要的人。清空build在build->clean build。在这个菜单栏下还可以rebuild，generate APK等等。
  2. libs
    如果你的项目中使用到了第三方jar包，就需要把这些jar包都放在libs目录下，放在这个目录下的jar包都会被自动添加到构建路径里去。
    不只有jar包，还有安卓的aar包。
  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 构建脚本，这个文件中会指定很多项目构建相关的配置，我们稍后将会详细分析gradle构建脚本中的具体内容。
  11. proguard-rules.pro
    这个文件用于指定项目代码的混淆规则，当代码开发完成后打成安装包文件，如果不希望代码被别人破解，通常会将代码进行混淆，从而让破解者难以阅读。

Res

  1. drawable

放置图片资源的部分。应该和mipmap一样分hdpi等后缀，这些后缀主要是用来设置图片的大小的，但是在使用的时候不需要添加后缀。这里面还有一些比较复杂的机制，建议和UI小姐姐讨论好，然后直接放xxhdpi里面就完了。

drawable里面除了图片资源之外，还可以是statelistdrawable资源文件。如下

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:color="#f60" android:state_focused="true" />
    <item android:color="#0a0" android:state_focused="false" />
</selector>

之后可以在backpage属性中直接使用@drawable/文件名来使用
2. layout
放置布局文件的部分，以后经常用到。
3. mipmap
放置图标的部分。
4. values

这里面有三个文件分别是string，color和style。作用都顾名思义，不多做解释。主要介绍他的用法，一般有两种用法，第一种是在XML中，第二种是在Java中。
android:text="@string/app_name"
android:textColor="@color/colorPrimary"
getResources().getColor(R.color.colorPrimary);
getResources().getString(R.string.app_name);

style有些许不同。如果想要使用，首先需要编辑你需要的style，如下是默认的主题style

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <!-- Customize your theme here. -->
        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
        <item name="colorAccent">@color/colorAccent</item>
    </style>

在引用的时候使用style="@style/AppTheme"即可。如果有属性冲突，会采用就近原则，也就是说style中的属性会被覆盖。

同时这个AppTheme是默认的主题。主题样式的使用方法也有两个，但是有一些不同，就是需要在Androidmanifest中的application的theme属性中设置，其中的属性的含义如下。


同时也可以在java代码中使用setTheme()，但是有一点需要注意的就是setTheme()必须要在 setContentView()之前调用。

新版本的Android Studio不会自动生成dimens文件了，这个文件主要是放置尺寸文件的。尺寸数值多为一下两种。

dp：设备独立像素，可以根据手机的大小缩放
sp：可伸缩像素（建议设置字体），可以根据手机的字体大小缩放

<resources>
    <dimen name="activity_horizontal_margin">128dp</dimen>
    <dimen name="activity_vertical_margin">128dp</dimen>
</resources>

创建以下文件，之后使用方法同string和color类似，getResources().getDimension();。

  1. 其他

除了这些自动生成的资源意外，还可以自己建立很多资源。其中比较常用的有menu，这些在后期编程都会十分常用。

build.gradle

项目分为两个build.gradle，一个在最外层，一个在App文件中，后期项目变大后，还会有更多的module和build.gradle。

最外层的build.gradle

最新版的内容

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:4.0.0"
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

——第一行代码
首先，两处repositories的闭包中都声明了jcenter()这行配置，那么这个jcenter是什么意思呢？其实它是一个代码托管仓库，很多Android 开源项目都会选择将代码托管到jcenter上，声明了这行配置之后，我们就可以在项目中轻松引用任何jcenter.上的开源项目了。
接下来，dependencies闭包中使用classpath声明了一个Gradle插件。为什么要声明这个插件呢？因为Gradle并不是专门为构建Android项目而开发的，Java、 C++等很多种项目都可以使用Gradle来构建。因此如果我们要想使用它来构建Android项目，则需要声明com.android.tools.build:gradle:2.2.0这个插件。其中，最后面的部分是插件的版本号,我在写作本书时最新的插件版本是2.2.0。

新版本中添加了google()还有后面生成了一个clean，笔者也不知道什么意思。但是开发也有些许时日了，暂时没有对这里进行过修改。

app的build.gradle

apply plugin: 'com.android.application'

android {
    compileSdkVersion 29
    buildToolsVersion "29.0.3"

    defaultConfig {
        applicationId "com.firstcode.testdemo"
        minSdkVersion 24
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar"])
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test.ext:junit:1.1.1'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
}

因为《第一行代码》第二版，已经年代久远了。所以这里发生了比较大的改变，但是本质是不变的。

——第一行代码
首先第一行应用了一个插件，一般有两种值可选: com.android.application表示这是一个应用程序模块，com.android.library表示这是一个库模块。应用程序模块和库模块的最大区别在于一个是
可以直接运行的，一个只能作为代码库依附于别的应用程序模块来运行。

很好理解com.android.library就是抽取出来的module的值，早期开发都用不太到，后期大项目为了解耦，才会分模块开发。

Android闭包里面就是一些基础配置，包括现在的安卓版本，本应用的安卓版本等一系列信息。
defaultConfig闭包就是更加详细的配置。
compileSdkVersion：项目的编译版本。其中比较常用的就是24，代表Android 7.0系统的SDK。15代表Android 4.0，Android 4.0已经可以覆盖100%的手机了。
buildToolsVersion：用于指定项目构建工具的版本
applicationId：用于指定项目的包名
minSdkVersion：用于指定项目最低兼容的Android系统版本
targetSdkVersion：适用的Android系统版本
versionCode 用于指定项目的版本号，versionName用于指定项目的版本名，这两个属性在生成安装文件的时候非常重要

buildTypes就是代码混淆。
buildTypes闭包中用于指定生成安装文件的相关配置，通常只会有两个子闭包，一个是debug，一个是release。debug闭包用于指定生成测试版安装文件的配置，release闭包用于指定生成正式版安装文件的配置。
minifyEnabled用于指定是否对项目的代码进行混淆，true 表示混淆，false表示不混淆。proguardFiles用于指定混淆时使用的规则文件，这里指定了两个文件，第一个proguard-android.txt是在Android SDK目录下的，里面是所有项目通用的混淆规则，第二个proguard-rules.pro是在当前项目的根目录下的，里面可以编写当前项目特有的混淆规则。

dependencies闭包已经发生很大变化，但是原理还是一样的。
这个闭包的功能非常强大，它可以指定当前项目所有的依赖关系。通常Android Studio项目一共有3种依赖方式：本地依赖、库依赖和远程依赖。本地依赖可以对本地的Jar包或目录添加依赖关系，库依赖可以对项目中的库模块添加依赖关系，远程依赖则可以对jcenter库上的开源项目添加依赖关系。
首先这个fileTree还是原来的味道，一个本地依赖声明，它表示将libs目录下所有.jar后缀的文件都添加到项目的构建路径当中。
第二个v7包已经被替换成Androidx了，但是原理仍然不变，一个标准的远程依赖库格式，需要域名，用于和其他公司的库做区分; 组名称，用于和同一个公司中不同的库做区分; 版本号，用于和同一个库不同的版本做区分。这个和maven一样，通过三个参数锁定一个包。
至于库依赖声明，它的基本格式是implementation project 后面加上要依赖的库名称，比如说有一个库模块的名字叫helper，那么添加这个库的依赖关系只需要加入implementation project(' : helper' )这句声明即可。
后面同样都是测试，不需要理会。

至此整个资源文件就已经讲完了。如果不明白并不要紧，因为笔者一开始也不知道其中的奥秘。是开发了一段时间回来整理，才有了自己的理解。所以需要大家温故而知新！

【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/zllk/p/13363628.html