在 Visual Studio 中新增虛幻引擎類別、模組和外掛程式

在本文中，了解如何使用適用於虛幻引擎的 Visual Studio Tools 來：

• 在 Visual Studio 中新增虛幻引擎模組
• 在 Visual Studio 中新增 Unreal Engine 類別
• 在 Visual Studio 中新增 Unreal Engine 外掛程式

必要條件

必須安裝下列項目：

• Visual Studio 版本 17.11 (17.11 預覽版) 或以上版本。
• Unreal Engine 5 版或更新版本。
• Visual Studio Tools for Unreal Engine。 如需安裝指示，請參閱安裝 Visual Studio Tools for Unreal Engine。
• 完成快速入門：適用於虛幻引擎的 Visual Studio Tools，下載並建立 Lyra 遊戲，並將其設定為使用適用於虛幻引擎的 Visual Studio Tools。

在 Visual Studio 中新增虛幻引擎模組

現在，您可以從 Visual Studio 中，將虛幻引擎模組新增到虛幻引擎專案中。 您不再需要為了新增模組而切換虛幻引擎編輯器和 Visual Studio，也不再需要之後將 Visual Studio 解決方案與虛幻引擎專案檔案同步。

模組是一種在虛幻引擎中組織程式碼的方式。 它們可協助您將相關的類別和資產分組在一起，並將程式碼組織成可以在執行階段載入和卸載的獨立單位。 如果手動建立模組可能會很繁瑣且容易出錯，因為它需要編輯設定檔並新增樣板程式碼。 Visual Studio 會提供對話方塊來引導您完成整個流程、進行設定並新增樣板，讓建立模組變得更加容易。

若要在 Visual Studio 中新增虛幻引擎模組，請在完成快速入門：適用於虛幻引擎的 Visual Studio Tools 後，依照下列步驟下載並建立 Lyra 遊戲。 這些步驟假設您已在 Visual Studio 中開啟 LyraStarterGame.sln 解決方案：

1. 在 [方案總管] 中選擇一個專案，例如 LyraStarterGame，也就是您希望新增新模組的專案。
2. 以右鍵按一下專案 (請選擇專案而不是資料夾)，然後選擇 [新增>虛幻引擎項目...] 以開啟虛幻引擎項目的 [新增項目] 對話方塊：
3. 選擇 [虛幻引擎模組]，在 [名稱] 欄位中提供模組名稱，然後選擇 [新增] 以開啟 [新增虛幻引擎模組] 對話方塊：

   

   [新增虛幻引擎模組] 對話方塊包含模組名稱欄位、模組類型下拉式清 (選擇執行階段時) 和模組載入階段 (選擇預設時)。 系統會列出模組路徑、標頭、原始程式碼和建置檔案路徑。 已選取 [使用虛幻編輯器工具重新整理 IntelliSense 資訊] 核取方塊。

4. 使用下拉式清單選取 [模組類型] 和 [模組載入階段]。
5. 選擇 [確定]，將模組新增至專案，並更新 Visual Studio 解決方案檔案。

模組只能在 Source 資料夾中建立，或作為 Plugins 資料夾內外掛程式的模組建立。
建置路徑會顯示 Build.cs 檔案的建立位置。 Build.cs 檔案包含模組的設定資訊。

在 Visual Studio 中新增 Unreal Engine 類別

現在，您可以從 Visual Studio 中，將虛幻引擎類別新增到虛幻引擎專案中。 您不再需要為了新增類別而切換虛幻編輯器和 Visual Studio，也不再需要之後將 Visual Studio 解決方案與虛幻引擎專案檔案同步。

若要在 Visual Studio 中新增虛幻引擎類別，請在完成快速入門：適用於虛幻引擎的 Visual Studio Tools 後，依照下列步驟下載並建立 Lyra 遊戲。 這些步驟假設您已在 Visual Studio 中開啟 LyraStarterGame.sln 解決方案：

1. 在 [方案總管] 中，選擇新類別所在的資料夾。 例如，在 LyraStarterGame 專案中，您可以將新類別新增至 LyraStarterGame>Source 資料夾中。
2. 以右鍵按一下該資料夾，然後選擇 [新增>虛幻引擎項目...]，以開啟 [新增項目] 對話框：

   

   它有多個選項，包含新增虛幻引擎通用類別 (已選取)、空白的虛幻引擎模組和虛幻引擎外掛程式。

3. 選擇 [虛幻引擎通用類別]，然後選擇 [新增] 以開啟 [新增虛幻引擎類別] 對話方塊：

   

   系統會顯示用於選擇基礎 (例如演員、角色等) 的選項。 有類別名稱欄位，和用於新增類別到模組的下拉式清單。 這會列出標頭檔和來源檔案的路徑。 選取一個核取方塊，以使用虛幻編輯器工具重新整理 IntelliSense 資訊。

4. 選擇 [類別名稱]。 如果名稱與現有類別或檔案衝突，Visual Studio 會發出警告。
5. 選擇 [基礎類別]。 選取基礎類別可確保該類別類型包含正確的標頭和巨集。
6. 使用 [選取要新增類別的模組] 下拉式清單選擇要新增到類別的模組。 模組名稱是包含該模組的資料夾的名稱。
7. 勾選 [使用虛幻編輯器工具刷重新整理 IntelliSense 資訊] 核取方塊，以選擇 Visual Studio 是否使用虛幻編輯器工具來更新 IntelliSense 資訊。 選擇此選項將使虛幻建置工具重新產生 Visual Studio 解決方案檔案。
8. 選擇 [確定] 為新類別產生標頭檔和來源檔案，並將它們新增至 Visual Studio 解決方案檔案。 這會導致提示重新載入專案。 選擇 [重新載入] 以重新載入專案。

在 Visual Studio 中新增 Unreal Engine 外掛程式

現在，您可以從 Visual Studio 中，將虛幻引擎外掛程式新增到虛幻引擎專案中。 您不再需要為了新增外掛程式而切換虛幻編輯器和 Visual Studio，也不再需要之後將 Visual Studio 解決方案與虛幻引擎專案檔案同步。

若要在 Visual Studio 中新增虛幻引擎外掛程式，請在完成快速入門：適用於虛幻引擎的 Visual Studio Tools 後，依照下列步驟下載並建立 Lyra 遊戲。 這些步驟假設您已在 Visual Studio 中開啟 LyraStarterGame.sln 解決方案：

1. 在 [方案總管] 中，選擇新外掛程式所在的資料夾。 例如，在 LyraStarterGame 專案中，您可以將新外掛程式新增至 LyraStarterGame>Source 資料夾中。
2. 以右鍵按一下該資料夾，然後選擇 [新增>虛幻引擎項目...]，以開啟 [新增項目] 對話框：

   

   它有多個選項，包含新增虛幻引擎通用類別、空白的虛幻引擎模組和虛幻引擎外掛程式 (已選取)。

3. 選擇 [虛幻引擎外掛程式]，然後選擇 [新增] 以開啟 [新增虛幻引擎外掛程式] 對話方塊：

   

   有外掛程式類型清單 (已選取 [進階])，以及外掛程式名稱、路徑、作者、描述和 URL 欄位。 有 [Beta 中的外掛程式] 核取方塊 (未勾選)，和 [使用虛幻編輯器工具重新整理 IntelliSense 資訊] 核取方塊 (已勾選)。

4. 從 [外掛程式類型] 清單中選擇外掛程式的類型。
5. 提供 [外掛程式名稱]、[外掛程式作者]、[外掛程式描述] 和 [外掛程式 URL]。
6. 根據需要選取 [Beta 中的外掛程式] 方塊。
7. 勾選 [使用虛幻編輯器工具刷重新整理 IntelliSense 資訊] 核取方塊，以選擇 Visual Studio 是否使用虛幻編輯器工具來更新 IntelliSense 資訊。 這會導致虛幻建置工具重新產生 Visual Studio 解決方案檔案。
8. 選擇 [新增] 以產生新外掛程式的外掛程式標頭檔和來源檔案，並將它們新增至 Visual Studio 解決方案檔案。 這會導致提示重新載入專案。 選擇 [重新載入] 以重新載入專案。

相關內容

Visual Studio Tools for Unreal Engine
在 Visual Studio 中查看虛幻引擎藍圖
在 Visual Studio 中查看虛幻引擎記錄
在 Visual Studio 中查看虛幻引擎巨集