一、项目视图模式

在开始之前，确保你的 Project 面板使用的是 【Android】 视图（默认）。这是最常用的视图，它将相关文件按功能逻辑分组展示。

💡 你也可以切换到 【Project】 视图查看完整的文件系统结构。

二、顶级项目结构

一个标准的 Android 项目包含以下顶级目录和文件：

✅ 核心：我们开发的重心几乎都在 app/ 模块中。

三、应用模块结构 (app/)

进入 app/ 目录，这是整个 Android 应用的核心。其结构如下：

1. src/ 目录（源码与资源）

这是存放所有源代码和资源文件的地方。主要包含 main、androidTest、test 等子目录。

✅ src/main/ - 主要源码与资源

这是应用的主体部分。

✅ res/ 目录详解

res/ 目录下的每个子目录都有特定用途，命名规则严格。

💡 最佳实践：将资源分类存放，使用清晰的命名（如 btn_submit_background.xml, ic_settings.xml），并在 strings.xml 中管理所有文本。

✅ src/androidTest/ - Android 测试

• 包含在真实设备或模拟器上运行的 Instrumented Tests（仪器化测试）。
• 使用 Android SDK 中的测试框架（如 JUnit, Espresso）。
• 代码通常放在 java/ 目录下，与主代码包名一致。

✅ src/test/ - 本地单元测试

• 包含在本地 JVM 上运行的 Unit Tests（单元测试）。
• 用于测试纯 Kotlin/Java 逻辑，不依赖 Android SDK。
• 使用 JUnit 框架。

2. build/ 目录

• 存放 Gradle 构建过程中生成的所有文件，如编译后的 class 文件、打包的 APK、资源索引等。
• 这是自动生成的目录，不应手动修改。清理项目（Clean Project）会删除此目录。

3. libs/ 目录

• 用于存放 第三方 JAR 或 AAR 库文件。
• 如果将库文件放在这里，需要在 build.gradle 中通过 implementation files('libs/xxx.jar') 引用。
• 现代开发更推荐使用远程依赖（如 Maven Central），通过 implementation 'groupId:artifactId:version' 添加。

4. build.gradle (Module: app)

• 模块级别的构建脚本，定义了 app 模块特有的配置。
• 关键配置包括：

  android {compileSdk 34 // 编译时使用的 Android SDK 版本defaultConfig {applicationId "com.example.myapp" // 应用的唯一 IDminSdk 24     // 最低支持的 Android 版本targetSdk 34  // 目标 Android 版本versionCode 1 // 内部版本号（整数）versionName "1.0" // 用户可见的版本名}buildTypes {release {minifyEnabled false // 是否启用代码混淆proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'}}
  }dependencies {implementation 'androidx.core:core-ktx:1.13.1'implementation 'androidx.appcompat:appcompat:1.7.0'implementation 'com.google.android.material:material:1.12.0'// ... 其他依赖
  }

• dependencies 块是添加项目依赖（库）的地方。

5. proguard-rules.pro

• 如果启用了代码混淆（minifyEnabled true），此文件用于编写 ProGuard 混淆规则，防止关键代码被错误混淆。

四、总结：一张图看懂工程结构

MyApplication/                  <-- 项目根目录
├── app/                        <-- 应用模块
│   ├── build/                  <-- 构建输出（自动生成）
│   ├── libs/                   <-- 第三方库（JAR/AAR）
│   ├── src/
│   │   ├── main/
│   │   │   ├── AndroidManifest.xml  <-- 应用清单
│   │   │   ├── java/           <-- Kotlin/Java 源码
│   │   │   │   └── com/example/myapp/
│   │   │   │       ├── MainActivity.kt
│   │   │   │       └── ...
│   │   │   ├── res/            <-- 资源文件
│   │   │   │   ├── drawable/   <-- 图片/Drawable
│   │   │   │   ├── layout/     <-- 布局文件
│   │   │   │   ├── mipmap/     <-- 应用图标
│   │   │   │   ├── values/     <-- 字符串/颜色/尺寸
│   │   │   │   └── ...
│   │   │   └── assets/         <-- 原始资源
│   │   ├── androidTest/        <-- Android 测试
│   │   └── test/               <-- 本地单元测试
│   └── build.gradle            <-- 模块构建脚本
├── gradle/                     <-- Gradle Wrapper
├── .gradle/                    <-- Gradle 缓存
├── build.gradle                <-- 项目构建脚本
├── settings.gradle             <-- 项目设置
└── gradle.properties           <-- Gradle 属性

五、结语

感谢您的阅读！如果你有任何疑问或想要分享的经验，请在评论区留言交流！