跳到主要内容

Android项目结构

介绍​

在开始开发Android应用之前，了解Android项目的基本结构是非常重要的。一个良好的项目结构不仅有助于提高代码的可读性和可维护性，还能让团队协作更加顺畅。本文将详细介绍Android项目的标准结构，并解释每个文件夹和文件的用途。

Android项目的基本结构​

一个典型的Android项目通常包含以下几个主要部分：

  1. app 模块
  2. Gradle 构建脚本
  3. res 资源文件夹
  4. AndroidManifest.xml 文件
  5. java 或 kotlin 源代码文件夹

1. app 模块​

app 模块是Android项目的核心部分，包含了应用的所有代码和资源。它通常包括以下子文件夹：

  • src/main/java 或 src/main/kotlin: 存放应用的Java或Kotlin源代码。
  • src/main/res: 存放应用的所有资源文件，如布局文件、图片、字符串等。
  • src/main/AndroidManifest.xml: 定义应用的基本信息和组件。

2. Gradle 构建脚本​

Gradle是Android项目的构建工具，负责编译代码、打包应用和管理依赖。项目中有两个主要的Gradle文件：

  • build.gradle (Project Level): 配置整个项目的构建设置。
  • build.gradle (Module Level): 配置特定模块（如app模块）的构建设置。
groovy
// 项目级别的 build.gradle 文件
buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:7.0.2"
    }
}

// 模块级别的 build.gradle 文件
plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 21
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.3.1'
    implementation 'com.google.android.material:material:1.4.0'
}

3. res 资源文件夹​

res 文件夹包含了应用的所有资源文件，如布局文件、图片、字符串等。常见的子文件夹包括：

  • res/layout: 存放布局文件（XML格式），定义UI界面。
  • res/drawable: 存放图片资源。
  • res/values: 存放字符串、颜色、尺寸等资源。
xml
<!-- res/layout/activity_main.xml -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello, World!" />
</LinearLayout>

4. AndroidManifest.xml 文件​

AndroidManifest.xml 文件是Android应用的配置文件，定义了应用的基本信息、组件（如Activity、Service等）和权限。

xml
<!-- 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/Theme.MyApp">
        <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>

5. java 或 kotlin 源代码文件夹​

src/main/java 或 src/main/kotlin 文件夹存放应用的源代码。通常，每个Activity、Fragment或其他组件都会有一个对应的类文件。

kotlin
// MainActivity.kt
package com.example.myapp

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }
}

实际案例​

假设我们要开发一个简单的待办事项应用，项目结构可能如下：

MyTodoApp/
├── app/
│   ├── build.gradle
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   └── com/example/mytodoapp/
│   │   │   │       ├── MainActivity.kt
│   │   │   │       └── TodoAdapter.kt
│   │   │   ├── res/
│   │   │   │   ├── layout/
│   │   │   │   │   ├── activity_main.xml
│   │   │   │   │   └── item_todo.xml
│   │   │   │   ├── values/
│   │   │   │   │   ├── strings.xml
│   │   │   │   │   └── colors.xml
│   │   │   └── AndroidManifest.xml
│   │   └── test/
│   │       └── java/
│   │           └── com/example/mytodoapp/
│   │               └── ExampleUnitTest.kt
├── build.gradle
└── settings.gradle

总结​

了解Android项目的基本结构是开发Android应用的第一步。通过合理地组织代码和资源，你可以更高效地开发和维护应用。本文介绍了Android项目的标准结构，并通过一个简单的待办事项应用展示了实际应用场景。

附加资源​

练习​

  1. 创建一个新的Android项目，并按照本文介绍的结构组织代码和资源。
  2. 尝试在res/layout文件夹中添加一个新的布局文件，并在MainActivity中使用它。
  3. 修改AndroidManifest.xml文件，添加一个新的Activity，并在应用中启动它。
提示

在开发过程中，保持项目结构的清晰和一致是非常重要的。这将有助于你在项目规模扩大时更容易地进行维护和扩展。