[KMP] Kotlin Multiplatform Shared Module 을 생성 할 수 없는 문제 해결

이지훈·2025년 1월 20일
1

KMP

목록 보기
4/6

서두

기존의 Android 프로젝트를 Compose Multiplatform 으로 migration 하기 시작하면서 발생했던 문제와 그 해결 방법을 공유해보고자 한다.

본론

Compose Multiplatform 형태로 프로젝트를 구성하기 위해 composeApp 모듈을 생성하려고 했다.
이미 이전에 Koltin Multiplatform plugin 을 설치해두었기 때문에, New Project Wizard 에 Kotlin Multiplatform app/library 프로젝트를 생성할 수 있는 것을 확인하였다.

몰랐는데 Circuit 이랑 Koin 같이 쓸 수 있더라!
https://doitddo.tistory.com/177

문제 발생

전엔 잘만 보였던 KMP Shared Module 이 생성할 수 있는 모듈 목록에 보이지 않았다.

Kotlin Multiplatform plugin 이 설치가 되어있는데, 뭐가 문제인가? 혹시 추가적으로 설치해야할 plugin 이 있는지 구글링 해보았지만, 별도의 plugin 을 설치할 필요는 없어보였다.

문제 해결

질문 팁. 현재의 문제 상황을 영어로 옮긴 후 구글에 검색해보자.

Koltin Multiplatform Shared Module 이 보이지 않는다.
-> Kotlin Multiplatform Shared Module is not showing

'발견'

https://youtrack.jetbrains.com/issue/KT-72727/KMP-Shared-Module-option-is-missing-in-AS-Ladybug-2024.2.1-Patch-2

이번엔 내 문제가 아니고 Android Studio 의 문제였다.
덧글로 작성해주신 해결책들을 하나씩 적용해보도록 하자.

동작하지 않으면 -> is not working ㅇㅇ
gpt 의 시대가 도래했지만, StackOverflow 를 사용하던 시절에 단련해두었던 검색 방법이 아직 유효해서 다행이다.

1) settings 내에 experimental Multipatform 활성화

2) Android Studio 최신 버전으로 업데이트

해당 Ladybug-2024.2.1-Patch-2 버전에서 발생한 문제이므로, JetBrains Toolbox 를 통해 새로운 버전이 나왔는지 확인 후, 업데이트 해주자.

3) Plugin 하위 버전 설치

https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform

위 링크를 클릭하면, kotlin multiplatform plugin 의 이전 버전을 다운 받을 수 있다.
현재 설치되어있는 LadyBug 버전 0.8.3(242)-5 버전을 Android Studio 내에서 삭제하고, 0.8.3(242)-4 버전을 다운받아 주자.


다음과 같이 KmmPlugin.zip 파일이 다운받아지는데, 더블 클릭하여도 압축이 풀리지 않는다.

위에 Jetbrains marketplace 에서 plugin 을 다운받을 때 나온 안내 문구처럼 톱니바귀 모양을 눌러 Install Plugin from Disk 를 클릭한다. 다운받은 zip 파일을 선택하고, IDE 를 재시작하면 다운받은 버전이 적용된다.

결과


New Module 을 통해 생성 가능한 모듈 목록을 확인했을 때, 보이지 않았던 Kotlin Multiplatform Shared Module 이 추가된 것을 확인할 수 있다.

이제 본격적으로 Compose Multiplatform 으로 migration 을 시작하면 될듯 하다!

위 과정을 통해서도 해결이 되지 않거나, Kotlin Multiplatform Shared Module 을 클릭해도, 제대로 동작하지 않는다면, Android Studio canary version(Meerkat) 과 그에 맞는 plugin 버전을 설치하여 문제가 없는지 확인해보도록 하자. 시작부터 쉽지 않다,, 지지말자!

reference)
https://youtrack.jetbrains.com/issue/KT-72727/KMP-Shared-Module-option-is-missing-in-AS-Ladybug-2024.2.1-Patch-2

profile
실력은 고통의 총합이다. Android Developer

0개의 댓글

관련 채용 정보