共用方式為

開發新的程式代碼和檔

  • 發行項

視存取層級而定，新的程式碼和檔可能會在新功能分支或分支中開發。 一般而言，最好從個別分叉工作，有時是唯一的替代方案。

git/GitHub 開發的最佳做法不在這份文件的範圍之外，但如需進一步閱讀，請參閱 這裡。

新程序代碼

提交提取要求 （PR）

任何提取要求都應該包含透過 CI 建置管線的手動執行。 管線會藉由將批註新增至PR來觸發。 下列命令會觸發完整組建：

/azp run

如果已知變更完全受限於程式代碼或檔，則只能執行組建的該端。 例如，僅檢查程式代碼變更：

/azp run wlt_ci

或只檢查檔案變更：

/azp run wlt_docs

不過，請記住，即使是限制為程序代碼 （.cs） 檔案的變更，也可能觸發文件變更。 執行完整組建一律更安全。

在 PR 的任何重大變更之後，以及在 PR 最終完成之前，執行適當的版本。 請記住，這些工具已就緒，以保護參與者免於中斷組建。 使用它們是為了您自己的利益，以及其他人在同一空間工作的好處。

程式碼檢閱

所有PR都必須由另一位開發人員檢閱，才能完成。

執行程式代碼檢閱時，保持友好且共同作業的氣氛。 總是值得一點額外的時間，找到一種方法來表達建議或更正，讓對方對變化感到積極。

發佈新版本

經過徹底測試和穩定，產品的新 安全 版本可能會發佈。

產品可透過兩個通道提供：

  1. 透過開放原始碼 GitHub 存放庫，標記為已驗證的版本認可。
  2. 透過已發佈 .unitypackage 的檔案。

這兩個通道都可在 WLTU 的 GitHub 版本頁面上取得。

建置 Unity 套件

注意：此處所述的程式確切 UI 可能經常變更。 如果您在畫面上看到的內容不符合這裡的螢幕快照，那可能沒關係。 只要尋找相關的關鍵詞並追蹤即可。

  1. 首先，移至 建置管線頁面。 請確定已選取 [wlt_ci]。

  2. 選取符合將作為發行基礎之認可的組建。

    選取組建

  3. 該選取專案將會導致下列畫面，您可以從中存取組建成品。*

    尋找組建成品

  4. 選取 Unity 套件。

    選取 unity 套件

  5. 然後下載為 zip。

    將 unity 套件下載為 zip 檔案

  6. 安裝及測試套件之後，它們可能會整合到新版本中。

建立發行

更新程式代碼中的 [版本] 欄位

更新 [WorldLockingManager.Version] 字段，以正確反映新版本。

建立發行分支

例如，建立名為 「release/v0.3.6-alpha」 的分支。 雖然具有標記的備援，但此分支可協助對發行進行熱修正，這不適用於主要開發分支「主要」。

發佈發行

移至 [ 適用於 Unity 的世界鎖定工具] 版本頁面。

按兩下 [建立新版本] 按鈕。

指定標記。 卷標的格式應該是 vX.Y.Z[-prerelease-modifier]。 此標籤的 X、Y 和 Z 是三個整數，應該符合 WorldLockingManager.Version 欄位中所指定的版本。 這些數位也應該符合發行分支名稱。

指定上面建立的發行分支做為目標。

適當地填入標題和描述欄位。

將上面建立的.unitypackage檔案拖曳到標示為「將二進位檔放在此處或選取二進位檔」的矩形中。

大型範例套件也包含其 MRTK 相依性快照集，可能需要相當長的時間才能上傳。 在上傳成功完成之前，最好不要離開該頁面。

.unitypackage成功上傳檔案時，按兩下 [發行發行] 按鈕。

確認所有項目在發行頁面上看起來都正確。