生產環境與工具
本頁將 Koin 專案的各個階段對應到涵蓋該階段的工具。Koin 本身涵蓋了組建期、開發與測試。在生產環境方面,Kotzilla(打造 Koin 的公司)提供了一個選用的監控平台。
除了隨 Koin 一同隨附的工具之外,Koin 中的所有功能皆可在沒有本頁提及的任何工具的情況下運作。請依據您的需求選擇合適的工具。
針對不同需求選擇工具
| 階段 | 需求 | 工具 | 隨附於 Koin |
|---|---|---|---|
| 組建期 | 在遺漏相依性或限定詞錯誤時使組建失敗 | 搭配 Koin 編譯器外掛程式的編譯期安全性 | 是 |
| 開發 | 查看 Koin 建立與解析的內容 | 搭配 printLogger() 或平台記錄器的記錄 | 是 |
| 開發 | 在定義與注入點之間導覽,在編輯器中查看問題 | 適用於 Android Studio 和 IntelliJ IDEA 的 IDE 外掛程式 | 否,Kotzilla 提供的免費外掛程式 |
| 開發 | 讓您的 AI 編碼代理設定、編寫、遷移與診斷 Koin 程式碼 | 適用於 Claude Code、Cursor、Codex、Copilot 的 Koin Skills | 否,Koin 團隊提供的免費 skills |
| 測試 | 無需執行應用程式即可檢查模組配置 | 搭配 verify() 的驗證模組 | 是 |
| 測試 | 使用 fake 或 mock 替換定義 | 搭配 KoinTest 的測試 | 是 |
| 生產環境 | 追蹤所選函式的執行時間 | 搭配 Kotzilla SDK 的 @Monitor | 註解為是,追蹤需要 SDK |
| 生產環境 | 從真實使用者工作階段中查看啟動、主執行緒與背景效能問題及當機 | 搭配 Kotzilla 平台的生產環境監控 | 否,Kotzilla 服務 |
組建期
Koin 編譯器外掛程式會在編譯期間檢查您的相依性圖 (dependency graph)。遺漏定義、遺漏限定詞或未知的作用域都會使組建失敗並顯示 KOIN-Dxxx 診斷訊息,而不是在執行期發生崩潰。這是第一道防線:請參閱編譯期安全性以了解驗證的內容以及如何進行設定。
開發
Koin 記錄器會印出模組載入與執行個體建立資訊。使用 printLogger(Level.DEBUG) 或平台記錄器(androidLogger()、SLF4J)將其開啟。它會將原始文字寫入主控台或 Logcat,因此它是一項偵錯輔助工具,而非監控工具。請參閱記錄。
IDE 外掛程式在編輯器中新增了導覽、模組與定義的樹狀視圖,以及配置檢查功能。
Koin skills 為您的 AI 編碼代理提供 Koin 規則:設定、定義、從其他 DI 架構遷移,以及 Koin 錯誤的診斷。
測試
verify() 可透過純 JUnit 測試來檢查模組中的每個定義是否都能成功組建。如果您使用編譯器外掛程式,編譯期安全性就已經涵蓋了 verify() 所檢查的大部分內容。請參閱驗證模組與測試。
生產環境
編譯期安全性與測試能夠擷取配置錯誤。但它們無法告訴您該圖在真實裝置上的運作狀況:啟動時解析需要多長時間、哪個相依性阻塞了主執行緒、哪次當機源自於 Koin 解析。
Koin 本身沒有生產環境監控功能。Kotzilla 平台透過插入至 Koin 容器中的 Kotzilla SDK 來滿足此需求。請參閱生產環境監控。@Monitor 註解則將此功能延伸至您自己的函式中。
