Правильная организация build.gradle.kts: как настроить проект с нуля

Если вы занимаетесь разработкой Android-приложений, то наверняка сталкивались с файлом build.gradle.kts. Этот файл является ключевым для настройки вашего проекта, включая сборку, зависимости и многое другое. В этой статье мы разберем пример файла build.gradle.kts, чтобы вы могли понять, как правильно его организовать и какие директивы использовать.

Плагины — это расширения, которые добавляют дополнительные возможности в ваш проект. В данном случае мы используем два плагина:

• android.application: Этот плагин необходим для сборки Android-приложений. Он добавляет поддержку Android-специфичных задач, таких как компиляция ресурсов, создание APK и многое другое.
• kotlin.android: Этот плагин добавляет поддержку языка Kotlin в Android-проект. Он позволяет использовать Kotlin для написания кода приложения, а также добавляет необходимые зависимости.

2. Настройки Android

android блок содержит настройки, специфичные для Android-приложения. Давайте разберем каждую директиву:

• namespace: Указывает пространство имен вашего приложения. Это значение используется для уникальной идентификации вашего приложения в системе Android.
• compileSdk: Указывает версию Android SDK, которая будет использоваться для компиляции вашего приложения. В данном случае это версия 35.
• defaultConfig: Содержит основные настройки приложения:
  applicationId: Уникальный идентификатор вашего приложения. Он используется для установки и обновления приложения на устройствах пользователей.
  minSdk: Минимальная версия Android, на которой может работать ваше приложение. В данном случае это версия 21 (Android 5.0 Lollipop).
  targetSdk: Целевая версия Android, для которой разрабатывается ваше приложение. В данном случае это версия 34.
  versionCode: Целочисленный идентификатор версии приложения. Он используется для определения того, какая версия приложения является более новой.
  versionName: Строковый идентификатор версии приложения, который отображается пользователям.
  testInstrumentationRunner: Указывает класс, который будет использоваться для запуска инструментальных тестов. В данном случае это AndroidJUnitRunner, который предоставляется библиотекой AndroidX.
• buildFeatures: Включает или отключает определенные функции сборки. В данном случае мы включаем поддержку Jetpack Compose, современного инструментария для создания пользовательских интерфейсов в Android.
• composeOptions: Содержит настройки, специфичные для Jetpack Compose. В данном случае мы указываем версию расширения компилятора Kotlin для Jetpack Compose.
• buildTypes: Определяет различные типы сборок, такие как отладочная и релизная сборка. В данном случае мы настраиваем релизную сборку:
  isMinifyEnabled: Включает или отключает минификацию кода. В данном случае минификация отключена.
  proguardFiles: Указывает файлы конфигурации ProGuard, которые будут использоваться для минификации и обфускации кода.
• compileOptions: Указывает параметры компиляции для Java-кода:
  sourceCompatibility: Указывает версию Java, которая будет использоваться для компиляции исходного кода. В данном случае это Java 8.
  targetCompatibility: Указывает версию Java, для которой будет скомпилирован код. В данном случае это также Java 8.
• kotlinOptions: Указывает параметры компиляции для Kotlin-кода:
  jvmTarget: Указывает версию JVM, для которой будет скомпилирован Kotlin-код. В данном случае это Java 8.

3. Зависимости

dependencies блок содержит список зависимостей, которые необходимы для вашего проекта. Давайте разберем каждую зависимость:

• implementation(platform("androidx.compose:compose-bom:2024.01.00")): Импортирует Bill of Materials (BOM) для Jetpack Compose. BOM — это файл, который определяет совместимые версии библиотек Jetpack Compose. Использование BOM позволяет избежать конфликтов версий библиотек.
• implementation("androidx.compose.ui:ui"): Добавляет основную библиотеку Jetpack Compose для создания пользовательских интерфейсов.
• implementation("androidx.compose.material3:material3"): Добавляет библиотеку Material Design 3 для Jetpack Compose, которая предоставляет компоненты пользовательского интерфейса, соответствующие последним рекомендациям Material Design.
• implementation("androidx.compose.ui:ui-tooling-preview"): Добавляет библиотеку для предварительного просмотра пользовательских интерфейсов Jetpack Compose в Android Studio.
• implementation("androidx.activity:activity-compose:1.7.2"): Добавляет библиотеку для интеграции Jetpack Compose с Android Activity.
• debugImplementation("androidx.compose.ui:ui-tooling"): Добавляет библиотеку для инструментов разработки Jetpack Compose, которая доступна только в отладочных сборках.
• implementation(libs.androidx.core.ktx): Добавляет библиотеку AndroidX Core KTX, которая предоставляет расширения Kotlin для основных Android API.
• implementation(libs.androidx.appcompat): Добавляет библиотеку AndroidX AppCompat, которая предоставляет совместимость с более старыми версиями Android.
• implementation(libs.material): Добавляет библиотеку Material Design, которая предоставляет компоненты пользовательского интерфейса, соответствующие рекомендациям Material Design.
• testImplementation(libs.junit): Добавляет библиотеку JUnit, которая является популярным фреймворком для написания модульных тестов.
• androidTestImplementation(libs.androidx.junit): Добавляет библиотеку AndroidX JUnit, которая предоставляет расширения для JUnit для написания инструментальных тестов.
• androidTestImplementation(libs.androidx.espresso.core): Добавляет библиотеку Espresso, которая является популярным фреймворком для написания инструментальных тестов пользовательского интерфейса.

Заключение

Файл build.gradle.kts является важным инструментом для настройки вашего Android-проекта. В этой статье мы рассмотрели пример файла build.gradle.kts, разобрали каждую директиву и объяснили, для чего нужны различные зависимости. Надеемся, что эта статья поможет вам лучше понять, как правильно организовать ваш файл build.gradle.kts и создавать качественные Android-приложения.

Если вы всё правильно сделали, то результат должен быть таким, как показано на скриншоте ниже. Убедитесь, что все зависимости и настройки соответствуют вашим требованиям, и проект должен успешно собираться и работать без ошибок.

Также рекомендую прочитать в связке с этой статьёй