版本控制｜如何將UnrealGameSync與Perforce Helix Core結合使用

為了幫助虛幻引擎4和虛幻引擎5的開發，Epic公司開發了UnrealGame

Sync，使其與版本控制工具Perforce Helix Core互動。雖然UnrealGameSync除了P4V （Helix Core客戶端）之外還有許多功能，但主要用途是分發內部引擎和專案構建，它極大地簡化了向團隊分發虛幻編輯器的方式，幫助所有員工高效工作。閱讀本篇文章，您能瞭解到什麼是UnrealGameSync，它的用處及優勢，以及如何設定使用。

龍智

作為DevSecOps研發安全運營一體化解決方案供應商、Perforce授權合作伙伴，持續關注版本控制領域動態與發展，為您提供最新洞察與最佳實踐參考，幫助遊戲開發團隊更好地進行資產管理，加強協作，提升效率。立即聯絡我們，瞭解遊戲開發的最佳實踐與案例。

什麼是UnrealGameSync？

UnrealGameSync （UGS） 是一個開發者工具，它可以使開發人員的工作區與虛幻專案流同步。它提供了一個圖形化的前端，能夠從

Perforce Helix Core

同步虛幻引擎4/虛幻引擎5專案。

UnrealGameSync有什麼用？

由於專案會及時更新，UnrealGameSync讓開發人員可以在同一專案上進行工作，促進協作開發環境中的程式碼和內容整合。

安裝UnrealGameSync後，您就可以輕鬆地對虛幻引擎專案進行引導和迭代，而不需要承擔使用同步工

具帶來的額外成本。

透過使用UnrealGameSync，您可以：

同步專案檔案；

解決合併衝突；

使用同步編輯器編輯二進位制檔案；

更新版本檔案；

生成專案檔案；

構建虛幻引擎4/虛幻引擎5；

執行虛幻專案。

UnrealGameSync的優勢

使用UnrealGameSync有很多好處，其中包括：

能夠在提交變更列表後立即同步到變更列表；

為每個修改添加註釋，將構建標記為好或壞；

提供有關目前正在進行的破損構建的修復通知；

安全地從本地構建進行內容更改，而無需提交未經版本管理的資產；

如果您無權訪問

Visual Studio

，則可以訪問專案的壓縮編輯器的構建。

如何設定和安裝UnrealGameSync

下面將介紹如何設定和安裝UnrealGameSync。

1. 下載並安裝Wix

安裝完成後，系統會提示您在Visual Studio中安裝其他依賴項。在第一次執行解決方案檔案時，請允許更新和安裝這些依賴項，以便進一步構建專案。

*

注意：使用適當的Visual Studio版本很重要。

2. 下載虛幻引擎原始碼

為了能夠訪問這些檔案，您需要將您的Epic帳戶與您的Github帳戶相關聯。或者，如果您有許可，則可以從Epic的公共

Perforce Helix Core

許可伺服器中獲取。

3. 將虛幻引擎原始檔新增到一個新的主線流中

請將此工作區設定為

AllWrite，

以避免構建問題。

* 注意：

如果您使用的是Windows系統，請確保您的工作區根路徑少於50個字元，或者您的登錄檔中已經啟用了長檔案路徑長度。

4. 執行Setup.bat來安裝依賴項

* 注意：安裝Visual Studio依賴項所需的時間可能會有所不同，這取決於虛幻引擎或UnrealGameSync是否已經在機器上構建過。

5.執行GenerateProjectFiles.bat

6.開啟\Engine\Source\Programs\UnrealGameSync\UnrealGameSync.sln

您應該會收到在VS Code （ASP。NET） 中安裝額外擴充套件的提示。

額外擴充套件安裝完成後，執行UnrealGameSync的構建：Release – Any CPU – UnrealGameSync。這將建立一個構建：

\

Engine

\

Source

\

Programs

\

UnrealGameSync

\

bin

\

Release

\

netcoreapp3

。1

其中：

\Engine\Source\Programs\UnrealGameSync\Installer

您可以執行Build。bat來建立UGS的安裝程式。這將建立一個msi安裝程式，您可以在本地安裝：

\Engine\Source\Programs\UnrealGameSync\Installer\bin\

Release

7. p4ignore和型別對映

您的p4ignore可以遵循與標準的虛幻專案相同的格式。

此外，您的p4型別對映應如下所示（請將//depot自定義為//<您的流depot的名稱>，例如

//UE5

：

Typemap：binary+S2w //depot/。。。。exebinary+S2w //depot/。。。。dllbinary+S2w //depot/。。。。libbinary+S2w //depot/。。。。appbinary+S2w //depot/。。。。dylibbinary+S2w //depot/。。。。stubbinary+S2w //depot/。。。。ipabinary //depot/。。。。bmptext //depot/。。。。initext //depot/。。。。configtext //depot/。。。。cpptext //depot/。。。。htext //depot/。。。。ctext //depot/。。。。cstext //depot/。。。。mtext //depot/。。。。mmtext //depot/。。。。pybinary+l //depot/。。。。uassetbinary+l //depot/。。。。umapbinary+l //depot/。。。。upkbinary+l //depot/。。。。udk

您可以使用p4對映-i < “filename。txt” 命令為您的客戶端設定型別對映。

如何使用UnrealGameSync

當您在完成安裝程式後執行UnrealGameSync時，它會首先詢問

您

這些預設值：

伺服器

使用者名稱

密碼

然後，UnrealGameSync會接著詢問您將要使用的虛幻專案檔案的位置。

回答

後，您將看到主遊戲同步UI，其中列出了所有相關的變更列表。

如果尚未構建引擎，UnrealGameSync將同步簽入儲存庫的預構建檔案。通常情況下，Unreal

GameSync

會使用最後一個好的構建。但如果有需求，您也可以堅持同步到特定的更改列表。如果您這樣做了，並且還沒有構建與原始碼匹配的引擎，那麼只要符合先決條件，UnrealGameSync將嘗試在啟動編輯器之前從原始碼

自行構建引擎。

然而，為了充分利用您的UnrealGameSync設定，最好的做法是同時儲存已完成的構建。如果你勾選“Use Unstable Build（使用不穩定構建）”，它會在裡面尋找一個名為“Unstable”的資料夾。否則，它將尋找名為“Release”的資料夾。

* 注意：如果您是美術人員或設計師，您不會勾選“使用不穩定構建”。但是，如果您是開發人員並且正在處理問題，您可能需要勾選“使用不穩定的構建”來識別和修復問題。

現在您已經將構建儲存在您的倉庫中，可以快速選擇您想同步的變更列表編號。

如果一切執行正常，並且您希望使用者可以訪問這個相關的構建，可以將特定的變更列表標記為

好

。如果該特定構建中存在破壞性bug，則標記為

壞。

當用戶點選

Sync Now

（立即同步）

時，他們將收到標記為

好

的最高版本，然後能夠從頂部面板啟動各種編輯器。

開始使用：Unrea

lGameSync

立即開始使用

Perforce Helix Core

和UnrealGameSync。Perforce Helix Core被視為遊戲版本控制的行業標準，並受到19家Top 20 AAA工作室的青睞。