Koin のセットアップ

このガイドでは、プロジェクトに Koin を追加するために必要なすべての事項について説明します。

クイックセットアップ

開始するには、プラットフォームを選択してください：

プラットフォーム	パッケージ	ガイド
Kotlin/JVM	koin-core	Gradle のセットアップ
Android	koin-android	Gradle のセットアップ
Android + Jetpack Compose	koin-android + koin-compose	Gradle のセットアップ
Compose Multiplatform	koin-compose	Gradle のセットアップ
Kotlin Multiplatform	koin-core	Gradle のセットアップ
Ktor	koin-ktor	Gradle のセットアップ

推奨セットアップ: BOM + コンパイラプラグイン

最良のエクスペリエンスを得るために、以下を推奨します：

1. Koin BOM を使用する - すべての Koin ライブラリのバージョンを一括管理します
2. Koin コンパイラプラグインを使用する - コンパイル時の安全性を確保します

詳細な手順については、コンパイラプラグインのセットアップガイドを参照してください。

セットアップガイド

Gradle のセットアップ

すべてのプラットフォーム向けの完全な依存関係設定：

• Koin BOM (推奨)
• バージョンカタログ (Version catalogs)
• プラットフォーム固有のパッケージ
• テスト用の依存関係

コンパイラプラグインのセットアップ

Koin コンパイラプラグインの詳細ガイド：

• Gradle プラグインの設定
• 設定オプション
• Kotlin バージョンの要件
• トラブルシューティング

KSP プロセッサのセットアップ (非推奨)

Koin Annotations 向けの KSP ベースのプロセッサである koin-ksp-compiler のレガシーなセットアップ：

• ⚠️ koin-ksp-compiler は非推奨です — Koin コンパイラプラグインへ移行してください
• Koin Annotations 自体は非推奨ではありません。koin-annotations は現在、メインの Koin プロジェクトの一部となっています
• 移行ガイドが含まれています

バージョンの互換性

Koin バージョン	Kotlin バージョン	Koin コンパイラプラグイン
4.2.x	2.3+	✅ 推奨
4.1.x	2.1/2.2+	⚠️ KSP プロセッサのみ
4.0.x	1.9/2.0+	⚠️ KSP プロセッサのみ
3.5.x	1.8+	❌ 利用不可

現在のバージョン

• Koin:
• Koin コンパイラプラグイン:

Maven Central ですべての Koin パッケージを確認できます。

次のステップ

セットアップの後に：

• コアコンセプト - Koin の使い方を学ぶ
• チュートリアル - 初めてのアプリを作成する
• Android との統合 - Android 固有の機能