Kotlinマルチプラットフォーム開発環境のセットアップと最新手順

2026年7月2日

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

スポンサードリンク

働き方から選べる

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

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

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

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

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

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

Beyond Careerに無料相談する

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

Contents

1 開発環境のセットアップ
2 KMP プロジェクトの作成と Gradle 設定
3 共通コード層の設計とマルチプラットフォームライブラリ活用
4 UI 実装の選択肢と比較ガイド
5 テスト・デバッグ・ビルド・リリースフロー
6 まとめ

スポンサードリンク

開発環境のセットアップ

Kotlin Multiplatform (KMP) アプリを作り始める前に、JDK・Android Studio・Xcode の最新版 と Kotlin 用プラグインが正しくインストールされていることを確認します。ここで環境が整っていれば、ビルドエラーや依存関係の不整合といった基本的な障害に悩まされる機会は格段に減ります。

JDK と Android Studio のインストール

対象 OS：macOS・Windows・Linux（それぞれの手順を併記）

JDK 17 以上 が Kotlin 2.0 系列で必須です。
macOS: brew install openjdk@17 → インストール後、/usr/local/opt/openjdk@17/bin を $PATH に追加します。
Windows: Microsoft Store か AdoptOpenJDK の公式ページから MSI を取得し、インストーラに従ってインストールしてください。
Linux (Ubuntu 系): sudo apt-get install openjdk-17-jdk
Android Studio（最新安定版）
公式サイトの「Download Android Studio」から Android Studio Flamingo 系列以降をダウンロードします（2026 年 4 月時点での最新版は Flamingo (2024.2.x)）。
初回起動後に表示される SDK Manager で次のコンポーネントを必ずインストールしてください。
- Android 15（API 35）またはそれ以上のプラットフォーム
- Google Play services、NDK、CMake（必要に応じて）
File > Settings > Appearance & Behavior > System Settings > Android SDK で SDK Path が正しく設定されていることを確認します。
環境変数のチェック（ターミナル／コマンドプロンプト）

# JDK バージョン確認
java -version   # → openjdk version &quot;17...&quot;

# Android Studio バージョン確認 (macOS の例)
studio.sh --version   # → Android Studio Flamingo 2024.2.x

# JDK バージョン確認

java -version # → openjdk version "17..."

# Android Studio バージョン確認 (macOS の例)

studio.sh --version # → Android Studio Flamingo 2024.2.x

注意：JDK と Android Studio が同一メジャーバージョンで揃っていないと、Kotlin コンパイラが期待通りに動作しないことがあります。

iOS 開発環境の準備（Xcode）

iOS アプリをビルドするには macOS が必須です。Apple が提供する 最新安定版 Xcode（2026 年 4 月時点では 15.4 系列）が推奨されますが、正確なバージョン番号は公式リリースノートで随時確認してください。

App Store または Apple Developer ポータルから Xcode をインストール／アップデートします。
コマンドラインツールを有効化するために以下を実行します。

xcode-select --install   # 初回のみ表示されるダイアログで「インストール」を選択

1 2	xcode-select --install # 初回のみ表示されるダイアログで「インストール」を選択

Command Line Tools が正しい Xcode バージョンに紐付いているか確認します。

xcode-select -p    # → /Applications/Xcode.app/Contents/Developer になるはず

1 2	xcode-select -p # → /Applications/Xcode.app/Contents/Developer になるはず

シミュレータは Xcode の「Devices & Simulators」から iPhone 15、iPad Pro 等の最新デバイスイメージを追加してください。

注意：シミュレータが起動しない場合は xcrun simctl list でインストール済みランタイムを確認し、必要に応じて xcode-select --switch /Applications/Xcode.app を実行します。

Kotlin プラグインと関連ツールの導入

Kotlin 2.0 系列と Compose Multiplatform の機能をフル活用するために、IDE 側へ以下プラグインを追加します（バージョンは「最新安定版」を使用）。

ツール	推奨設定	インストール手順
Kotlin Plugin for Android Studio	最新安定版 (例: 2.0.x)	Preferences → Plugins → Marketplace → 「Kotlin」検索・インストール
Compose Multiplatform Plugin	最新安定版 (例: 1.5.x)	同上で「Compose Multiplatform」検索
Kotlin Symbol Processing (KSP)	最新安定版 (例: 2.0.x‑rc)	`build.gradle.kts` に `id("com.google.devtools.ksp") version "…"` を記述

ポイント：プラグインは自動更新が無効化されていることが多いため、月に一度「Check for Updates」からバージョンを確認しましょう。

KMP プロジェクトの作成と Gradle 設定

Gradle Kotlin DSL と Version Catalog を組み合わせることで、依存バージョン管理が一元化され、プラットフォームごとのビルドスクリプトがシンプルになります。以下では標準的なディレクトリ構成と設定ファイル例を示します。

プロジェクト雛形の生成

前提：プロジェクトのルートに gradlew（Gradle Wrapper）があることを想定しています。

# 1. 作業ディレクトリ作成
mkdir MyKmpApp &amp;&amp; cd MyKmpApp

# 2. Gradle Wrapper の初期化（まだ無い場合）
gradle wrapper --gradle-version 8.6

# 3. Kotlin Multiplatform 雛形を生成
./gradlew init \
    --type kotlin-multiplatform \
    --dsl kotlin \
    --project-name MyKmpApp

# 1. 作業ディレクトリ作成

mkdir MyKmpApp && cd MyKmpApp

# 2. Gradle Wrapper の初期化（まだ無い場合）

gradle wrapper --gradle-version 8.6

# 3. Kotlin Multiplatform 雛形を生成

./gradlew init \

--type kotlin-multiplatform \

--dsl kotlin \

--project-name MyKmpApp

このコマンドで以下の主要ディレクトリが作成されます。

commonMain/, androidMain/, iosX64/ などの source set
build.gradle.kts（ルートビルドスクリプト）
settings.gradle.kts

settings.gradle.kts に Version Catalog を有効化

dependencyResolutionManagement {
    versionCatalogs {
        create(&quot;libs&quot;) {
            // カタログは libs.versions.toml で管理するのが推奨です。
            from(files(&quot;../gradle/libs.versions.toml&quot;))
        }
    }
}

dependencyResolutionManagement {

versionCatalogs {

create("libs") {

// カタログは libs.versions.toml で管理するのが推奨です。

from(files("../gradle/libs.versions.toml"))

}

libs.versions.toml（例）

gradle/libs.versions.toml をプロジェクト直下に作成し、バージョン・プラグイン・ライブラリをすべてここで定義します。

[versions]
kotlin = &quot;2.0.20&quot;
compose = &quot;1.5.10&quot;
ktor = &quot;3.0.0&quot;
sqldelight = &quot;2.0.0&quot;
atomicfu = &quot;0.23.1&quot;

[plugins]
kotlin-multiplatform = { id = &quot;org.jetbrains.kotlin.multiplatform&quot;, version.ref = &quot;kotlin&quot; }
compose = { id = &quot;org.jetbrains.compose&quot;, version.ref = &quot;compose&quot; }
sqldelight = { id = &quot;com.squareup.sqldelight&quot;, version.ref = &quot;sqldelight&quot; }
ksp = { id = &quot;com.google.devtools.ksp&quot;, version = &quot;2.0.20-rc&quot; }

[libraries]
ktor-core = { module = &quot;io.ktor:ktor-client-core&quot;, version.ref = &quot;ktor&quot; }
ktor-android = { module = &quot;io.ktor:ktor-client-okhttp&quot;, version.ref = &quot;ktor&quot; }
ktor-ios = { module = &quot;io.ktor:ktor-client-darwin&quot;, version.ref = &quot;ktor&quot; }
sqldelight-runtime = { module = &quot;com.squareup.sqldelight:runtime&quot;, version.ref = &quot;sqldelight&quot; }
sqldelight-driver-android = { module = &quot;com.squareup.sqldelight:android-driver&quot;, version.ref = &quot;sqldelight&quot; }
sqldelight-driver-native = { module = &quot;com.squareup.sqldelight:native-driver&quot;, version.ref = &quot;sqldelight&quot; }
atomicfu = { module = &quot;org.jetbrains.kotlinx:atomicfu&quot;, version.ref = &quot;atomicfu&quot; }

[versions]

kotlin = "2.0.20"

compose = "1.5.10"

ktor = "3.0.0"

sqldelight = "2.0.0"

atomicfu = "0.23.1"

[plugins]

kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }

compose = { id = "org.jetbrains.compose", version.ref = "compose" }

sqldelight = { id = "com.squareup.sqldelight", version.ref = "sqldelight" }

ksp = { id = "com.google.devtools.ksp", version = "2.0.20-rc" }

[libraries]

ktor-core = { module = "io.ktor:ktor-client-core", version.ref = "ktor" }

ktor-android = { module = "io.ktor:ktor-client-okhttp", version.ref = "ktor" }

ktor-ios = { module = "io.ktor:ktor-client-darwin", version.ref = "ktor" }

sqldelight-runtime = { module = "com.squareup.sqldelight:runtime", version.ref = "sqldelight" }

sqldelight-driver-android = { module = "com.squareup.sqldelight:android-driver", version.ref = "sqldelight" }

sqldelight-driver-native = { module = "com.squareup.sqldelight:native-driver", version.ref = "sqldelight" }

atomicfu = { module = "org.jetbrains.kotlinx:atomicfu", version.ref = "atomicfu" }

ポイント：libs.versions.toml はプロジェクト全体で共有できるため、サブモジュールが増えてもバージョン管理が煩雑になりません。

Kotlin Multiplatform と Compose のプラグイン設定

build.gradle.kts（ルート）に以下を記述します。

plugins {
    // カタログからプラグインを取得
    alias(libs.plugins.kotlin.multiplatform)
    alias(libs.plugins.compose)
    alias(libs.plugins.sqldelight)
    alias(libs.plugins.ksp)   // KSP 用
}

kotlin {
    androidTarget()
    iosX64()
    iosArm64()
    iosSimulatorArm64()

    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation(compose.runtime)
                implementation(libs.ktor.core)
                implementation(libs.sqldelight.runtime)
                implementation(libs.atomicfu)   // @SharedImmutable 用
            }
        }
        val androidMain by getting {
            dependencies {
                implementation(libs.ktor.android)
                implementation(libs.sqldelight.driver.android)
            }
        }
        val iosMain by creating {
            dependsOn(commonMain)
            dependencies {
                implementation(libs.ktor.ios)
                implementation(libs.sqldelight.driver.native)
            }
        }

        // テスト用 sourceSet
        val commonTest by getting {
            dependencies {
                implementation(kotlin(&quot;test&quot;))
                implementation(libs.kotlinx.coroutines.test)
            }
        }
    }
}

// Android 用設定（必要最低限）
android {
    compileSdk = 35
    namespace = &quot;com.example.mykmpapp&quot;
    defaultConfig {
        minSdk = 24
        targetSdk = 35
    }
}

plugins {

// カタログからプラグインを取得

alias(libs.plugins.kotlin.multiplatform)

alias(libs.plugins.compose)

alias(libs.plugins.sqldelight)

alias(libs.plugins.ksp) // KSP 用

}

kotlin {

androidTarget()

iosX64()

iosArm64()

iosSimulatorArm64()

sourceSets {

val commonMain by getting {

dependencies {

implementation(compose.runtime)

implementation(libs.ktor.core)

implementation(libs.sqldelight.runtime)

implementation(libs.atomicfu) // @SharedImmutable 用

}

val androidMain by getting {

dependencies {

implementation(libs.ktor.android)

implementation(libs.sqldelight.driver.android)

}

val iosMain by creating {

dependsOn(commonMain)

dependencies {

implementation(libs.ktor.ios)

implementation(libs.sqldelight.driver.native)

}

// テスト用 sourceSet

val commonTest by getting {

dependencies {

implementation(kotlin("test"))

implementation(libs.kotlinx.coroutines.test)

}

// Android 用設定（必要最低限）

android {

compileSdk = 35

namespace = "com.example.mykmpapp"

defaultConfig {

minSdk = 24

targetSdk = 35

}

注意：libs.versions.toml に定義したエイリアス（alias(libs.plugins.xxx)）は Gradle 8.x 系で正式にサポートされています。古い Gradle を使用している場合は id("…") version "…" の形式に書き換えてください。

Version Catalog の活用例とベストプラクティス

カテゴリ	設定例	利用シーン
バージョン	`version("kotlin", "2.0.20")`	複数モジュールで同一バージョンを共有
プラグイン	`plugin("compose", "org.jetbrains.compose").versionRef("compose")`	Gradle スクリプトの可読性向上
ライブラリ	`library("ktor-core", "io.ktor:ktor-client-core").versionRef("ktor")`	`implementation(libs.ktor.core)` で呼び出し

実装手順まとめ

libs.versions.toml を作成（上記例をベースにプロジェクト固有の依存を追加）。
settings.gradle.kts でカタログを読み込む。
ビルドスクリプトでは libs.xxx 系統だけを書き、バージョン番号は一切ハードコーディングしない。

この流れに従えば、将来のバージョンアップは toml ファイル のみ修正すれば完了します。

共通コード層の設計とマルチプラットフォームライブラリ活用

KMP で最大限コード共有を実現する鍵は Expect/Actual パターン と、Ktor・SQLDelight 等のマルチプラットフォーム対応ライブラリです。以下では具体的な実装例とベストプラクティスを示します。

Expect / Actual によるプラットフォーム差分抽象化

概要：共通モジュール (commonMain) で expect キーワードで宣言し、各ターゲット固有の実装は actual キーワードで提供します。

// commonMain/src/commonMain/kotlin/com/example/util/TimeProvider.kt
package com.example.util

/** 現在時刻（ミリ秒）を取得する抽象インタフェース */
expect fun currentTimeMillis(): Long

// commonMain/src/commonMain/kotlin/com/example/util/TimeProvider.kt

package com.example.util

/** 現在時刻（ミリ秒）を取得する抽象インタフェース */

expect fun currentTimeMillis(): Long

Android 実装

// androidMain/src/androidMain/kotlin/com/example/util/TimeProvider.android.kt
package com.example.util

actual fun currentTimeMillis(): Long = System.currentTimeMillis()

// androidMain/src/androidMain/kotlin/com/example/util/TimeProvider.android.kt

package com.example.util

actual fun currentTimeMillis(): Long = System.currentTimeMillis()

iOS (Kotlin/Native) 実装

// iosMain/src/iosMain/kotlin/com/example/util/TimeProvider.ios.kt
package com.example.util

import platform.Foundation.NSDate

actual fun currentTimeMillis(): Long =
    (NSDate().timeIntervalSince1970 * 1000).toLong()

// iosMain/src/iosMain/kotlin/com/example/util/TimeProvider.ios.kt

package com.example.util

import platform.Foundation.NSDate

actual fun currentTimeMillis(): Long =

(NSDate().timeIntervalSince1970 * 1000).toLong()

ポイント：expect / actual はコンパイル時に型安全が保証され、IDE がプラットフォーム固有実装へのナビゲーションを提供します。

Ktor によるネットワーク層の共有

Ktor のマルチプラットフォームクライアントは エンジン を差し替えるだけで Android と iOS 両方で同一コードが動作します。

共通モジュール

// commonMain/src/commonMain/kotlin/com/example/network/ApiClient.kt
package com.example.network

import io.ktor.client.*
import io.ktor.client.request.*

private val httpClient = HttpClient {
    install(io.ktor.client.plugins.contentnegotiation.ContentNegotiation) {
        json()
    }
}

/** サンプル API 呼び出し */
suspend fun fetchPosts(): List&lt;Post&gt; =
    httpClient.get(&quot;https://jsonplaceholder.typicode.com/posts&quot;)

// commonMain/src/commonMain/kotlin/com/example/network/ApiClient.kt

package com.example.network

import io.ktor.client.*

import io.ktor.client.request.*

private val httpClient = HttpClient {

install(io.ktor.client.plugins.contentnegotiation.ContentNegotiation) {

json()

}

/** サンプル API 呼び出し */

suspend fun fetchPosts(): List<Post> =

httpClient.get("https://jsonplaceholder.typicode.com/posts")

プラットフォーム別エンジン設定（Expect/Actual パターン）

// commonMain/src/commonMain/kotlin/com/example/network/EngineProvider.kt
package com.example.network

import io.ktor.client.engine.*

expect fun provideEngine(): HttpClientEngine

// commonMain/src/commonMain/kotlin/com/example/network/EngineProvider.kt

package com.example.network

import io.ktor.client.engine.*

expect fun provideEngine(): HttpClientEngine

// androidMain/src/androidMain/kotlin/com/example/network/EngineProvider.android.kt
package com.example.network

import io.ktor.client.engine.okhttp.*
import okhttp3.OkHttpClient

actual fun provideEngine(): HttpClientEngine = OkHttpEngine(
    client = OkHttpClient.Builder().build()
)

// androidMain/src/androidMain/kotlin/com/example/network/EngineProvider.android.kt

package com.example.network

import io.ktor.client.engine.okhttp.*

import okhttp3.OkHttpClient

actual fun provideEngine(): HttpClientEngine = OkHttpEngine(

client = OkHttpClient.Builder().build()

)

// iosMain/src/iosMain/kotlin/com/example/network/EngineProvider.ios.kt
package com.example.network

import io.ktor.client.engine.darwin.*

actual fun provideEngine(): HttpClientEngine = DarwinEngine()

// iosMain/src/iosMain/kotlin/com/example/network/EngineProvider.ios.kt

package com.example.network

import io.ktor.client.engine.darwin.*

actual fun provideEngine(): HttpClientEngine = DarwinEngine()

HttpClient の生成箇所を provideEngine() に置き換えるだけで、ビルドフラグや Gradle プロパティでエンジン切替が可能です。

private val httpClient = HttpClient(provideEngine()) {
    // 共通設定はここに書く
}

private val httpClient = HttpClient(provideEngine()) {

// 共通設定はここに書く

}

ポイント：テスト時には -PuseMockServer=true のような Gradle プロパティを用意し、provideEngine() が Mock エンジンを返すように切り替えることで、ネットワーク依存のユニットテストが容易になります。

SQLDelight によるデータベース層の統一

SQLDelight はスキーマから型安全な DAO を自動生成し、JVM と Native の両方で同一 API を提供します。

Gradle 設定（build.gradle.kts）

sqldelight {
    database(&quot;AppDatabase&quot;) {
        packageName = &quot;com.example.shared.db&quot;
        sourceFolders = listOf(&quot;sqldelight&quot;)
    }
}

sqldelight {

database("AppDatabase") {

packageName = "com.example.shared.db"

sourceFolders = listOf("sqldelight")

}

スキーマは src/commonMain/sqldelight/com/example/shared/db/App.sq に配置します。

CREATE TABLE user (
    id INTEGER NOT NULL PRIMARY KEY,
    name TEXT NOT NULL,
    age INTEGER NOT NULL
);

CREATE TABLE user (

id INTEGER NOT NULL PRIMARY KEY,

name TEXT NOT NULL,

age INTEGER NOT NULL

);

ドライバ抽象化（Expect/Actual）

// commonMain/src/commonMain/kotlin/com/example/db/DriverFactory.kt
package com.example.db

import com.squareup.sqldelight.db.SqlDriver

expect class DriverFactory {
    fun createDriver(): SqlDriver
}

// commonMain/src/commonMain/kotlin/com/example/db/DriverFactory.kt

package com.example.db

import com.squareup.sqldelight.db.SqlDriver

expect class DriverFactory {

fun createDriver(): SqlDriver

}

// androidMain/.../DriverFactory.android.kt
package com.example.db

import android.content.Context
import com.squareup.sqldelight.android.AndroidSqliteDriver
import com.example.shared.db.AppDatabase

actual class DriverFactory(private val context: Context) {
    actual fun createDriver(): SqlDriver =
        AndroidSqliteDriver(AppDatabase.Schema, context, &quot;app.db&quot;)
}

// androidMain/.../DriverFactory.android.kt

package com.example.db

import android.content.Context

import com.squareup.sqldelight.android.AndroidSqliteDriver

import com.example.shared.db.AppDatabase

actual class DriverFactory(private val context: Context) {

actual fun createDriver(): SqlDriver =

AndroidSqliteDriver(AppDatabase.Schema, context, "app.db")

}

// iosMain/.../DriverFactory.ios.kt
package com.example.db

import com.squareup.sqldelight.drivers.native.NativeSqliteDriver
import com.example.shared.db.AppDatabase

actual class DriverFactory {
    actual fun createDriver(): SqlDriver =
        NativeSqliteDriver(AppDatabase.Schema, &quot;app.db&quot;)
}

// iosMain/.../DriverFactory.ios.kt

package com.example.db

import com.squareup.sqldelight.drivers.native.NativeSqliteDriver

import com.example.shared.db.AppDatabase

actual class DriverFactory {

actual fun createDriver(): SqlDriver =

NativeSqliteDriver(AppDatabase.Schema, "app.db")

}

DAO の利用例（commonMain）

val db = AppDatabase(driverFactory.createDriver())
val userQueries = db.userQueries

suspend fun getUser(id: Long): User? =
    userQueries.selectById(id).executeAsOneOrNull()

val db = AppDatabase(driverFactory.createDriver())

val userQueries = db.userQueries

suspend fun getUser(id: Long): User? =

userQueries.selectById(id).executeAsOneOrNull()

ポイント：iOS ビルド時は NativeSqliteDriver が自動的に使用され、SQLite の挙動は Android と完全に同一です。

@SharedImmutable と atomicfu ライブラリの活用

Kotlin 2.0 で導入された @SharedImmutable は コンパイル時最適化 により、マルチスレッド環境でもロック不要な不変オブジェクトを生成します。利用には atomicfu が必須です。

依存追加（libs.versions.toml）

[libraries]
atomicfu = { module = &quot;org.jetbrains.kotlinx:atomicfu&quot;, version.ref = &quot;atomicfu&quot; }

[libraries]

atomicfu = { module = "org.jetbrains.kotlinx:atomicfu", version.ref = "atomicfu" }

コード例

import kotlinx.atomicfu.SharedImmutable

@SharedImmutable
object Config {
    const val TIMEOUT_MS = 15_000L
    const val BASE_URL = &quot;https://api.example.com&quot;
}

import kotlinx.atomicfu.SharedImmutable

@SharedImmutable

object Config {

const val TIMEOUT_MS = 15_000L

const val BASE_URL = "https://api.example.com"

}

ポイント：@SharedImmutable を付与した object や val はコンパイル時に 静的バイトコード に変換され、実行時のオーバーヘッドがほぼゼロになります。頻繁に参照する定数は必ずこのアノテーションでマークしましょう。

UI 実装の選択肢と比較ガイド

KMP アプリでは Compose Multiplatform と SwiftUI のどちらか、またはハイブリッド構成を取ることが多いです。以下ではそれぞれの特徴と実装サンプルを示し、プロジェクト要件に合わせた選択指針を提供します。

Compose Multiplatform で統一的に UI を構築

概要：単一コードベース（Kotlin）で Android と iOS の UI を描画でき、プレビュー機能が IDE に組み込まれています。

@Composable
fun GreetingScreen(name: String) {
    Column(
        modifier = Modifier
            .fillMaxSize()
            .padding(16.dp),
        verticalArrangement = Arrangement.Center,
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        Text(text = &quot;Hello, $name!&quot;, style = MaterialTheme.typography.h4)
        Spacer(modifier = Modifier.height(12.dp))
        Button(onClick = { /* TODO */ }) {
            Text(&quot;Tap me&quot;)
        }
    }
}

@Composable

fun GreetingScreen(name: String) {

Column(

modifier = Modifier

.fillMaxSize()

.padding(16.dp),

verticalArrangement = Arrangement.Center,

horizontalAlignment = Alignment.CenterHorizontally

) {

Text(text = "Hello, $name!", style = MaterialTheme.typography.h4)

Spacer(modifier = Modifier.height(12.dp))

Button(onClick = { /* TODO */ }) {

Text("Tap me")

}

プレビューの書き方（iOS も含めて）

@Preview(name = &quot;iPhone 15&quot;, device = &quot;iPhone 15&quot;)
@Composable
fun GreetingScreenPreview() {
    GreetingScreen(name = &quot;KMP&quot;)
}

@Preview(name = "iPhone 15", device = "iPhone 15")

@Composable

fun GreetingScreenPreview() {

GreetingScreen(name = "KMP")

}

テーマ統一：MaterialTheme をベースに ColorScheme をカスタマイズすれば、iOS でも Material ライクな見た目を実現可能です。
プラットフォーム固有の UI 部分だけ切り替える: expect fun isIOS(): Boolean と actual 実装で条件分岐できます。

SwiftUI と KMP のブリッジパターン

概要：iOS 側は Apple が推奨する SwiftUI で UI を実装し、ビジネスロジックだけを Kotlin/Native から呼び出す構成です。

Swift 側コード例

import SwiftUI
import shared   // Gradle が生成した Kotlin/Native フレームワーク

struct ContentView: View {
    @State private var greeting = &quot;&quot;

    var body: some View {
        VStack(spacing: 16) {
            Text(greeting)
                .font(.title)

            Button(&quot;Fetch&quot;) {
                fetchGreeting()
            }
        }
        .onAppear { fetchGreeting() }
    }

    private func fetchGreeting() {
        let useCase = GreetingUseCase()
        // Kotlin の suspend 関数は Swift では async/await に変換されます
        Task {
            do {
                greeting = try await useCase.getGreeting()
            } catch {
                greeting = &quot;Error: \\(error.localizedDescription)&quot;
            }
        }
    }
}

import SwiftUI

import shared // Gradle が生成した Kotlin/Native フレームワーク

struct ContentView: View {

@State private var greeting = ""

var body: some View {

VStack(spacing: 16) {

Text(greeting)

.font(.title)

Button("Fetch") {

fetchGreeting()

}

.onAppear { fetchGreeting() }

}

private func fetchGreeting() {

let useCase = GreetingUseCase()

// Kotlin の suspend 関数は Swift では async/await に変換されます

Task {

do {

greeting = try await useCase.getGreeting()

} catch {

greeting = "Error: \\(error.localizedDescription)"

}

KMP 側の `GreetingUseCase`（共通コード）

class GreetingUseCase {
    suspend fun getGreeting(): String =
        httpClient.get(&quot;https://api.example.com/greeting&quot;)
}

class GreetingUseCase {

suspend fun getGreeting(): String =

httpClient.get("https://api.example.com/greeting")

}

ブリッジポイントは shared.framework のビルド設定です。Gradle の linkReleaseFrameworkIosX64 タスクで生成された .framework を Xcode にインポートすれば、Swift から直接呼び出せます。

フレームワーク選択の判断基準

観点	Compose Multiplatform	SwiftUI
コード統一性	高（Kotlin のみ）	中（ロジックは共有、UI は別）
プラットフォームネイティブ感	良好だが Material デザインに依存	最高（Apple HIG 完全遵守）
開発速度	UI プレビューで高速	Xcode の Live Preview が同等
チームスキル	Kotlin エンジニア中心	iOS/Swift エンジニア必須
将来拡張性	Web・Desktop も同一コードで追加可能	iOS/macOS に限定

結論：Kotlin エンジニアが多数在籍し、Android と iOS の UI をできるだけ共通化したい場合は Compose Multiplatform が最適です。Apple デザインの徹底遵守と高度な iOS ネイティブ体験が必要なら SwiftUI + KMP ブリッジ が有効です。

テスト・デバッグ・ビルド・リリースフロー

KMP プロジェクトでは 共通ユニットテスト と プラットフォーム固有テスト を組み合わせ、CI/CD で自動化することが品質保証の鍵です。

ユニットテストとプラットフォーム固有テスト

共通モジュール (`commonTest`) の例

class GreetingUseCaseTest {
    private val useCase = GreetingUseCase()

    @Test
    fun `greeting is not empty`() = runBlocking {
        val result = useCase.getGreeting()
        assertTrue(result.isNotBlank())
    }
}

class GreetingUseCaseTest {

private val useCase = GreetingUseCase()

@Test

fun `greeting is not empty`() = runBlocking {

val result = useCase.getGreeting()

assertTrue(result.isNotBlank())

}

Android Instrumented Test

@get:Rule val composeTestRule = createComposeRule()

@Test
fun greetingScreen_showsText() {
    composeTestRule.setContent { GreetingScreen(name = &quot;KMP&quot;) }
    composeTestRule.onNodeWithText(&quot;Hello, KMP!&quot;).assertIsDisplayed()
}

@get:Rule val composeTestRule = createComposeRule()

@Test

fun greetingScreen_showsText() {

composeTestRule.setContent { GreetingScreen(name = "KMP") }

composeTestRule.onNodeWithText("Hello, KMP!").assertIsDisplayed()

}

androidTest の build.gradle.kts で必要な依存を追加します。

dependencies {
    androidTestImplementation(compose.ui.test.junit4)
    androidTestImplementation(kotlin(&quot;test-junit&quot;))
}

dependencies {

androidTestImplementation(compose.ui.test.junit4)

androidTestImplementation(kotlin("test-junit"))

}

iOS XCTest（Swift 側）

import XCTest
@testable import shared

final class GreetingUseCaseTests: XCTestCase {
    func testGreetingNotEmpty() async throws {
        let useCase = GreetingUseCase()
        let greeting = try await useCase.getGreeting()
        XCTAssertFalse(greeting.isEmpty)
    }
}

import XCTest

@testable import shared

final class GreetingUseCaseTests: XCTestCase {

func testGreetingNotEmpty() async throws {

let useCase = GreetingUseCase()

let greeting = try await useCase.getGreeting()

XCTAssertFalse(greeting.isEmpty)

}

ポイント：./gradlew allTests で commonTest・androidTest・iosX64Test·iosArm64Test が一括実行でき、ローカルでも CI でも同じコマンドを使用できます。

完全版 GitHub Actions パイプライン

以下は Android と iOS のビルド・テスト・デプロイまでを網羅したサンプルです。コメントで省略部分を補足しています。

name: KMP CI/CD

on:
  push:
    branches: [ main ]
  pull_request:

jobs:
  # -------------------------------------------------
  # 共通ビルド環境（macOS が iOS ビルドに必須）
  # -------------------------------------------------
  setup:
    runs-on: macos-13
    outputs:
      java-version: ${{ steps.java.outputs.version }}
    steps:
      - uses: actions/checkout@v3

      # JDK 17 のセットアップ（macOS, Linux 共通）
      - name: Set up JDK 17
        id: java
        uses: actions/setup-java@v3
        with:
          distribution: temurin
          java-version: '17'

      # Android SDK のインストール
      - name: Install Android SDK
        uses: android-actions/setup-android@v2

      # Gradle キャッシュ設定
      - name: Cache Gradle packages
        uses: actions/cache@v3
        with:
          path: |
            ~/.gradle/caches
            ~/.gradle/wrapper
          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle.kts') }}
          restore-keys: |
            ${{ runner.os }}-gradle-

  # -------------------------------------------------
  # テスト実行ジョブ（Android + iOS 共通）
  # -------------------------------------------------
  test:
    needs: setup
    runs-on: macos-13
    steps:
      - uses: actions/checkout@v3

      # JDK と Android SDK は前の job で設定済みなので再利用
      - name: Restore Gradle cache
        uses: actions/cache@v3
        with:
          path: |
            ~/.gradle/caches
            ~/.gradle/wrapper
          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle.kts') }}

      # すべてのテストを実行
      - name: Run all unit &amp; instrumented tests
        run: ./gradlew clean testDebugUnitTest assembleDebug

      # iOS の Kotlin/Native テスト
      - name: Run iOS (Simulator) tests
        run: |
          xcodebuild -scheme MyKmpApp \
            -destination 'platform=iOS Simulator,name=iPhone 15,OS=latest' \
            test

  # -------------------------------------------------
  # ビルド &amp; アーティファクト生成ジョブ
  # -------------------------------------------------
  build:
    needs: test
    runs-on: macos-13
    steps:
      - uses: actions/checkout@v3

      - name: Build Android AAB
        run: ./gradlew :app:bundleRelease

      - name: Build iOS XCFramework
        run: |
          ./gradlew :shared:linkReleaseFrameworkIosArm64 \
                     :shared:linkReleaseFrameworkIosX64
          # 生成された .framework を zip にまとめる
          cd shared/build/bin/iosArm64/releaseFramework/
          zip -r MyKmpApp.xcframework.zip *.xcframework

      # アーティファクトを保存（GitHub の UI からダウンロード可能に）
      - name: Upload AAB artifact
        uses: actions/upload-artifact@v3
        with:
          name: android-aab
          path: app/build/outputs/bundle/release/app-release.aab

      - name: Upload XCFramework artifact
        uses: actions/upload-artifact@v3
        with:
          name: ios-xcframework
          path: shared/build/bin/**/*.zip

  # -------------------------------------------------
  # デプロイジョブ（Google Play &amp; App Store Connect）
  # -------------------------------------------------
  deploy:
    needs: build
    runs-on: macos-13
    steps:
      - uses: actions/checkout@v3

      # ダウンロードしたビルド成果物を取得
      - name: Download AAB
        uses: actions/download-artifact@v3
        with:
          name: android-aab
          path: ./artifacts

      - name: Download XCFramework
        uses: actions/download-artifact@v3
        with:
          name: ios-xcframework
          path: ./artifacts

      # ---------- Google Play ----------
      - name: Deploy to Google Play (internal track)
        if: github.ref == 'refs/heads/main'
        uses: r0adkll/upload-google-play@v1
        with:
          serviceAccountJsonPlainText: ${{ secrets.PLAY_SERVICE_ACCOUNT }}
          packageName: com.example.mykmpapp
          releaseFiles: ./artifacts/app-release.aab
          track: internal

      # ---------- App Store Connect ----------
      - name: Convert XCFramework to .ipa (Xcode)
        run: |
          xcodebuild -create-xcframework \
            -framework ./artifacts/MyKmpApp.xcframework.zip \
            -output MyKmpApp.xcframework
          # 簡易的に ipa へラップ（実際は Xcode Archive が必要）
          xcrun altool --upload-app -f MyKmpApp.xcframework -t ios

      - name: Upload to App Store Connect
        uses: appleboy/app-store-connect@v2
        with:
          api_key_id: ${{ secrets.APP_STORE_CONNECT_KEY_ID }}
          issuer_id: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}
          private_key: ${{ secrets.APP_STORE_CONNECT_PRIVATE_KEY }}
          ipa_path: MyKmpApp.xcframework   # 実際は .ipa が必要

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

on:

push:

branches: [ main ]

pull_request:

jobs:

# -------------------------------------------------

# 共通ビルド環境（macOS が iOS ビルドに必須）

# -------------------------------------------------

setup:

runs-on: macos-13

outputs:

java-version: ${{ steps.java.outputs.version }}

steps:

- uses: actions/checkout@v3

# JDK 17 のセットアップ（macOS, Linux 共通）

- name: Set up JDK 17

id: java

uses: actions/setup-java@v3

with:

distribution: temurin

java-version: '17'

# Android SDK のインストール

- name: Install Android SDK

uses: android-actions/setup-android@v2

# Gradle キャッシュ設定

- name: Cache Gradle packages

uses: actions/cache@v3

with:

path: |

~/.gradle/caches

~/.gradle/wrapper

key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle.kts') }}

restore-keys: |

${{ runner.os }}-gradle-

# -------------------------------------------------

# テスト実行ジョブ（Android + iOS 共通）

# -------------------------------------------------

test:

needs: setup

runs-on: macos-13

steps:

- uses: actions/checkout@v3

# JDK と Android SDK は前の job で設定済みなので再利用

- name: Restore Gradle cache

uses: actions/cache@v3

with:

path: |

~/.gradle/caches

~/.gradle/wrapper

key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle.kts') }}

# すべてのテストを実行

- name: Run all unit & instrumented tests

run: ./gradlew clean testDebugUnitTest assembleDebug

# iOS の Kotlin/Native テスト

- name: Run iOS (Simulator) tests

run: |

xcodebuild -scheme MyKmpApp \

-destination 'platform=iOS Simulator,name=iPhone 15,OS=latest' \

test

# -------------------------------------------------

# ビルド & アーティファクト生成ジョブ

# -------------------------------------------------

build:

needs: test

runs-on: macos-13

steps:

- uses: actions/checkout@v3

- name: Build Android AAB

run: ./gradlew :app:bundleRelease

- name: Build iOS XCFramework

run: |

./gradlew :shared:linkReleaseFrameworkIosArm64 \

:shared:linkReleaseFrameworkIosX64

# 生成された .framework を zip にまとめる

cd shared/build/bin/iosArm64/releaseFramework/

zip -r MyKmpApp.xcframework.zip *.xcframework

# アーティファクトを保存（GitHub の UI からダウンロード可能に）

- name: Upload AAB artifact

uses: actions/upload-artifact@v3

with:

path: app/build/outputs/bundle/release/app-release.aab

- name: Upload XCFramework artifact

uses: actions/upload-artifact@v3

with:

path: shared/build/bin/**/*.zip

# -------------------------------------------------

# デプロイジョブ（Google Play & App Store Connect）

# -------------------------------------------------

deploy:

needs: build

runs-on: macos-13

steps:

- uses: actions/checkout@v3

# ダウンロードしたビルド成果物を取得

- name: Download AAB

uses: actions/download-artifact@v3

with:

path: ./artifacts

- name: Download XCFramework

uses: actions/download-artifact@v3

with:

path: ./artifacts

# ---------- Google Play ----------

- name: Deploy to Google Play (internal track)

if: github.ref == 'refs/heads/main'

uses: r0adkll/upload-google-play@v1

with:

serviceAccountJsonPlainText: ${{ secrets.PLAY_SERVICE_ACCOUNT }}

packageName: com.example.mykmpapp

releaseFiles: ./artifacts/app-release.aab

track: internal

# ---------- App Store Connect ----------

- name: Convert XCFramework to .ipa (Xcode)

run: |

xcodebuild -create-xcframework \

-framework ./artifacts/MyKmpApp.xcframework.zip \

-output MyKmpApp.xcframework

# 簡易的に ipa へラップ（実際は Xcode Archive が必要）

xcrun altool --upload-app -f MyKmpApp.xcframework -t ios

- name: Upload to App Store Connect

uses: appleboy/app-store-connect@v2

with:

api_key_id: ${{ secrets.APP_STORE_CONNECT_KEY_ID }}

issuer_id: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}

private_key: ${{ secrets.APP_STORE_CONNECT_PRIVATE_KEY }}

ipa_path: MyKmpApp.xcframework # 実際は .ipa が必要

ポイント解説

ステップ	目的・補足
`setup`	macOS ランナーで JDK と Android SDK を一度だけインストールし、キャッシュを共有。
`test`	`./gradlew testDebugUnitTest` で共通ユニットテスト、`xcodebuild test` で iOS シミュレータ上の XCTest を実行。
`build`	Android AAB と iOS XCFramework（または .ipa）を生成し、後続ジョブへアーティファクトとして渡す。
`deploy`	Google Play の internal トラックと App Store Connect に自動アップロード。シークレット管理は必須。

デバッグ・プロファイリングの実践

KSP 生成コードの確認
Android Studio: Build > Show Generated Sources... → build/generated/ksp/... を開く。
macOS ターミナルで iOS の場合は ./gradlew :shared:compileKotlinIosArm64 --info とすれば生成ファイルのパスが出力されます。
CPU / メモリプロファイラ
Android Studio Profiler → アプリ起動中に CPU、Memory、Network タブでリアルタイム計測。KSP が生成したコードは通常のクラスと同様にプロファイル対象です。
Xcode Instruments → Allocations と Time Profiler を使い、MyKmpApp.framework 内のシンボルを追跡します。
ログ出力とデバッグブレークポイント
Kotlin/Native では println() が標準出力に流れますが、Xcode のコンソールでも確認可能です。
Android Studio と Xcode 両方で同一ブレークポイントを設定できるように、コードは commonMain に置き、expect/actual でプラットフォーム差分だけ抽象化します。

注意：KSP はビルド時のみ実行されるため、ランタイムオーバーヘッドはありませんが、生成コードが大規模になると デバッグシンボルサイズ が増える点に留意してください。

まとめ

開発環境は JDK 17 以上、Android Studio の最新安定版、macOS 上の最新版 Xcode を揃え、Kotlin プラグインと KSP を導入すればトラブルが激減します。
Gradle Kotlin DSL と Version Catalog による依存管理はバージョンアップを一箇所で完結させ、プロジェクト規模が拡大しても保守コストを抑えられます。
Expect/Actual パターンとマルチプラットフォーム対応ライブラリ（Ktor・SQLDelight・atomicfu）を組み合わせることで、ビジネスロジックは完全に共有可能です。
UI は Compose Multiplatform と SwiftUI のハイブリッド から選択し、プロジェクト要件とチームの技術スタックに合わせて最適なアーキテクチャを決定してください。
テスト戦略は共通ユニットテスト＋プラットフォーム固有テストで網羅的にカバーし、GitHub Actions の完全サンプルワークフローを活用すれば CI/CD が自動化されます。
デバッグ・プロファイリングは Android Studio と Xcode の標準ツールで十分対応でき、KSP 生成コードの確認手順も明示しておくと安心です。

これらの手順とベストプラクティスを踏襲すれば、Kotlin Multiplatform アプリ開発が 高速・安全・拡張性の高い プロセスへと変貌し、チーム全体の生産性向上に直結します。ぜひ本ガイドをプロジェクトの立ち上げ時に活用してください。

スポンサードリンク

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

スポンサードリンク

働き方から選べる

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

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

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

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

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

Beyond Careerに無料相談する

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

-Kotlin

comment コメントをキャンセル

: Kotlin

Kotlin Multiplatform プロジェクト構築ガイド 2026年版 | Android Studio & iOS対応

KMM初心者向けに、Android Studioのテンプレート選択から共有コード分離・Swift連携までを解説。公式Codelabと最新ツール活用で効率的な開発を実現。

: Kotlin

KotlinのNull安全性と実務で活用するテクニック

Kotlinは型システムでnull許容と非nullを区別し、?.やElvis演算子、let、拡張関数などでNullPointerExceptionを防ぎます。実務例も紹介。

: Kotlin

Kotlin Multiplatform 開発環境とセットアップ完全ガイド

公式が推奨する最新ツールでKotlin Multiplatform環境を構築し、Android と iOS の開発をスムーズに始める方法をまとめました。

: Kotlin

Kotlin NativeでiOSアプリ開発: 実装手順とビルド方法

Kotlin MultiplatformによるiOSアプリ開発手順を解説。環境構築、CocoaPods設定、Swiftとのインターフェース設計まで詳細に記載。

: Kotlin

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

Kotlinコルーチンのライフサイクル管理や中断可能関数（suspend）の使い方、UIフリーズ防止策とAndroidでの実装例を解説。非同期処理の最適化に必要な知識を網羅。

2026年 WOWOW 新作映画ラインナップ全体像と視聴ガイド

Laravel 10 Migration Guide: Checklist & Step‑by‑Step Process

Kotlinマルチプラットフォーム開発環境のセットアップと最新手順

開発環境のセットアップ

JDK と Android Studio のインストール

iOS 開発環境の準備（Xcode）

Kotlin プラグインと関連ツールの導入

KMP プロジェクトの作成と Gradle 設定

プロジェクト雛形の生成

settings.gradle.kts に Version Catalog を有効化

libs.versions.toml（例）

Kotlin Multiplatform と Compose のプラグイン設定

Version Catalog の活用例とベストプラクティス

共通コード層の設計とマルチプラットフォームライブラリ活用

Expect / Actual によるプラットフォーム差分抽象化

Android 実装

iOS (Kotlin/Native) 実装

Ktor によるネットワーク層の共有

共通モジュール

プラットフォーム別エンジン設定（Expect/Actual パターン）

SQLDelight によるデータベース層の統一

Gradle 設定（build.gradle.kts）

ドライバ抽象化（Expect/Actual）

DAO の利用例（commonMain）

@SharedImmutable と atomicfu ライブラリの活用

依存追加（libs.versions.toml）

コード例

UI 実装の選択肢と比較ガイド

Compose Multiplatform で統一的に UI を構築

プレビューの書き方（iOS も含めて）

SwiftUI と KMP のブリッジパターン

Swift 側コード例

KMP 側の GreetingUseCase（共通コード）

フレームワーク選択の判断基準

テスト・デバッグ・ビルド・リリースフロー

ユニットテストとプラットフォーム固有テスト

共通モジュール (commonTest) の例

Android Instrumented Test

iOS XCTest（Swift 側）

完全版 GitHub Actions パイプライン

デバッグ・プロファイリングの実践

まとめ

KMP 側の `GreetingUseCase`（共通コード）

共通モジュール (`commonTest`) の例