Из каких частей состоит Android проект

Состав типичного Android проекта (модуля)

Современный Android проект, особенно использующий Gradle как систему сборки, имеет четкую модульную структуру. Вот его ключевые компоненты:

1. Файлы конфигурации верхнего уровня (на уровне проекта)

• settings.gradle.kts (или settings.gradle) – определяет, какие модули входят в проект.
• build.gradle.kts (уровня проекта) – содержит общие настройки сборки для всех модулей (репозитории, зависимости плагинов сборки).
• gradle.properties – настраивает свойства Gradle (размер heap для JVM, флаги).
• local.properties – не коммитится в VCS, содержит локальные настройки (путь к Android SDK).
• Папка gradle/wrapper/ – содержит Gradle Wrapper, позволяющий собирать проект с единой версией Gradle.

2. Структура модуля приложения (app/)

Это основной модуль. Его структура наиболее важна.

app/build.gradle.kts – "сердце" конфигурации модуля.

Здесь задаются: версия SDK, зависимости библиотек, версия приложения, настройки buildTypes (debug, release) и productFlavors.

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
}

android {
    namespace = "com.example.myapp"
    compileSdk = 34

    defaultConfig {
        applicationId = "com.example.myapp"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
    }

    buildTypes {
        release {
            isMinifyEnabled = true
            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
        }
    }
}

dependencies {
    implementation("androidx.core:core-ktx:1.12.0")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.11.0")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
}

app/src/ – исходный код и ресурсы.

• main/ – основной исходный код.

    *   **`java/`** или **`kotlin/`** (`com/example/myapp/`) – пакеты с **Activity**, **Fragment**, **ViewModel**, репозиториями и другими классами.
    *   **`res/`** – ресурсы.
        *   `layout/` – XML-файлы макетов (`activity_main.xml`).
        *   `values/` – строки (`strings.xml`), цвета (`colors.xml`), стили (`themes.xml`), размеры.
        *   `drawable/`/`mipmap/` – изображения и иконки.
        *   `menu/` – XML для меню.
    *   **`AndroidManifest.xml`** – декларативная конфигурация приложения: его компоненты (**Activity**, **Service**, **BroadcastReceiver**, **ContentProvider**), разрешения, `applicationId`, главная Activity.

app/src/ с вариантами сборки (source sets)

• debug/, release/ – для разных buildTypes. Можно переопределить ресурсы или код (например, использовать другой URL API для отладки).
• flavorName/ (например, free/, paid/) – для разных productFlavors.

3. Другие типы модулей

Проект может быть мультимодульным, что улучшает инкапсуляцию и скорость сборки.

• :library – модули Android-библиотек (AAR).
• :feature – feature-модули (динамические com.android.dynamic-feature или просто библиотеки).
• :core, :data, :domain – модули по архитектурным слоям (чистый Kotlin/Java, com.android.library).

4. Вспомогательные файлы и папки

• .gitignore – исключения для системы контроля версий.
• proguard-rules.pro – правила обфускации и минификации для сборки release.
• Папки сгенерированных файлов (build/, .idea/) – создаются IDE и Gradle, не коммитятся.
• app/src/androidTest/ и app/src/test/ – код для инструментальных и юнит-тестов соответственно.

Эволюция структуры

Раньше структура определялась IDE (Eclipse + ADT). С переходом на Android Studio и Gradle структура стала стандартизированной и гибкой. Внедрение AndroidX и Jetpack библиотек, а также Kotlin как предпочтительного языка, сделало проекты более модульными и удобными для поддержки.

Итог: Современный Android проект — это, прежде всего, конфигурация Gradle (build.gradle файлы), организующая исходный код (src/) по модулям и вариантам сборки, плюс манифест и ресурсы. Понимание этой структуры критически важно для настройки сборки, организации кода и работы в команде.