001. (KMM Mobile) 1. 개발 환경 설정

1. 개발 환경 설정

KMP는 Kotlin Multiplatform의 약자로, 하나의 코드로 여러 플랫폼을 타겟으로 제품을 빌드할 수 있게 해준다.

여기서는 Android와 iOS를 동시에 개발할 수 있도록 개발 환경 설정을 해보자.

다만, Window 기반 기기도 개발 환경을 설정할 수는 있지만, iOS 빌드를 위해선 macOS 기기가 필수적으로 요구된다.

필자는 macOS만 사용중이므로 해당 환경을 기준으로 작성하였다.

1.1. Android Studio 설치

Android 개발 환경 구축을 위해 Android Studio를 설치한다.

설치 후 실행한 Android Studio에서 Kotlin Multiplatform Mobile 플러그인을 설치한다.

참고 Android Studio 다운로드

1.2. Xcode 설치

iOS 개발 환경 구축을 위해 Xcode를 설치한다.

참고 Xcode - App Store

1.3. Homebrew 설치

Homebrew는 Ruby 언어로 개발된 macOS용 패키지 관리 도구이다.

Homebrew를 이용하면 필요한 파일을 터미널에서 바로바로 설치할 수 있다.

Homebrew 또한 아래와 같이 CLI 형태로 터미널에서 바로 설치를 진행할 수 있다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치가 된 상태라면 아래와 같이 출력된다.

참고 brew 홈페이지

1.4. KDoctor 설치

KDoctor는 JetBrains사에서 공식적으로 제공하는 Kotlin Multiplatform을 위한 도구이다.

현재 운영체제나 JDK, Android Studio, Xcode, CocoaPods 등의 상태를 점검해주는 역할을 한다.

설치는 brew를 이용해 간단히 진행할 수 있다.

brew install kdoctor

Xcode 설치 후 실행한 적이 없을 경우 약관 동의를 안 받았기에, Xcode 관련 라이센스가 없다고 경고 메시지가 노출된다.

Error: You have not agreed to the Xcode license. Please resolve this by running:
  sudo xcodebuild -license accept

Xcode를 실행하여 위의 약관에 동의하면 정상적으로 설치를 진행할 수 있다.

설치후 kdoctor를 명령어로 입력하면 아래와 같이 무엇이 미비되어있는 지 점검해준다.

참고 KDoctor github

1.5. Cocoapods 설치

kdoctor 명령어 수행 후 미비된 것으로 나온 cocoapods르 설치해보자.

cocoapods은 ruby 2.7.2 버전과 호환되므로, 현재 설치된 ruby의 버전을 먼저 확인해야한다.

ruby -v

위의 명령어를 실행하면 현재 설치된 ruby의 버전을 출력해준다.

현재 설치된 ruby는 v2.6.10 이므로 v2.7.6를 설치해주자.

ruby는 아래와 같이 특정 버전을 설치할 수 있다.

brew install rbenv # rbenv 설치
rbenv install 2.7.6 # ruby 2.7.6 설치
rbenv global 2.7.6 # 전역 설정
rbenv rehash # 변경사항 반영

다시 kdoctor를 수행해보자.

이제 KMM을 위한 개발 환경이 모두 마무리 되었다.