共用方式為

快速入門：Visual Studio Tools for Unreal Engine

  • 發行項

在本文中，下載虛幻引擎 (UE) 遊戲範例，並設定適用於虛幻引擎的 Visual Studio Tools。 Visual Studio Tools for Unreal Engine 是免費的擴充功能，可協助您使用 Unreal Engine 開發遊戲。 它提供可改善 Visual Studio 中 Unreal Engine 開發體驗的功能。

必要條件

必須安裝下列項目：

  • Visual Studio 17.10 或更新版本。
  • Unreal Engine 第 5 版或更新版本，因為本文中使用的範例需要虛幻引擎 5 或更新版本。
  • Visual Studio Tools for Unreal Engine。 如需安裝指示，請參閱安裝 Visual Studio Tools for Unreal Engine。

在 Visual Studio 中下載並建置 Lyra 遊戲範例

Lyra 是一個範例遊戲專案，可用來了解需幻引擎。 如需下載指示，請參閱 Lyra 範例遊戲的下載 Lyra 入門遊戲一節。 如果您透過 Unreal Engine 的原始程式碼安裝取得該版本，該版本不包含建置和執行遊戲所需的資產。 使用下載指示，透過 Epic 安裝程式取得您需要的所有專案。

設定 Lyra 遊戲範例以使用 Visual Studio Tools for Unreal Engine

從 Visual Studio 2022 版本 17.7 開始，虛幻引擎安裝程式中會包含適用於虛幻引擎的 Visual Studio Tools 外掛程式。 不再需要查看虛幻引擎藍圖。 如果您有舊版的 Visual Studio，請參閱安裝適用於 Unreal Engine 的 Visual Studio 工具以手動安裝外掛程式。

下載遊戲範例之後，請更新 LyraStarterGame.uproject，以使用 Visual Studio Tools 外掛程式。 執行此作業的方式之一是在 Unreal 編輯器中。 載入 Lyra 專案，然後從主功能表選擇 [編輯]> [外掛程式]。 尋找 Visual Studio Integration Tools 外掛程式，然後核取其旁邊的方塊。

執行此作業的另一種方式是手動編輯 LyraStarterGame.uproject 檔案。 方法如下：

  1. 在文字編輯器中開啟 LyraStarterGame.uproject 檔案。 其位於您安裝遊戲範例的目錄中。

  2. 在 Plugins 區段的結尾新增下列程式碼：

    ,{
    "Name": "VisualStudioTools",
    "Enabled": true
}

在 Unreal Engine

  1. 在 Unreal Engine 中開啟 Lyra 專案。
  2. 從 Unreal Engine 編輯器主功能表中，選擇 [工具]>[產生 Visual Studio 專案]。 這會建立 Visual Studio 的解決方案檔案。
  3. 從虛幻引擎編輯器主要功能表中，選擇 [工具]>[開啟 Visual Studio]，以在 Visual Studio 中開啟遊戲。 如果您的電腦上有多個版本的 Visual Studio，請確定開啟正確的版本：從 Visual Studio 主功能表中，選擇 [說明]>[關於 Microsoft Visual Studio]。 Visual Studio 2022 17.7 版或更高版本。 如果正確的版本未開啟，請以正確的 Visual Studio 版本手動開啟 LyraStarterGame.sln。

在 Visual Studio 中

  1. 將 [解決方案設定] 下拉式清單變更為 [開發編輯器]。 這可啟用 Blueprints Visual Studio Tools for Unreal Engine：Visual Studio 的螢幕擷取畫面，其中已展開 [解決方案設定] 下拉式清單，並已選取 [開發編輯器]。
  2. 將啟動專案設定為 LyraStarterGame 專案。 在 [方案總管]，以滑鼠右鍵按一下解決方案，然後選擇 [屬性]。
  3. 在 [方案屬性頁面] 對話方塊的 [通用屬性] 底下，選擇 [設定啟動專案]。
  4. 確定已選取 [單一啟動專案]，然後在下拉式清單中選擇 [LyraStarterGame ]。

    [解決方案屬性頁面] 對話方塊的螢幕擷取畫面。

  5. 選擇 [確定] 以關閉對話方塊。
  6. 從 Visual Studio 主功能表中，選擇 [建置]>[建置方案] 來建置遊戲。

Visual Studio 建置輸出視窗

Visual Studio 中的建置輸出視窗顯示建置進度，以及發生的任何錯誤或警告。 您可以透過 [檢視]>[輸出] 從 Visual Studio 主功能表開啟建置輸出視窗。

從 Visual Studio 2022 17.12 開始，您可以在輸出視窗中按兩下檔案的絕對路徑，以在 Visual Studio 中開啟該檔案。 Visual Studio 解決方案必須包括原始程式碼，而輸出視窗中的路徑必須是絕對路徑。 這適用於在 Visual Studio 中建立虛幻引擎專案或其他類型的專案。

下列螢幕擷取畫面顯示 LyraStarterGame 範例建置的輸出視窗。 使用者已按兩下來自 LyraCharacter.generated.h 的警告。 因為提供了該檔案的絕對路徑，所以在編輯器中開啟該檔案。

Visual Studio 輸出視窗的螢幕擷取畫面。LyraCharacter.generated.h 檔案會醒目提示，因為已指定絕對路徑，而且使用者按兩下它以開啟 LyrCharacter.generated.h 檔案。

虛幻引擎工具列

Visual Studio 提供了一個工具列，可改善 Visual Studio 中的虛幻引擎開發整合體驗。 工具列可讓您快速存取常用的 UE 工作。

透過 [檢視]>[工具列]>[虛幻引擎]，從主要功能表啟動 Visual Studio 中的虛幻引擎工具列。 該工具列看起來像：

Visual Studio 中虛幻引擎工具列的螢幕擷取畫面。

工具列按鈕，從左到右：

  • 播放圖示是一個快速附加按鈕，可附加到右側下拉式清單中所列的程序。 下拉式清單列出了虛幻引擎的相關程序，讓您可更輕鬆地附加到虛幻引擎編輯器。 您也可以使用它附加到任何程序。
  • 用於啟動和停止虛幻引擎整合伺服器的按鈕。 整合伺服器提高了虛幻引擎與 Visual Studio 整合的效能。 它會以背景程式的形式執行，並在您處理專案時自動更新測試資訊。 您可以將其關閉以回收電腦資源，並在需要整合改善時啟動。 當您在 Visual Studio 中開啟 UE 專案時，會自動啟動伺服器。
  • 用於重新掃描虛幻引擎藍圖資產的按鈕。 這將使用虛幻引擎專案中的最新藍圖資產更新 Visual Studio 解決方案。
  • 用於開啟虛幻引擎記錄視窗的按鈕。
  • 用於開啟 [虛幻引擎整合設定視窗] 的按鈕，您可以在其中重新整理並查看整體設定狀態和 Visual Studio 整合工具狀態、檢查藍圖支援、查看是否取得虛幻引擎命名慣例檢查器狀態等。

命令行自變數下拉式清單

在內部循環的編輯和偵錯過程中，您可能會經常使用不同的命令行自變數組合來啟動遊戲。 現在，命令行自變數下拉式清單會比較容易：

命令行args下拉式清單的螢幕快照。

若要新增命令行自變數，請在下拉式清單中輸入它們，然後按 Enter。 自變數會以您輸入自變數的順序儲存，並出現在下拉式清單中以供日後使用。

在移除最舊命令行之前，您可以新增五個命令行的限制，以騰出空間供新的命令行使用。

偵錯在 Unreal Engine 編輯器中執行的 Unreal Engine 專案時，第一個自變數必須是項目的路徑。 例如： C:\UE\LyraStarterGame\LyraStarterGame.uproject 。

如需使用命令行自變數下拉式清單的詳細資訊，請參閱在偵錯時傳遞命令行自變數（C++）。

下一步

在 Visual Studio 中新增虛幻引擎類別、模組和外掛程式
在 Visual Studio 中查看虛幻引擎藍圖
在 Visual Studio 中查看虛幻引擎記錄
在 Visual Studio 中查看虛幻引擎巨集