Android开发基础06-Android项目结构
详细介绍Android项目结构
Android开发过程中，高效、清晰的项目结构是成功的关键。理解并合理组织项目结构，有助于提高代码的可维护性和团队协作的效率。
目录概览
一个典型的Android项目目录结构如下：
MyApplication/
├── app/
│ ├── build/
│ ├── libs/
│ ├── src/
│ │ ├── androidTest/
│ │ │ └── java/
│ │ ├── main/
│ │ │ ├── java/
│ │ │ ├── kotlin/
│ │ │ ├── res/
│ │ │ ├── AndroidManifest.xml
│ │ └── test/
│ │ └── java/
│ ├── build.gradle
├── build/
├── gradle/
├── .gradle/
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── local.properties
1. 顶级目录
顶级目录包含整个项目的全局配置和设置。
1.1 build.gradle
这是顶级Gradle构建脚本，用于配置全局项目设置和依赖项。一个典型的顶级 build.gradle 文件可能如下所示：
buildscript {
ext.kotlin_version = '1.5.21'
repositories {
google()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:7.0.0'
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
1.2 settings.gradle
用于包括多模块项目的设置文件。通常包含项目名称和模块信息：
include ':app'
1.3 gradle.properties
用于设置Gradle构建系统的一些属性，例如内存设置、缓存选项等：
org.gradle.jvmargs=-Xmx1536m
1.4 gradlew 和 gradlew.bat
它们是Gradle Wrapper脚本，允许在没有预先安装Gradle的环境中运行Gradle任务。gradlew 是适用于Unix/Linux系统的脚本，而 gradlew.bat 适用于Windows系统。
1.5 local.properties
这个文件通常包含本地机器的特定配置，例如Android SDK的路径：
sdk.dir=/Users/your_user/Library/Android/sdk
2. app 模块
app 是应用程序的主模块，也是最常见的模块。它包含应用程序的源代码、资源文件、构建脚本等。
2.1 build.gradle
该文件是模块级的构建脚本，定义了模块的构建配置和依赖关系：
plugins {
id 'com.android.application'
}
android {
compileSdkVersion 30
defaultConfig {
applicationId "com.example.myapp"
minSdkVersion 16
targetSdkVersion 30
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
implementation 'com.android.support:appcompat-v7:28.0.0'
implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
testImplementation 'junit:junit:4.12'
}
3. src 目录
src 目录包含应用程序的所有源代码、资源文件和配置文件。
3.1 main 目录
这是应用程序的主目录，也是最重要的目录，包含以下子目录：
3.1.1 java 目录
包含所有的Java源代码文件。通常，它的目录结构与包名一致：
src/main/java/com/example/myapp/
├── MainActivity.java
└── AnotherActivity.java
3.1.2 kotlin 目录
如果项目使用Kotlin编写，这里将包含所有的Kotlin源代码文件：
src/main/kotlin/com/example/myapp/
├── MainActivity.kt
└── AnotherActivity.kt
3.1.3 res 目录
包含所有应用程序的资源文件，如布局文件、图片、字符串资源等。res 目录中通常包含以下子目录：
drawable/：包含位图文件，如PNG、JPEG等。layout/：存放应用程序的布局文件（XML）。mipmap/：存放启动图标（.ico），不同尺寸分别存在mipmap-hdpi,mipmap-mdpi,mipmap-xhdpi等目录。values/：存放资源值文件，如strings.xml,colors.xml,styles.xml等。
3.2 AndroidManifest.xml
这是一个非常重要的配置文件，定义了应用程序的基本信息、组件、权限等：
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.myapp">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!-- 其他组件，如Service、BroadcastReceiver等 -->
</application>
</manifest>
4. 测试目录
包括 androidTest 和 test 目录，分别用于编写仪器化测试和单元测试代码。
4.1 androidTest 目录
包含仪器化测试的源代码，通过 AndroidJUnitRunner 运行：
src/androidTest/java/com/example/myapp/
└── ExampleInstrumentedTest.java
4.2 test 目录
包含单元测试的源代码，使用 JUnit 或其他测试框架进行测试：
src/test/java/com/example/myapp/
└── ExampleUnitTest.java
5. build 目录
此目录用于存储Gradle构建生成的文件，如编译后的代码、打包的APK等。通常不需要手动修改或查看。
6. libs 目录
存放项目依赖的外部库（.jar 或 .aar 文件）。可以通过在 build.gradle 文件中引用该目录的库：
dependencies {
implementation files('libs/some-library.jar')
}
总结
在实际项目中，根据具体需求可能会有所调整，但总体结构大致相同。掌握这些知识，有助于我们更好地组织和管理Android项目，提高开发效率和代码质量。
