1.1 Android Project 组成部分

Android Project 组成部分

在使用Android Studio 新建一个项目时，需要用到Java Sdk Android Sdk Gradle Sdk，Android Studio 在创建项目成功后，会自动生成很多文件和目录，用来构建我们创建的Android项目，生成apk文件。

在使用Gradle构建我们项目的时候，只需要三个文件行。

• MainActivity.java
• AndroidManifest.xml
• build.gradle

目录结构

demo
└─ src
├─ main
│ ├─ java
│ │ └─ wang.relish.demo
│ │ └─ MainActivity.java
│ └─ AndroidManifest.xml
└─ build.gradle

build.gradle 内容如下:

buildscript {// 一个在项目构建之前, 为项目进行前期准备和初始化相关配置依赖的地方
repositories { //配置需要依赖的gradle插件所在的仓库地址
jcenter()
google()
}
dependencies {// 配置需要依赖的gradle插件
classpath 'com.android.tools.build:gradle:3.1.3' // Android Gradle 插件
}
}
allprojects{
repositories{
jcenter()
google()
}
}
apply plugin: 'com.android.application'
android {
compileSdkVersion 27
}

运行gradle assemble命令即可编译成功，会在根目录demo下生成build目录，里面有debug和release环境的apk。

那么Android Studio 在我们新建项目的时候，默认生成的其它文件是用来干什么的呢，下面一一分析。

Gradle Wrapper

Gradle Wrapper是对Gradle的一层包装, 便于团队开发过程中统一Gradle构建的版本。 我们在项目开发过程中, 用的都是Wrapper这种方式。

在项目根目录下运行gradle wrapper命令，会生成如下目录：

├─ gradle
│ └─ wrapper
│ ├─ gradle-wrapper.jar
│ └─ gradle-wrapper.properties
├─ gradlew
└─ gradlew.bat

• gradlew 和 gradlew.bat 分别为Linux和window平台的可执行脚本文件
• gradle-wrapper.jar 是具体业务逻辑实现的jar包。gradlew最终是使用这个jar包来执行相关的gradle操作。
• gradle-wrapper.properties 是配置文件，用来配置哪个版本的gradler

打开gradle-wrapper.properties文件, 可以看到以下内容:

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.8-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

字段名	说明
distributionBase	下载的Gradle压缩包解压后储存的主目录
distributionPath	相对于distributionBase的解压缩后的Gradle压缩包路径
zipStoreBase	同distributionBase，只不过是存放zip压缩包的
zipStorePath	同distributionPath，只不过是存放zip压缩包的
distributionUrl	Gradle发型版压缩包的下载地址

为什么要使用Wrapper?使用Wrapper有什么好处?

因为使用gradle wrapper的方式不需要提前将gradle下载好，而是会自动根据本地的缓存情况决定是否需要联网下载
gradle。而且假设每个开发者电脑上未安装/配置gradle环境, 那么他/她仍能通过执行gradlew命令执行gradle相关任
务。而且wrapper规定了使用的gradle版本, 在团队开发中, 执行gradlew命令运行的都是同一个版本的gradle。避免
了每个团队成员电脑上配置的gradle版本不同而带来的执行结果的差异。

多项目配置 setting.gradle

setting.gradle 中配置多个子项目：

include ':app', ':module1', ':module2'

其他文件

文件 | 说明
-- | -- | --
*.iml、.idea文件夹 | JetBrain家的IDEA系列IDE的项目配置文件(Android Studio是基于IntelliJ IDEA的), 可以删除,下次用Android Studio打开时会自动生成
gradle.properties | 可以放置gradle相关的全局常量声明和项目运行内存设置等
local.properties | 声明AndroidSDK和NDK所在路径
app/proguard-rules.pro | 代码混淆配置
app/libs | 存放jar/aar包
.gitignore、app/.gitignore |

AS项目模板的app/build.gradle文件内容

apply plugin: 'com.android.application' // 应用Android Gradle插件. (有些网友在介绍gradle的文章中把它描述为"声明是Android程序",纯属扯淡)

android { // Android Gradle插件为Project对象添加的一个拓展
compileSdkVersion 26 // 编译版本
defaultConfig {
applicationId "wang.relish.demo" // 应用包名
minSdkVersion 14 // 此app允许运行的最低的API版本的手机
targetSdkVersion 26 // 允许使用新特性的最高版本。也就是说API27及以上的手机也能安装这个app, 但仅仅有API26及以下的新特性
versionCode 1 // app版本编号
versionName "1.0" // app版本号。其实就是个字符串叫啥都可以。业内统一使用xxx.xxx.xxx的形式。
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" // 单元测试: AndroidJUnit
}
buildTypes {
release {
// 是否进行混淆
minifyEnabled false
// 混淆文件的位置
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}

dependencies { // 声明依赖
implementation fileTree(dir: 'libs', include: ['*.jar']) // 位于app/libs/下的jar包依赖
implementation 'com.android.support:appcompat-v7:26.1.0'
implementation 'com.android.support.constraint:constraint-layout:1.1.2'
testImplementation 'junit:junit:4.12' // 单元测试：junit
androidTestImplementation 'com.android.support.test:runner:1.0.2'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2' // AndroidUI自动化测试框架
}

 

参考文章：从手写最简单的Android程序到Android Studio项目模板的全面解析