一、項目視圖模式

在開始之前，確保你的 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 屬性

五、結語

感謝您的閱讀！如果你有任何疑問或想要分享的經驗，請在評論區留言交流！