[Android][KMP] Android/IOS SplashScreen 적용해보기

윤찬·2025년 10월 1일

Android

목록 보기

33/37

이번 KMP 예제 프로젝트는 스플래시 스크린을 적용해보는 것이다.

SplashScreen이란?

iOS나 Android에서 Splash Screen(스플래시 화면)은 앱을 실행할 때 제일 먼저 잠깐 보여주는 화면. 사용자가 앱 아이콘을 눌러 앱을 시작하면 → 운영체제가 앱 프로세스를 띄우는 동안 → 흰 화면 대신 앱이 준비한 간단한 이미지/로고/배경을 보여주는 용도다.

이번에도 유튜브 강의와 블로그를 참고하려 만들었다.

Android SplashScreen

1.의존성 추가

먼저 안드로이드는 아래와 같은 의존성을 추가해야한다.

[versions]
#..
core-splashscreen = "1.0.1"

[libraries]
#...
core-splashscreen = { group = "androidx.core", name = "core-splashscreen", version.ref = "core-splashscreen" }

안드로이드 전용 라이브러리이기 때문에 androidMain에 의존성 추가

kotlin {
	//...
    
    sourceSets {
        androidMain.dependencies {
			//...
            implementation(libs.core.splashscreen)
        }
        //...
    }
}

이후 AndroidMain > res > values에 splash.xml 파일을 생성 후 아래와 같은 코드를 작성

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="Theme.App.Starting" parent="@android:style/Theme.Material.NoActionBar">
      	<!--배경 색상-->
        <item name="windowSplashScreenBackground">#202020</item>
      	<!--아이콘 로고 선택-->
        <item name="windowSplashScreenAnimatedIcon">@drawable/logo_squared</item>
      
      	<!--테마 선택 액션바가 없는 일반 Material 테마-->
        <item name="postSplashScreenTheme">@android:style/Theme.Material.NoActionBar</item>
    </style>
</resources>

2. MainActivity 코드 작성

이후 AndroidMain > kotlin > package > ActivityMain.kt에 아래와 같은 코드 추가

lass MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        enableEdgeToEdge()
         //3초 후에 스플래시 스크린이 사라지도록 구현
        var isChecking = true
        lifecycleScope.launch {
            delay(3000)
            isChecking = false
        }
        //스플래시 스크린 호출하고 setKeepOnScreenCondition은 스플래스 스크린이 사라질지 안사라질지 여부를 판다.
        installSplashScreen().apply {
        	// { } 에서 true면 유지, false면 스플래시 스크린이 사라짐
            setKeepOnScreenCondition { isChecking }
        }
        //...
    }
}

3. AndroidManifest.xml에 Splash.xml 등록

AndroidManifest.xml에 value폴더에 생성한 splash.xml 등록하기

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
	
  	<!--theme 부분 변경 원래 기본 값이 있을 것임-->
    <application       
        android:theme="@style/Theme.App.Starting">
        <!--...-->
    </application>

</manifest>

4. 실행 영상

위 영상처럼 스플래시 화면이 정상적으로 나오지만 문제점으로 화면 위에 ActionBar가 나오는 것을 볼 수 있다.

분명히 postSplashScreenTheme에는 NoActionBar가 적용하도록 했는데 실제로는 ActionBar가 나오지 않는 것을 알 수 있다.

이 문제를 해결하려고 열심히 삽질한 끝에 간단하게 해결할 수 있었따...(무려 1시간 시간낭비를 ㅠㅠ)

해결방법은 MainActivity.kt 파일에 installSplashScreen함수를 최상단에 놔두는 것이다.

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        var isChecking = true
        lifecycleScope.launch {
            delay(3000)
            isChecking = false
        }
        installSplashScreen().apply {
            setKeepOnScreenCondition { isChecking }
        }
        
        //아래 두 코드보다 위에 작성해야 ActionBar가 안나옴 ㅅㅂ..
        enableEdgeToEdge()
        super.onCreate(savedInstanceState)

        setContent {
            App()
        }
    }
}