參與 MRTK2

Mixed Reality工具組 (MRTK) 歡迎來自社群的貢獻。 所有變更都是小型或大型的,必須遵守 MRTK 編碼標準,因此請確定您在開發時熟悉這些變更,以避免在檢閱變更時發生延遲。

如果您有任何問題,請連絡 Slack 上的混合實境工具組通道。 您可以透過 自動邀請寄件者加入 Slack 社群。

提交程式

我們提供數個路徑,讓開發人員能夠參與Mixed Reality工具組,從建立新的問題開始。

選取問題類型

在這裡,您會檔案:

  • 錯誤報表- 其中一個Mixed Reality工具組元件的功能問題
  • 檔問題- Mixed Reality工具組的問題
  • 功能要求- 新Mixed Reality工具組功能的提案

建議功能要求

要求新的Mixed Reality工具組功能時,請務必記錄要解決的客戶權益/問題。 提交之後,將會在 GitHub 上檢閱並討論功能要求。 我們鼓勵每個功能提案的開放且有效率的討論,以確保工作對大量客戶很有説明。

若要避免需要重新工作功能,通常建議在檢閱階段期間不會開始開發功能。 許多時候,社群檢閱程式發現一或多個可能需要對建議實作進行重大變更的問題。

注意

如果您想要處理已存在於待辦專案上的某個專案,您可以使用該工作專案作為提案。 請務必也對工作加上批註,通知維護人員您正努力完成工作。

貢獻程式

若要開始使用,只要遵循下列步驟:

  1. 派生存放庫。 按一下頁面右上方的 [分叉] 按鈕,並遵循流程。
  2. 分支 的分支 (中建立分支) ,讓您更輕鬆地隔離任何變更,直到準備好提交為止。 如需發行穩定期間的錯誤修正,請尋找最新的 prerelease/* 分支。 新功能應該一律進入 main

如果您不熟悉 Git 工作流程, 請參閱 Github 的簡介

新增錯誤修正或功能時,請遵循下列步驟:

  1. 實作錯誤修正或功能。 建置和部署 MRTK 的指示位於 部署至 Hololens 和 WMR 裝置。 請記得遵循 程式碼撰寫指導方針
  2. 如果新增功能,也新增示範功能的範例場景。
  3. 如果新增實驗性功能,則不需要撰寫測試和檔。 相反地,請遵循 實驗性功能指導方針
  4. 新增測試以驗證錯誤修正/功能。 撰寫和執行測試的指示位於 UnitTests
  5. 請確定程式碼和功能 () 記載如 檔指導方針中所述。
  6. 請確定程式碼如預期般在所有平臺上運作。 如需支援的平臺清單,請參閱 版本資訊 。 針對 Windows UWP 專案,程式碼必須 符合 WACK 規範。 若要這樣做,請產生 Visual Studio 方案,以滑鼠右鍵按一下專案;商店>建立應用程式套件。 遵循提示並執行 WACK 測試。 請確定它們全都成功。
  7. 在提出提取要求時,請遵循提取 要求 中的指示。