Android 15 대응 프로젝트 구조 변화... 그리고 toml알아보기 + Hilt 라이브러리 추가하기

버전 카탈로그를 베타로 밀고있다가 없애버리고, 새로 만드는 프로젝트에 무조건 버전 카탈로그 + gradle로 적용하도록 바뀌었다... 따라서 toml을 이제 필수적으로 알아야한다.

 

또 jellyfish에서 생성한 View 프로젝트에서 달라진 코드들이 매우 많아서 이 부분들 먼저 잡고 가야겠다. 심지어 메인 액티비티도 변화가 생겼다.

# edge-to-edge 디스플레이 대응

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        setContentView(R.layout.activity_main)
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
            val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
            insets
        }
    }
}

id가 main인 것의 정체는 MainActivity의 제일 바깥쪽 ConstraintLayout이다. 너무 많이 바뀌어서 좀 혼란스러운데 Activity가 바뀐 것부터 살펴보겠다.

 

우선 enableEdgeToEdge는 edge-to-edge 디스플레이 모드(상태바까지 확장되는)를 활성화 시켜주는 부분이다. 상태바의 색상도 알아서 투명하게 조절해주는 기능이다.

 

지금 코드에서 setOnApplyWindowInsetsListener는 현재 레이아웃의 패딩을 동적으로 결정해주는 요소다. 이게 왜 필요하냐면 지금 edge-to-edge를 활성화 했기 때문이다. 상태바는 물론이고 시스템 네비게이션바 위치까지 확장된 건데 그러면 앱의 UI 중 네비게이션 바 때문에 사용할 수 없는 부분이 생긴다. 그걸 막기위해 inset 설정을 하는게 이 리스너다.

 

insets를 꼭 반환해줘야 시스템이 알아먹는다. insets을 반환하면 다른 뷰(계층구조상으로 존재하는)들도 이 id로 지정해둔 insets을 감지한다는 의미이고 WindowInsetsCompat.CONSUMED를 반환하면 다른 뷰들한테 inset 변경사항을 알리지않는다는 의미가 된다.

 

꼭 레이아웃으로 달 필요없이 시스템 요소에 가려지지 않길 원하면 이렇게 사용할수 있다. systemBars에 속하는 요소는 상태표시줄, 네비게이션바, 캡션 바가 있다. 키보드에 해당하는 IME는 여기에 들어가지않는다.

https://developer.android.com/develop/ui/views/layout/edge-to-edge?hl=ko

앱에 더 넓은 화면에 콘텐츠 표시  |  Views  |  Android Developers

# toml(Tom's Obvious Minimal Language) + version catalog

gradle 달라진거 먼저 보자... 다 alias로 toml에 선언된 값을 가져오는 방식이다. 버전 카탈로그를 사용할 때는 buildscript 블록과 classpath를 직접 사용하지 않는다. 대신 plugins 블록을 사용하여 플러그인으로 다 처리한다고 한다... 

// project 수준 gradle
plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.jetbrains.kotlin.android) apply false
}

// app 수준 gradle
plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.jetbrains.kotlin.android)
}

android {
    namespace = "com.kimmandoo.hilt"
    compileSdk = 34

    defaultConfig {
        applicationId = "com.kimmandoo.hilt"
        minSdk = 28
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {

    implementation(libs.androidx.core.ktx)
    implementation(libs.androidx.appcompat)
    implementation(libs.material)
    implementation(libs.androidx.activity)
    implementation(libs.androidx.constraintlayout)
    testImplementation(libs.junit)
    androidTestImplementation(libs.androidx.junit)
    androidTestImplementation(libs.androidx.espresso.core)
}

buildSrc를 사용할 때 보다 더 간단해진 것 같다. libs.versions.toml 파일 하나에서 모든 라이브러리 의존성을 관리한다.

versions, libraries, plugins 세 부분으로 나뉘어져 있고, 보고 이해못할정도로 복잡하게 기술되어있진 않다.

[versions]
agp = "8.4.1"
kotlin = "1.9.0"
coreKtx = "1.10.1"
junit = "4.13.2"
junitVersion = "1.1.5"
espressoCore = "3.5.1"
appcompat = "1.6.1"
material = "1.10.0"
activity = "1.8.0"
constraintlayout = "2.1.4"

[libraries]
androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
junit = { group = "junit", name = "junit", version.ref = "junit" }
androidx-junit = { group = "androidx.test.ext", name = "junit", version.ref = "junitVersion" }
androidx-espresso-core = { group = "androidx.test.espresso", name = "espresso-core", version.ref = "espressoCore" }
androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }
material = { group = "com.google.android.material", name = "material", version.ref = "material" }
androidx-activity = { group = "androidx.activity", name = "activity", version.ref = "activity" }
androidx-constraintlayout = { group = "androidx.constraintlayout", name = "constraintlayout", version.ref = "constraintlayout" }

[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }
jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }

이제 어떻게 생긴지는 확인했고, gradle에 어떻게 추가할 지를 실습해봐야한다. hilt를 추가해보면서 적용해보겠다.

 

# Hilt 추가하기

Hilt는 의존성 주입(DI) 도구로 어노테이션 기반이고 미리 정해진 컴포넌트(표준 컨테이너)가 있어서 그걸 어노테이션으로 지정해서 쓰는 형태이다.

https://dagger.dev/hilt/gradle-setup

Gradle Build Setup

나는 어노테이션 프로세서로 ksp를 사용했다.

 

hilt를 추가하려면 루트수준, 모듈 수준 gradle 파일에 플러그인을 추가하고, 라이브러리들을 dependency에 추가해줘야한다. toml 방식을 사용한다고 해서 이전에 사용하던 방식을 사용하지 못하는 건 아니라서, 복잡한게 싫다면 그냥 문서대로 추가하면 된다.

[versions]
hilt = "2.51.1"
ksp = "1.9.0-1.0.13"

[libraries]
hilt-android = { group = "com.google.dagger", name = "hilt-android", version.ref = "hilt" }
hilt-compiler = { group = "com.google.dagger", name = "hilt-compiler", version.ref = "hilt" }
hilt-android-testing = { group = "com.google.dagger", name = "hilt-android-testing", version.ref = "hilt" }

[plugins]
hilt-gradle-plugin = { id = "com.google.dagger.hilt.android", version.ref = "hilt" }
ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }

문서에 있는 걸 toml방식으로 바꿔서 추가했다. 사용된 dash(-)는 나중에 (.)으로 참조하게된다. 나는 코틀린 버전이 1.9.0이라서 ksp버전을 1.9.0-1.0.13으로 맞춰줬다.

 

이렇게 추가해줬다면 프로젝트 수준 gradle에 아래처럼 추가한다. apply false는 프로젝트 내 모듈에 전체적용할지 물어보는건데 보통 false로 둔다.

plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.jetbrains.kotlin.android) apply false
    alias(libs.plugins.hilt.gradle.plugin) apply false
    alias(libs.plugins.ksp) apply false
}

모듈 수준 gradle의 plugin에는 아래처럼 추가한다.

plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.jetbrains.kotlin.android)
    alias(libs.plugins.ksp)
    alias(libs.plugins.hilt.gradle.plugin)
}

그리고 dependeny를 아래처럼 추가하면 끝이다.

dependencies {
	...
    // hilt
    implementation(libs.hilt.android)
    ksp(libs.hilt.compiler)
    androidTestImplementation(libs.hilt.android.testing)
    kspAndroidTest(libs.hilt.compiler)
}

한가지 주의할 점은 toml파일에 선언하고 나서 gradle sync를 해줘야 gradle 파일에 plugin 추가할 때 올바르게 올라간다.

이러면 필수사항은 다 마쳤다(test는 선택사항). 

kapt를 기존에 이용하던 사람들은 corretErrorTypes까지 처리해줬을텐데 ksp는 자바 변환 과정이 없어서 이걸 안달아 줘도 된다.

 

toml... 뭔가 편한듯 안편하긴한데 renovatebot같은 도구로 라이브러리 버전관리를 한다면 꼭 필요한 기능처럼 보인다.

 

도움이 됐다면 댓글이나 공감 버튼 한 번씩 누르고 가주세요!