Visual Studio에서 AGDE로 디버깅

언리얼 엔진의 Android 프로젝트에서 Visual Studio 디버깅을 활성화하고 사용하는 방법을 설명합니다.

Choose your operating system:

Windows

macOS

Linux

언리얼 엔진(UE)Visual Studio 에서 Android Game Development Extension(AGDE) 플러그인 을 통한 디버깅을 지원합니다. 이 플러그인을 사용하면 Android Studio 환경으로 전환하지 않아도 Visual Studio에서 Android 프로젝트에 필요한 디버깅 및 프로파일링 툴을 사용할 수 있습니다. 이는 Windows 사용자가 UE에서 Android 프로젝트를 진행할 때 권장되는 디버깅 환경입니다.

이 가이드는 해당 플러그인을 다운로드 및 활성화하는 방법과 사용할 때 유용한 리소스 링크를 안내합니다.

AGDE 플러그인 다운로드 및 설치

AGDE 플러그인을 설치하려면 작업할 프로젝트의 솔루션을 설치하고 다음 단계를 따르세요.

  1. Visual Studio 2019 가 설치되었으며 언리얼 엔진의 디폴트 Visual Studio 버전으로 사용하고 있는지 확인합니다.

  2. Android 개발자 페이지에서 AGDE 플러그인을 다운로드합니다.

  3. Visual Studio에 AGDE 플러그인을 설치합니다.

  4. 프로젝트의 .uproject 파일을 찾아 우클릭하여 컨텍스트 메뉴를 연 다음, 프로젝트 파일 생성(Generate Project Files) 을 눌러 Visual Studio 솔루션을 재생성합니다.

새로 재생성된 솔루션은 기본적으로 플러그인이 활성화되어 있습니다.

AGDE 플러그인 사용하기

AGDE가 활성화되면 플러그인이 Visual Studio에 직접 연결된 Android 디바이스를 검색합니다. AGDE로 디버깅하기에 앞서 프로젝트를 APK로 빌드 및 스테이징해야 합니다. 디버깅 시 쿠킹 프로세스를 시작하지 않기 때문입니다. 쿠킹 및 스테이징에 대한 자세한 정보는 빌드 작업 가이드를 참조하세요. 빌드가 생성되면 AGDE로 실행 및 디버그할 수 있습니다.

SIGILL 오류가 발생하면 F5를 눌러 오류를 건너뛰고 AGDE를 계속 실행하세요. 이 문제는 언리얼 엔진의 향후 버전에서 해결될 예정입니다.

AGDE의 기능에 대한 추가 정보는 다음 문서를 참조하세요.

언리얼 엔진의 이전 버전을 위해 작성된 페이지입니다. 현재 언리얼 엔진 5 버전을 위해 업데이트되지 않았습니다.