Android开发-工程结构

在进行Android应用开发时，了解并掌握项目的工程结构是非常重要的一步。一个典型的Android项目由多个模块组成，每个模块又包含不同的目录和文件，它们各自承担着特定的功能。本文将带你深入了解Android Studio生成的默认项目结构，并解释每个重要部分的作用，帮助你更好地组织与管理代码。

一、Android项目的整体结构概述

使用 Android Studio 创建一个新的项目后，你会看到如下图所示的项目视图（选择“Project”视图模式）：

MyApplication/
├── build.gradle (Project)
├── settings.gradle
├── gradle.properties
├── app/                         --> 主要的应用模块
│   ├── build.gradle             --> 模块级构建配置
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/            --> Kotlin 或 Java 源码
│   │   │   ├── res/             --> 资源文件（布局、图片、字符串等）
│   │   │   └── AndroidManifest.xml --> 应用清单文件
│   │   ├── test/                --> 单元测试代码
│   │   └── androidTest/         --> 仪器化测试代码
│   └── ...
├── gradle/                      --> Gradle wrapper 配置
├── .gitignore
└── README.md

二、核心目录详解

1. build.gradle（Project级别）

这个文件定义了整个项目的全局构建配置，通常包括：

• 使用的 Gradle 插件版本（如 com.android.tools.build:gradle:x.x.x）
• 构建脚本中使用的仓库和依赖项

示例内容：

// build.gradle (Project)
buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.2.1'
    }
}

2. build.gradle（Module级别）

位于 app/build.gradle 中，用于配置当前模块的编译选项，例如：

• 应用ID（applicationId）
• 编译SDK版本（compileSdkVersion）
• 构建类型（buildTypes）
• 模块依赖关系（dependencies）

示例内容：

// build.gradle (Module: app)
android {
    namespace 'com.example.myapplication'
    compileSdk 34

    defaultConfig {
        applicationId "com.example.myapplication"
        minSdk 24
        targetSdk 34
        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.10.1'
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.9.0'
}

3. src/main/java —— Java/Kotlin源码目录

包含了所有Java或Kotlin编写的Activity、Service、工具类等代码。比如：

java/
└── com.example.myapplication/
    ├── MainActivity.kt
    └── utils/
        └── DataUtils.kt

4. src/main/res —— 资源目录(Resources)

这是存放应用程序资源的地方，非常重要。常见的子目录包括：

注意：资源文件名只能是小写字母、数字和下划线。

5. AndroidManifest.xml —— 应用清单文件

这是Android项目的“身份证”，它定义了：

• 应用包名（package name）
• 应用组件（Activity、Service、BroadcastReceiver等）
• 权限声明（如网络权限、读写权限）

示例片段：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapplication">

    <uses-permission android:name="android.permission.INTERNET" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        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>
    </application>

</manifest>

6. gradle.properties —— Gradle配置属性

用于配置Gradle的运行参数，如是否启用Jetifier、JVM参数等。

7. settings.gradle —— 多模块配置

如果你的项目包含多个模块（如库模块、功能模块），可以在这里通过 include 添加这些模块。

示例：

include ':app', ':library', ':feature-login'

三、其他常见目录和文件

四、模块化开发简介（多模块结构）

随着项目规模的增长，建议采用模块化架构设计，将功能拆分成多个独立模块。例如：

MyApp/
├── app/                   --> 主模块（主App）
├── library/               --> 公共库模块
├── feature-login/         --> 登录功能模块
├── feature-profile/       --> 用户中心模块

这种结构有助于提高代码复用性、便于多人协作开发以及提升构建效率。

五、结语

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