KMM（Kotlin Multiplatform Mobile）の環境構築とチュートリアル

Takashi Sawada

KMM（Kotlin Multiplatform Mobile）を導入してみよう、ということで、環境構築とチュートリアルをやってみたいと思います。

Takashi Sawada

こちらを参考にやっていく。

Takashi Sawada

まずは環境構築から。

なお、手元の環境は以下の通り。

macOS Ventura 13.3.1
M1 MacBook Air

Takashi Sawada

必要なのは以下のもの。

Android Studio
Xcode
JDK
Kotlin Multiplatform Mobile Plugin
Kotlin plugin

Takashi Sawada

Android Studio

https://developer.android.com/studio

どのバージョンをインストールするかかなり迷う。
だが、それも後述するXcodeとの兼ね合いな気もする。

今回は「Android Studio Electric Eel」の最新パッチが当たっているものを入れる。

ここから過去のバージョンをダウンロードできるみたい。

Takashi Sawada

Xcode

Xcodeも同様に最新版をダウンロードすると、Android Studioの兼ね合いもあるので、ちょっと恐いので、過去バージョンが無難かと思われる。

今回はXcode 14.2をベースにやってみる。

Takashi Sawada

JDK

これについてはいったん後回し。
組み込み済みのものでいけないかを検討。

Takashi Sawada

Kotlin Multiplatform Mobile Plugin

Android Studioのプラグインなので、Android Studio経由でインストールする。

Android Studioを起動して、メニューバーにあるSetting… > Pluginsを選び、検索窓にKotlin Multiplatform Mobileと入力すると出てくる。

もしくはAndroid Studioを起動したときに表示される画面のPluginsの項目からもインストールできるようだった。

Takashi Sawada

Kotlin plugin

Kotlinの最新版にアップデートするように書かれてあった。

Android Studioをダウンロードした時点で最新版のものが入っているっぽいので、今回は特に作業は行わない。

Takashi Sawada

まずはプロジェクトの作成をする

Takashi Sawada

専用のプロジェクトのテンプレート（Kotlin Multiplatform App）があった。
たぶん、プラグインを入れたからだと思われる。

Takashi Sawada

プロジェクトの設定。
この部分はいったんこれで初期設定のまま。

Minimum SDKは今回はチュートリアルなので、適当に設定した。

Takashi Sawada

プラットフォームごとの設定。
こちらもきちんと設定をしないといけないかもしれないが、今回はデフォルトの設定をそのまま適用させることに。

Takashi Sawada

プロジェクトができあがった。

Takashi Sawada

話は戻って、JDKの環境構築。
プロジェクトを作って、Gradleの項目を再度見たところ、ちゃんとインストールされているっぽかった。

Takashi Sawada

Andtoid Studio のターミナルでJavaのバージョンを確認

% java -version
The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

きちんと読み込まれていない模様

Takashi Sawada

Mac限定のようだけど、kdoctorというチェックツールがある模様。
これをクリアすれば、使えるという感じになりそう。

 % kdoctor 
Environment diagnose (to see all details, use -v option):
[✓] Operation System
[✖] Java
  ✖ Java not found
    Get JDK from https://www.oracle.com/java/technologies/javase-downloads.html
[✓] Android Studio
[✓] Xcode
[✖] Cocoapods
  ✖ System ruby is currently used
    CocoaPods is not compatible with system ruby installation on Apple M1 computers.
    Please install ruby via Homebrew, rvm, rbenv or other tool and make it default
    Detailed information: https://stackoverflow.com/questions/64901180/how-to-run-cocoapods-on-apple-silicon-m1/66556339#66556339
  ✖ CocoaPods requires your terminal to be using UTF-8 encoding.
    Consider adding the following to ~/.zprofile
    export LANG=en_US.UTF-8
    export LC_ALL=en_US.UTF-8

Conclusion:
  ✖ KDoctor has diagnosed one or more problems while checking your environment.
    Please check the output for problem description and possible solutions.

Takashi Sawada

とりあえず~/.zshrcに以下を追加してみることに。
kdoctorで表示されたCocoaPodsのものも追加してみる。

# JDK
export JAVA_HOME=/Applications/Android\ Studio.app/Contents/jbr/Contents/Home/

# CocoaPods
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

このあたりを参考に。

追加したらこれを実行。

% source ~/.zshrc

そして、Android Studioを再起動する。

Takashi Sawada

再度kdoctorを実行したら、以下の表示に変わった。

 % kdoctor
Environment diagnose (to see all details, use -v option):
[✓] Operation System
[✓] Java
[✓] Android Studio
[✓] Xcode
[✖] Cocoapods
  ✖ System ruby is currently used
    CocoaPods is not compatible with system ruby installation on Apple M1 computers.
    Please install ruby via Homebrew, rvm, rbenv or other tool and make it default
    Detailed information: https://stackoverflow.com/questions/64901180/how-to-run-cocoapods-on-apple-silicon-m1/66556339#66556339

Conclusion:
  ✖ KDoctor has diagnosed one or more problems while checking your environment.
    Please check the output for problem description and possible solutions.