Kotlin Multiplatform(KMP)による共有ライブラリの構築:AndroidとiOS間でビジネスロジックとネットワーク通信を共通化する

Programming tutorial - IT technology blog
Programming tutorial - IT technology blog

モバイルアプリ開発における「二重作業」の罠

2つのプラットフォーム、2つのコードベース、しかし提供する機能はまったく同じ――。AndroidチームがRetrofitとMoshiを使ってリポジトリ層を書いているすぐ隣で、iOSチームはURLSessionとSwift Decodableを使って寸分違わぬ同一のロジックを実装しています。プロダクト側がチェックアウト時のバリデーションルールをたった1つ変更しただけでも、両チームが慌ててコード修正に追われます。そして本番環境でエッジケースのパースエラーが発生すれば、調査も修正も2回ずつ行わなければなりません。

以前関わった8名のモバイルエンジニアからなるフィンテックプロジェクトでは、プラットフォーム間の仕様同期だけに2週間のスプリントの35%が費やされていました。毎週何十時間もかけてプルリクエストを比較し、プラットフォーム間でデータモデルを揃える作業を行っていたのです。しかし、Kotlin Multiplatform(KMP)を採用したことで、その無駄なオーバーヘッドは完全に解消されました。わずか2四半期のうちに約8,000行に及ぶ重複したネットワーク通信コードを削減し、プラットフォーム差異に起因するリグレッションバグを半減させることができました。

KMPなら、アプリ全体を一から書き直すような極端な移行は不要です。UIコードは完全にネイティブのまま維持できます――iOSならSwiftUI、AndroidならJetpack Composeをそのまま使い続けます。その一方で、共有モジュールが舞台裏でネットワークリクエスト、ビジネスロジック、データ永続化、状態バリデーションといったエンジン部分をしっかりと支えてくれます。

Kotlin Multiplatformとは何か(そして何ではないのか)

KMPはFlutterやReact Nativeとは異なります。独自のレンダリングパイプラインで描画したり、ネイティブコンポーネントをラップしたり、共通のデザインシステムを強制したりすることはありません。その代わりに、KotlinコードがAndroid向けにはJVMバイトコードへ、iOS向けにはKotlin/Native(Objective-C/Swiftとの相互運用性を持つ)経由でAppleネイティブフレームワークへと直接コンパイルされます。

共有する範囲を、最もレバレッジの効く領域に絞り込むことが重要です:

  • HTTPリクエスト、インターセプター、JSONシリアライズ
  • ドメインルール、入力バリデーション、データフォーマット処理
  • 共通データモデルとDTO
  • ローカルデータベースのキャッシングとマイグレーション

ビュー層との境界線は明確に引いておきましょう。Viewの状態の抽象化まで共有しようとするモバイルチームは、すぐに各プラットフォーム特有のライフサイクルの問題に悩まされることになります。まずはネットワーク通信とモデルの共通化からスリムに始めましょう。必要に応じて後からスコープを広げれば十分です。

共有モジュールのアーキテクチャ

本番環境で運用されるKMPリポジトリは、通常3つの明確なディレクトリに分かれます:

  • shared/ — 共通ロジックとプラットフォームバインディングを含むマルチプラットフォームGradleモジュール
  • androidApp/ — 共有コードをGradle依存関係として直接利用する標準的なAndroidアプリケーションモジュール
  • iosApp/ — コンパイルされた.xcframework、またはCocoaPods/SPMアーティファクトをリンクするネイティブXcodeプロジェクト

shared/ディレクトリ内では、Kotlinがソースセット(source set)を通じてコンパイルターゲットを整理します:

  • commonMain — すべてのコンパイルターゲット間で共有されるマルチプラットフォームコード
  • androidMain — Android SDK向けにコンパイルされるプラットフォーム固有の実装
  • iosMain — Kotlin/Nativeを通じてAppleプラットフォームAPI向けにコンパイルされるiOS実装

Keychainアクセスやログ出力のようにプラットフォーム固有のAPIが必要になった場合は、commonMainでexpectシグネチャを宣言します。そして、androidMainとiosMainで対応するactual実装を記述します。ターゲット間でコンパイル時に保証されるインターフェース規約のようなものだと考えるとわかりやすいでしょう。

共有モジュールのセットアップ

JetBrainsのWebウィザード(kmp.jetbrains.com)を使えば手軽に始められますが、Gradleファイルを手動で構築することで、マルチプラットフォームターゲットとXCFrameworkパッケージングが実際にどのように連携しているかを深く理解できます。

プロジェクトルートの build.gradle.kts

plugins {
    kotlin("multiplatform") version "2.0.0" apply false
    kotlin("plugin.serialization") version "2.0.0" apply false
    id("com.android.library") version "8.4.0" apply false
}

共有モジュールの build.gradle.kts

Xcodeが追加ツールなしで読み込めるiOSフレームワークを生成するために、XCFrameworkパッケージングタスクを明示的に設定します:

import org.jetbrains.kotlin.gradle.plugin.mpp.apple.XCFrameworkConfig

plugins {
    kotlin("multiplatform")
    kotlin("plugin.serialization")
    id("com.android.library")
}

kotlin {
    androidTarget()

    // iOSアーキテクチャを単一のXCFrameworkにまとめる
    val xcf = XCFramework("SharedKit")
    listOf(
        iosX64(),
        iosArm64(),
        iosSimulatorArm64()
    ).forEach { target ->
        target.binaries.framework {
            baseName = "SharedKit"
            xcf.add(this)
        }
    }

    sourceSets {
        commonMain.dependencies {
            implementation("io.ktor:ktor-client-core:2.3.12")
            implementation("io.ktor:ktor-client-content-negotiation:2.3.12")
            implementation("io.ktor:ktor-serialization-kotlinx-json:2.3.12")
            implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.9.0")
            implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
        }
        androidMain.dependencies {
            implementation("io.ktor:ktor-client-okhttp:2.3.12")
        }
        iosMain.dependencies {
            implementation("io.ktor:ktor-client-darwin:2.3.12")
        }
    }
}

android {
    namespace = "com.example.shared"
    compileSdk = 34
    defaultConfig {
        minSdk = 24
    }
}

エンジンが分離された設計になっている点に注目してください。共通コードはktor-client-coreをターゲットにし、各プラットフォームのソースセットが特化したエンジンを注入します。AndroidのコネクションプーリングにはOkHttpを、iOSにはAppleネイティブのNSURLSessionをベースにしたDarwinエンジンを利用します。

共有ネットワーク通信サービスの実装

以下は、HTTPリクエストとJSONデシリアライズを処理する共有クライアントの実装例です:

// shared/src/commonMain/kotlin/com/example/shared/api/PostsApi.kt
package com.example.shared.api

import io.ktor.client.HttpClient
import io.ktor.client.call.body
import io.ktor.client.plugins.contentnegotiation.ContentNegotiation
import io.ktor.client.request.get
import io.ktor.serialization.kotlinx.json.json
import kotlinx.serialization.Serializable
import kotlinx.serialization.json.Json

@Serializable
data class Post(
    val id: Int,
    val title: String,
    val body: String
)

class PostsApi {
    private val client = HttpClient {
        install(ContentNegotiation) {
            json(Json {
                ignoreUnknownKeys = true
                isLenient = true
            })
        }
    }

    @Throws(Exception::class)
    suspend fun getPosts(): List<Post> {
        return client.get("https://jsonplaceholder.typicode.com/posts").body()
    }

    @Throws(Exception::class)
    suspend fun getPost(id: Int): Post {
        return client.get("https://jsonplaceholder.typicode.com/posts/$id").body()
    }
}

@Throws(Exception::class)アノテーションはAppleプラットフォームにとって極めて重要です。これがないと、suspend関数内でキャッチされなかったKotlinの例外が、Swiftのtry/catchブロックに適切なNSError値として伝播されず、サイレントに失敗するかObjective-Cランタイムをクラッシュさせてしまいます。

expect/actual によるプラットフォーム差異の吸収

ネイティブのログ出力やローカルストレージが必要な場合は、commonMainでプラットフォーム規約を定義します:

// shared/src/commonMain/kotlin/com/example/shared/platform/Logger.kt
package com.example.shared.platform

expect class Logger() {
    fun log(tag: String, message: String)
}

// shared/src/androidMain/kotlin/com/example/shared/platform/Logger.kt
package com.example.shared.platform

actual class Logger actual constructor() {
    actual fun log(tag: String, message: String) {
        android.util.Log.d(tag, message)
    }
}

// shared/src/iosMain/kotlin/com/example/shared/platform/Logger.kt
package com.example.shared.platform

import platform.Foundation.NSLog

actual class Logger actual constructor() {
    actual fun log(tag: String, message: String) {
        NSLog("[%@] %@", tag, message)
    }
}

Android側で共有コードを利用する

Androidでの利用は非常にシンプルです。androidApp/build.gradle.kts内に共有プロジェクトの参照を追加するだけです:

dependencies {
    implementation(project(":shared"))
}

あとはAndroidのViewModelやActivityから直接APIを呼び出します:

// androidApp/src/main/kotlin/com/example/app/MainActivity.kt
class MainActivity : AppCompatActivity() {
    private val api = PostsApi()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        lifecycleScope.launch {
            try {
                val posts = api.getPosts()
                // 取得した投稿データをJetpack ComposeまたはXMLレイアウトにバインド
            } catch (e: Exception) {
                Log.e("MainActivity", "ネットワークエラー", e)
            }
        }
    }
}

iOS側で共有コードを利用する

プロジェクトのルートディレクトリから以下のGradleタスクを実行し、デバッグ用XCFrameworkをビルドします:

./gradlew :shared:assembleSharedKitDebugXCFramework

ビルドされたフレームワークはshared/build/XCFrameworks/debug/SharedKit.xcframeworkに出力されます。このディレクトリをXcodeプロジェクトのFrameworks, Libraries, and Embedded Contentセクションにドラッグ&ドロップします。これで、SwiftUIビューに直接インポートして利用できるようになります:

// iosApp/ContentView.swift
import SwiftUI
import SharedKit

struct ContentView: View {
    @State private var posts: [Post] = []
    @State private var errorMessage: String? = nil
    private let api = PostsApi()

    var body: some View {
        NavigationStack {
            List(posts, id: \.id) { post in
                VStack(alignment: .leading) {
                    Text(post.title).font(.headline)
                    Text(post.body).font(.subheadline).foregroundColor(.secondary)
                }
            }
            .navigationTitle("共有フィード")
            .overlay {
                if let error = errorMessage {
                    Text(error).foregroundColor(.red)
                }
            }
            .task {
                do {
                    posts = try await api.getPosts()
                } catch {
                    errorMessage = "投稿の読み込みに失敗しました: \(error.localizedDescription)"
                }
            }
        }
    }
}

Kotlinのsuspend関数は、Swiftのasync/await構文へと自然にマッピングされます。UI側ではSwiftらしい直感的なコードを書きながら、その内部では共有されたネットワークロジックを活用できます。

本番運用で早期に対処すべき3つの落とし穴

1. Kotlin/Nativeのメモリ管理とスレッド化ルール

初期バージョンのKotlin/Nativeでは厳格なフリーズルールが適用されており、バックグラウンドスレッドに渡されたオブジェクトは永久にイミュータブル(変更不可)になっていました。この従来のメモリモデルはKotlin 1.7.20で完全に刷新され、1.9.0以降では新モデルがデフォルトになっています。ビルド環境で最新のCoroutines(kotlinx-coroutines-core:1.8.0+)を使用していることを確認してください。もし古いブログ記事で@ThreadLocalやfreeze()の使用が推奨されていても、無視して問題ありません。最新のガベージコレクタは、標準的なJVMメモリとまったく同様に機能します。

2. CIランナーのコスト格差

CI環境でXCFrameworkをコンパイルするにはmacOSハードウェアが必須です。GitHub ActionsのLinuxランナーが1分あたり約0.008ドルであるのに対し、macOSランナーは1分あたり0.08〜0.12ドルと、およそ10倍のコストがかかります。すべての機能開発プルリクエストで完全なiOSフレームワークビルドを実行するのは避けましょう。通常のパイプラインではAndroidのユニットテストとcommonTestを安価なLinuxインスタンスで実行し、macOSでのXCFrameworkビルドはshared/ディレクトリが変更されたプルリクエストや統合ブランチへのマージ時のみトリガーするように設定するのが賢明です。

3. バイナリサイズの増加

Kotlin/Nativeのランタイムと標準ライブラリを組み込むため、iOSアプリには一定のベースラインオーバーヘッドが追加されます。シンプルなKMPネットワークモジュールの場合、非圧縮のリリースバイナリでおよそ1.5MB〜2.5MB程度の増加が見込まれます。しかし実際には、この増加コストはすぐに頭打ちになります。共有ビジネスロジックの規模が1,000行から20,000行に膨らんだとしても、ランタイムの固定オーバーヘッドはすでに支払われているため、バイナリサイズが急激に増えることはほとんどありません。

次のステップ

ネットワーク通信の共通化が確認できたら、次のアーキテクチャマイルストーンはローカル永続化の統合です。SQLDelightやRoom for KMP(Android Jetpackで導入)を使えば、SQLスキーマを一度定義するだけで、AndroidのSQLiteとiOSの(CoreDataを介さない)SQLiteの両方に対応した型安全なデータベースクエリを生成できます。

プラットフォーム間の状態管理アーキテクチャには、DecomposeやKoinの検討をおすすめします。100%ネイティブなView層を維持したまま、ステートマシンや依存性注入(DI)グラフを共通化できます。

大規模な本番運用への導入は、もはや実験段階ではありません。Cash App、9GAG、McDonald’s、Netflixなどの企業が、日々何億人ものユーザーに利用されるアプリでKMPを稼働させています。まずは設定取得エンドポイントや利用規約APIなど、リスクの低い機能から共有モジュールへの移行を試してみてください。APIのバグ修正を2回ではなく1回で済ませられる快適さを一度体験すれば、誰も以前の開発スタイルに戻りたいとは思わなくなるはずです。

Share: