Kotlin マルチプラットフォームを使ってみる
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

1. 始める前に

前提条件

Jetpack Compose アプリを構築する方法に関する知識
Kotlin の使用経験。
Swift 構文に関する基本的な知識。

必要なもの

最新の Android Studio の安定版（Meerkat 以降）。
Xcode 16.1 と iPhone シミュレーター（iOS 16.0 以降を搭載したもの）を搭載した macOS システム。

学習内容

Kotlin マルチプラットフォームの基本を理解する。
プラットフォーム間でコードを共有する方法。
Android と iOS で共有コードを接続する方法。

2. セットアップする

バックアップの手順:

GitHub リポジトリのクローンを作成します。

$ git clone https://github.com/android/codelab-android-kmp.git

または、リポジトリを ZIP ファイルとしてダウンロードすることもできます。

Android Studio で get-started プロジェクトを開きます。このプロジェクトには以下のブランチが含まれます。

main: このプロジェクトのスターターコードが含まれています。これに変更を加えて Codelab を完了します。
end: この Codelab の解答コードが含まれています。

この Codelab では、main ブランチから始めます。Codelab の手順に沿って、自分のペースで進めることができます。

解答コードを確認する場合は、このコマンドを実行します。

$ git clone -b end https://github.com/android/codelab-android-kmp.git

または、解答コードをダウンロードすることもできます。

XCode をインストールします。

この Codelab の iOS 部分をビルドして実行するには、Xcode と iOS シミュレータが必要です。

Mac App Store から Xcode をインストールします（Apple アカウントが必要です）。
インストールが完了したら、Xcode を起動します。
組み込まれているコンポーネントと、ダウンロードが必要なコンポーネントを示すダイアログが表示されます。
iOS 18.4（またはそれ以降）を確認します。
[ダウンロードしてインストール] をクリックします。
コンポーネントがインストールされるまで待ちます。

この Codelab は Xcode 16.3 でテストされています。他のバージョンの Xcode を使用しているときに問題が発生した場合は、この Codelab で説明されているバージョンをダウンロードすることをおすすめします。

サンプルアプリ

このコードベースには、Jetpack Compose でビルドされた Android アプリと SwiftUI でビルドされた iOS アプリの両方が含まれています。Android プロジェクトは androidApp/ フォルダに配置されます。iOS プロジェクトは iosApp/ フォルダに配置され、このフォルダには、Xcode で実行する KMPGetStartedCodelab.xcodeproj も含まれています。

3. Kotlin マルチプラットフォームの概要

Kotlin マルチプラットフォーム（KMP）を使用すると、コードを 1 回記述して、Android、iOS、ウェブ、デスクトップなどの複数のターゲットプラットフォームで共有できます。KMP を活用することで、コードの重複を最小限に抑え、整合性を維持し、開発時間と労力を大幅に削減できます。

KMP では、共有するコードベースの量や部分を判断しません。共有する価値があるコードの部分は、ご自身で判断してください。

この共有コードにより、プラットフォーム間で整合性を維持し、重複を減らすことができます。多くのモバイルチームは、まず個別のビジネスロジック（データベースアクセス、ネットワークアクセスなど）と関連するテストを共有し、その後、追加のコードを共有します。

多くの Android Jetpack ライブラリは KMP をサポートしています。マルチプラットフォーム化された Jetpack ライブラリは、ターゲットプラットフォームに応じて複数のサポートティアを提供します。ライブラリとそのサポートレベルの一覧については、ドキュメントをご覧ください。

たとえば、サポートされているライブラリの 1 つである Room データベースライブラリは、Android、iOS、デスクトップのすべてをサポートしています。これにより、両方のプラットフォームの他のネイティブコードを保持しながら、データベースの作成と関連するデータベースロジックを共通の KMP 共有モジュールに移植できます。

データベースの移行後の次のステップとして、他のドメインロジックを共有することもできます。また、Android Jetpack の ViewModel マルチプラットフォームライブラリの使用も検討してください。

プラットフォーム固有のコードを記述する方法

Kotlin マルチプラットフォームでは、プラットフォーム固有の機能を実装するための新しい手法が導入されています。

expect 宣言と actual 宣言

expect actual Kotlin 言語機能は、IDE を完全にサポートする Kotlin マルチプラットフォームコードベースをサポートするように設計されています。

このアプローチは、プラットフォーム固有の動作を 1 つの関数またはクラスにカプセル化できる場合に最適です。これは柔軟で強力なメカニズムです。たとえば、共通の expect クラスには、よりオープンな可視性修飾子、追加のスーパータイプ、異なるパラメータタイプまたは修飾子を持つ、プラットフォーム固有の actual の対応クラスを設定できます。厳格なインターフェース API では、このようなバリエーションを実現できません。さらに、expect actual は静的に解決されます。つまり、プラットフォーム固有の実装がコンパイル時に適用されます。

Kotlin のインターフェースと実装

両方のプラットフォームで同様の API に準拠しつつ、実装が異なる必要がある場合は、expect 宣言とactual 宣言の代わりに、共有コードでインターフェースを定義できます。このアプローチにより、異なるテスト実装を使用したり、実行時に別の実装に切り替えたりできます。

また、インターフェースには Kotlin 固有の知識は必要ないため、他の言語のインターフェースに精通しているデベロッパーにも使いやすいオプションです。

共通の共有コードのインターフェース、ネイティブコード（Android または Swift）の実装。

場合によっては、KMP コードでは利用できないコードを記述する必要があります。この場合、共有コードでインターフェースを定義し、Android 用に Kotlin で実装し、iOS 用に Swift で対応するインターフェースを用意できます。通常、ネイティブ実装は、依存関係インジェクションまたは直接インジェクションによって共有コードに挿入されます。この戦略により、共有コードの共通インターフェースを維持しながら、各プラットフォームでカスタマイズされたエクスペリエンスを実現できます。

4. Android Studio から Xcode プロジェクトを開きます。

Xcode をインストールしたら、iOS アプリを実行できることを確認する必要があります。

iOS プロジェクトは Android Studio から直接開くことができます。

[Project] ペインを切り替えて Project ビューを使用します。
[root]/iosApp/ フォルダで KmpGetStartedCodelab.xcodeproj ファイルを探します。
ファイルを右クリックし、[開く]、[関連するアプリで開く] の順に選択します。Xcode で iOS アプリが開きます。
⌘+R をクリックするか、[Product] メニューに移動して [Run] を選択して、Xcode でプロジェクトを実行します。

。

5. KMP モジュールを追加する

プロジェクトに KMP のサポートを追加するには、まず、プラットフォーム（Android、iOS）間で再利用されるコードの shared モジュールを作成します。

Android Studio には、KMP 共有モジュールテンプレートを使用して Kotlin マルチプラットフォームモジュールを追加する方法が用意されています。

KMP モジュールを作成するには、Android Studio で次の操作を行います。

[File] > [New] > [New Module] > [Kotlin Multiplatform Shared Module] に移動します。
パッケージを com.example.kmp.shared に変更します。
[Finish] をクリックします。
モジュールの作成が完了し、Gradle の同期が完了すると、プロジェクトに新しい shared モジュールが表示されます。下記のビューを表示するには、[Android] ビューから [Project] ビューに切り替える必要がある場合があります。

KMP 共有モジュールテンプレートによって生成された共有モジュールには、基本的なプレースホルダ関数とテストが含まれています。これらのプレースホルダにより、モジュールが最初から正常にコンパイルされ、実行されます。

重要: iosApp フォルダと iosMain フォルダの違いに注意してください。iosApp フォルダにはスタンドアロンの iOS アプリコードが含まれ、iosMain は追加した KMP 共有モジュールの一部です。iosApp には Swift コードが含まれ、iosMain には iOS プラットフォーム固有の KMP コードが含まれます。

共有モジュールを Android アプリにリンクする

まず、アプリが共有コードを使用できるように、新しい共有モジュールを :androidApp Gradle モジュールの依存関係としてリンクする必要があります。

androidApp/build.gradle.kts ファイルを開きます。
次のように、依存関係ブロックに shared モジュールの依存関係を追加します。

dependencies {
    ...
    implementation(projects.shared)
}

プロジェクトを Gradle ファイルと同期します。

`shared` モジュールへのコードアクセスを確認する

Android アプリが shared モジュールのコードにアクセスできることを確認するため、アプリを簡単に更新します。

KMPGetStartedCodelab プロジェクトで、androidApp/src/main/java/com/example/kmp/getstarted/android/MainActivity.kt にある MainActivity ファイルを開きます。
Text コンポーザブルのコンテンツを変更して、表示される文字列に platform() 情報を含めます。

Text(
  "Hello ${platform()}",
)

キーボードの ⌥(option)+return をクリックし、Import function 'platform' を選択します。
アプリをビルドして、Android デバイスまたはエミュレータで実行します。

この更新により、アプリが shared モジュールから platform() 関数を呼び出せるかどうかが確認されます。Android プラットフォームで実行すると、"Android" が返されます。

6. iOS アプリに共有モジュールを設定する

Swift は、Android アプリのように Kotlin モジュールを直接使用できないため、コンパイル済みバイナリフレームワーク（XCFramework バンドル）を生成する必要があります。XCFramework バンドルは、複数の Apple プラットフォーム用にビルドするために必要なフレームワークとライブラリを含むバイナリパッケージです。

共有ライブラリの配布方法

Android Studio の新しいモジュールテンプレートでは、各 iOS アーキテクチャのフレームワークを生成するように共有モジュールがすでに構成されています。次のコードは、shared モジュールの build.gradle.kts ファイルにあります。

val xcfName = "sharedKit"

iosX64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosSimulatorArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

iOS プロジェクトで共有ライブラリをリンクする

このステップでは、スクリプトを実行して Kotlin フレームワークを生成するように Xcode を設定し、iOS アプリで platform() 関数を呼び出します。

共有ライブラリを使用するには、次の手順で Kotlin フレームワークを iOS プロジェクトに接続する必要があります。

Xcode で iOS プロジェクト（前述の iosApp ディレクトリ）を開き、プロジェクトナビゲータでプロジェクト名をダブルクリックしてプロジェクト設定を開きます。
プロジェクト設定の [Build Phases] タブで、+ をクリックして [New Run Script Phase] を選択します。これにより、他のすべてのフェーズの後に新しい「実行スクリプト」フェーズが追加されます。
[Run Script] のタイトルをダブルクリックして名前を変更します。このフェーズの内容を明確にするために、デフォルトの [Run Script] という名前を [Compile Kotlin Framework] に変更します。
ビルドフェーズを開き、[Shell] の下のテキストフィールドに次のスクリプトコードを入力します。

cd "$SRCROOT/.."
./gradlew :shared:embedAndSignAppleFrameworkForXcode

[Compile Kotlin Framework] フェーズを [Compile Sources] フェーズの前にドラッグします。
⌘+B をクリックするか、プロダクトメニューに移動して [ビルド] を選択して、Xcode でプロジェクトをビルドします。ビルドの進行状況は Xcode の上部に表示されます。

すべてが正しく設定されていれば、プロジェクトは正常にビルドされます。

このように実行スクリプトビルドフェーズを設定すると、共有モジュールをコンパイルするために別のツールに切り替えることなく、Xcode から iOS プロジェクトをコンパイルできます。

`shared` モジュールへのコードアクセスを確認する

iOS アプリが shared モジュールのコードに正常にアクセスできることを確認するには、Android アプリに対して行った簡単な更新を iOS アプリに対して行います。

Xcode の iOS プロジェクトで、Sources/View/ContentView.swift にある ContentView.swift ファイルを開きます。
ファイルの先頭に import sharedKit を追加します。
Text ビューを変更して、表示される文字列に Platform_iosKt.platform() 情報を \(Platform_iosKt.platform()) で含めます。

ファイルの最終的な結果は次のようになります。

import SwiftUI
import sharedKit 

struct ContentView: View {
    var body: some View {
        VStack {
            Image(systemName: "globe")
                .imageScale(.large)
                .foregroundStyle(.tint)
            
            Text("Hello, \(Platform_iosKt.platform())!")
        }
        .padding()
    }
}

⌘+R をクリックするか、[Product] メニューに移動して [Run] をクリックしてアプリを実行します。

このアップデートでは、iOS アプリが共有モジュールから platform() 関数を呼び出せるかどうかを確認します。iOS プラットフォームで実行すると "iOS" が返されます。

7. Swift/Kotlin インターフェースエンハンサ（SKIE）を追加

デフォルトでは、Kotlin が生成したネイティブインターフェースは Objective-C ヘッダーです。Swift は Objective-C と直接互換性がありますが、Objective-C には Swift や Kotlin の最新機能がすべて含まれているわけではありません。

これは、前の例で Swift コードで platform() 呼び出しを直接使用できなかった理由でもあります。Objective-C はグローバル関数をサポートしておらず、クラスにカプセル化された静的関数のみをサポートしているため、KMP はグローバル関数を生成できません。そのため、Platform_iosKt を追加する必要があります。

インターフェースを Swift に適したものにするには、Swift/Kotlin Interface Enhancer（SKIE）ツールを使用して、:shared モジュールの Swift インターフェースを改善します。

SKIE の一般的な機能は次のとおりです。

デフォルト引数のサポートの強化
sealed 階層のサポートを強化（sealed class、sealed interface）
switch ステートメントでの網羅的な処理を備えた enum class のサポートの改善
Flow と AsyncSequence の互換性
suspend fun と async func の互換性

co.touchlab.skie Gradle プラグインを libs.versions.toml ファイルに追加します。

[versions]
skie = "0.10.1"

[plugins]
skie = { id = "co.touchlab.skie", version.ref = "skie" }

プラグインをルートの build.gradle.kts ファイルに追加する

plugins {
   ...
   alias(libs.plugins.skie) apply false
}

プラグインを :shared モジュールの build.gradle.kts ファイルに追加します。

plugins {
   ...
   alias(libs.plugins.skie)
}

Gradle がプロジェクトを同期する

静的関数呼び出しを削除する

iOS アプリを再ビルドしてもすぐには何も変化しませんが、Platform_iosKt 接頭辞を削除して、platform() 関数をグローバル関数として機能させることができます。

Text("Hello, KMP! \(platform())")

これは、SKIE が（他の機能とともに）Swift の API Notesを活用しているためです。API Notes は、Swift コードから API をより適切に使用できるように、API に関する情報を追加します。

8. 完了

これで、Android プロジェクトと iOS プロジェクトに最初の共有 Kotlin マルチプラットフォームコードが追加されました。これは最小限の開始点にすぎませんが、これで KMP でコードを共有するための高度な機能とユースケースを探求できるようになります。

次のステップ

次の codelab では、Jetpack Room を使用して Android と iOS 間でデータレイヤを共有する方法を学びます。

詳細

KMP をサポートする Jetpack ライブラリを確認する
公式の Kotlin マルチプラットフォームのドキュメントを確認する

Kotlin マルチプラットフォームを使ってみる コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

1. 始める前に

前提条件

必要なもの

学習内容

2. セットアップする

XCode をインストールします。

サンプルアプリ

3. Kotlin マルチプラットフォームの概要

共有する内容を決める

プラットフォーム固有のコードを記述する方法

expect 宣言と actual 宣言

Kotlin のインターフェースと実装

共通の共有コードのインターフェース、ネイティブ コード（Android または Swift）の実装。

4. Android Studio から Xcode プロジェクトを開きます。

5. KMP モジュールを追加する

共有モジュールを Android アプリにリンクする

shared モジュールへのコードアクセスを確認する

6. iOS アプリに共有モジュールを設定する

共有ライブラリの配布方法

iOS プロジェクトで共有ライブラリをリンクする

shared モジュールへのコードアクセスを確認する

7. Swift/Kotlin インターフェース エンハンサ（SKIE）を追加

静的関数呼び出しを削除する

8. 完了

次のステップ

詳細

Kotlin マルチプラットフォームを使ってみる
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

共通の共有コードのインターフェース、ネイティブコード（Android または Swift）の実装。

`shared` モジュールへのコードアクセスを確認する

`shared` モジュールへのコードアクセスを確認する

7. Swift/Kotlin インターフェースエンハンサ（SKIE）を追加