unity-test-runner

Unity Test Runner 是一款專為 Unity 遊戲開發設計的技能，旨在直接從命令列簡化品質保證流程。此工具服務於需要將自動化測試整合到本地工作流程或 CI/CD 管線中的 Unity 開發者與工程師。透過自動化整個測試生命週期，它減少了因重複測試週期而需開啟 Unity Editor 圖形介面所帶來的繁瑣作業。此工具在驗證遊戲邏輯、除錯迴歸錯誤以及在提交前確保專案穩定性方面特別有效。

• 自動偵測跨 Windows、macOS 和 Linux 平台的 Unity Editor 安裝，並支援多種 Unity 版本。

• 支援在 EditMode 或 PlayMode 下執行測試，適用於快速單元測試或全面的引擎級整合測試。

• 支援進階測試過濾與分類，開發者可選擇執行特定子集的測試，例如 Combat、AI 或 Physics 模組。

• 解析由 Unity Test Framework 產生的 NUnit 相容 XML 結果，提供結構化的摘要統計與失敗診斷資訊。

• 產生詳細且具備行動建議的失敗報告，包含完整的堆疊追蹤、原始碼檔案位置與行號，以利快速定位錯誤。

• 透過標準命令列參數與 shell 工作流程無縫整合，支援專案路徑、日誌輸出與測試結果匯出。

• 在嘗試執行前，請務必確認 ProjectSettings/ProjectVersion.txt 與 Assets 目錄的存在，以確保專案路徑有效。

• 若本地安裝有多個版本，請使用 find-unity-editor.js 指令碼列出並選擇適當的 Editor 版本。

• 建議使用 --json 參數以利程式化讀取偵測與測試分析指令碼的輸出結果。

• 執行測試時可使用背景程序監控；針對長時間運行的 PlayMode 測試，請設置適當的超時時間以避免過早中止。

• 此工具適用於已安裝 Unity Editor 且可透過標準 CLI 路徑存取的開發環境。