[BOOK-274] feat: 스플래시 화면내 강제 업데이트 기능 구현

easyhooon · easyhooon · commit 165c773c5bdf · 2025-08-20T17:58:47.000+09:00
diff --git a/build-logic/src/main/kotlin/AndroidApplicationConventionPlugin.kt b/build-logic/src/main/kotlin/AndroidApplicationConventionPlugin.kt
@@ -3,6 +3,7 @@ import com.ninecraft.booket.convention.ApplicationConstants
 import com.ninecraft.booket.convention.Plugins
 import com.ninecraft.booket.convention.applyPlugins
 import com.ninecraft.booket.convention.configureAndroid
+import com.ninecraft.booket.convention.libs
 import org.gradle.api.Plugin
 import org.gradle.api.Project
 import org.gradle.kotlin.dsl.configure
@@ -19,9 +20,9 @@ internal class AndroidApplicationConventionPlugin : Plugin<Project> {
                 configureAndroid(this)
 
                 defaultConfig {
-                    targetSdk = ApplicationConstants.TARGET_SDK
-                    versionName = ApplicationConstants.VERSION_NAME
-                    versionCode = ApplicationConstants.VERSION_CODE
+                    targetSdk = libs.versions.targetSdk.get().toInt()
+                    versionName = libs.versions.versionName.get()
+                    versionCode = libs.versions.versionCode.get().toInt()
                 }
             }
         }
diff --git a/build-logic/src/main/kotlin/AndroidLibraryConventionPlugin.kt b/build-logic/src/main/kotlin/AndroidLibraryConventionPlugin.kt
@@ -2,10 +2,10 @@ import com.android.build.gradle.LibraryExtension
 import com.ninecraft.booket.convention.Plugins
 import com.ninecraft.booket.convention.applyPlugins
 import com.ninecraft.booket.convention.configureAndroid
+import com.ninecraft.booket.convention.libs
 import org.gradle.api.Plugin
 import org.gradle.api.Project
 import org.gradle.kotlin.dsl.configure
-import com.ninecraft.booket.convention.ApplicationConstants
 
 internal class AndroidLibraryConventionPlugin : Plugin<Project> {
     override fun apply(target: Project) {
@@ -19,7 +19,7 @@ internal class AndroidLibraryConventionPlugin : Plugin<Project> {
                 configureAndroid(this)
 
                 defaultConfig.apply {
-                    targetSdk = ApplicationConstants.TARGET_SDK
+                    targetSdk = libs.versions.targetSdk.get().toInt()
                 }
             }
         }
diff --git a/build-logic/src/main/kotlin/com/ninecraft/booket/convention/Android.kt b/build-logic/src/main/kotlin/com/ninecraft/booket/convention/Android.kt
@@ -8,10 +8,10 @@ import org.jetbrains.kotlin.gradle.dsl.KotlinProjectExtension
 
 internal fun Project.configureAndroid(extension: CommonExtension<*, *, *, *, *, *>) {
     extension.apply {
-        compileSdk = ApplicationConstants.COMPILE_SDK
+        compileSdk = libs.versions.compileSdk.get().toInt()
 
         defaultConfig {
-            minSdk = ApplicationConstants.MIN_SDK
+            minSdk = libs.versions.minSdk.get().toInt()
         }
 
         compileOptions {
diff --git a/build-logic/src/main/kotlin/com/ninecraft/booket/convention/ApplicationConstants.kt b/build-logic/src/main/kotlin/com/ninecraft/booket/convention/ApplicationConstants.kt
@@ -3,11 +3,6 @@ package com.ninecraft.booket.convention
 import org.gradle.api.JavaVersion
 
 internal object ApplicationConstants {
-    const val MIN_SDK = 28
-    const val TARGET_SDK = 35
-    const val COMPILE_SDK = 35
-    const val VERSION_CODE = 3
-    const val VERSION_NAME = "1.0.0"
     const val JAVA_VERSION_INT = 17
     val javaVersion = JavaVersion.VERSION_17
 }
diff --git a/core/data/api/src/main/kotlin/com/ninecraft/booket/core/data/api/repository/RemoteConfigRepository.kt b/core/data/api/src/main/kotlin/com/ninecraft/booket/core/data/api/repository/RemoteConfigRepository.kt
@@ -2,4 +2,5 @@ package com.ninecraft.booket.core.data.api.repository
 
 interface RemoteConfigRepository {
     suspend fun getLatestVersion(): Result<String>
+    suspend fun shouldUpdate(): Result<Boolean>
 }
diff --git a/core/data/impl/build.gradle.kts b/core/data/impl/build.gradle.kts
@@ -12,6 +12,10 @@ android {
     buildFeatures {
         buildConfig = true
     }
+
+    defaultConfig {
+        buildConfigField("String", "APP_VERSION", "\"${libs.versions.versionName.get()}\"")
+    }
 }
 
 dependencies {
diff --git a/core/data/impl/src/main/kotlin/com/ninecraft/booket/core/data/impl/repository/DefaultRemoteConfigRepository.kt b/core/data/impl/src/main/kotlin/com/ninecraft/booket/core/data/impl/repository/DefaultRemoteConfigRepository.kt
@@ -3,6 +3,7 @@ package com.ninecraft.booket.core.data.impl.repository
 import com.google.firebase.remoteconfig.FirebaseRemoteConfig
 import com.google.firebase.remoteconfig.get
 import com.ninecraft.booket.core.data.api.repository.RemoteConfigRepository
+import com.ninecraft.booket.core.data.impl.BuildConfig
 import com.orhanobut.logger.Logger
 import kotlinx.coroutines.suspendCancellableCoroutine
 import javax.inject.Inject
@@ -24,7 +25,49 @@ class DefaultRemoteConfigRepository @Inject constructor(
         }
     }
 
+    override suspend fun shouldUpdate(): Result<Boolean> = suspendCancellableCoroutine { continuation ->
+        remoteConfig.fetchAndActivate().addOnCompleteListener { task ->
+            if (task.isSuccessful) {
+                val minVersion = remoteConfig[KEY_MIN_VERSION].asString()
+                val currentVersion = BuildConfig.APP_VERSION
+                continuation.resume(Result.success(checkMinVersion(currentVersion, minVersion)))
+            } else {
+                Logger.e(task.exception, "shouldUpdate: getMinVersion failed")
+                continuation.resume(Result.failure(task.exception ?: Exception("Unknown error")))
+            }
+        }
+    }
+
+    /**
+     * 현재 앱 버전이 최소 요구 버전보다 낮은지 확인하는 함수
+     *
+     * @param currentVersion 현재 앱의 버전 (예: "1.0.0")
+     * @param minVersion 최소 요구 버전 (Firebase Remote Config에서 가져온 값)
+     * @return true면 강제 업데이트 필요 (현재 버전 < 최소 요구 버전), false면 업데이트 불필요
+     *
+     * 버전 형식: "메이저.마이너.패치" (예: 1.2.3)
+     * 비교 순서: 메이저 → 마이너 → 패치 버전 순으로 비교
+     */
+    private fun checkMinVersion(currentVersion: String, minVersion: String): Boolean {
+        Logger.d("checkMinVersion: current: $currentVersion, min: $minVersion")
+        if (!Regex("""^\d+\.\d+\.\d+$""").matches(currentVersion)) return false
+        if (!Regex("""^\d+\.\d+\.\d+$""").matches(minVersion)) return false
+
+        val current = currentVersion.split('.').map { it.toInt() }
+        val min = minVersion.split('.').map { it.toInt() }
+
+        // 메이저 버전 비교
+        if (current[0] != min[0]) return current[0] < min[0]
+
+        // 마이너 버전 비교
+        if (current[1] != min[1]) return current[1] < min[1]
+
+        // 패치 버전 비교
+        return current[2] < min[2]
+    }
+
     companion object {
         private const val KEY_LATEST_VERSION = "LatestVersion"
+        private const val KEY_MIN_VERSION = "MinVersion"
     }
 }
diff --git a/feature/splash/build.gradle.kts b/feature/splash/build.gradle.kts
@@ -6,6 +6,14 @@ plugins {
 
 android {
     namespace = "com.ninecraft.booket.feature.splash"
+
+    buildFeatures {
+        buildConfig = true
+    }
+
+    defaultConfig {
+        buildConfigField("String", "PACKAGE_NAME", "\"${libs.versions.packageName.get()}\"")
+    }
 }
 
 ksp {
diff --git a/feature/splash/src/main/kotlin/com/ninecraft/booket/splash/HandleSplashSideEffects.kt b/feature/splash/src/main/kotlin/com/ninecraft/booket/splash/HandleSplashSideEffects.kt
@@ -0,0 +1,36 @@
+package com.ninecraft.booket.splash
+
+import android.content.Context
+import android.content.Intent
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.platform.LocalContext
+import androidx.core.net.toUri
+import com.ninecraft.booket.feature.splash.BuildConfig
+import com.skydoves.compose.effects.RememberedEffect
+
+@Composable
+internal fun HandleSplashSideEffects(
+    state: SplashUiState,
+    eventSink: (SplashUiEvent) -> Unit,
+) {
+    val context = LocalContext.current
+
+    RememberedEffect(state.sideEffect) {
+        when (state.sideEffect) {
+            is SplashSideEffect.NavigateToPlayStore -> {
+                openPlayStore(context)
+            }
+            null -> {}
+        }
+
+        if (state.sideEffect != null) {
+            eventSink(SplashUiEvent.InitSideEffect)
+        }
+    }
+}
+
+private fun openPlayStore(context: Context) {
+    // https://play.google.com/store/apps/details?id=com.ninecraft.booket
+    val intent = Intent(Intent.ACTION_VIEW, "market://details?id=${BuildConfig.PACKAGE_NAME}".toUri())
+    context.startActivity(intent)
+}
diff --git a/feature/splash/src/main/kotlin/com/ninecraft/booket/splash/SplashPresenter.kt b/feature/splash/src/main/kotlin/com/ninecraft/booket/splash/SplashPresenter.kt
@@ -9,6 +9,7 @@ import androidx.compose.runtime.setValue
 import com.ninecraft.booket.core.common.constants.ErrorScope
 import com.ninecraft.booket.core.common.utils.postErrorDialog
 import com.ninecraft.booket.core.data.api.repository.AuthRepository
+import com.ninecraft.booket.core.data.api.repository.RemoteConfigRepository
 import com.ninecraft.booket.core.data.api.repository.UserRepository
 import com.ninecraft.booket.core.model.AutoLoginState
 import com.ninecraft.booket.core.model.OnboardingState
@@ -17,7 +18,7 @@ import com.ninecraft.booket.feature.screens.HomeScreen
 import com.ninecraft.booket.feature.screens.LoginScreen
 import com.ninecraft.booket.feature.screens.OnboardingScreen
 import com.ninecraft.booket.feature.screens.SplashScreen
-import com.skydoves.compose.effects.RememberedEffect
+import com.orhanobut.logger.Logger
 import com.slack.circuit.codegen.annotations.CircuitInject
 import com.slack.circuit.retained.collectAsRetainedState
 import com.slack.circuit.retained.rememberRetained
@@ -34,14 +35,16 @@ class SplashPresenter @AssistedInject constructor(
     @Assisted private val navigator: Navigator,
     private val userRepository: UserRepository,
     private val authRepository: AuthRepository,
+    private val remoteConfigRepository: RemoteConfigRepository,
 ) : Presenter<SplashUiState> {
 
     @Composable
     override fun present(): SplashUiState {
         val scope = rememberCoroutineScope()
         val onboardingState by userRepository.onboardingState.collectAsRetainedState(initial = OnboardingState.IDLE)
         val autoLoginState by authRepository.autoLoginState.collectAsRetainedState(initial = AutoLoginState.IDLE)
-        var isSplashTimeCompleted by rememberRetained { mutableStateOf(false) }
+        var isForceUpdateDialogVisible by rememberRetained { mutableStateOf(false) }
+        var sideEffect by rememberRetained { mutableStateOf<SplashSideEffect?>(null) }
 
         fun checkTermsAgreement() {
             scope.launch {
@@ -64,14 +67,7 @@ class SplashPresenter @AssistedInject constructor(
             }
         }
 
-        LaunchedEffect(Unit) {
-            delay(1000L)
-            isSplashTimeCompleted = true
-        }
-
-        RememberedEffect(onboardingState, autoLoginState, isSplashTimeCompleted) {
-            if (!isSplashTimeCompleted) return@RememberedEffect
-
+        fun proceedToNextScreen() {
             when (onboardingState) {
                 OnboardingState.NOT_COMPLETED -> {
                     navigator.resetRoot(OnboardingScreen)
@@ -99,7 +95,44 @@ class SplashPresenter @AssistedInject constructor(
             }
         }
 
-        return SplashUiState
+        fun handleEvent(event: SplashUiEvent) {
+            when (event) {
+                SplashUiEvent.OnUpdateButtonClick -> {
+                    sideEffect = SplashSideEffect.NavigateToPlayStore
+                }
+
+                SplashUiEvent.InitSideEffect -> {
+                    sideEffect = null
+                }
+            }
+        }
+
+        LaunchedEffect(onboardingState, autoLoginState) {
+            delay(1000L)
+
+            if (onboardingState == OnboardingState.IDLE || autoLoginState == AutoLoginState.IDLE) {
+                return@LaunchedEffect
+            }
+
+            remoteConfigRepository.shouldUpdate()
+                .onSuccess { shouldUpdate ->
+                    if (shouldUpdate) {
+                        isForceUpdateDialogVisible = true
+                    } else {
+                        proceedToNextScreen()
+                    }
+                }
+                .onFailure { exception ->
+                    Logger.e("${exception.message}")
+                    proceedToNextScreen()
+                }
+        }
+
+        return SplashUiState(
+            isForceUpdateDialogVisible = isForceUpdateDialogVisible,
+            sideEffect = sideEffect,
+            eventSink = ::handleEvent,
+        )
     }
 
     @CircuitInject(SplashScreen::class, ActivityRetainedComponent::class)
diff --git a/feature/splash/src/main/kotlin/com/ninecraft/booket/splash/SplashUi.kt b/feature/splash/src/main/kotlin/com/ninecraft/booket/splash/SplashUi.kt
@@ -1,5 +1,6 @@
 package com.ninecraft.booket.splash
 
+import android.R.attr.description
 import androidx.compose.foundation.Image
 import androidx.compose.foundation.background
 import androidx.compose.foundation.layout.Box
@@ -21,6 +22,7 @@ import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.unit.dp
 import com.ninecraft.booket.core.designsystem.DevicePreview
 import com.ninecraft.booket.core.designsystem.theme.ReedTheme
+import com.ninecraft.booket.core.ui.component.ReedDialog
 import com.ninecraft.booket.feature.screens.SplashScreen
 import com.ninecraft.booket.feature.splash.R
 import com.slack.circuit.codegen.annotations.CircuitInject
@@ -30,6 +32,7 @@ import tech.thdev.compose.exteions.system.ui.controller.rememberSystemUiControll
 @CircuitInject(SplashScreen::class, ActivityRetainedComponent::class)
 @Composable
 fun SplashUi(
+    state: SplashUiState,
     modifier: Modifier = Modifier,
 ) {
     val systemUiController = rememberSystemUiController()
@@ -50,6 +53,11 @@ fun SplashUi(
         }
     }
 
+    HandleSplashSideEffects(
+        state = state,
+        eventSink = state.eventSink,
+    )
+
     Box(
         modifier = modifier
             .fillMaxSize()
@@ -74,13 +82,28 @@ fun SplashUi(
             )
             Spacer(Modifier.height(ReedTheme.spacing.spacing8))
         }
+
+        if (state.isForceUpdateDialogVisible) {
+            ReedDialog(
+                title = stringResource(R.string.splash_force_update_title),
+                description = stringResource(R.string.splash_force_update_message),
+                confirmButtonText = stringResource(R.string.splash_force_update_button_text),
+                onConfirmRequest = {
+                    state.eventSink(SplashUiEvent.OnUpdateButtonClick)
+                },
+            )
+        }
     }
 }
 
 @DevicePreview
 @Composable
 private fun SplashPreview() {
     ReedTheme {
-        SplashUi()
+        SplashUi(
+            state = SplashUiState(
+                eventSink = {},
+            ),
+        )
     }
 }
diff --git a/feature/splash/src/main/kotlin/com/ninecraft/booket/splash/SplashUiState.kt b/feature/splash/src/main/kotlin/com/ninecraft/booket/splash/SplashUiState.kt
@@ -1,5 +1,21 @@
 package com.ninecraft.booket.splash
 
+import androidx.compose.runtime.Immutable
+import com.slack.circuit.runtime.CircuitUiEvent
 import com.slack.circuit.runtime.CircuitUiState
 
-object SplashUiState : CircuitUiState
+data class SplashUiState(
+    val isForceUpdateDialogVisible: Boolean = false,
+    val sideEffect: SplashSideEffect? = null,
+    val eventSink: (SplashUiEvent) -> Unit,
+) : CircuitUiState
+
+@Immutable
+sealed interface SplashSideEffect {
+    data object NavigateToPlayStore : SplashSideEffect
+}
+
+sealed interface SplashUiEvent : CircuitUiEvent {
+    data object InitSideEffect : SplashUiEvent
+    data object OnUpdateButtonClick : SplashUiEvent
+}
diff --git a/feature/splash/src/main/res/values/strings.xml b/feature/splash/src/main/res/values/strings.xml
@@ -1,4 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="splash_title">책 덮기 전 한 문장을 기록해보세요</string>
+    <string name="splash_force_update_title">최신 버전이 출시 되었습니다.</string>
+    <string name="splash_force_update_message">최적의 사용 환경을 위해 업데이트를 해주세요.</string>
+    <string name="splash_force_update_button_text">업데이트 하기</string>
 </resources>
diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml

Original file line number	Diff line number	Diff line change
`@@ -3,6 +3,7 @@ import com.ninecraft.booket.convention.ApplicationConstants`
`3`	`3`	`import com.ninecraft.booket.convention.Plugins`
`4`	`4`	`import com.ninecraft.booket.convention.applyPlugins`
`5`	`5`	`import com.ninecraft.booket.convention.configureAndroid`
	`6`	`+import com.ninecraft.booket.convention.libs`
`6`	`7`	`import org.gradle.api.Plugin`
`7`	`8`	`import org.gradle.api.Project`
`8`	`9`	`import org.gradle.kotlin.dsl.configure`
`@@ -19,9 +20,9 @@ internal class AndroidApplicationConventionPlugin : Plugin<Project> {`
`19`	`20`	`configureAndroid(this)`
`20`	`21`
`21`	`22`	`defaultConfig {`
`22`		`- targetSdk = ApplicationConstants.TARGET_SDK`
`23`		`- versionName = ApplicationConstants.VERSION_NAME`
`24`		`- versionCode = ApplicationConstants.VERSION_CODE`
	`23`	`+ targetSdk = libs.versions.targetSdk.get().toInt()`
	`24`	`+ versionName = libs.versions.versionName.get()`
	`25`	`+ versionCode = libs.versions.versionCode.get().toInt()`
`25`	`26`	`}`
`26`	`27`	`}`
`27`	`28`	`}`
Original file line number	Diff line number	Diff line change
`@@ -2,10 +2,10 @@ import com.android.build.gradle.LibraryExtension`
`2`	`2`	`import com.ninecraft.booket.convention.Plugins`
`3`	`3`	`import com.ninecraft.booket.convention.applyPlugins`
`4`	`4`	`import com.ninecraft.booket.convention.configureAndroid`
	`5`	`+import com.ninecraft.booket.convention.libs`
`5`	`6`	`import org.gradle.api.Plugin`
`6`	`7`	`import org.gradle.api.Project`
`7`	`8`	`import org.gradle.kotlin.dsl.configure`
`8`		`-import com.ninecraft.booket.convention.ApplicationConstants`
`9`	`9`
`10`	`10`	`internal class AndroidLibraryConventionPlugin : Plugin<Project> {`
`11`	`11`	`override fun apply(target: Project) {`
`@@ -19,7 +19,7 @@ internal class AndroidLibraryConventionPlugin : Plugin<Project> {`
`19`	`19`	`configureAndroid(this)`
`20`	`20`
`21`	`21`	`defaultConfig.apply {`
`22`		`- targetSdk = ApplicationConstants.TARGET_SDK`
	`22`	`+ targetSdk = libs.versions.targetSdk.get().toInt()`
`23`	`23`	`}`
`24`	`24`	`}`
`25`	`25`	`}`
Original file line number	Diff line number	Diff line change
`@@ -2,4 +2,5 @@ package com.ninecraft.booket.core.data.api.repository`
`2`	`2`
`3`	`3`	`interface RemoteConfigRepository {`
`4`	`4`	`suspend fun getLatestVersion(): Result<String>`
	`5`	`+ suspend fun shouldUpdate(): Result<Boolean>`
`5`	`6`	`}`
Original file line number	Diff line number	Diff line change
`@@ -12,6 +12,10 @@ android {`
`12`	`12`	`buildFeatures {`
`13`	`13`	`buildConfig = true`
`14`	`14`	`}`
	`15`	`+`
	`16`	`+ defaultConfig {`
	`17`	`+ buildConfigField("String", "APP_VERSION", "\"${libs.versions.versionName.get()}\"")`
	`18`	`+ }`
`15`	`19`	`}`
`16`	`20`
`17`	`21`	`dependencies {`