Android 퀵스타트

이 퀵스타트 가이드에서는 Android 게임 개발용으로 언리얼 엔진 (UE)을 구성하기 위한 모든 핵심 사항을 안내하며, 다음 주제가 포함됩니다.

• Android 게임 개발용 테스트 디바이스 및 컴퓨터를 구성합니다.
• 모바일 개발용 새 프로젝트를 환경설정합니다.
• Android 빌드 패키징을 위해 언리얼 에디터 를 구성합니다.
• 모바일 렌더링 기능 레벨로 프리뷰할 수 있도록 에디터를 설정합니다.
• 에디터를 통해 디바이스에서 프로젝트를 테스트합니다.
• 프로젝트의 독립형 빌드를 패키징합니다.

이 가이드를 마치면 Android 프로젝트를 초기 구성부터 테스트, 패키징까지 진행할 준비가 되어 있을 것입니다.

1 - Android 개발 필수 구성 요소

Android 프로젝트를 생성하고 디플로이하려면 UE에 포함된 몇 가지 Android 개발 필수 구성 요소를 설치하여 디바이스의 테스트 준비를 마쳐야 합니다.

1. 언리얼에 Android SDK 및 NDK 구성하기 가이드를 따라 Android Studio를 설치하고 UE에서의 Android 개발을 위한 필수 SDK 컴포넌트를 구성합니다.

2. 테스트에 사용할 디바이스에서 설정(Settings) 을 열고 개발자 모드(Developer Mode) 를 활성화합니다.

3. 디바이스의 설정에서 개발자 옵션(Developer Options) 을 찾은 다음 USB 디버깅(USB Debugging) 을 활성화합니다.

   이미지를 클릭하면 최대 크기로 볼 수 있습니다.

4. 컴퓨터에 디바이스를 연결한 다음, 컴퓨터가 디바이스의 데이터에 액세스하도록 허용합니다.

5. 디바이스에 필요한 드라이버를 컴퓨터에 모두 설치합니다.

이 단계를 완료하면 새 Android 프로젝트를 개발할 준비가 끝납니다.

• 디바이스 구성에 대한 자세한 내용은 개발용 Android 디바이스 구성하기 가이드를 참조하세요.

2 - 프로젝트 생성하기

이 섹션에서는 삼인칭 템플릿을 기반으로 새 UE5 프로젝트를 생성하는 프로세스를 보여주며, 예시를 통해 Android 디바이스에서 실행할 UE5 프로젝트를 빠르게 얻는 방법을 설명합니다.

1. 언리얼 에디터 를 실행합니다. 언리얼 프로젝트 브라우저 에서 다음 세팅을 사용하여 새 프로젝트를 생성합니다.

   • 프로젝트 카테고리: 게임(Games)
   • 템플릿: 삼인칭(Third Person)
   • 타깃 하드웨어: Mobile
   • 퀄리티 레벨: Scalable

2. 프로젝트를 AndroidQuickStart 로 명명하고 생성(Create) 버튼을 클릭하여 프로젝트 생성을 마칩니다.

이미지를 클릭하면 확대됩니다.

타깃 하드웨어를 Mobile로, 타깃 퀄리티 레벨을 Scalable로 선택하면 프로젝트가 모바일 디바이스의 사용자 인터페이스 및 하드웨어 제한 사항을 고려합니다.

3 - Android용 언리얼 에디터 구성하기

다음으로는 언리얼 에디터의 프로젝트 세팅(Project Settings) 을 Android APK 빌드용으로 환경설정해야 합니다.

1. 편집(Edit) > 프로젝트 세팅 을 클릭하여 프로젝트 세팅 창을 엽니다.

   

2. 프로젝트 세팅 창의 플랫폼(Platforms) > Android 로 이동합니다.

3. APK 패키징(APK Packaging) 에서 Android 패키지 이름(Android Package Name) 을 찾아 적절한 회사 이름 및 프로젝트 이름을 입력합니다. 이 사례에서는 com.EpicGames.AndroidQuickStart 를 사용합니다.

   이미지를 클릭하면 확대됩니다.

4. APK 패키징 에서 최소 SDK 버전(Minimum SDK Version) 및 타깃 SDK 버전(Target SDK Version) 을 찾아 프로젝트 타깃 디바이스의 적절한 Android API 버전을 입력합니다. 이 사례에서는 그에 따라 SDK 버전 19 및 SDK 버전 28을 사용합니다.

   이미지를 클릭하면 확대됩니다.

5. APK 패키징 아래에 "프로젝트가 Android 플랫폼용으로 환경설정되지 않았습니다(Project is not configured for the Android platform)"라는 경고가 표시될 것입니다. 지금 환경설정(Configure Now) 버튼을 클릭하여 필수 플랫폼 파일이 쓰기 가능하도록 프로젝트를 자동 구성합니다.

6. SDK 라이선스 수락(Accept SDK License) 버튼이 활성화되어 있는 경우 버튼을 클릭하여 Android의 SDK 라이선스 계약을 수락합니다. 이전에 이 계약을 수락했다면 이 단계를 완료하지 않아도 됩니다.

   이미지를 클릭하면 확대됩니다.

7. Google Play 서비스(Google Play Services) 아래에 "프로젝트가 Google Play 서비스용으로 환경설정되지 않았습니다(Project is not configured for the Google Play services)"라는 경고가 표시될 것입니다. 지금 환경설정(Configure Now) 버튼을 클릭하여 필수 파일이 쓰기 가능하도록 프로젝트를 자동 구성합니다.

   이미지를 클릭하면 확대됩니다.

이제 프로젝트의 Android 빌드를 생성하여 Android 디바이스에서 실행할 수 있습니다.

4 - 모바일 프리뷰용 에디터 및 PIE 환경설정하기

언리얼 에디터의 에디터에서 플레이(Play-In-Editor, PIE) 모드를 설정하여 모바일 렌더러에서 게임이 어떻게 보일지 프리뷰를 확인할 수 있습니다.

1. 툴바 에서 세팅(Settings) > 프리뷰 렌더링 레벨(Preview Rendering Level) 을 클릭한 다음 사용 가능한 Android용 렌더링 레벨 중 하나를 선택합니다.

   

2. 툴바 에서 플레이 패널의 드롭다운 을 클릭합니다. 선택한 렌더링 레벨에 해당하는 사용 가능한 모바일 프리뷰(Mobile Preview) 모드 중 하나를 선택합니다.

   

이제 에디터가 타깃 렌더러와 시각적으로 일관된 방식으로 게임을 표시합니다. 또한 PIE 버튼을 누르면 표준 모바일 종횡비로 설정되고 마우스를 사용하여 터치스크린을 에뮬레이트하도록 환경설정된 독립형 창에서 게임이 실행됩니다. 이러한 세팅은 모바일 디바이스용 패키징에 영향을 미치지 않지만, 에디터에서 작업 시 정확한 프리뷰를 제공합니다.

모바일 프리뷰어 환경설정 방법에 대한 자세한 내용은 모바일 프리뷰어 레퍼런스를 참조하세요.

5 - Android 디바이스에서 실행하기

Android 기반 디바이스에서 현재 레벨 을 테스트하려면 다음 단계를 따라야 합니다.

1. 먼저, 테스트할 레벨이 열려 있어야 합니다. 이 예시에서는 지난 단계에서 생성된 블루프린트 기반 프로젝트의 ThirdPersonMap 레벨을 사용합니다.

   

2. ThirdPersonMap 이 이제 열렸다면 메인 툴바 로 이동하고 플랫폼(Platforms) 버튼을 클릭하여 더 많은 옵션을 표시합니다.

   

3. 플랫폼 메뉴의 빠른 실행(Quick Launch) 섹션 목록에서 사용 중인 Android 디바이스를 클릭하여 선택합니다.

   

4. 레벨이 디바이스에서 실행되는 동안 진행률은 다음 이미지와 같이 화면의 우측 하단에 표시됩니다.

   

5. 디플로이를 마치면 프로젝트가 Android 디바이스에서 자동으로 실행되기 시작합니다. 프로젝트가 자동 시작되지 않는 경우 디바이스에서 앱을 찾아 탭하여 실행할 수 있습니다.

   이미지를 클릭하면 확대됩니다.

6 - Android 빌드 패키징하기

위의 단계는 프로젝트를 패키징하여 디바이스에서 즉시 실행하는 방법을 제공합니다. 배포 및 테스트를 위해 독립형 APK를 패키징하려면 다음 단계를 따릅니다.

1. 메인 툴바 로 이동하여 플랫폼 > Android 를 클릭합니다. Android (Multi:ASTC,DXT,ETC2) 옵션을 활성화하고 프로젝트 패키지(Package Project) 를 클릭합니다.

   이미지를 클릭하면 확대됩니다.

2. 프로젝트 패키지 다이얼로그가 나타나면 저장할 디렉터리를 선택합니다. 여기에서는 AndroidQuickStart/Build 에 저장합니다.

   

3. 폴더 선택(Select Folder) 을 클릭하면 언리얼 에디터가 프로젝트 패키징을 시작합니다. 패키징을 마칠 때까지 기다립니다.

빌드를 출력할 폴더로 이동하면, 폴더에는 Android 디바이스에 게임을 설치하기 위한 필수 APK 및 OBB 파일이 포함되어 있을 것입니다. 연결된 디바이스에 빌드를 자동으로 설치하거나 제거하는 데 사용할 수 있는 .bat 파일 쌍도 있습니다.

Android 빌드용 패키징 세팅 환경설정에 대한 자세한 내용은 Android 프로젝트 패키징 레퍼런스 페이지를 참조하세요.

7 - 실전 응용

이제 이 퀵스타트에서 배운 내용을 통해 일반 Android 디바이스에 UE5 프로젝트를 패키징 및 배포할 준비가 되었습니다. 완전하게 작동하는 모바일 게임을 만들려면 새 게임플레이 및 레벨을 생성하여 UE5의 제공된 템플릿에서 확장시켜야 합니다. 프로젝트의 요구 사항 및 특정 타깃 디바이스에 따라 빌드 최적화를 위해 추가 환경설정이 필요할 것입니다. 다음 링크에는 프로젝트 빌드를 다음 단계로 발전시키기 위한 자세한 정보가 나와 있습니다.

• Android 개발 레퍼런스 - UE의 Android 개발자를 위한 일반 레퍼런스 정보입니다.
• Android 개발 요구 사항 - 특정 UE 버전 사용 시 호환 가능한 하드웨어와 SDK 및 OS 요구 사항 레퍼런스입니다.
• Android 디버깅 - 디바이스에서 Android 프로젝트를 디버깅하기 위한 하우투 가이드입니다.
• 모바일 렌더링 - 모바일 전용 렌더링 기능에 대한 정보입니다.
• 모바일 서비스 - 온라인 서비스 및 알림 구현에 대한 정보입니다.
• Android로 출시하기 - 게임 배포를 준비하기 위한 가이드라인입니다.