本番環境とツール
このページでは、Koin プロジェクトの各ステージと、それをカバーするツールを対応付けて紹介します。Koin 自体はビルド時、開発、およびテストをカバーしています。本番環境向けには、Kotzilla(Koin を開発している企業)がオプションのモニタリングプラットフォームを提供しています。
Koin に同梱されているものを除き、Koin のすべての機能はこのページにあるツールがなくても動作します。ニーズに合わせて選択してください。
ニーズに応じたツールの選択
| ステージ | ニーズ | ツール | Koin に同梱 |
|---|---|---|---|
| ビルド時 | 依存関係の不足や誤った qualifier によるビルドの失敗 | Koin Compiler Plugin を利用した Compile-Time Safety | はい |
| 開発 | Koin が何を生成し解決しているかを確認 | printLogger() やプラットフォームロガーによる Logging | はい |
| 開発 | 定義とインジェクションポイント間のナビゲーション、エディタ内での問題の確認 | Android Studio および IntelliJ IDEA 向けの IDE Plugin | いいえ(Kotzilla による無料プラグイン) |
| 開発 | AI コーディングエージェントによる Koin コードのセットアップ、作成、移行、診断 | Claude Code、Cursor、Codex、Copilot 向けの Koin Skills | いいえ(Koin チームによる無料スキル) |
| テスト | アプリを実行せずにモジュール設定を検証 | verify() による Verifying Modules | はい |
| テスト | 定義をフェイクやモックに置き換え | KoinTest による Testing | はい |
| 本番環境 | 選択した関数の実行時間をトレース | Kotzilla SDK を利用した @Monitor | アノテーションは「はい」(トレースには SDK が必要) |
| 本番環境 | 実際のユーザーセッションから起動時間、メインスレッドおよびバックグラウンドのパフォーマンス問題やクラッシュを確認 | Kotzilla プラットフォームによる Production Monitoring | いいえ(Kotzilla のサービス) |
ビルド時
Koin Compiler Plugin は、コンパイル時に依存関係グラフをチェックします。定義の欠落、qualifier の欠落、または未知のスコープがある場合、実行時にクラッシュする代わりに KOIN-Dxxx 診断によってビルドが失敗します。これは防御の第一線となります。検証される内容やセットアップ方法については、Compile-Time Safety を参照してください。
開発
Koin ロガーは、モジュールのロードとインスタンスの生成を出力します。printLogger(Level.DEBUG) やプラットフォームロガー(androidLogger()、SLF4J)を使用して有効にできます。これはコンソールや Logcat に未加工のテキストを出力するため、モニタリングツールではなくデバッグ支援用です。詳細は Logging を参照してください。
IDE Plugin は、ナビゲーション、モジュールと定義のツリービュー、エディタ内での設定チェック機能を追加します。
Koin skills は、セットアップ、定義、他の DI フレームワークからの移行、Koin エラーの診断など、Koin のルールを AI コーディングエージェントに提供します。
テスト
verify() は、通常の JUnit テストからモジュール内のすべての定義がビルド可能であることをチェックします。Compiler Plugin を使用している場合、コンパイル時の安全性(Compile-time safety)によって verify() がチェックする内容の大部分はすでにカバーされています。詳細は Verifying Modules および Testing を参照してください。
本番環境
コンパイル時の安全性チェックやテストは設定エラーを検出します。しかし、起動時の解決にどれくらい時間がかかるか、どの依存関係がメインスレッドをブロックしているか、どのクラッシュが Koin の解決に起因しているかなど、実際のデバイス上でグラフがどのように動作するかまではわかりません。
Koin 自体には本番環境向けのモニタリング機能はありません。Koin コンテナに組み込まれる Kotzilla SDK を通じて、Kotzilla プラットフォームがこのニーズをカバーします。詳細は Production Monitoring を参照してください。@Monitor アノテーションを使用すると、独自の関数にもこの機能を拡張できます。
関連情報
- Compile-Time Safety: Compiler Plugin がビルド時にチェックする内容
- Starting Koin: Koin ロガーの有効化と設定
- Verifying Modules: テストからの設定チェック
- IDE Plugin: Android Studio および IntelliJ IDEA におけるナビゲーションとチェック機能
- Production Monitoring: Koin アプリ向けの Kotzilla プラットフォーム
