1️⃣ IDE 설치하기
Kotlin Multiplatform을 사용하기 위해서는 Android Studio 또는 Intellij IDEA를 설치해주어야 합니다. 링크를 클릭하여 선호하는 IDE를 설치해주세요. 여기서 주의하셔야 할 것이 있는데, 버전을 확인하셔야 합니다.
| IDE 이름 | 버전 |
| Android Studio | Narwhal 2025.1.1 Canary 10 이상 |
| IntelliJ IDEA | 2025.1.1.1 이상 |
2️⃣ IDE에 KMP 플러그인 설치하기
에디터를 설치하셨다면 플러그인을 설치해야 합니다. 이곳을 통해 설치 페이지로 이동하실 수 있습니다. 한 가지 팁이 있다면 설치하신 IDE를 운영체제에서 실행하신 후 페이지를 계속 새로고침 해보세요. 그러면 실행 중인 해당 프로그램을 페이지에서 알아내서 Install to Intellij IDEA... 또는 Install to Android Studio...와 같이 우측 상단의 파란색 버튼이 바뀔 겁니다. 성공적으로 설치가 끝나셨다면 다음 단계로 넘어가주세요.
혹시 Windows나 Linux를 사용하시는 분께서는 아래 공식 문서에서 가져온 주의사항을 확인해주세요.
Windows와 Linux 운영체제에서 동작하는 IDE에서 KMP 플러그인은 아직 사용할 수 없습니다. 하지만 해당 운영체제에서 플러그인은 필수가 아닙니다.
그러나 저는 Windows를 사용하고 있지만 어떻게 위 방법으로 설치가 잘 되었습니다(2025.06.03). 만일 설치가 실패하신 분께서는 아래 플러그인을 수동으로 모두 다운받아주시면 됩니다.
| 플러그인 이름 및 다운로드 링크 |
| Android |
| Android Design Tools |
| Jetpack Compose |
| Native Debugging Support |
| Compose Multiplatform for Desktop IDE Support |
3️⃣ SDK 환경변수 설정하기
Android SDK을 설치 안 하셨다면 Android Studio를 실행하고 Tools > SDK Manager를 선택한 다음, SDK Platform에서 SDK를 선택 후 설치 경로를 확인하고 다운로드를 진행하시면 됩니다. 자세한 건 공식 문서를 참고해주세요. 사전에 SDK를 설치하신 분께서도 설치 위치는 다시 한번 확인해주세요.
해당 설치 경로를 ANDROID_HOME에 저장해야 합니다. 아래 명령어를 실행해주세요.
# CMD (Windows)
setx ANDROID_HOME "<path to the SDK>"# bash 또는 zsh
export ANDROID_HOME=~/Library/Android/sdk⚠️ 추가: iOS 앱을 만드려고 할 경우
KMP를 사용하여 iOS 앱을 만들 경우, KMP 개발 팀은 다음과 같은 주의사항을 말해주었습니다.
iOS 애플리케이션을 만들려면 macOS에서 Xcode가 설치된 환경이 필요합니다. IDE는 내부적으로 Xcode를 사용해서 iOS용 프레임워크를 빌드하게 됩니다.
Kotlin Multiplatform(KMP) 프로젝트를 시작하기 전에 Xcode를 한 번 실행해서 초기 설정을 완료해 주세요.
또한 Xcode가 업데이트될 때마다 수동으로 실행해서 최신 툴링을 설치해야 합니다. Kotlin Multiplatform용 IDE 플러그인은 사전 점검을 수행해서, Xcode가 올바른 상태가 아닐 경우 알림을 띄워줍니다.
KMP를 사용하기 위한 구축 환경 설정에 대해 다루었습니다. 곧 이어서 KMP 프로젝트를 어떻게 만드는지 알아보겠습니다.
감사합니다.
'KMP > Release' 카테고리의 다른 글
| [KMP] Kotlin Multiplatform 시작하기 : 프로젝트 생성(Windows, Linux) (1) | 2025.06.04 |
|---|