Unreal Engine-osztályok, modulok és beépülő modulok hozzáadása a Visual Studióban

Ebből a cikkből megtudhatja, hogyan használhatja a Visual Studio Tools for Unreal Engine-t a következő célokra:

• Unreal Engine-modulok hozzáadása a Visual Studio
• Unreal Engine-osztályok hozzáadása a Visual Studio
• Unreal Engine beépülő modulok hozzáadása a Visual Studio-ban

Előfeltételek

A következőket kell telepíteni:

• A Visual Studio 17.11-es vagy újabb verziója.
• Az Unreal Engine 5-ös vagy újabb verziója.
• Visual Studio Tools for Unreal Engine. A telepítési utasításokért tekintse meg A Visual Studio Tools for Unreal Engine telepítése című témakört.
• Töltse ki a rövid útmutatót: Visual Studio Tools for Unreal Engine a Lyra játék letöltéséhez és összeállításához, és konfigurálja a Visual Studio Tools for Unreal Engine használatára.

Unreal Engine-modulok hozzáadása a Visual Studióban

Mostantól az Unreal Engine -modulokat az Unreal Engine-projekthez a Visual Studióból is hozzáadhatja. Már nem kell váltania az Unreal Engine Editor és a Visual Studio között, hogy hozzáadjon egy modult, vagy szinkronizálnia a Visual Studio megoldást az Unreal Engine projektfájllal.

A modulok használatával rendszerezheti a kódot az Unreal Engine-ben. Segítenek a kapcsolódó osztályok és eszközök csoportosításában, valamint a kód önálló egységekbe rendezésében, amelyek futásidőben betölthetők és eltávolíthatók. A modulok létrehozása nehézkes és hajlamos a hibákra, ha kézzel végzi, mert konfigurációs fájlok szerkesztésére és sablonkód hozzáadására van szükség. A Visual Studio megkönnyíti a modulok létrehozását azáltal, hogy egy párbeszédpanelt biztosít, amely végigvezeti a folyamaton, elvégzi a konfigurációt, és hozzáadja a szükséges sablont.

Az Unreal Engine modul Visual Studióban való hozzáadásához kövesse az alábbi lépéseket rövid útmutató elvégzése után: Visual Studio Tools for Unreal Engine a Lyra-játék letöltéséhez és létrehozásához. Ezek a lépések feltételezik, hogy a LyraStarterGame.sln megoldás meg van nyitva a Visual Studióban:

1. A Megoldáskezelőválasszon ki egy projektet, például LyraStarterGame, ahová az új modult el szeretné helyezni.
2. Kattintson a jobb gombbal a projektre (győződjön meg arról, hogy a projekt ki van jelölve, és ne mappa), és válassza a >Unreal Engine elem hozzáadása... az Új elem hozzáadása párbeszédpanel megnyitásához az Unreal Engine-elemek esetében:
3. Válassza a Unreal Engine Modullehetőséget, adjon meg egy modulnevet a Név mezőben, majd válassza a Hozzáadás opciót az Unreal Engine Modul hozzáadása párbeszédpanel megnyitásához.

   

   Az Unreal Engine modul hozzáadása párbeszédablakban található egy mező a modul nevéhez, legördülő listák a modul típusához (a Runtime van kiválasztva) és a modul betöltési fázisához (Alapértelmezett van kiválasztva). A modul elérési útja, fejléc, forrás és a build fájlok elérési útjai vannak felsorolva. Az "IntelliSense adatainak frissítése az Unreal Editor-eszközökkel" jelölőnégyzet be van jelölve.

4. A legördülő menüben válassza ki a modultípust és modulbetöltési fázist.
5. Válassza OK lehetőséget a modul projekthez való hozzáadásához és a Visual Studio-megoldásfájl frissítéséhez.

A modulok csak a Forrás mappában vagy a beépülő modul moduljaként hozhatók létre a Beépülő modulok mappában.
A Build elérési útja megjeleníti a Build.cs fájl létrehozásának helyét. A Build.cs fájl a modul konfigurációs adatait tartalmazza.

Egyetlen Unreal Engine-modul létrehozása

A modul hozzáadása után hozza létre, hogy elérhetővé tegye az Unreal Engine Editorban. A teljes projekt létrehozása helyett csak a modult hozhatja létre.

A Megoldáskezelőkattintson a jobb gombbal a modulmappára, és válassza a Buildlehetőséget. Ez létrehozza a beépülő modult, és elérhetővé teszi az Unreal Engine Editorban.

A myModule modulmappára való jobb kattintás után megjelenő menübeállítások láthatók. Az Unreal Engine modul összeállítása című bejegyzés ki van emelve.

A buildkimenet a Kimeneti ablakban jelenik meg. Ha a build sikeres, a modul elérhető az Unreal Engine Editorban. Ha a build sikertelen, a Kimeneti ablakban megjelennek a hibaüzenetek.

Unreal Engine-osztályok hozzáadása a Visual Studióban

Mostantól az Unreal Engine-osztályokat is hozzáadhatja az Unreal Engine-projekthez a Visual Studióban. Többé nem kell váltania az Unreal Editor és a Visual Studio között egy osztály hozzáadásához, és nem szükséges szinkronizálnia a Visual Studio-projektet az Unreal Engine projektfájllal.

Az Unreal Engine-osztály Visual Studióban való hozzáadásához kövesse az alábbi lépéseket rövid útmutató elvégzése után: Visual Studio Tools for Unreal Engine a Lyra-játék letöltéséhez és összeállításához. A lépések feltételezik, hogy meg van nyitva a LyraStarterGame.sln megoldás a Visual Studióban:

1. A Megoldáskezelőválassza ki azt a mappát, ahová az új osztályt be szeretné helyezni. A LyraStarterGame projektben például hozzáadhat egy új osztályt a LyraStarterGame>Source mappához.
2. Kattintson a jobb egérgombbal a mappára, és válassza az >Unreal Engine elem hozzáadása... lehetőséget az Új elem hozzáadása párbeszédpanel megnyitásához.

   

   Lehetőség van az Unreal Engine common classes (amely ki van választva), Empty Unreal Engine Module és Unreal Engine Plugins hozzáadására.

3. Válassza az Unreal Engine Common Classes elemet, majd válassza a Hozzáadás lehetőséget az Unreal Engine Osztály hozzáadása párbeszédablak megnyitásához:

   

   Az alap kiválasztására szolgáló lehetőségek, például az Aktor, a Karakter és így tovább, láthatók. Van egy mező az osztálynévhez, és egy legördülő lista ahhoz, hogy a modul hozzáadja az osztályt. A fejlécfájl és a forrásfájl elérési útjai láthatók a listában. Be van jelölve egy jelölőnégyzet az IntelliSense-információk Unreal Editor-eszközökkel való frissítéséhez.

4. Válasszon egy osztálynevet. A Visual Studio figyelmezteti, ha a név ütközik egy meglévő osztálysal vagy fájllal.
5. Válasszon egy Bázisosztály. Az alaposztály kiválasztása biztosítja, hogy az adott osztálytípushoz a megfelelő fejlécek és makrók tartoznak.
6. Válasszon ki egy modult, amelyet hozzá szeretne adni az osztályához a válasszon modult az osztály hozzáadásához legördülő menüben. A modul neve annak a mappának a neve, amely a modult tartalmazza.
7. Jelölje be az Az IntelliSense adatainak frissítése az Unreal Editor-eszközökkel jelölőnégyzetet, és adja meg, hogy a Visual Studio Az IntelliSense adatainak frissítéséhez használja-e az Unreal Editor-eszközöket. Ha ezt választja, az Unreal Build eszköz újragenerálja a Visual Studio-megoldásfájlt.
8. Válassza az OK lehetőséget az új osztály fejléc- és forrásfájljainak létrehozásához, és adja hozzá őket a Visual Studio megoldásfájljához. Válassza a Újratöltés lehetőséget a projekt újratöltéséhez megjelenő parancssorban.

Unreal Engine pluginok hozzáadása a Visual Studióban

Mostantól az Unreal Engine-bővítményeket is hozzáadhatja az Unreal Engine-projekthez a Visual Studióban. Már nem kell váltania az Unreal Megjelenítő és a Visual Studio között beépülő modul hozzáadásához, és nem szükséges szinkronizálni a Visual Studio megoldást az Unreal Engine projektfájljával.

Az Unreal Engine plugin Visual Studióban való hozzáadásához, hajtsa végre az alábbi lépéseket a Quickstart: Visual Studio Tools for Unreal Engine útmutató elvégzése után a Lyra játék letöltéséhez és felépítéséhez. A lépések feltételezik, hogy meg van nyitva a LyraStarterGame.sln megoldás a Visual Studióban:

1. A Megoldáskezelőválassza ki azt a mappát, ahová az új beépülő modult el szeretné helyezni. A LyraStarterGame projektben például hozzáadhat egy új beépülő modult a LyraStarterGame>Source mappához.
2. Kattintson a mappa jobb egérgombjával, és válassza a >Unreal Engine elem hozzáadása... lehetőséget az Új elem hozzáadása párbeszédablak megnyitásához:

   

   Lehetőség van az Unreal Engine Common Classes, az Empty Unreal Engine Module és az Unreal Engine Beépülő modulok hozzáadására (amely ki van választva).

3. Válassza a Unreal Engine beépülő modulokat, majd válassza a Hozzáadás gombot az Unreal Engine beépülő modul hozzáadása párbeszédpanel megnyitásához.

   

   A beépülő modultípusok listája (a Speciális beállítás van kiválasztva), valamint a beépülő modul nevének, elérési útjának, szerzőjének, leírásának és URL-címének mezői. Van egy Is beépülő modul a bétatesztelésben (nincs bejelölve) és az IntelliSense-adatok frissítése az Unreal Editor Tools jelölőnégyzet használatával (bejelölve).

4. Válassza ki a beépülő modul típusát a beépülő modul típusának listájából.
5. Adja meg a beépülő modul nevét, beépülő modul szerzőjének, beépülő modul leírásánakés beépülő modul URL-címét.
6. Ha szükséges, jelölje be az A bővítmény béta verzióban jelölőnégyzetet.
7. Jelölje be az IntelliSense-adatok frissítése az Unreal Editor eszközökkel jelölőnégyzetet, hogy meghatározza, a Visual Studio az Unreal Editor eszközöket használja-e az IntelliSense-adatok frissítéséhez. Emiatt az Unreal Build eszköz újragenerálja a Visual Studio-megoldásfájlt.
8. Válassza a lehetőséget az új beépülő modul fejlécének és forrásfájljainak létrehozásához, majd adja hozzá őket a Visual Studio projektfájlhoz. Ez azt eredményezi, hogy a projekt újratöltésére vonatkozó kérés jelenik meg. Válassza a Újratöltés lehetőséget a projekt újratöltéséhez.

Egyetlen Unreal Engine beépülő modul készítése

A beépülő modul hozzáadása után építse meg, hogy elérhetővé tegye az Unreal Engine szerkesztőben. A teljes projekt létrehozása helyett csak a beépülő modult hozhatja létre.

A Megoldáskezelőbenkattintson a jobb gombbal a beépülő modul mappájára, és válassza Az Unreal Engine beépülő modul létrehozásalehetőséget. Ez létrehozza a beépülő modult, és elérhetővé teszi az Unreal Engine Editorban.

A MyPlugin beépülő modulmappára való jobb kattintás után megjelenő menübeállítások láthatók. Az "Építsd meg ezt az Unreal Engine beépülő modult" bejegyzés van kiemelve.

Ha a build sikeres, a beépülő modul az Unreal Engine Editorban érhető el. Ha a build sikertelen, a Kimeneti ablakban megjelennek a hibaüzenetek.

Kapcsolódó tartalom

Visual Studio Eszközök az Unreal Engine-hez
Unreal Engine blueprintek megtekintése a Visual Studio-ban
Az Unreal Engine naplózásának megtekintése a Visual Studio-ban
Unreal Engine-makrók megtekintése a Visual Studio-ban