Skip to content

生產環境與工具 ​

本頁將 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 註解則將此功能延伸至您自己的函式中。