Kotlin Multiplatform 을 시작하기 위해서는
1. 필요한 프로그램
1. Android Studio 설치
2. JDK
3. Xcode 설치
4. Kotlin Multiplatform 플러그인 설치 (Android Studio)
을 설치해줘야 합니다.
(아래 링크 참고)
Set up an environment | Kotlin Multiplatform Development
www.jetbrains.com
2. kdoctor 설치
kdoctor을 설치하면 Android Studio, Xcode 등이 잘 설치가 되어있는지 알 수 있습니다.
1) kdoctor 설치 명령어
(homebrew 는 미리 설치가 되어있어야 합니다.)
brew install kdoctor
2) kdoctor가 설치가 됐는지 확인
kdoctor
위 이미지를 보면 빨갛게 X표시로 되있는 부분은 반드시 해결을 해야하는 부분입니다.
노랑색으로 !느낌표로 되있는 부분은 반드시 해결을 해야하는건 아니지만 저는 깔끔하게 해결하고 넘어가도록 하겠습니다.
위 내용들이 이해가 어렵게 보이기도 하지만 한줄 한줄 천천히 읽어보면 해결방법을 다 제시해주고 있기 때문에 하라는 대로 진행하고 완료하겠습니다.
3. 안드로이드 스튜디오
안드로이드 스튜디오는 설치하고 Kotlin Multiplatform Plugin만 설치하면 해결이 되지만
안드로이드 최신버전 (Ladybug | 2024.02.01) 을 설치하니까 kdoctor가 인지를 하지 못했습니다.
이전 버전인 코알라 버전으로 다시 설치하니까 바로 해결되었습니다.
4. jdk 설치
1) jdk 17 설치
brew install openjdk@17
2) 설치가 완료되면 OpenJDK 17의 위치를 PATH에 추가
sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk
3) 설치가 잘되었는지 확인
java -version
5. xcode 해결
마지막줄에 보면
이 부분에 맞게 Xcode Settings에 들어와서 Command Line Tools 에서 설치된 Xcode 버전을 선택해주면 해결됩니다.
(Xcode 는 이미 설치된 상태)
6. cocoapods
1) CocoaPods not found
: Cocoapods 가 설치되지 않아서 발생합니다. Cocoapods을 설치해줍니다.
brew install cocoapods
2) CocoaPods requires your terminal to be using UTF-8 encoding
: Cocoapods 을 설치하고 문제가 발생하면 터미널 encoding을 UTF-8로 설정하라는 의미입니다.
해결
~/.zshrc 파일에 export LC_ALL=en_US.UTF-8 을 추가합니다
source ~/.zshrc 으로 적용시켜 줍니다.
3) System ruby is currently used CocoaPods is not ~~~~
: 맥북이 Apple Chip 인 경우 System Ruby와 호환이 맞지 않아서 그렇습니다.
해결
ruby를 설치합니다.
brew install ruby
~/.zshrc 파일에 ruby의 경로를 설정해줍니다.
경로 :
export PATH=/opt/homebrew/opt/ruby/bin:/opt/homebrew/lib/ruby/gems/3.3.6/bin:$PATH
"3.3.6" 이 버전 숫자는 설치된 ruby 버전을 입력해줍니다.
ruby -v
7 . 마무리
위 내용들을 다 마무리하고 kdoctor 명령어를 입력하고
아래와 같이 다 완료되면 코틀린 멀티플랫폼 시작할 준비가 끝났습니다.
'Kotlin Multiplatform' 카테고리의 다른 글
| [Kotlin Multiplatform] 2. KMP 프로젝트 생성 (0) | 2025.02.02 |
|---|