[BOOK-274] feat: 설정화면 내 선택 업데이트 팝업 연동 및 스토어 이동 플로우 구현

Author: easyhooon

core/common/build.gradle.kts

@@ -9,6 +9,14 @@ plugins {
 
 android {
     namespace = "com.ninecraft.booket.core.common"
+
+    buildFeatures {
+        buildConfig = true
+    }
+
+    defaultConfig {
+        buildConfigField("String", "PACKAGE_NAME", "\"${libs.versions.packageName.get()}\"")
+    }
 }
 
 dependencies {

core/data/impl/src/main/kotlin/com/ninecraft/booket/core/data/impl/repository/DefaultRemoteConfigRepository.kt

@@ -2,6 +2,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.common.util.isUpdateRequired
 import com.ninecraft.booket.core.data.api.repository.RemoteConfigRepository
 import com.ninecraft.booket.core.data.impl.BuildConfig
 import com.orhanobut.logger.Logger
@@ -30,42 +31,14 @@ class DefaultRemoteConfigRepository @Inject constructor(
             if (task.isSuccessful) {
                 val minVersion = remoteConfig[KEY_MIN_VERSION].asString()
                 val currentVersion = BuildConfig.APP_VERSION
-                continuation.resume(Result.success(checkMinVersion(currentVersion, minVersion)))
+                continuation.resume(Result.success(isUpdateRequired(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"

feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/HandlingSettingsSideEffect.kt

@@ -3,6 +3,7 @@ package com.ninecraft.booket.feature.settings
 import android.widget.Toast
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.platform.LocalContext
+import com.ninecraft.booket.core.common.extensions.openPlayStore
 import com.skydoves.compose.effects.RememberedEffect
 
 @Composable
@@ -18,7 +19,11 @@ internal fun HandleSettingsSideEffects(
                 Toast.makeText(context, state.sideEffect.message, Toast.LENGTH_SHORT).show()
             }
 
-            null -> {}
+            is SettingsSideEffect.NavigateToPlayStore -> {
+                context.openPlayStore()
+            }
+
+            else -> {}
         }
 
         if (state.sideEffect != null) {

feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsPresenter.kt

@@ -39,6 +39,7 @@ class SettingsPresenter @AssistedInject constructor(
         var isWithdrawBottomSheetVisible by rememberRetained { mutableStateOf(false) }
         var isWithdrawConfirmed by rememberRetained { mutableStateOf(false) }
         var latestVersion by rememberRetained { mutableStateOf("") }
+        var isOptionalUpdateDialogVisible by rememberRetained { mutableStateOf(false) }
         var sideEffect by rememberRetained { mutableStateOf<SettingsSideEffect?>(null) }
 
         fun logout() {
@@ -173,6 +174,18 @@ class SettingsPresenter @AssistedInject constructor(
                 is SettingsUiEvent.Withdraw -> {
                     withdraw()
                 }
+
+                is SettingsUiEvent.OnVersionClick -> {
+                    isOptionalUpdateDialogVisible = true
+                }
+
+                is SettingsUiEvent.OnOptionalUpdateDialogDismiss -> {
+                    isOptionalUpdateDialogVisible = false
+                }
+
+                is SettingsUiEvent.OnUpdateButtonClick -> {
+                    sideEffect = SettingsSideEffect.NavigateToPlayStore
+                }
             }
         }
 
@@ -186,6 +199,7 @@ class SettingsPresenter @AssistedInject constructor(
             isWithdrawBottomSheetVisible = isWithdrawBottomSheetVisible,
             isWithdrawConfirmed = isWithdrawConfirmed,
             latestVersion = latestVersion,
+            isOptionalUpdateDialogVisible = isOptionalUpdateDialogVisible,
             sideEffect = sideEffect,
             eventSink = ::handleEvent,
         )

feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsUi.kt

@@ -6,9 +6,9 @@ import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.Row
 import androidx.compose.foundation.layout.Spacer
 import androidx.compose.foundation.layout.fillMaxSize
-import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.height
 import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.width
 import androidx.compose.foundation.rememberScrollState
 import androidx.compose.foundation.verticalScroll
 import androidx.compose.material3.CircularProgressIndicator
@@ -26,7 +26,7 @@ import androidx.compose.ui.graphics.vector.ImageVector
 import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.res.vectorResource
-import com.ninecraft.booket.core.common.extensions.clickableSingle
+import com.ninecraft.booket.core.common.util.compareVersions
 import com.ninecraft.booket.core.designsystem.DevicePreview
 import com.ninecraft.booket.core.designsystem.component.ReedDivider
 import com.ninecraft.booket.core.designsystem.theme.ReedTheme
@@ -35,10 +35,12 @@ import com.ninecraft.booket.core.ui.ReedScaffold
 import com.ninecraft.booket.core.ui.component.ReedBackTopAppBar
 import com.ninecraft.booket.core.ui.component.ReedDialog
 import com.ninecraft.booket.feature.screens.SettingsScreen
+import com.ninecraft.booket.feature.settings.component.SettingItem
 import com.ninecraft.booket.feature.settings.component.WithdrawConfirmationBottomSheet
 import com.slack.circuit.codegen.annotations.CircuitInject
 import dagger.hilt.android.components.ActivityRetainedComponent
 import kotlinx.coroutines.launch
+import com.ninecraft.booket.core.designsystem.R as designR
 
 @OptIn(ExperimentalMaterial3Api::class)
 @CircuitInject(SettingsScreen::class, ActivityRetainedComponent::class)
@@ -62,6 +64,10 @@ internal fun SettingsUi(
         }.getOrNull() ?: "Unknown"
     }
 
+    val isUpdateAvailable = remember(appVersion, state.latestVersion) {
+        compareVersions(state.latestVersion, appVersion) > 0
+    }
+
     ReedScaffold(
         modifier = modifier
             .fillMaxSize()
@@ -88,7 +94,7 @@ internal fun SettingsUi(
                 },
                 action = {
                     Icon(
-                        imageVector = ImageVector.vectorResource(id = com.ninecraft.booket.core.designsystem.R.drawable.ic_chevron_right),
+                        imageVector = ImageVector.vectorResource(id = designR.drawable.ic_chevron_right),
                         contentDescription = "Right Chevron Icon",
                         tint = Color.Unspecified,
                     )
@@ -101,7 +107,7 @@ internal fun SettingsUi(
                 },
                 action = {
                     Icon(
-                        imageVector = ImageVector.vectorResource(id = com.ninecraft.booket.core.designsystem.R.drawable.ic_chevron_right),
+                        imageVector = ImageVector.vectorResource(id = designR.drawable.ic_chevron_right),
                         contentDescription = "Right Chevron Icon",
                         tint = Color.Unspecified,
                     )
@@ -114,21 +120,36 @@ internal fun SettingsUi(
                 },
                 action = {
                     Icon(
-                        imageVector = ImageVector.vectorResource(id = com.ninecraft.booket.core.designsystem.R.drawable.ic_chevron_right),
+                        imageVector = ImageVector.vectorResource(id = designR.drawable.ic_chevron_right),
                         contentDescription = "Right Chevron Icon",
                         tint = Color.Unspecified,
                     )
                 },
             )
             SettingItem(
                 title = stringResource(R.string.settings_app_version),
-                isClickable = false,
+                isClickable = isUpdateAvailable,
+                onItemClick = {
+                    state.eventSink(SettingsUiEvent.OnVersionClick)
+                },
                 action = {
-                    Text(
-                        text = appVersion,
-                        style = ReedTheme.typography.body1Medium,
-                        color = ReedTheme.colors.contentBrand,
-                    )
+                    Row(
+                        verticalAlignment = Alignment.CenterVertically,
+                    ) {
+                        Text(
+                            text = appVersion,
+                            style = ReedTheme.typography.body1Medium,
+                            color = ReedTheme.colors.contentBrand,
+                        )
+                        if (isUpdateAvailable) {
+                            Spacer(modifier = Modifier.width(ReedTheme.spacing.spacing2))
+                            Icon(
+                                imageVector = ImageVector.vectorResource(id = designR.drawable.ic_chevron_right),
+                                contentDescription = "Right Chevron Icon",
+                                tint = Color.Unspecified,
+                            )
+                        }
+                    }
                 },
                 description = {
                     Text(
@@ -199,46 +220,19 @@ internal fun SettingsUi(
                 },
             )
         }
-    }
-}
-
-@Composable
-private fun SettingItem(
-    title: String,
-    modifier: Modifier = Modifier,
-    isClickable: Boolean = true,
-    onItemClick: () -> Unit = {},
-    action: @Composable () -> Unit = {},
-    description: @Composable () -> Unit = {},
-) {
-    val combinedModifier = if (isClickable) {
-        modifier
-            .fillMaxWidth()
-            .clickableSingle { onItemClick() }
-    } else {
-        modifier.fillMaxWidth()
-    }
 
-    Column {
-        Row(
-            modifier = combinedModifier
-                .padding(
-                    horizontal = ReedTheme.spacing.spacing5,
-                    vertical = ReedTheme.spacing.spacing4,
-                ),
-            verticalAlignment = Alignment.CenterVertically,
-        ) {
-            Column(
-                modifier = Modifier.weight(1f),
-            ) {
-                Text(
-                    text = title,
-                    style = ReedTheme.typography.body1Medium,
-                    color = ReedTheme.colors.contentPrimary,
-                )
-                description()
-            }
-            action()
+        if (state.isOptionalUpdateDialogVisible) {
+            ReedDialog(
+                onDismissRequest = {
+                    state.eventSink(SettingsUiEvent.OnOptionalUpdateDialogDismiss)
+                },
+                title = stringResource(R.string.settings_optional_update_title),
+                description = stringResource(R.string.settings_optional_update_message),
+                confirmButtonText = stringResource(R.string.settings_optional_update_button_text),
+                onConfirmRequest = {
+                    state.eventSink(SettingsUiEvent.OnUpdateButtonClick)
+                },
+            )
         }
     }
 }

feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsUiState.kt

@@ -11,6 +11,8 @@ data class SettingsUiState(
     val isWithdrawBottomSheetVisible: Boolean = false,
     val isWithdrawConfirmed: Boolean = false,
     val latestVersion: String = "",
+    val isUpdateAvailable: Boolean = false,
+    val isOptionalUpdateDialogVisible: Boolean = false,
     val sideEffect: SettingsSideEffect? = null,
     val eventSink: (SettingsUiEvent) -> Unit,
 ) : CircuitUiState
@@ -21,6 +23,8 @@ sealed interface SettingsSideEffect {
         val message: String,
         private val key: String = UUID.randomUUID().toString(),
     ) : SettingsSideEffect
+
+    data object NavigateToPlayStore : SettingsSideEffect
 }
 
 sealed interface SettingsUiEvent : CircuitUiEvent {
@@ -35,4 +39,7 @@ sealed interface SettingsUiEvent : CircuitUiEvent {
     data object OnWithdrawConfirmationToggled : SettingsUiEvent
     data object Logout : SettingsUiEvent
     data object Withdraw : SettingsUiEvent
+    data object OnVersionClick : SettingsUiEvent
+    data object OnOptionalUpdateDialogDismiss : SettingsUiEvent
+    data object OnUpdateButtonClick : SettingsUiEvent
 }

feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/component/SettingItem.kt

@@ -0,0 +1,64 @@
+package com.ninecraft.booket.feature.settings.component
+
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import com.ninecraft.booket.core.common.extensions.clickableSingle
+import com.ninecraft.booket.core.designsystem.ComponentPreview
+import com.ninecraft.booket.core.designsystem.theme.ReedTheme
+
+@Composable
+internal fun SettingItem(
+    title: String,
+    modifier: Modifier = Modifier,
+    isClickable: Boolean = true,
+    onItemClick: () -> Unit = {},
+    action: @Composable () -> Unit = {},
+    description: @Composable () -> Unit = {},
+) {
+    val combinedModifier = if (isClickable) {
+        modifier
+            .fillMaxWidth()
+            .clickableSingle { onItemClick() }
+    } else {
+        modifier.fillMaxWidth()
+    }
+
+    Column {
+        Row(
+            modifier = combinedModifier
+                .padding(
+                    horizontal = ReedTheme.spacing.spacing5,
+                    vertical = ReedTheme.spacing.spacing4,
+                ),
+            verticalAlignment = Alignment.CenterVertically,
+        ) {
+            Column(
+                modifier = Modifier.weight(1f),
+            ) {
+                Text(
+                    text = title,
+                    style = ReedTheme.typography.body1Medium,
+                    color = ReedTheme.colors.contentPrimary,
+                )
+                description()
+            }
+            action()
+        }
+    }
+}
+
+@ComponentPreview
+@Composable
+private fun SettingItemPreview() {
+    ReedTheme {
+        SettingItem(
+            title = "로그아웃",
+        )
+    }
+}

feature/settings/src/main/res/values/strings.xml

@@ -15,4 +15,7 @@
     <string name="settings_withdraw_action">탈퇴하기</string>
     <string name="oss_licenses_title">오픈소스 라이선스</string>
     <string name="latest_version">최신 버전 %1$s</string>
+    <string name="settings_optional_update_title">최신 버전이 출시되었습니다.</string>
+    <string name="settings_optional_update_message">최적의 사용 환경을 위해 업데이트해주세요.</string>
+    <string name="settings_optional_update_button_text">업데이트하기</string>
 </resources>