Skip to content

本番環境とツール ​

このページでは、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 アノテーションを使用すると、独自の関数にもこの機能を拡張できます。