Gradle에서 setting.gradle.kts 와 build.gradle.kts 차이

[murjune]

setting.gradle.kts

프로젝트의 전반적인 구조, 플러그인(plugin), 의존성(dependency)을 관리하는 파일입니다.
빌드 프로세스 중 초기화 단계에서 사용된다.

플러그인 관리(PluginManagement)

pluginManagement.repositories에 Plugin 검색 및 다운로드할 repository 등록

pluginManagement {
    repositories {
        google() // Google Maven 저장소
        mavenCentral()
        gradlePluginPortal() 
    }
}

• google()

  • Google의 Maven 저장소
  • 안드로이드 플러그인(com.android.application) 등 안드로이드 관련 플러그인이 여기에 저장되어 있음

• mavenCentral()

  • Maven Central 저장소
  • Kotlin 플러그인 등 일반적인 Gradle 플러그인이 저장되어 있음

• gradlePluginPortal()

  • Gradle 플러그인 포털
  • Gradle 플러그인이 저장되어 있음

의존성 관리

dependencyResolutionManagement.repositories에서 라이브러리를 검색 및 다운로드할 repository 등록

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

• repositories

  • 의존성을 다운로드할 저장소를 설정
  • google(): 안드로이드와 관련된 Jetpack, AndroidX 라이브러리가 저장된 Google Maven 저장소.
    • 예: androidx.appcompat:appcompat, androidx.core:core-ktx.
  • mavenCentral(): 일반적인 오픈소스 라이브러리가 저장된 Maven Central 저장소.
    예: com.squareup.retrofit2:retrofit, org.jetbrains.kotlin:kotlin-stdlib

• repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)

  • repository 설정을 build.gradle.kts 파일에 설정할 경우 에러를 발생시키도록 설정
  • 이는 repository 에 대한 설정을 settings.gradle.kts 파일에 중앙 집중화하기 위함임

루트 프로젝트 이름 설정

rootProject.name = "PokeRogueHelper"

서브 모듈 등록

include(":app", ":data", ":remote", ":local")
...

build.gradle.kts

프로젝트, 모듈의 빌드 설정을 관리하는 파일이다.
각 모듈, 빌드 로직, 의존성 등록, 플러그인 등록, task 등록 및 설정을 담당한다.

Gradle 실행 프로세스 중 Configure 단계에서 해당 파일들을 분석해서 Task들을 도출하고, Task 그래프를 그린다.

• Plugin, dependency 등록 : Setting 에서 설정한 repository 에서 플러그인과 의존성을 검색하고 다운받는다.

plugins {
    alias(libs.plugins.android.application) apply false // agp 등록
}

dependencies {
    implementation(libs.androidx.core.ktx) // androidx core 라이브러리 등록
}

- task 설정

```kotlin
    tasks {
        withType<Test> {
            useJUnitPlatform() // JUnit5를 사용하겠다.
        }
    }