나만의 안드로이드 앱 만들기(고급자 편) - 멀티 모듈 프로젝트 구성하기

나만의 안드로이드 앱 만들기/고급자

by Victorywskim 2023. 12. 26. 05:36

본편에서는 멀티 모듈 프로젝트를 직접 구성해보도록 하겠습니다.

기준 코드는 다음과 같습니다.

GitHub - tmvlke/SimpleDutch: 심플더치 프로젝트 입니다.

심플더치 프로젝트 입니다. Contribute to tmvlke/SimpleDutch development by creating an account on GitHub.

github.com

저번 편에서 설명드린 것 처럼 전 4가지 관점을 주로 적용하여 멀티 모듈 프로젝트를 구성하고 있습니다.

기능
계층
UI 관련 여부
테스트 가능성

기능은 저는 주로 탭을 기준으로 구분하고 있으며, 이번편에서도 탭을 기준으로 구분하고자 합니다.

만약 제가 카카오톡 개발자라면 친구 관리 모듈, 채팅 모듈 등으로 멀티 모듈을 구성 했을 것 같습니다.

계층은 이미 클린 아키텍쳐가 도입 되어 있어서 이번편에서는 넘어가고자 합니다.

UI 관련 여부는 앱에서 공통으로 사용되는 컴포넌트 및 ui 기능(navigation)들을 UI 모듈들에서도 똑같이 적용하고자할때 사용합니다.

테스트 가능성은 기능 관점에서 멀티 모듈 프로젝트를 구성하면서 같이 적용해볼 예정입니다.

멀티 모듈 프로젝트 구성 소개

현 프로젝트에서는 홈과 저장소 2개의 탭으로 구성되어 있습니다.

본편에서는 기존 프로젝트에서는 presentaion 내에 homeTab 과 storageTab, baseUiKit 4가지 모듈을 추가하고자 합니다.

homeTab 과 storageTab 은 메인 서비스를 관리하는 모듈이며, baseUiKit 은 공용 컴포넌트 및 네비게이션, 캘린더, 그래프 등 공통 기능들을 관리하는 모듈입니다.

구조는 다음과 같습니다.

...
presentaion
- baseUiKit
- homeTab
- storageTab

제약 조건은 다음과 같습니다.

presentaion
- 실질적인 앱입니다.
- 스플래시 및 메인 페이지 등을 담당하고 있으나, 추후 분리 예정입니다.
- baseUiKit, homeTab, storageTab 모두 참조 가능합니다.
baseUiKit
- 컴포넌트 및 페이지, 네이게이션 등을 관리합니다.
- data, domain 만 참조 가능하며, 다른 모듈들은 참조 불가합니다.
homeTab
- 홈 기능을 담당합니다.
- baseUiKit 만 참조 가능하며, 다른 모듈들은 참조 불가합니다.
storageTab
- 저장소 기능을 담당합니다.
- baseUiKit 만 참조 가능하며, 다른 모듈들은 참조 불가합니다.

모듈 생성하기

모듈 생성 방법은 다음과 같습니다.

presentaion 모듈에서 우클릭을 하고 New -> Module 을 클릭합니다.

그 다음 Android Library 를 선택하고 baseUiKit, homeTab, storageTab 를 생성합니다.

생성이 완료되면 다음과 같습니다.

의존 관계 설정하기

presentaion

...

dependencies {

    implementation(project(mapOf("path" to ":presentation:baseUiKit")))
    implementation(project(mapOf("path" to ":presentation:homeTab")))
    implementation(project(mapOf("path" to ":presentation:storageTab")))

    ...
}

...

추가된 baseUiKit, homeTab, storageTab 을 각각 추가해주고, 불필요한 의존성을 제거합니다.

baseUiKit

...

dependencies {

    api(project(":domain"))
    api(project(":data"))

    // ktx
    api(SdDependency.Ktx.core)
    api(SdDependency.Ktx.lifecycleRuntime)
    api(SdDependency.Compose.activity)

    api(platform(SdDependency.Compose.bom)) // compose
    api(SdDependency.Compose.ui)
    api(SdDependency.Compose.graphics)
    api(SdDependency.Compose.preview)
    api(SdDependency.Compose.material3)

    api(SdDependency.Navigation.compose) // navigation
    api(SdDependency.Navigation.hilt)

    api(SdDependency.Compose.constraint)

    api(SdDependency.Navigation.animation)

    api(SdDependency.coil) // coil

    // Hilt
    implementation(SdDependency.Hilt.android)
    kapt(SdDependency.Hilt.androidCompiler)

    // tdd
    testImplementation(SdTestDependency.Tdd.junit5)
    testRuntimeOnly(SdTestDependency.Tdd.junit5Engine)
    testImplementation(SdTestDependency.Tdd.junit5Params)
    testRuntimeOnly(SdTestDependency.Tdd.junit5ParamsEngine)

    testImplementation(SdTestDependency.Tdd.mockk)

    testImplementation(SdTestDependency.Tdd.coroutines)

    // bdd1
    androidTestImplementation(SdTestDependency.Bdd.junit)
    androidTestImplementation(platform(SdTestDependency.Bdd.composeBom))
    androidTestImplementation(SdTestDependency.Bdd.composeJunit)

    // bdd2
    debugImplementation(SdTestDependency.Bdd.debugComposeTooling)
    debugImplementation(SdTestDependency.Bdd.debugComposeManifest)
}

...

presentaion 에서 공통으로 사용될 의존성을 이전합니다.

homeTab 및 storageTab

...

dependencies {

    implementation(project(mapOf("path" to ":presentation:baseUiKit")))

    // Hilt
    implementation(SdDependency.Hilt.android)
    kapt(SdDependency.Hilt.androidCompiler)

    // tdd
    testImplementation(SdTestDependency.Tdd.junit5)
    testRuntimeOnly(SdTestDependency.Tdd.junit5Engine)
    testImplementation(SdTestDependency.Tdd.junit5Params)
    testRuntimeOnly(SdTestDependency.Tdd.junit5ParamsEngine)

    testImplementation(SdTestDependency.Tdd.mockk)

    testImplementation(SdTestDependency.Tdd.coroutines)

    // bdd1
    androidTestImplementation(SdTestDependency.Bdd.junit)
    androidTestImplementation(platform(SdTestDependency.Bdd.composeBom))
    androidTestImplementation(SdTestDependency.Bdd.composeJunit)

    // bdd2
    debugImplementation(SdTestDependency.Bdd.debugComposeTooling)
    debugImplementation(SdTestDependency.Bdd.debugComposeManifest)
}

...

baseUiKit 을 비롯하여 테스트 라이브러리까지 추가해주었습니다.

소스코드 이전하기

presentaion 은 root 경로로 NavGraph.kt, MainActivity, SdApplication 3 파일만 있으면 됩니다. 하지만 지금은 불필요한 모듈 추가를 지양하고자 main 과 splash 는 남겨두었습니다. 추후 회원가입 이나 소개 페이지 등이 추가되면서 점점 비대해진다면 그땐 별도 모듈로 분리할 예정입니다.