Kotlin Multiplatform 最新安定版とIDE設定・Gradle構築ガイド (2024年4月)

2026年5月29日

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

エンジニアの世界では、「いつでも動ける状態を作っておけ」とよく言われます。
技術やポートフォリオがあっても、自分に合う案件情報を日常的に見れていないと、いざ動こうと思った時に比較や判断が難しくなってしまいます。
普段から案件情報が集まる環境を作っておくと、良い案件が出た時にすぐ動きやすくなりますよ。
筆者自身も、メガベンチャー勤務時代に年収1,500万円を超えた経験があります。振り返ると、技術だけでなく「どんな案件や働き方があるか」を日頃から見ていたことが、キャリアの選択肢を広げるきっかけになりました。
このブログを読んでくれた方に感謝を込めて、実際に使っている情報収集サービスを紹介します。

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

Contents

1 📅 記事の最終更新日とバージョン確認方針
2 1. Kotlin Multiplatform の最新安定版を取得する手順
3 2. 推奨 IDE と設定の簡潔化
- 3.1 なぜ IntelliJ IDEA / Android Studio が必要か
- 3.2 インストールとプラグインの統合手順
4 3. KMP ウィザードによるプロジェクト作成とディレクトリ構造
- 4.1 プロジェクト生成フロー（概要）
- 4.2 生成ディレクトリの実体例
5 4. Gradle 設定 – Kotlin Multiplatform プラグインと依存関係の最新化
- 5.1 基本的な build.gradle.kts（KMP 推奨構成）
  - 5.1.1 バージョンチェック手順（コードブロック内のバージョンを最新に保つ）
- 5.2 完全なターゲット宣言と依存関係例
6 5. 共通ロジックと Platform‑Specific 実装のベストプラクティス
- 6.1 「どこに何を書くか」の指針（KMP ガイド参照）
  - 6.1.1 具体的なコード例
- 6.2 UI 側から呼び出す例
7 6. ビルド・デバッグ手順と Xcode 連携
- 7.1 Android 側ビルドフロー
- 7.2 iOS 側ビルドフロー（XCFramework 利用）
8 7. まとめ

スポンサードリンク

📅 記事の最終更新日とバージョン確認方針

最終更新: 2026‑05‑29

本記事は「Kotlin Multiplatform（KMP）環境構築」に関わる情報が、時間経過とともに古くなるリスクを考慮し、バージョンの確認手順と公式出典 を随時追記できる形で作成しています。本文中で触れるツール・ライブラリの最新版は、以下の方法でローカルでも簡単に取得できます。

確認対象	推奨チェック方法
Kotlin 本体 & KMP プラグイン	公式サイト「Release notes」ページ（https://kotlinlang.org/docs/releases.html）を定期的に閲覧、または `curl -s https://api.github.com/repos/JetBrains/kotlin/tags \\| jq '.[0].name'` で最新タグ取得
Android Studio / IntelliJ IDEA	IDE の「Help → Check for Updates」から最新版を確認。公式ダウンロードページ（https://developer.android.com/studio）でもリリースノートが公開されます
Gradle & プラグイン	`./gradlew --version`、`./gradlew dependencyUpdates -Drevision=release` （Gradle Versions Plugin 使用）
ライブラリ（kotlinx.* など）	Maven Central の検索結果（例: https://search.maven.org/artifact/org.jetbrains.kotlinx/kotlinx-coroutines-core）や `./gradlew :shared:dependencies` で実際に解決されているバージョンを確認

1. Kotlin Multiplatform の最新安定版を取得する手順

KMP を利用する上で最も重要なのは 「使用している Kotlin バージョンが公式の最新版」 かどうかです。2024 年 3 月 7 日にリリースされた Kotlin 1.9.20 が執筆時点（2024‑04）での最新安定版でした。この情報は JetBrains の公式ブログ記事で正式に発表されています。

📖 公式リリースノート: Kotlin 1.9.20 released – Kotlin Blog (2024‑03‑07)
📦 GitHub タグ一覧（自動取得例）: curl -s https://api.github.com/repos/JetBrains/kotlin/tags \| jq '.[0].name' → "v1.9.20"

ポイント：Kotlin のバージョンは IDE に同梱されるだけでなく、Gradle ビルドスクリプトでも明示的に指定します。バージョンが古くなると、KMP プラグインや kotlinx 系ライブラリとの互換性が失われることがあります。

2. 推奨 IDE と設定の簡潔化

なぜ IntelliJ IDEA / Android Studio が必要か

KMP 開発は コード補完・マルチターゲットビルド をフルサポートする IDE が不可欠です。公式が推奨する環境は以下のとおりです。

IntelliJ IDEA Ultimate（2024.2 以降）
Android Studio Flamingo (2022.2.1) 以上 – 将来的に新しいコードネームへ移行する可能性があるため、常に「最新安定版」かどうかを IDE のアップデート機能で確認してください。

インストールとプラグインの統合手順

手順	操作内容
1️⃣ ダウンロード	https://developer.android.com/kotlin/multiplatform/setup にアクセスし、OS に合わせて IntelliJ IDEA Community / Ultimate または Android Studio を取得
2️⃣ JDK 設定	インストール時に「OpenJDK 17」(64‑bit) が自動でセットされます。手動で変更する場合は `File > Project Structure > SDKs` から確認
3️⃣ 必要プラグインの有効化	Kotlin と Gradle Kotlin DSL はデフォルトで同梱されていますが、Marketplace で最新版に更新しておくことを推奨します
4️⃣ コードスタイル（任意）	`Preferences > Editor > Code Style > Kotlin` → インデント幅 4、行末セミコロンなし、Import の自動整理を有効化

注：IDE 設定とプラグイン導入は同一の手順に統合したため、以前記事で別々に記載していた冗長部分は削除しました。

3. KMP ウィザードによるプロジェクト作成とディレクトリ構造

プロジェクト生成フロー（概要）

KMP 用テンプレートを使うことで、共通コードと各プラットフォーム固有コードのフォルダが自動生成されます。以下は手順の概略です。

IDE の「New Project」 → 「Kotlin Multiplatform」テンプレートを選択
プロジェクト名・保存場所を入力し Next
対象プラットフォームに Android、iOS (iosArm64, iosX64)、JVM、JavaScript をチェック（不要なものは除外可）
「Finish」すると build.gradle.kts とサンプルコードが生成されます

生成ディレクトリの実体例

src/
├─ commonMain/kotlin/          # 共通ロジック
│   └─ com/example/shared/
├─ androidMain/kotlin/         # Android 用実装
│   └─ com/example/android/
├─ iosMain/kotlin/             # iOS 用実装（expect / actual）
│   └─ com/example/ios/
├─ jvmMain/kotlin/             # JVM デスクトップ／サーバー向け
└─ jsMain/kotlin/              # JavaScript (ブラウザ/Node) 用

src/

├─ commonMain/kotlin/ # 共通ロジック

│ └─ com/example/shared/

├─ androidMain/kotlin/ # Android 用実装

│ └─ com/example/android/

├─ iosMain/kotlin/ # iOS 用実装（expect / actual）

│ └─ com/example/ios/

├─ jvmMain/kotlin/ # JVM デスクトップ／サーバー向け

└─ jsMain/kotlin/ # JavaScript (ブラウザ/Node) 用

ポイント：commonMain にビジネスロジックやデータモデルを置き、プラットフォーム固有の API は expect / actual で分離します。不要なフォルダは削除しても構いませんが、Gradle の sourceSets から対象ターゲットを外すことを忘れないでください。

4. Gradle 設定 – Kotlin Multiplatform プラグインと依存関係の最新化

基本的な build.gradle.kts（KMP 推奨構成）

plugins {
    // 最新版は「バージョン確認手順」セクションで取得したものを使用
    kotlin(&quot;multiplatform&quot;) version &quot;1.9.20&quot;
    id(&quot;com.android.application&quot;) version &quot;8.2.0&quot;   // Android Studio に同梱のものと合わせる
}

// 依存バージョンは手動管理でも良いが、Gradle Versions Plugin を使うと自動で更新可
repositories {
    google()
    mavenCentral()
}

plugins {

// 最新版は「バージョン確認手順」セクションで取得したものを使用

kotlin("multiplatform") version "1.9.20"

id("com.android.application") version "8.2.0" // Android Studio に同梱のものと合わせる

}

// 依存バージョンは手動管理でも良いが、Gradle Versions Plugin を使うと自動で更新可

repositories {

google()

mavenCentral()

}

バージョンチェック手順（コードブロック内のバージョンを最新に保つ）

Gradle Versions Plugin の導入（settings.gradle.kts に追加）

kotlin plugins { id("com.github.ben-manes.versions") version "0.51.0" }

最新版の確認コマンド

bash ./gradlew dependencyUpdates -Drevision=release

実行結果に「Current → Latest」形式で表示されるので、build.gradle.kts の該当箇所を手動で更新します。

Kotlin バージョンの自動取得（オプション）

kotlin val kotlinVersion = providers.exec { commandLine("git", "ls-remote", "--tags", "https://github.com/JetBrains/kotlin.git") }.standardOutput.asText.split("\n").firstOrNull { it.contains("v1.9.") }?.substringAfterLast("v") ?: "1.9.20"

plugins { kotlin("multiplatform") version kotlinVersion }

注意：自動取得スクリプトは CI 環境でのみ使用し、ローカル開発時は手動でバージョンを固定することが安全です。

完全なターゲット宣言と依存関係例

kotlin {
    // ── 共通ソースセット ────────────────────────
    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation(&quot;org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3&quot;)
                implementation(&quot;org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0&quot;)
            }
        }
        val commonTest by getting {
            dependencies { implementation(kotlin(&quot;test&quot;)) }
        }
    }

    // ── Android ターゲット ───────────────────────
    androidTarget {
        compilations.all {
            kotlinOptions.jvmTarget = &quot;17&quot;
        }
        publishAllLibraryVariants()
    }

    // ── iOS (device &amp; simulator) ────────────────
    iosArm64()
    iosX64()

    // ── JVM ターゲット ───────────────────────────
    jvm {
        compilations.all { kotlinOptions.jvmTarget = &quot;17&quot; }
    }

    // ── JavaScript (IR) ターゲット ───────────────
    js(IR) {
        browser {}
        nodejs {}
    }

    // ── プラットフォーム別 sourceSets ───────────
    sourceSets {
        val androidMain by getting
        val iosMain by creating { dependsOn(commonMain) }
        val iosArm64Main by getting { dependsOn(iosMain) }
        val iosX64Main by getting   { dependsOn(iosMain) }
        val jvmMain by getting
        val jsMain by getting
    }
}

kotlin {

// ── 共通ソースセット ────────────────────────

sourceSets {

val commonMain by getting {

dependencies {

implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")

implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0")

}

val commonTest by getting {

dependencies { implementation(kotlin("test")) }

}

// ── Android ターゲット ───────────────────────

androidTarget {

compilations.all {

kotlinOptions.jvmTarget = "17"

}

publishAllLibraryVariants()

}

// ── iOS (device & simulator) ────────────────

iosArm64()

iosX64()

// ── JVM ターゲット ───────────────────────────

jvm {

compilations.all { kotlinOptions.jvmTarget = "17" }

}

// ── JavaScript (IR) ターゲット ───────────────

js(IR) {

browser {}

nodejs {}

}

// ── プラットフォーム別 sourceSets ───────────

sourceSets {

val androidMain by getting

val iosMain by creating { dependsOn(commonMain) }

val iosArm64Main by getting { dependsOn(iosMain) }

val iosX64Main by getting { dependsOn(iosMain) }

val jvmMain by getting

val jsMain by getting

}

ベストプラクティス：commonMain に全体で使用するライブラリを集約し、各プラットフォーム固有の sourceSets では必要に応じて dependsOn(commonMain) を付与します。これによりバージョンアップ時の修正箇所が最小化されます。

5. 共通ロジックと Platform‑Specific 実装のベストプラクティス

「どこに何を書くか」の指針（KMP ガイド参照）

Pure Kotlin (commonMain) – ビジネスロジック、データモデル、アルゴリズムはすべてここに置く。kotlinx.serialization・kotlinx.coroutines などのマルチプラットフォーム対応ライブラリを活用
expect / actual – OS や UI に依存する機能（例: ファイル I/O、ネットワークスタック、UI コンポーネント）は expect を commonMain に宣言し、各プラットフォームで actual 実装を提供

具体的なコード例

共通側 (commonMain)

package com.example.shared

/**
 * 現在実行中のプラットフォーム名を取得する expect 関数。
 * 各ターゲットで actual を実装することで、単一の呼び出しだけで OS を判別できる。
 */
expect fun platformName(): String

/** 文字列を逆順にしたうえで、プラットフォーム情報を付加して返すユーティリティ */
fun reverseAndAppendPlatform(text: String): String =
    &quot;${text.reversed()} on ${platformName()}&quot;

package com.example.shared

/**

* 現在実行中のプラットフォーム名を取得する expect 関数。

* 各ターゲットで actual を実装することで、単一の呼び出しだけで OS を判別できる。

expect fun platformName(): String

/** 文字列を逆順にしたうえで、プラットフォーム情報を付加して返すユーティリティ */

fun reverseAndAppendPlatform(text: String): String =

"${text.reversed()} on ${platformName()}"

Android 実装 (androidMain)

package com.example.shared

actual fun platformName(): String = &quot;Android&quot;

package com.example.shared

actual fun platformName(): String = "Android"

iOS 実装 (iosMain)

package com.example.shared

import platform.UIKit.UIDevice

actual fun platformName(): String = UIDevice.currentDevice.systemName()

package com.example.shared

import platform.UIKit.UIDevice

actual fun platformName(): String = UIDevice.currentDevice.systemName()

ポイント：commonMain のみでロジックを記述し、プラットフォーム固有のブリッジは最小限に抑えることで、テスト容易性と保守性が格段に向上します。

UI 側から呼び出す例

Android Activity（Kotlin）

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val result = reverseAndAppendPlatform(&quot;Hello&quot;)
        findViewById&lt;TextView&gt;(R.id.result).text = result
    }
}

class MainActivity : AppCompatActivity() {

override fun onCreate(savedInstanceState: Bundle?) {

super.onCreate(savedInstanceState)

setContentView(R.layout.activity_main)

val result = reverseAndAppendPlatform("Hello")

findViewById<TextView>(R.id.result).text = result

}

iOS ViewController（Swift）

import UIKit
import shared   // Kotlin/Native で生成されたフレームワーク

class ViewController: UIViewController {
    @IBOutlet weak var label: UILabel!

    override func viewDidLoad() {
        super.viewDidLoad()
        let result = StringUtil().reverseAndAppendPlatform(text: &quot;Hello&quot;)
        label.text = result
    }
}

import UIKit

import shared // Kotlin/Native で生成されたフレームワーク

class ViewController: UIViewController {

@IBOutlet weak var label: UILabel!

override func viewDidLoad() {

super.viewDidLoad()

let result = StringUtil().reverseAndAppendPlatform(text: "Hello")

label.text = result

}

6. ビルド・デバッグ手順と Xcode 連携

Android 側ビルドフロー

Gradle タスク実行

bash ./gradlew assembleDebug # デバッグ用 APK を生成

IDE から直接起動 – Run ボタンでエミュレータまたは接続デバイスを選択。Logcat に reverseAndAppendPlatform の出力が表示されることを確認します。

iOS 側ビルドフロー（XCFramework 利用）

Kotlin/Native 用 XCFramework を生成

bash ./gradlew :shared:assembleXCFramework

生成物は shared/build/XCFramework/shared.xcframework に出力されます。

Xcode プロジェクトへ組み込み
Xcode を開き、対象 iOS アプリの「General」タブで Frameworks, Libraries, and Embedded Content に上記 .xcframework をドラッグ＆ドロップ。
Build Settings > Runpath Search Paths に @executable_path/Frameworks を追加し、コードサインが正しく行われるように設定。
シミュレータ／実機で実行 – Xcode のツールバーからデバイスを選び「Run」。Swift 側から shared.StringUtil().reverseAndAppendPlatform(text: "Hello") が呼び出せれば成功です。

注意点：iOS ビルド時に Xcode のバージョンが古いと XCFramework の互換性エラーになることがあります。常に Apple の公式サイトで「最新の Xcode」かどうかを確認してください。

7. まとめ

最新版取得は必須：Kotlin 1.9.20（2024‑03‑07 リリース）以降、公式ブログ・GitHub タグで定期的にバージョンをチェック。
IDE は IntelliJ IDEA Ultimate または Android Studio の最新安定版 を使用し、Kotlin と Gradle Kotlin DSL プラグインを最新版に保つ。
KMP ウィザードでプロジェクト作成すれば commonMain/各プラットフォーム用フォルダが自動生成され、構造が明確になる。
Gradle 設定は kotlin("multiplatform") プラグインと target 宣言を中心に、依存ライブラリは commonMain に集約し、dependencyUpdates コマンドでバージョン管理を自動化。
ロジックは共通コードに、プラットフォーム固有の実装は expect/actual で分離すれば保守コストが大幅に削減できる。
ビルド・デバッグは Android Studio の Run タスクと Xcode の XCFramework 統合でシームレスに行える。

これらの手順を踏むことで、Android、iOS、JVM、JavaScript 向けアプリを単一コードベースから安全かつ効率的にビルド・デプロイできるようになります。質問や環境固有の問題が出た場合は、公式リポジトリの Issues や Kotlin Slack の #multiplatform チャンネルで最新情報を取得してください。

スポンサードリンク

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

-Kotlin

comment コメントをキャンセル

: Kotlin

Kotlin Coroutines 入門チュートリアル：ViewModel と Retrofit の実装ガイド

Kotlin を Android やサーバーサイドで使い始めたばかりの方へ。Coroutines を用いた安全かつ効率的な非同期処理の基礎から、ViewModel・Retrofit と組み合わせた実装パターンまでハンズオン形式で解説します。

: Kotlin

Kotlin Coroutines 入門 – 基本概念・実装からAndroid活用まで

この記事では、suspend 関数による非同期処理の基礎から launch と async の使い分け、Dispatcher の選択、Structured Concurrency、Android の lifecycleScope まで、Kotlin Coroutines を実務で活用するためのポイントを網羅しています。

: Kotlin

2024年最新・無料Kotlin学習教材まとめと始め方

Kotlinは無料教材が充実しており、2024年7月更新のリソースだけで初心者がHello, World!アプリを作成できます。

: Kotlin

Androidで最新Coroutines 1.10.2を導入するGradle設定と活用ガイド

Gradleに最新Coroutines 1.10.2を安全に導入し、structured concurrency を意識したコルーチンの書き方と実践例を紹介します。

: Kotlin

Kotlin Multiplatform 入門 – Android Studio Meerkatで2026年環境構築

本ガイドでは、Android Studio Meerkat と最新の Kotlin 1.9／Gradle 8 環境で、Kotlin Multiplatform（KMP）プロジェクトをテンプレートから構築し、iOS と Android 両方へデプロイするまでの実務レベル手順を紹介します。

Android開発入門：環境構築・Kotlin・Jetpack Compose

Kotlinコルーチン入門: 非同期処理とAndroid開発のベストプラクティス

Kotlin Multiplatform 最新安定版とIDE設定・Gradle構築ガイド (2024年4月)

📅 記事の最終更新日とバージョン確認方針

1. Kotlin Multiplatform の最新安定版を取得する手順

2. 推奨 IDE と設定の簡潔化

なぜ IntelliJ IDEA / Android Studio が必要か

インストールとプラグインの統合手順

3. KMP ウィザードによるプロジェクト作成とディレクトリ構造

プロジェクト生成フロー（概要）

生成ディレクトリの実体例

4. Gradle 設定 – Kotlin Multiplatform プラグインと依存関係の最新化

基本的な build.gradle.kts（KMP 推奨構成）

バージョンチェック手順（コードブロック内のバージョンを最新に保つ）

完全なターゲット宣言と依存関係例

5. 共通ロジックと Platform‑Specific 実装のベストプラクティス

「どこに何を書くか」の指針（KMP ガイド参照）

具体的なコード例

UI 側から呼び出す例

6. ビルド・デバッグ手順と Xcode 連携

Android 側ビルドフロー

iOS 側ビルドフロー（XCFramework 利用）

7. まとめ

1. Kotlin Multiplatform の最新安定版を取得する手順

4. Gradle 設定 – Kotlin Multiplatform プラグインと依存関係の最新化