
0️⃣ 시작하기 앞서
Kotlin Multiplatform(KMP) 개발을 위한 IDE 설정 이후 진행해야 하는 단계입니다. 아직 설정하지 않으셨다면 아래 글을 참고해주세요. IDE 설정을 완료하셨다면 계속 읽어주시면 감사하겠습니다.
[KMP] Kotlin Multiplatform 시작하기 : 개발 환경 구축의 모든 것
1️⃣ IDE 설치하기Kotlin Multiplatform을 사용하기 위해서는 Android Studio 또는 Intellij IDEA를 설치해주어야 합니다. 링크를 클릭하여 선호하는 IDE를 설치해주세요. 여기서 주의하셔야 할 것이 있는데,
wadmadang.tistory.com
1️⃣ KMP Wizard에서 프로젝트 생성하기
KMP 개발팀은 Windows와 Linux 운영체제에서 작업하는 개발자에게 아래 프로젝트 생성 방법을 설명하고 있습니다. 먼저 KMP Wizard에 접속해주세요.
Kotlin Multiplatform Wizard | JetBrains
kmp.jetbrains.com
그럼 아래와 같은 화면이 나타납니다. 차례대로 어떤 설정인지 살펴보겠습니다.

- 프로젝트 이름: KMP 프로젝트에서 사용할 이름을 설정합니다.
- 프로젝트 ID: KMP 프로젝트에서 사용할 패키지 이름(ID)를 설정합니다.
그리고 그 아래로 여러 체크박스 아이템이 있는데, 해당 기능을 넣을지 선택하는 부분이라고 생각하시면 됩니다. 예를 들어 Android와 함께 Web에서 작동하는 KMP 프로젝트를 만들고 싶다면 두 개를 선택하시면 됩니다.
여기서 주의해야할 부분은 바로 iOS입니다. Share UI를 선택하면 Android와 iOS 모두 Kotlin으로 작성한 동일한 UI 코드를 사용할 수 있지만, Do not share UI를 선택하면 UI 코드를 공유하지 않고 SwiftUI를 사용하여 iOS의 UI를 직접 구현하게 됩니다.
설정을 완료하셨다면 DOWNLOAD 버튼을 눌러 프로젝트 압축파일을 다운받으실 수 있습니다. 압축을 풀고 원하시는 위치에 프로젝트 폴더를 옮겨주세요.
2️⃣ IDE에서 프로젝트 열기
KMP는 Android Studio 또는 Intellij IDEA 두 IDE 중 하나를 사용할 것을 권하고 있습니다. 저는 IDEA로 프로젝트를 열도록 하겠습니다.

처음 열면 Gradle이 실행되면서 초기 개발 환경 구성 설정을 도와줍니다. (조금 오랜) 시간이 지나면 오른쪽 아래 바쁘게 돌아가던 Gradle이 멈추고 Build가 완성되었다고 나오면서 위 사진과 같이 성공적으로 프로젝트를 열 수 있게 됩니다.
3️⃣ 앱 실행하기

오른쪽 위 툴바에서 앱을 실행시킬 수 있습니다. composeApp을 제 휴대폰에 실행시켜 보겠습니다. 저는 Android 개발자 옵션에서 USB 디버깅을 활성화시킨 후 노트북과 유선으로 연결해서 앱을 실행하고 있습니다.

성공적으로 앱을 실행했습니다!
4️⃣ 오류 해결하기
앱이 잘 실행됐는데 몇 가지 오류가 발생하여 이걸 해결해보도록 하겠습니다.
1️⃣ local.properties의 SDK 경로 문제

The following problems were found when resolving the SDK location:
Where: sdk.dir property in local.properties file. Problem: Set with empty value
해당 오류는 말 그대로 local.properties 파일에 SDK 경로를 설정하지 않아서 발생한 문제입니다. SDK 설치 위치를 넣어주세요.
# local.properties
sdk.dir=E\:\\Android\\Sdk
2️⃣ Kotlin/Native target들을 빌드할 수 없다는 경고

The following Kotlin/Native targets cannot be built on this machine and are disabled:
iosArm64, iosSimulatorArm64, iosX64
To hide this message, add 'kotlin.native.ignoreDisabledTargets=true' to the Gradle properties.
해당 문제는 Windows와 Linux 환경에서 작업하면 iOS와 관련된 native 앱을 빌드할 수 없다는 뜻입니다. 경고 문구인 만큼 무시하셔도 괜찮지만 해결하고 싶으시다면 gradle.properties 파일에 아래 문장을 추가하시면 됩니다.
# gradle.properties
kotlin.native.ignoreDisabledTargets=true
혹시 위 문장을 넣은 후 오른쪽 위 툴바에 앱 실행 버튼이 비활성화 됐다면 아래 방법을 시도해보세요:
- File > Repair IDE
- Build > Sync Project with Gradle Files
- Build > Rebuild Project
- File > Invalidate Caches... > Invalidate and Restart
위 네 가지 방법은 앱 개발 대부분의 오류를 해결할 수 있으니 앞으로도 많이 참고해주시면 좋겠습니다.
이번 글에서는 KMP 프로젝트를 생성하는 방법과 IDE에서 실행하는 방법을 다뤄봤습니다.
감사합니다.
'KMP > Release' 카테고리의 다른 글
[KMP] Kotlin Multiplatform 시작하기 : 개발 환경 구축의 모든 것 (1) | 2025.06.03 |
---|