로컬 리소스 환경 관리
언어나 테마 변경과 같이 사용자가 자신의 환경을 맞춤 설정할 수 있도록 인앱 설정을 관리해야 할 수 있습니다. 애플리케이션의 리소스 환경을 동적으로 업데이트하려면 애플리케이션에서 사용하는 다음과 같은 리소스 관련 설정을 구성할 수 있습니다:
로케일
각 플랫폼은 언어 및 지역과 같은 로케일 설정을 서로 다르게 처리합니다. 공통 공개 API가 구현되기 전까지 임시 해결책으로, 공유 코드에 공통 진입점을 정의해야 합니다. 그런 다음 플랫폼별 API를 사용하여 각 플랫폼에 해당하는 선언을 제공합니다:
- Android:
context.resources.configuration.locale - iOS:
NSLocale.preferredLanguages - 데스크톱:
Locale.getDefault() - 웹:
window.navigator.languages
공통 소스 세트(common source set)에서
expect키워드를 사용하여 예상되는LocalAppLocale객체를 정의합니다. 로케일은es,es-ES,zh-Hans와 같은 BCP 47 언어 태그로 지정됩니다. 시스템 로케일을 사용하려면customAppLocale을null로 설정합니다:kotlinvar customAppLocale by mutableStateOf<String?>(null) expect object LocalAppLocale { val current: String @Composable get @Composable infix fun provides(value: String?): ProvidedValue<*> } @Composable fun AppEnvironment(content: @Composable () -> Unit) { CompositionLocalProvider( LocalAppLocale provides customAppLocale, ) { key(customAppLocale) { content() } } }Android 소스 세트에
context.resources.configuration.locale을 사용하는actual구현을 추가합니다:kotlinactual object LocalAppLocale { private var default: Locale? = null actual val current: String @Composable get() = Locale.getDefault().toString() @Composable actual infix fun provides(value: String?): ProvidedValue<*> { val configuration = LocalConfiguration.current if (default == null) { default = Locale.getDefault() } val new = when(value) { null -> default!! else -> Locale(value) } Locale.setDefault(new) configuration.setLocale(new) val resources = LocalContext.current.resources resources.updateConfiguration(configuration, resources.displayMetrics) return LocalConfiguration.provides(configuration) } }iOS 소스 세트에
NSLocale.preferredLanguages를 수정하는actual구현을 추가합니다:kotlinactual object LocalAppLocale { private const val LANG_KEY = "AppleLanguages" private val default = NSLocale.preferredLanguages.first() as String private val LocalAppLocale = staticCompositionLocalOf { default } actual val current: String @Composable get() = LocalAppLocale.current @Composable actual infix fun provides(value: String?): ProvidedValue<*> { val new = value ?: default if (value == null) { NSUserDefaults.standardUserDefaults.removeObjectForKey(LANG_KEY) } else { NSUserDefaults.standardUserDefaults.setObject(arrayListOf(new), LANG_KEY) } return LocalAppLocale.provides(new) } }데스크톱 소스 세트에
Locale.getDefault()를 사용하여 JVM의 기본 로케일을 업데이트하는actual구현을 추가합니다:kotlinactual object LocalAppLocale { private var default: Locale? = null private val LocalAppLocale = staticCompositionLocalOf { Locale.getDefault().toString() } actual val current: String @Composable get() = LocalAppLocale.current @Composable actual infix fun provides(value: String?): ProvidedValue<*> { if (default == null) { default = Locale.getDefault() } val new = when(value) { null -> default!! else -> Locale(value) } Locale.setDefault(new) return LocalAppLocale.provides(new.toString()) } }웹 플랫폼의 경우
window.navigator.languages프로퍼티의 읽기 전용 제한을 우회하여 커스텀 로케일 로직을 도입합니다:kotlinactual object LocalAppLocale { private val LocalAppLocale = staticCompositionLocalOf { Locale.current } actual val current: String @Composable get() = LocalAppLocale.current.toString() @Composable actual infix fun provides(value: String?): ProvidedValue<*> { updateCustomLocale(value?.replace('_', '-')) return LocalAppLocale.provides(Locale.current) } } @OptIn(ExperimentalWasmJsInterop::class) private fun updateCustomLocale(value: String?) { js( """ if (window.__customLocale !== value) { window.__customLocale = value; window.dispatchEvent(new Event("languagechange")); } """ ) }그런 다음 브라우저의
index.html에서 애플리케이션 스크립트를 로드하기 전에 다음 코드를 추가합니다:html<html lang="en"> <head> <meta charset="UTF-8"> ... <script> var currentLanguagesImplementation = Object.getOwnPropertyDescriptor(Navigator.prototype, "languages"); var newLanguagesImplementation = Object.assign({}, currentLanguagesImplementation, { get: function () { if (window.__customLocale) { return [window.__customLocale]; } else { return currentLanguagesImplementation.get.apply(this); } } }); Object.defineProperty(Navigator.prototype, "languages", newLanguagesImplementation) </script> <script src="skiko.js"></script> ... </head> <body></body> <script src="webApp.js"></script> </html>
테마
Compose Multiplatform은 isSystemInDarkTheme()을 통해 현재 테마를 정의합니다. 테마는 플랫폼마다 다르게 처리됩니다:
- Android는 다음과 같은 비트 연산을 통해 테마를 정의합니다:kotlin
Resources.getConfiguration().uiMode and Configuration.UI_MODE_NIGHT_MASK - iOS, 데스크톱, 웹 플랫폼은
LocalSystemTheme.current를 사용합니다.
공통 공개 API가 구현되기 전까지 임시 해결책으로, expect-actual 메커니즘을 사용하여 이러한 차이를 해결하고 플랫폼별 테마 맞춤 설정을 관리할 수 있습니다:
공통 코드에서
expect키워드를 사용하여 예상되는LocalAppTheme객체를 정의합니다:kotlinvar customAppThemeIsDark by mutableStateOf<Boolean?>(null) expect object LocalAppTheme { val current: Boolean @Composable get @Composable infix fun provides(value: Boolean?): ProvidedValue<*> } @Composable fun AppEnvironment(content: @Composable () -> Unit) { CompositionLocalProvider( LocalAppTheme provides customAppThemeIsDark, ) { key(customAppThemeIsDark) { content() } } }Android 코드에
LocalConfigurationAPI를 사용하는actual구현을 추가합니다:kotlinactual object LocalAppTheme { actual val current: Boolean @Composable get() = (LocalConfiguration.current.uiMode and UI_MODE_NIGHT_MASK) == UI_MODE_NIGHT_YES @Composable actual infix fun provides(value: Boolean?): ProvidedValue<*> { val new = if (value == null) { LocalConfiguration.current } else { Configuration(LocalConfiguration.current).apply { uiMode = when (value) { true -> (uiMode and UI_MODE_NIGHT_MASK.inv()) or UI_MODE_NIGHT_YES false -> (uiMode and UI_MODE_NIGHT_MASK.inv()) or UI_MODE_NIGHT_NO } } } return LocalConfiguration.provides(new) } }iOS, 데스크톱, 웹 플랫폼에서는
LocalSystemTheme을 직접 변경할 수 있습니다:kotlin@OptIn(InternalComposeUiApi::class) actual object LocalAppTheme { actual val current: Boolean @Composable get() = LocalSystemTheme.current == SystemTheme.Dark @Composable actual infix fun provides(value: Boolean?): ProvidedValue<*> { val new = when(value) { true -> SystemTheme.Dark false -> SystemTheme.Light null -> LocalSystemTheme.current } return LocalSystemTheme.provides(new) } }
밀도
애플리케이션의 해상도 Density를 변경하려면 모든 플랫폼에서 지원되는 공통 LocalDensity API를 사용할 수 있습니다:
var customAppDensity by mutableStateOf<Density?>(null)
object LocalAppDensity {
val current: Density
@Composable get() = LocalDensity.current
@Composable
infix fun provides(value: Density?): ProvidedValue<*> {
val new = value ?: LocalDensity.current
return LocalDensity.provides(new)
}
}
@Composable
fun AppEnvironment(content: @Composable () -> Unit) {
CompositionLocalProvider(
LocalAppDensity provides customAppDensity,
) {
key(customAppDensity) {
content()
}
}
}다음 단계
- 리소스 한정자(qualifier)에 대해 자세히 알아보세요.
- 리소스 현지화 방법에 대해 알아보세요.
