Android アプリケーションを iOS で動作させる – チュートリアル
このチュートリアルでは、既存の Android アプリケーションをクロスプラットフォーム化し、Android と iOS の両方で動作させる方法を説明します。 Android と iOS の両方のコードを一度に、同じ場所で記述できるようになります。
このチュートリアルでは、ユーザー名とパスワードを入力するための単一画面を持つ サンプル Android アプリケーション を使用します。入力された認証情報は検証され、インメモリデータベースに保存されます。
アプリケーションを iOS と Android の両方で動作させるには、まず一部のコードを共有モジュール(shared module)に移動してコードをクロスプラットフォーム化します。 その後、クロスプラットフォーム化したコードを Android アプリケーションで使用し、さらに同じコードを新しい iOS アプリケーションでも使用します。
Kotlin Multiplatform にまだ慣れていない場合は、まず クロスプラットフォームアプリケーションをゼロから作成する 方法をご覧ください。
開発環境の準備
クイックスタートの指示に従って、Kotlin Multiplatform 開発用の環境をセットアップ します。
iOS アプリケーションの実行など、このチュートリアルの特定の手順を完了するには macOS を搭載した Mac が必要です。 これは Apple の要件によるものです。
Android Studio で、バージョン管理から新しいプロジェクトを作成します:
texthttps://github.com/Kotlin/kmp-integration-samplemasterブランチにはプロジェクトの初期状態(シンプルな Android アプリケーション)が含まれています。 iOS アプリケーションと共有モジュールを含む最終状態を確認するには、finalブランチに切り替えてください。Project ビューに切り替えます:

コードのクロスプラットフォーム化
コードをクロスプラットフォーム化するには、以下の手順に従います:
- クロスプラットフォーム化するコードの決定
- クロスプラットフォームコード用の共有モジュールの作成
- コード共有のテスト
- Android アプリケーションに共有モジュールへの依存関係を追加
- ビジネスロジックのクロスプラットフォーム化
- Android でクロスプラットフォームアプリケーションを実行
クロスプラットフォーム化するコードの決定
Android アプリケーションのどのコードを iOS と共有し、どのコードをネイティブのまま残すかを決定します。シンプルなルールとして、「可能な限り再利用したいものを共有する」というものがあります。ビジネスロジックは Android と iOS の両方で同じであることが多いため、再利用に最適な候補です。
サンプルの Android アプリケーションでは、ビジネスロジックは com.jetbrains.simplelogin.androidapp.data パッケージに格納されています。今後作成する iOS アプリケーションでも同じロジックを使用するため、これもクロスプラットフォーム化する必要があります。

クロスプラットフォームコード用の共有モジュールの作成
iOS と Android の両方で使用されるクロスプラットフォームコードは、共有モジュールに格納されます。 Android Studio と IntelliJ IDEA の両方に、Kotlin Multiplatform 用の共有モジュールを作成するためのウィザードが用意されています。
既存の Android アプリケーションと今後作成する iOS アプリケーションの両方に接続するための共有モジュールを作成します:
Android Studio で、メインメニューから File | New | New Module を選択します。
テンプレートの一覧から Kotlin Multiplatform Shared Module を選択します。 モジュール名は
sharedのままにし、パッケージ名を入力します:textcom.jetbrains.simplelogin.sharedFinish をクリックします。ウィザードによって共有モジュールが作成され、それに応じてビルドスクリプトが変更され、Gradle の同期(sync)が開始されます。
同期が完了するのを待ちます。
sharedディレクトリ内に以下のようなファイル構造が表示されます:
生成されたプロジェクトのレイアウトをより詳しく理解したい場合は、Kotlin Multiplatform プロジェクト構造の基本 を参照してください。
sharedモジュールは Android アプリケーションのライブラリとして使用されるため、shared/build.gradle.kts内のkotlin.android {}ブロックを以下のandroidLibrary {}ブロックに置き換えます:kotlinimport org.jetbrains.kotlin.gradle.dsl.JvmTarget kotlin { androidLibrary { namespace = "com.jetbrains.simplelogin.shared" compileSdk = libs.versions.android.compileSdk.get().toInt() compilerOptions { jvmTarget = JvmTarget.JVM_11 } androidResources { enable = true } withHostTestBuilder { } withDeviceTestBuilder { sourceSetTreeName = "test" }.configure { instrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" } } //... }
共有モジュールへのコードの追加
共有モジュールが作成できたので、shared/src/commonMain/kotlin/com.jetbrains.simplelogin.shared ディレクトリに共有する共通コードを追加します:
以下のコードを含む新しい
Greetingクラスを作成します:kotlinpackage com.jetbrains.simplelogin.shared class Greeting { private val platform = getPlatform() fun greet(): String { return "Hello, ${platform.name}!" } }既存のファイル内のコードを以下のように置き換えます:
commonMain/Platform.kt内:kotlinpackage com.jetbrains.simplelogin.shared interface Platform { val name: String } expect fun getPlatform(): PlatformandroidMain/Platform.android.kt内:kotlinpackage com.jetbrains.simplelogin.shared import android.os.Build class AndroidPlatform : Platform { override val name: String = "Android ${Build.VERSION.SDK_INT}" } actual fun getPlatform(): Platform = AndroidPlatform()iosMain/Platform.ios.kt内:kotlinpackage com.jetbrains.simplelogin.shared import platform.UIKit.UIDevice class IOSPlatform: Platform { override val name: String = UIDevice.currentDevice.systemName() + " " + UIDevice.currentDevice.systemVersion } actual fun getPlatform(): Platform = IOSPlatform()
これで、プラットフォーム名をプロパティとして持つプラットフォーム固有のオブジェクトを返す共通の getPlatform() 関数が用意できました。
Android アプリケーションに共有モジュールへの依存関係を追加
Android アプリケーションでクロスプラットフォームコードを使用するには、共有モジュールを接続し、ビジネスロジックコードをそこに移動して、そのコードをクロスプラットフォーム化します。
app/build.gradle.ktsファイルに共有モジュールへの依存関係を追加します:kotlindependencies { // ... implementation(project(":shared")) }IDE のプロンプトに従うか、File | Sync Project with Gradle Files メニュー項目を使用して Gradle ファイルを同期します。
app/src/main/java/ディレクトリで、com.jetbrains.simplelogin.androidapp.ui.loginパッケージ内のLoginActivity.ktファイルを開きます。共有モジュールがアプリケーションに正常に接続されていることを確認するために、
onCreate()メソッドにLog.i()呼び出しを追加してgreet()関数の結果をログに出力します:kotlinoverride fun onCreate(savedInstanceState: Bundle?) { enableEdgeToEdge() super.onCreate(savedInstanceState) Log.i("Login Activity", "Hello from shared module: " + (Greeting().greet())) // ... }IDE の提案に従って、不足しているクラスをインポートします。
ツールバーで、実行構成ドロップダウンの横にあるデバッグアイコンをクリックします:

Logcat ツールウィンドウでログ内の「Hello」を検索すると、共有モジュールからの挨拶が表示されます:

ビジネスロジックのクロスプラットフォーム化
これで、ビジネスロジックコードを Kotlin Multiplatform 共有モジュールの commonMain ソースセットに抽出できるようになりました。 これにより、Android と iOS の両方でコードを使用できるようになります。
ビジネスロジックコード
com.jetbrains.simplelogin.androidapp.dataをappディレクトリからshared/src/commonMainディレクトリのcom.jetbrains.simplelogin.sharedパッケージへ移動します。
Android Studio からどのような処理を行うか尋ねられたら、パッケージの移動を選択し、リファクタリングを承認します。

プラットフォーム依存のコードに関するすべての警告を無視し、Refactor Anyway をクリックします。

Android 固有のコードをクロスプラットフォームの Kotlin コードに置き換えるか、expect/actual 宣言 を使用して Android 固有の API に接続することで、Android 固有のコードを削除します。詳細については以下のセクションを参照してください:
Android 固有のコードをクロスプラットフォームコードに置き換える
コードが Android と iOS の両方で適切に動作するように、移動した
dataディレクトリ内のすべての JVM 依存関係を可能な限り Kotlin の依存関係に置き換えます。LoginDataValidatorクラスで、android.utilsパッケージのPatternsクラスを、メール検証用のパターンに一致する Kotlin の正規表現に置き換えます:kotlin// 変更前 private fun isEmailValid(email: String) = Patterns.EMAIL_ADDRESS.matcher(email).matches()kotlin// 変更後 private fun isEmailValid(email: String) = emailRegex.matches(email) companion object { private val emailRegex = ("[a-zA-Z0-9\\+\\.\\_\\%\\-\\+]{1,256}" + "\\@" + "[a-zA-Z0-9][a-zA-Z0-9\\-]{0,64}" + "(" + "\\." + "[a-zA-Z0-9][a-zA-Z0-9\\-]{0,25}" + ")+").toRegex() }Patternsクラスのインポートディレクティブを削除します:kotlinimport android.util.PatternsLoginDataSourceクラスで、login()関数内のIOExceptionをRuntimeExceptionに置き換えます。IOExceptionは Kotlin/JVM 以外では利用できません。```kotlin // 変更前 return Result.Error(IOException("Error logging in", e)) ``` ```kotlin // 変更後 return Result.Error(RuntimeException("Error logging in", e)) ```IOExceptionのインポートディレクティブも同様に削除します:kotlinimport java.io.IOException
プラットフォーム固有の UUID 生成を実装する
LoginDataSourceクラスでは、fakeUserの汎用一意識別子(UUID)がjava.util.UUIDクラスを使用して生成されていますが、これは iOS では利用できません。kotlinval fakeUser = LoggedInUser(java.util.UUID.randomUUID().toString(), "Jane Doe")Kotlin 標準ライブラリには UUID 生成用のクラス が用意されていますが、ここではプラットフォーム固有の機能の接続を練習するために、プラットフォーム固有の機能を使用してみましょう。
共有コードで
randomUUID()関数のexpect宣言を提供し、Android と iOS の各プラットフォームに対応するソースセットでそのactual実装を提供します。 詳細については、プラットフォーム固有の API への接続 を参照してください。login()関数内のjava.util.UUID.randomUUID()呼び出しを、各プラットフォーム向けに実装するrandomUUID()呼び出しに変更します:kotlinval fakeUser = LoggedInUser(randomUUID(), "Jane Doe")shared/src/commonMainディレクトリのcom.jetbrains.simplelogin.sharedパッケージにUtils.ktファイルを作成し、expect宣言を提供します:kotlinpackage com.jetbrains.simplelogin.shared expect fun randomUUID(): Stringshared/src/androidMainディレクトリのcom.jetbrains.simplelogin.sharedパッケージにUtils.android.ktファイルを作成し、Android 向けのrandomUUID()のactual実装を提供します:kotlinpackage com.jetbrains.simplelogin.shared import java.util.* actual fun randomUUID() = UUID.randomUUID().toString()shared/src/iosMainディレクトリのcom.jetbrains.simplelogin.sharedパッケージにUtils.ios.ktファイルを作成し、iOS 向けのrandomUUID()のactual実装を提供します:kotlinpackage com.jetbrains.simplelogin.shared import platform.Foundation.NSUUID actual fun randomUUID(): String = NSUUID().UUIDString()shared/src/commonMainディレクトリのLoginDataSource.ktファイルにrandomUUID関数をインポートします:kotlinimport com.jetbrains.simplelogin.shared.randomUUID
これで、Kotlin は Android と iOS 向けにプラットフォーム固有の UUID 実装を使用するようになります。
Android でクロスプラットフォームアプリケーションを実行
app 実行構成を実行して、Android アプリが以前と同じように動作することを確認します。

iOS でクロスプラットフォームアプリケーションを動作させる
Android アプリケーションをクロスプラットフォーム化したら、iOS アプリケーションを作成し、共有ビジネスロジックをその中で再利用できます。
- Xcode で iOS プロジェクトを作成
- KMP フレームワークを使用するように iOS プロジェクトを設定
- Android Studio で iOS の実行構成を設定
- iOS プロジェクトで共有モジュールを使用
Xcode で iOS プロジェクトを作成
Xcode で、File | New | Project をクリックします。
ダイアログで、iOS タブに切り替えます:

App テンプレートを選択し、Next をクリックします。
プロダクト名として「simpleLoginIOS」を指定し、Next をクリックします。

プロジェクトの保存場所として、クロスプラットフォームアプリケーションを格納しているディレクトリ(例:
kmp-integration-sample)を選択します。Android Studio では、以下のような構造になります:

クロスプラットフォームプロジェクトの他のトップレベルディレクトリとの一貫性を保つため、Xcode を閉じて、
simpleLoginIOSディレクトリの名前をiosAppに変更します。Xcode を開いたままフォルダの名前を変更すると、警告が表示され、プロジェクトが破損する可能性があります。

KMP フレームワークを使用するように iOS プロジェクトを設定
iOS アプリと Kotlin Multiplatform によってビルドされたフレームワークとの連携を直接設定できます。
この方法の代替手段(SwiftPM および CocoaPods)については、iOS 連携方法の概要 で説明されています。
Android Studio で、
iosApp/simpleLoginIOS.xcodeprojディレクトリを右クリックし、Open In | Open In Associated Application を選択して Xcode で iOS プロジェクトを開きます。Xcode で、Project ナビゲータのプロジェクト名をクリックして iOS プロジェクト設定を開きます。
左側の Targets セクションで simpleLoginIOS を選択し、Build Phases タブをクリックします。
+ アイコンをクリックし、New Run Script Phase を選択します。

run script フィールドに以下のスクリプトを貼り付けます:
bashif [ "YES" = "$OVERRIDE_KOTLIN_BUILD_IDE_SUPPORTED" ]; then echo "Skipping Gradle build task invocation due to OVERRIDE_KOTLIN_BUILD_IDE_SUPPORTED environment variable set to \"YES\"" exit 0 fi cd "$SRCROOT/.." ./gradlew :shared:embedAndSignAppleFrameworkForXcodeBased on dependency analysis オプションを無効にします。 これにより、Xcode がビルドのたびにスクリプトを実行するようになり、出力の依存関係の欠落に関する警告が毎回表示されるのを防ぎます。

Run Script フェーズを上へ移動し、Compile Sources フェーズの前に配置します:

Build Settings タブで、Build Options の下にある User Script Sandboxing オプションを無効にします:

デフォルトの
DebugやReleaseと異なるカスタムビルド構成を使用している場合は、Build Settings タブの User-Defined にKOTLIN_FRAMEWORK_BUILD_TYPE設定を追加し、DebugまたはReleaseに設定してください。Info タブで、カスタムの
CADisableMinimumFrameDurationOnPhoneプロパティを追加し、YESに設定して iOS での高リフレッシュレートを有効にします。Signing & Capabilities タブで、開発チームを選択するか、まだ作成していない場合は作成します。 これにより、KMP モジュールによって生成された
sharedフレームワークの署名が有効になります。ここでは、Bundle Identifier に一意の値が設定されていることも確認してください。そうしないと Xcode でビルドに失敗する可能性があります。
Xcode でプロジェクトをビルドします(メインメニューの Product | Build)。 すべてが正しく設定されていれば、プロジェクトは正常にビルドされるはずです (「build phase will be run during every build」という警告は無視しても問題ありません)。
User Script Sandboxing オプションを無効にする前にプロジェクトをビルドした場合、ビルドが失敗することがあります。 Gradle デーモンプロセスがサンドボックス化されている可能性があるため、再起動が必要です。 プロジェクトディレクトリ(この例では
kmp-integration-sample)で次のコマンドを実行し、プロジェクトを再度ビルドする前にデーモンを停止してください:shell./gradlew --stop
Android Studio で iOS の実行構成を設定
Xcode のセットアップが正しく完了していることを確認したら、Android Studio に戻ります:
メインメニューで File | Sync Project with Gradle Files を選択します。Android Studio は simpleLoginIOS という名前の実行構成を自動的に生成します。
Android Studio は simpleLoginIOS という名前の実行構成を自動的に生成し、
iosAppディレクトリをリンクされた Xcode プロジェクトとしてマークします。実行構成のリストで simpleLoginIOS を選択します。 iOS エミュレータを選択し、Run をクリックして iOS 実行構成が正しく動作することを確認します。

iOS プロジェクトで共有モジュールを使用
shared/build.gradle.kts ファイルでは、各 iOS ターゲットの binaries.framework.baseName プロパティが sharedKit として定義されています。 これは、Kotlin Multiplatform が iOS アプリで使用するためにビルドするフレームワークの名前です。
連携をテストするために、Swift コードに共通コードへの呼び出しを追加します:
Android Studio で
iosApp/simpleloginIOS/ContentView.swiftファイルを開き、フレームワークをインポートします:swiftimport sharedKit適切に接続されていることを確認するために、
ContentView構造体のコードを更新してsharedモジュールのgreet()関数を使用するようにします:swiftstruct ContentView: View { var body: some View { Text(Greeting().greet()) .padding() } }Android Studio の iOS 実行構成を使用してアプリを実行し、結果を確認します:

ContentView.swiftファイルのコードを再度更新し、共有モジュールのビジネスロジックを使用してアプリケーション UI を描画します:kotlinsimpleLoginIOSApp.swiftファイルで、sharedKitモジュールをインポートし、ContentView()関数の引数を指定します:swiftimport SwiftUI import sharedKit @main struct SimpleLoginIOSApp: App { var body: some Scene { WindowGroup { ContentView(viewModel: .init(loginRepository: LoginRepository(dataSource: LoginDataSource()), loginValidator: LoginDataValidator())) } } }iOS 実行構成を再度実行して、iOS アプリにログインフォームが表示されることを確認します。
ユーザー名に「Jane」、パスワードに「password」と入力します。
先ほど連携を設定した ため、iOS アプリは共通コードを使用して入力を検証します:

結果の確認 – ロジックの更新は一度だけ
これでアプリケーションがクロスプラットフォーム化されました。shared モジュールのビジネスロジックを更新すれば、Android と iOS の両方でその結果を確認できます。
ユーザーのパスワードの検証ロジックを変更します:「password」は無効なオプションとします。 これを行うには、
LoginDataValidatorクラスのcheckPassword()関数を更新します (素早く見つけるには、Shift を2回押し、クラス名を貼り付けて Classes タブに切り替えます):kotlinpackage com.jetbrains.simplelogin.shared.data class LoginDataValidator { //... fun checkPassword(password: String): Result { return when { password.length < 5 -> Result.Error("Password must be >5 characters") password.lowercase() == "password" -> Result.Error("Password shouldn't be \"password\"") else -> Result.Success } } //... }Android Studio から iOS と Android の両方のアプリケーションを実行して変更を確認します (iOS のエラーメッセージは、赤い警告三角形をタップすると表示されます):

このチュートリアルの 最終的なコード を確認できます。
他に何を共有できるか?
ここではアプリケーションのビジネスロジックを共有しましたが、アプリケーションの他のレイヤーも共有することを検討できます。 たとえば、ViewModel クラスのコードは Android と iOS アプリケーション でほぼ同じであり、モバイルアプリケーションで同一のプレゼンテーション層を持たせる必要がある場合は、これも共有することが可能です。
次のステップ
Android アプリケーションをクロスプラットフォーム化したら、さらに以下のステップに進むことができます:
Compose Multiplatform を使用して、すべてのプラットフォームで統一された UI を作成できます:
- Compose Multiplatform と Jetpack Compose について学ぶ
- Compose Multiplatform の利用可能なリソースを確認する
- 共有ロジックと UI を持つアプリを作成する
コミュニティリソースも確認できます:
