Что прописано в файле сборки Gradle уровня модуля

Что находится в файле build.gradle (уровня модуля)?

Файл build.gradle уровня модуля (также известный как app/build.gradle или module/build.gradle) содержит конфигурацию сборки для конкретного модуля в проекте Android. Этот файл написан на языке Gradle DSL (Domain-Specific Language) и управляет настройками, зависимостями и задачами сборки для отдельного модуля приложения или библиотеки.

Основные разделы файла

1. Plugins (Плагины)

В верхней части файла указываются плагины, которые расширяют функциональность Gradle для Android-разработки:

plugins {
    id 'com.android.application' // Для приложения
    // ИЛИ id 'com.android.library' для библиотеки
    id 'org.jetbrains.kotlin.android' // Для поддержки Kotlin
}

• com.android.application — для сборки APK/AAB.
• com.android.library — для создания Android-библиотеки (AAR).
• Kotlin/Java плагины — для поддержки языков программирования.

2. android { } — Блок конфигурации Android

Самый важный раздел, содержащий специфичные для Android настройки:

android {
    namespace 'com.example.myapp'
    compileSdk 34 // Версия SDK для компиляции
    
    defaultConfig {
        applicationId "com.example.myapp" // Уникальный идентификатор приложения
        minSdk 24 // Минимальная версия Android
        targetSdk 34 // Целевая версия Android
        versionCode 1 // Числовая версия для магазинов
        versionName "1.0" // Человекочитаемая версия
        
        // Дополнительные настройки
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    
    buildTypes {
        release {
            minifyEnabled true // Включение обфускации
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
        debug {
            applicationIdSuffix ".debug" // Суффикс для отладочной версии
        }
    }
    
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_11
        targetCompatibility JavaVersion.VERSION_11
    }
    
    kotlinOptions {
        jvmTarget = '11'
    }
    
    buildFeatures {
        viewBinding true // Включение ViewBinding
        compose true // Включение Jetpack Compose
    }
}

3. dependencies { } — Блок зависимостей

Определяет все внешние библиотеки и модули, от которых зависит данный модуль:

dependencies {
    // Локальные зависимости
    implementation project(':mylibrary')
    
    // Стандартные зависимости Android
    implementation 'androidx.core:core-ktx:1.12.0'
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.11.0'
    
    // Архитектурные компоненты
    implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.7.0'
    implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.7.0'
    
    // Тестовые зависимости
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
    
    // Типы конфигураций зависимостей:
    // implementation — для основного кода
    // api — экспортирует зависимость для зависимых модулей
    // compileOnly — только для компиляции
    // runtimeOnly — только для выполнения
    // testImplementation — для unit-тестов
    // androidTestImplementation — для инструментальных тестов
    // debugImplementation — только для debug-сборки
}

4. Дополнительные конфигурации

В файле также могут присутствовать:

• Настройки продуктивных вариантов (productFlavors) — для создания разных версий приложения:

productFlavors {
    free {
        applicationIdSuffix ".free"
        versionNameSuffix "-free"
    }
    paid {
        applicationIdSuffix ".paid"
        versionNameSuffix "-paid"
    }
}

• Конфигурации сборки с использованием Kotlin DSL (в файле build.gradle.kts):

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

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

Ключевые особенности файла уровня модуля:

1. Иерархическая структура — Наследует настройки из корневого build.gradle, но может их переопределять.
2. Модульность — Каждый модуль имеет собственный файл конфигурации.
3. Инкрементальная сборка — Изменения затрагивают только конкретный модуль.
4. Управление зависимостями — Тонкая настройка зависимостей для каждого модуля.

Файл сборки уровня модуля является основным инструментом конфигурации для разработчика Android, позволяя точно управлять поведением сборки, версиями SDK, зависимостями и флавирами приложения для разных сценариев разработки и публикации.