2022. 8. 2. 22:11ㆍTrouble Shootings/Game
☢️발생한 문제
Unreal Engine 5 온라인 러닝을 통해 실습해보고 있었는데, 새 C++ 클래스를 생성하고 난 후에 C++ 파일을 빌드하는 데 실패했고, 탐색기에서는 해당 cpp 파일이 표시될 순 있으나 콘텐츠 브라우저에서는 보이지 않을 수도 있다는 말을 하더군요. 그리고 나서 UE5를 다시 실행하니 다음과 같은 오류가 떴습니다.
The following modules are missing or built with a different engine version:
<제 프로젝트 이름>
Would you like to rebuild them now?
예(Yes)를 눌러봐도 다음과 같은 대답이 돌아올 뿐이었습니다.
<제 프로젝트 이름> could not be compiled. Try rebuilding from source manually.
찾아보니, C++ 코드를 빌드해야 하는데 빌드하기 못했기 때문에 발생하는 문제라고 합니다. Unity와 달리 Unreal Project는 C++ 코드가 컴파일되지 않으면 열 수 없다고 하네요.
✅해결 과정
1. Visual Studio Installer 패키지 체크 여부 확인하기
첫 번째로 생각난 것은 Visual Studio Installer에서 제가 과연 UE5에 대한 패키지를 설치했는가입니다.
Unreal Engine 설치 관리자 항목이 체크되어 있지 않았습니다. 그 외에도 C++ 프로파일링 도구, Windows 10 SDK가 체크되어 있어야 한다고 들었습니다. 우선 필요한 항목들을 체크하여 다운로드 받았습니다. 그런데도 똑같이 제자리 걸음이었습니다.
2. uproject 파일 살펴보기
에픽게임즈 런처에서 프로젝트의 파일 탐색기 경로를 열 수 있습니다.
열어 보면 언리얼 프로젝트와 관련된 파일들이 나옵니다.
.uproject 파일을 우클릭하면, Generate Visual Studio project files란 항목이 있습니다.
여기서도 파일 생성 실패 오류가 떴는데, 아쉽게도 제가 문제를 다 해결한 후에 이 글을 작성하는 중이라 깜빡하고 문제 화면 캡쳐를 못 해왔습니다... 다만 기억을 더듬어보면, .NET Core가 설치되어 있지 않다는 내용이었던 것 같습니다.
그리고 이와 관련된 내용을 구글링하던 중 한 🔗Youtube 영상을 찾았습니다.
For unreal engine 5 from source you will need the .net core 3.1 runtime in addition to those workloads
영상에서 이런 말씀을 하시더라구요. 다시 Visual Studio Installer로 들어가봤습니다. 개별 구성 요소에 들어가보니 .NET core 3.1 런타임(LTS)이 체크가 안 되어 있었습니다....
3. 마지막 재부팅 후 에디터 다시 실행
.NET core 3.1 런타임(LTS)를 체크해서 추가로 설치해준 후, 재부팅을 해주었습니다. 다시 에픽 게임즈 런처를 실행하여 제 프로젝트를 열려고 하니, 또 다시 다음과 같은 말을 하더군요.
The following modules are missing or built with a different engine version:
<제 프로젝트 이름>
Would you like to rebuild them now?
예(Yes)를 눌렀는데, 이번에는 컴파일할 수 없다는 문구가 안 뜨고 한동안 반응이 없더라구요. 그러다가 갑자기 익숙한 화면이 뜹니다.
들어가서 제가 작업하던 걸 보니 그대로 남아있었습니다. 천만다행이네요. 다시 C++ 클래스 파일도 생성하고 테스트 해보니 이제는 오류가 발생하지 않습니다. 아무래도 제가 Visual Studio와 UE5 간의 연동을 제대로 안 해놓은 상태에서 진행한 탓에 발생한 문제인 것 같습니다.
아무튼 1시간 동안 열심히 삽질하다가 해결해서 이렇게 글을 남기러 왔습니다.