1. Epic GamesDeveloper
  3. Visual Studio에서 AGDE로 디버깅

Visual Studio에서 AGDE로 디버깅

Visual Studio에서 AGDE를 사용하여 Android 프로젝트 디버깅

Visual Studio에서 AGDE로 디버깅

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

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

1. AGDE 다운로드 및 설치

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

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

  2. Android 개발자 페이지에서 AGDE 플러그인을 다운로드합니다. 현재 UE 버전에는 AGDE 23.1 82 이상 버전이 필요합니다.

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

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

새 솔루션 파일에서는 기본적으로 플러그인이 활성화되어 있습니다.

2. JDK 구성

AGDE는 JDK 17이 필요합니다. 이 버전의 JDK를 설치하지 않고 실행하려고 시도할 경우, 언리얼 자동화 툴(UAT) 에서 Gradle 오류로 인해 프로젝트를 패키징할 수 없습니다.

다음 단계를 따라 올바른 버전을 설치하세요.

  1. OpenJDK 17을 다운로드하여 설치합니다. 설치한 디렉터리를 적어두세요.

  2. 검색 창 을 열고 시스템 환경 변수 편집(Edit the System Environment Variables) 을 찾습니다. 이 옵션을 클릭하면 시스템 속성(System Properties) 다이얼로그가 열립니다.

  3. 환경 변수(Environment Variables) 버튼을 클릭합니다.

  4. AGDE_JAVA_HOME 환경 변수를 선택하고 편집(Edit) 을 클릭합니다. AGDE_JAVA_HOME 변수가 없는 경우 새 항목(New) 을 클릭하여 추가합니다.

  5. AGDE_JAVA_HOME 의 디렉터리를 JDK를 설치한 위치로 설정합니다.

    Change the JAVA_HOME environment variable to your installation of JDK

  6. 환경 변수가 적용되도록 컴퓨터를 리부트합니다.

완료되면 컴퓨터가 AGDE에 필요한 JDK를 보유하고 있을 것입니다.

3. AGDE로 프로젝트 실행

AGDE는 Android 디바이스에서 디버깅 또는 언리얼 엔진 애플리케이션과의 연결이 가능합니다. 이를 위해 Visual Studio에서 몇 가지 환경설정 옵션을 설정해야 하고, Android 프로젝트의 코드를 컴파일할 수 있지만 콘텐츠를 쿠킹할 수 없으므로 AGDE 사용 전에 APK를 패키징해야 합니다. 다음 단계를 따라 디바이스에서 프로젝트를 실행합니다.

  1. BuildCookRun 명령을 사용하여 Android에 맞춰 프로젝트를 패키징합니다. 언리얼 에디터 에서 턴키(Turnkey) 또는 플랫폼(Platforms) 드롭다운을 사용할 수도 있습니다.

    Click the Platforms dropdown to package your project from the editor

    쿠킹 및 패키징 프로세스에 관한 자세한 정보는 빌드 작업 및 콘텐츠 쿠킹을 참조하세요.

  2. 프로젝트의 Visual Studio 솔루션을 엽니다.

  3. 솔루션 구성(Solution Configuration) 을 DebugGame 으로 설정하고 솔루션 플랫폼(Solution Platform) 을 Android 로 설정합니다.

  4. USB 케이블을 사용하여 테스트할 Android 디바이스를 컴퓨터에 연결합니다. 디바이스에서 USB 디버깅 권한 또는 컴퓨터의 디바이스 데이터 액세스 권한 부여를 요청하는 경우 권한을 부여합니다.

    USB 연결을 사용할 때 컴퓨터의 케이블과 포트 모두 데이터를 지원해야 합니다.

  5. 프로젝트를 빌드 및 디버깅하는 버튼에 디바이스의 이름이 표시될 것입니다. 버튼을 클릭하거나 F5 를 눌러 디버깅을 시작합니다. 디버거 실행을 기다려야 할 수 있습니다.

    SIGILL 오류가 발생하면 F5를 눌러 오류를 건너뛰고 AGDE를 계속 실행하세요.

프로젝트가 디바이스에서 빌드 및 실행되고, Windows 애플리케이션에서와 마찬가지로 Visual Studio의 디버깅 툴을 사용할 수 있습니다.

4. 애플리케이션에 AGDE 연결

언리얼 엔진 애플리케이션의 실행 중인 인스턴스에 연결하려면 다음 단계를 따르세요.

  1. 툴바의 디버그(Debug) 드롭다운을 클릭하고 프로세스에 연결(Attach to Process) 을 클릭합니다.

    Click Debug > Attach to Process

  2. 연결 유형(Connection Type) 을 Android Game Development Extension 으로 설정합니다.

  3. 연결 대상(Connection Target) 드롭다운을 클릭하고 디바이스 항목을 클릭합니다.

  4. 애플리케이션에 대한 프로세스를 선택하고, 연결(Attach) 을 클릭합니다.

    Choose the process to attach to from the menu

추가 정보

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

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page