Skip to content

iOS 統合方法 ​

Kotlin Multiplatform の共有モジュールを iOS アプリに統合できます。そのためには、共有モジュールから iOS フレームワークを生成し、それを iOS プロジェクトに依存関係として追加します。

iOS integration scheme

このフレームワークは、ローカルまたはリモートの依存関係として利用できます。コードベース全体を完全に制御し、共通コードの変更を最終的なアプリケーションに即座に反映させたい場合は、ローカル統合を選択してください。

最終的なアプリケーションのコードベースを共通コードベースから明示的に分離したい場合は、リモート統合を設定します。この場合、共有コードは通常のサードパーティ製依存関係のように最終的なアプリケーションに統合されます。

ローカル統合 ​

ローカルセットアップでは、主に 2 つの統合オプションがあります。特別なスクリプトによる直接統合を使用でき、これにより Kotlin のビルドが iOS のビルドの一部になります。Kotlin Multiplatform プロジェクトに Pod の依存関係がある場合は、CocoaPods 統合のアプローチを採用してください。

直接統合 ​

Xcode プロジェクトに特別なスクリプトを追加することで、Kotlin Multiplatform プロジェクトから iOS フレームワークを直接接続できます。このスクリプトは、プロジェクトのビルド設定のビルドフェーズ(build phase)に統合されます。

この統合方法は、Kotlin Multiplatform プロジェクトで CocoaPods の依存関係をインポートしない場合に適しています。

Kotlin Multiplatform IDE プラグインを使用している場合、デフォルトで直接統合が適用されます。

詳細については、直接統合を参照してください。

ローカルパッケージによる SwiftPM 統合 ​

KMP の iOS フレームワークは、Swift Package Manager を通じてローカルの Swift パッケージに依存できます。

この統合方法は、以下の場合に適しています:

  • Swift パッケージを使用する iOS プロジェクトを含むモノリポジトリ(mono repository)構成である場合
  • Kotlin Multiplatform プロジェクトに、代替不可能な CocoaPods の依存関係がない場合

プロジェクトにローカルの Swift パッケージの依存関係を追加する方法については、依存関係としての Swift パッケージの追加を参照してください。

ローカル podspec による CocoaPods 統合 ​

Swift および Objective-C プロジェクトで一般的な依存関係マネージャーである CocoaPods を介して、Kotlin Multiplatform プロジェクトから iOS フレームワークを接続できます。

この統合方法は、以下の場合に適しています:

  • CocoaPods を使用する iOS プロジェクトを含むモノリポジトリ(mono repository)構成である場合
  • Kotlin Multiplatform プロジェクトで CocoaPods の依存関係をインポートしている場合

ローカルの CocoaPods 依存関係を使用したワークフローを設定する方法については、CocoaPods の概要とセットアップを参照してください。

リモート統合 ​

リモート統合では、プロジェクトで Swift Package Manager (SwiftPM) または CocoaPods 依存関係マネージャーを使用して、Kotlin Multiplatform プロジェクトから iOS フレームワークを接続できます。

XCFrameworks を使用した SwiftPM ​

Kotlin Multiplatform プロジェクトから XCFramework をエクスポートすることと、リモートの Swift パッケージを依存関係として KMP プロジェクトにインポートすることの両方が可能です:

XCFrameworks を使用した CocoaPods 統合 ​

Kotlin CocoaPods Gradle プラグインを使用して XCFrameworks をビルドし、プロジェクトの共有部分を CocoaPods 経由でモバイルアプリとは別に配布できます。

詳細については、最終的なネイティブバイナリのビルドを参照してください。