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自动化测试框架
}