直接統合
- ローカルマシン上に iOS をターゲットとする Kotlin Multiplatform プロジェクトが既にセットアップされている。
- Kotlin Multiplatform プロジェクトに CocoaPods の依存関係がない。
Kotlin Multiplatform プロジェクトと iOS プロジェクトの間でコードを共有しながら同時に開発したい場合、専用のスクリプトを使用して直接統合を設定できます。
このスクリプトは、Kotlin フレームワークを Xcode の iOS プロジェクトに接続するプロセスを自動化します:
このスクリプトは、Xcode 環境専用に設計された embedAndSignAppleFrameworkForXcode Gradle タスクを使用します。セットアップ時に、これを iOS アプリビルドの Run Script フェーズに追加します。これにより、iOS アプリのビルドが実行される前に Kotlin アーティファクトがビルドされ、派生データ(Derived Data)に含まれるようになります。
基本的に、このスクリプトは以下の処理を行います:
- コンパイルされた Kotlin フレームワークを、iOS プロジェクト構造内の適切なディレクトリにコピーする。
- 埋め込まれたフレームワークのコード署名プロセスを処理する。
- Kotlin フレームワーク内のコード変更が、Xcode 上の iOS アプリに確実に反映されるようにする。
セットアップ方法
現在、Kotlin フレームワークを接続するために CocoaPods プラグインを使用している場合は、まず移行を行ってください。プロジェクトに CocoaPods の依存関係がない場合は、この手順をスキップしてください。
CocoaPods プラグインからの移行
CocoaPods プラグインから移行するには:
Xcode で、Product | Clean Build Folder を選択するか、Cmd + Shift + K ショートカットを使用してビルドディレクトリをクリーンします。
Podfile のあるディレクトリで、次のコマンドを実行します:
nonepod deintegratebuild.gradle(.kts)ファイルからcocoapods {}ブロックを削除します。.podspecファイルと Podfile を削除します。
フレームワークをプロジェクトに接続する
マルチプラットフォームプロジェクトから生成された Kotlin フレームワークを Xcode プロジェクトに接続するには:
embedAndSignAppleFrameworkForXcodeタスクは、binaries.framework設定オプションが宣言されている場合にのみ登録されます。Kotlin Multiplatform プロジェクトのbuild.gradle.ktsファイルで、iOS ターゲットの宣言を確認してください。Xcode で、プロジェクト名をダブルクリックして iOS プロジェクト設定を開きます。
左側の Targets セクションでターゲットを選択し、Build Phases タブに移動します。
+ をクリックし、New Run Script Phase を選択します。

以下のスクリプトを調整し、新しいフェーズのスクリプトテキストフィールドに貼り付けます:
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 "<Path to the root of the multiplatform project>" ./gradlew :<Shared module name>:embedAndSignAppleFrameworkForXcodecdコマンドで、Kotlin Multiplatform プロジェクトのルートへのパスを指定します(例:$SRCROOT/..)。./gradlewコマンドで、共有モジュールの名前を指定します(例::sharedや:sharedUI)。
IntelliJ IDEA や Android Studio で iOS の実行構成を開始すると、Xcode のビルドを開始する前に Kotlin フレームワークの依存関係がビルドされ、環境変数
OVERRIDE_KOTLIN_BUILD_IDE_SUPPORTEDが "YES" に設定されます。提供されているシェルスクリプトはこの変数を確認し、Kotlin フレームワークが Xcode から二重にビルドされるのを防ぎます。これをサポートしていないプロジェクトで iOS の実行構成を起動すると、IDE はビルドガードを設定するための修正を提案します。
Based on dependency analysis オプションを無効にします。

これにより、Xcode が毎回のビルドでスクリプトを実行するようになり、出力の依存関係が見つからないという警告が毎回表示されるのを防ぎます。
Run Script フェーズを上に移動し、Compile Sources フェーズの前に配置します。

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

事前にサンドボックス化を無効にせずに iOS プロジェクトをビルドした場合、Gradle デーモンの再起動が必要になることがあります。 サンドボックス化された可能性のある Gradle デーモンプロセスを停止してください:
shell./gradlew --stopXcode でプロジェクトをビルドします。すべてが正しく設定されていれば、プロジェクトは正常にビルドされます。
デフォルトの Debug または Release とは異なるカスタムビルド構成を使用している場合は、Build Settings タブで、User-Defined の下に KOTLIN_FRAMEWORK_BUILD_TYPE 設定を追加し、Debug または Release に設定してください。
次のステップ
Swift Package Manager を使用する場合でも、ローカル統合を利用できます。ローカルパッケージで Kotlin フレームワークへの依存関係を追加する方法を見る。
