언리얼 엔진(UE) 은 Visual Studio 에서 Android Game Development Extension(AGDE) 플러그인 을 통한 디버깅을 지원합니다. 이 플러그인을 사용하면 Android Studio 환경으로 전환하지 않아도 Visual Studio에서 Android 프로젝트에 필요한 디버깅 및 프로파일링 툴을 사용할 수 있습니다. 이는 Windows 사용자가 UE에서 Android 프로젝트를 진행할 때 권장되는 디버깅 환경입니다.
이 가이드는 해당 플러그인을 다운로드 및 활성화하는 방법과 사용할 때 유용한 리소스 링크를 안내합니다.
AGDE 플러그인 다운로드 및 설치
AGDE 플러그인을 설치하려면 작업할 프로젝트의 솔루션을 설치하고 다음 단계를 따르세요.
-
Visual Studio 2019 가 설치되었으며 언리얼 엔진의 디폴트 Visual Studio 버전으로 사용하고 있는지 확인합니다.
-
Android 개발자 페이지에서 AGDE 플러그인을 다운로드합니다.
-
Visual Studio에 AGDE 플러그인을 설치합니다.
-
프로젝트의 .uproject 파일을 찾아 우클릭하여 컨텍스트 메뉴를 연 다음, 프로젝트 파일 생성(Generate Project Files) 을 눌러 Visual Studio 솔루션을 재생성합니다.
새로 재생성된 솔루션은 기본적으로 플러그인이 활성화되어 있습니다.
AGDE 플러그인 사용하기
AGDE가 활성화되면 플러그인이 Visual Studio에 직접 연결된 Android 디바이스를 검색합니다. AGDE로 디버깅하기에 앞서 프로젝트를 APK로 빌드 및 스테이징해야 합니다. 디버깅 시 쿠킹 프로세스를 시작하지 않기 때문입니다. 쿠킹 및 스테이징에 대한 자세한 정보는 빌드 작업 가이드를 참조하세요. 빌드가 생성되면 AGDE로 실행 및 디버그할 수 있습니다.
SIGILL 오류가 발생하면 F5를 눌러 오류를 건너뛰고 AGDE를 계속 실행하세요. 이 문제는 언리얼 엔진의 향후 버전에서 해결될 예정입니다.
AGDE의 기능에 대한 추가 정보는 다음 문서를 참조하세요.