共用方式為


參與適用於 Unity 的世界鎖定工具專案

目前為世界鎖定工具專案做出貢獻的最有價值方式是提出問題。 任何和所有有關將 World 鎖定工具 for Unity 專案與專案需求保持一致的任何和所有意見反應都非常有價值。

雖然您張貼的任何意見反應都很有價值,但以下是一些讓您可以採取動作的秘訣。

適當地使用標籤

一開始提交問題時,以及在以參與者身分追蹤問題時,適當使用標籤對於與其他參與者的協調非常有説明。

嘗試準確地區分什麼是 Bug、什麼是功能要求,以及未來提供更廣泛的建議。 所有這些都是有價值的,但一旦識別為這類,它們就更有價值。

同樣地,如果問題在目前的形式中似乎無法運作,則套用適當的標籤(例如,「不清楚」)有助於將其改進到可採取動作的位置。 當然,問題本身的具體評論非常有價值。 但適當的標籤可能會導致其他人看到一個批註,否則可能會被忽視。

回報 Bug

問題可能會從 GitHub 上的問題入口網站 提交。 花時間報告問題,或提出建議,其他人也會從中受益,也一直值得讚賞。

每個 Bug 報告都有自己的內容,但一般而言,包含的下列內容越多,問題就能更快解決。

來自裝置的記錄檔

來自裝置的記錄檔對於調查問題很有説明,特別是與以下建議的螢幕擷取搭配使用。 聯機到您的裝置時,可以使用 Windows 裝置入口網站,在 [系統 > 檔案 > 總管使用者資料夾\ LocalAppData \ WorldLockingTools] 底下取得它們

Unity 應用程式記錄檔

UnityPlayer.log位於TempState子資料夾中。 這是純文本檔案。

世界鎖定工具診斷記錄

診斷檔案位於 LocalState 子資料夾中。 檔案名稱會根據下列模式自動產生:

FrozenWorld-<device name>-<capture date and time>.hkfw

這是需要特殊軟體才能檢查的二進位檔。

請注意,若要擷取診斷記錄,需要在場景中的世界鎖定工具管理員元件上啟用診斷錄製。 如需詳細資訊,請參閱診斷檔。

重現步驟

指定問題發生方式。 理想的情況是在一組特定步驟之後發生 100% 的時間錯誤。 但是,即使是您只看到一次的錯誤,更詳細地將問題前的步驟關聯起來,越好。

重現步驟應遵循下列一般格式:

  1. 從這個正常穩定狀態開始...
  2. 然後我做了這個 (或注意到這個不尋常的事情)...
  3. 然後系統開始顯示這個不正確的行為...

螢幕擷取畫面

螢幕擷取可協助識別發生問題的完整內容。 特別是,畫面上顯示 [世界鎖定工具] 診斷有助於將體驗與記錄中的資訊相互關聯。 螢幕擷取可以是快照影像或視訊擷取。

裝置資訊

  • 哪種類型的裝置?
  • 執行哪個OS版本?

建置環境

  • Unity 版本
  • Visual Studio 版本

建議功能

當你發現世界鎖定工具 幾乎 做你需要的東西,機會是其他人遭受相同的限制。 我們同樣有興趣修正檔中的差距,以及提供新功能的範例。

在提出新功能時,最有價值的做法是清楚說明您嘗試完成的工作。 雖然關於如何實施它的想法也很有説明,但明確增加值的建議更有可能獲得牽引力。 讓問題成為功能所解決的明顯問題,最好是您在真實世界案例中完成的工作。

請務必將「增強功能」標籤附加至提交的提案問題。

貢獻程式碼

這是一個開放原始碼專案,因此,當然任何人都可以隨時進行分叉開發。 如果有人慷慨地分享回工作,那麼它非常感激,它是否會摺疊回主要存放庫。

在此初始推出期間,我們將有有限的資源來檢閱並接受提取要求到主要存放庫。 建議您避免在假設將分叉合併回主要存放庫的情況下,將花費大量時間投入分支。

減輕風險的其中一種方法是提交一個問題,提出預期的內容(標示為「增強功能」),再投入大量時間進行實作。 這也適用於可能查看相同問題區域的其他參與者。

另請參閱

編碼慣例發行程式