Version: 2019.4
언어: 한국어
Unity 리모트
Android용 앱 빌드

Android 플레이어 설정

이 페이지는 Android 플랫폼에 대한 Player 설정을 자세하게 다룹니다. 일반적인 Player 설정은 플레이어 설정을 참조하십시오.

Android 플레이어 설정
Android 플레이어 설정

프로퍼티 문서는 플레이어 UI 섹션에 나열된 순서대로 그룹화되었습니다.

아이콘(Icon)

Android 플레이어 설정의 아이콘 섹션
Android 플레이어 설정의 아이콘 섹션
프로퍼티 기능
Adaptive 앱의 Android Adaptive 아이콘에 대한 텍스처를 설정합니다.
Round 앱의 Android Round 아이콘에 대한 텍스처를 설정합니다.
Legacy 앱의 Android Legacy 아이콘에 대한 텍스처를 설정합니다.
Enable Android Banner Android TV 빌드용 커스텀 배너를 활성화합니다.

해상도(Resolution) 및 프리젠테이션(Presentation)

Resolution and Presentation 섹션에서 화면이 표시되는 모양에 대해 다음을 커스터마이즈할 수 있습니다.

Android 플랫폼의 Resolution and Presentation 설정
Android 플랫폼의 Resolution and Presentation 설정
설정 기능
Start in fullscreen mode 스플래시 화면이나 첫 번째 씬이 로드되는 동안 탐색 표시줄을 숨깁니다. 설정하지 않으면 스플래시 화면이나 첫 번째 씬이 로드되는 동안 탐색 표시줄이 나타납니다.
Render outside safe area 이 옵션을 활성화하면 디스플레이 컷아웃(노치) 영역을 비롯한 모든 이용 가능한 스크린 공간을 사용하여 렌더링할 수 있습니다. 자세한 내용은 Android 개발자 웹사이트의 디스플레이 컷아웃 지원 문서를 참조하십시오.
Optimized Frame Pacing 이 옵션을 활성화하면 Unity가 프레임 속도의 편차를 줄이기 위해 프레임을 균등하게 분배하므로 더 부드러운 게임플레이를 구현할 수 있습니다.

다른 해상도 및 프레젠테이션 프로퍼티는 이 섹션 아래에 그룹화됩니다.

해상도 스케일링

Android 플랫폼의 Resolution Scaling 설정
Android 플랫폼의 Resolution Scaling 설정
설정 기능
해상도 스케일링 모드(Resolution Scaling Mode) 스케일링을 네이티브 화면 해상도 이하가 되도록 설정할 수 있습니다.
FixedDPI 기기의 화면 해상도를 네이티브 해상도보다 낮게 스케일링하고 Target DPI 프로퍼티를 표시합니다. 성능과 배터리 수명을 최적화하거나 특정 DPI 설정을 타겟팅하는 데 사용합니다.
Disabled 스케일링이 적용되지 않고 게임이 네이티브 화면 해상도를 렌더링하도록 합니다.
타겟 DPI(Target DPI) 게임 화면의 해상도를 설정합니다. 기기의 네이티브 화면 DPI가 이 값보다 높은 경우, Unity는 이 설정에 일치하도록 게임 화면을 다운스케일링합니다. 스케일은 최소(타겟 DPI * 요소 / 화면 DPI, 1)로 계산됩니다. Factor품질 설정의 Resolution Scaling Fixed DPI Factor 에 의해 제어됩니다.
참고: 이 옵션은 Resolution Scaling ModeFixed DPI 로 설정된 경우에만 표시됩니다.
Blit Type blit를 사용해 최종 이미지를 화면에 렌더링할지 여부를 제어합니다.
Always (Always blit) Unity가 오프스크린 버퍼로 렌더링한 다음 시스템 프레임버퍼에 복사하도록 만듭니다. 이 옵션은 대부분의 기기와 호환되지만, 대개 Never 블리팅보다는 느립니다.
Never (Never blit) Unity가 OS에서 제공된 프레임버퍼에 렌더링하도록 만듭니다. 애플리케이션 런타임 시점에 실패를 유발하는 조건이 발생하면 애플리케이션은 일회성 경고를 기기 로그에 출력합니다. Never 블리팅은 대개 Always 블리팅보다 빠르지만, 일부 기기와 호환되지 않습니다.
Auto 가능한 경우 Unity가 OS에서 제공된 프레임버퍼에 렌더링하도록 만듭니다. 애플리케이션이 시스템 프레임버퍼에 렌더링하지 못하게 만드는 조건이 충족되면 애플리케이션은 오프스크린 렌더링으로 전환하고 기기 콘솔에 경고를 발행합니다.

지원되는 종횡비

Android 플랫폼의 Aspect Ratio Mode 설정
Android 플랫폼의 Aspect Ratio Mode 설정

기기에 대한 Aspect Ratio Mode 를 설정합니다. Legacy Wide Screen (1.86), Native Aspect Ratio, Custom 중에서 선택할 수 있습니다. Custom 을 선택하면 Up To 필드가 나타납니다.

Up To 프로퍼티를 사용하여 커스텀 최대 화면 너비를 설정하십시오. 이 프로퍼티는 Aspect Ratio ModeCustom 으로 설정된 경우에만 표시됩니다.

방향

Android 플랫폼의 Default Orientation 설정
Android 플랫폼의 Default Orientation 설정

Default Orientation 드롭다운 메뉴에서 게임 화면의 방향을 선택할 수 있습니다.

설정 기능
Portrait 홈 버튼이 하단에 표시됩니다.
Portrait Upside Down 홈 버튼이 상단에 표시됩니다.
Landscape Left 홈 버튼이 오른쪽에 표시됩니다.
Landscape Right 홈 버튼이 왼쪽에 표시됩니다.
Auto Rotation 화면이 Allowed Orientations for Auto Rotation 설정에서 지정된 방향으로 자동 회전합니다. 기본 옵션입니다.

참고: 이 설정은 iOS 및 Android 기기에서 동일합니다.

방향을 Auto Rotation 으로 설정하면 Allowed Orientations for Auto Rotation 섹션이 표시됩니다.

자동 회전 허용 방향

이 화면은 Default OrientationAuto Rotation 으로 설정된 경우에만 표시됩니다.

Android 플랫폼의 Allowed Orientations for Auto Rotation 설정
Android 플랫폼의 Allowed Orientations for Auto Rotation 설정

Auto Rotation 은 화면 방향을 기기에 맞춰 변경하므로, 허용된 화면 방향을 제한하는 것이 좋습니다(예: 기기를 가로 방향으로 잠금 설정).

이 섹션의 상자를 선택하여 원하는 방향을 활성화하십시오.

설정 기능
Portrait 세로 방향을 사용할 수 있습니다.
Portrait Upside Down 거꾸로 된 세로 방향(홈 버튼이 위쪽에 위치)을 사용할 수 있습니다.
Landscape Right 오른쪽 가로 방향(홈 버튼이 왼쪽 에 위치)을 사용합니다.
Landscape Left 풍경 왼쪽 방향(홈 버튼이 오른쪽 에 위치)을 사용할 수 있습니다.

기타

Android 플랫폼을 위한 다른 해상도 및 프레젠테이션 설정
Android 플랫폼을 위한 다른 해상도 및 프레젠테이션 설정
설정 기능
Use 32-bit Display Buffer 32비트 컬러 값(기본값은 16비트)을 유지하는 디스플레이 버퍼를 생성하려면 이 옵션을 활성화합니다. 줄무늬가 보이거나 포스트 프로세싱된 효과에 알파가 필요한 경우 사용합니다. 디스플레이 버퍼와 포맷이 동일한 렌더 텍스처를 생성하기 때문입니다.
Disable Depth and Stencil 뎁스 및 스텐실 버퍼를 비활성화하려면 이 옵션을 활성화합니다.
Render Over Native UI Unity가 Android 또는 iOS의 네이티브 UI 위에 렌더링하도록 만들려면 이 옵션을 활성화합니다. 이렇게 하려면 카메라의 Clear Flags를 알파가 1 미만인 단색으로 설정해야 합니다.
Show Loading Indicator 로딩 진행 표시줄이 표시되는 방식을 선택합니다. Don’t Show, Large, Inversed Large, Small, Inversed Small 옵션이 있습니다.

스플래시 이미지

일반 스플래시 화면 설정 위에서 Virtual Reality Splash Image 설정을 사용하여 가상 현실 디스플레이용 커스텀 스플래시 이미지를 지정할 수 있습니다.

Android 플랫폼의 Splash Image 설정
Android 플랫폼의 Splash Image 설정

일반 스플래시 화면 설정 아래에서 Android 전용 Static Splash Image 를 설정할 수 있습니다.

Android 플레이어 플랫폼의 실행 시 스토리보드 사용 화면
Android 플레이어 플랫폼의 실행 시 스토리보드 사용 화면

Android Splash Screen 프로퍼티를 사용하여 Android 스플래시 화면에 사용할 텍스처를 지정하십시오. 스플래시 화면 이미지의 표준 크기는 320x480입니다.

Splash Scaling 드롭다운 메뉴에서 Unity가 스플래시 이미지를 기기 화면에 맞게 스케일하는 방법을 선택하십시오. 다음의 옵션이 제공됩니다.

  • Center (only scale down)
  • Scale to Fit (letter-boxed)
  • Scale to Fill (cropped)

기타 설정

이 섹션에서는 다음 그룹으로 분류된 다양한 옵션을 커스터마이즈할 수 있습니다.

렌더링(Rendering)

다음 설정을 사용하여 Unity가 Android 플랫폼용으로 게임을 렌더링하는 방법을 커스터마이즈합니다.

Android 플랫폼용 렌더링 설정
Android 플랫폼용 렌더링 설정
프로퍼티 기능
Color Space GammaLinear 중 렌더링에 사용할 색 공간을 선택합니다.
두 옵션의 차이점에 대한 설명은 리니어 렌더링 개요를 참조하십시오.
Auto Graphics API 그래픽스 API를 수동으로 선택하고 순서를 변경하려면 이 옵션을 비활성화합니다. (OpenGL). 기본적으로 이 옵션은 활성화되어 있으며 Unity는 GLES3.2를 사용합니다. 기기가 GLES3.2를 지원하지 않으면 Unity는 GLES3.1, GLES3 또는 GLES2로 폴백합니다. 리스트에 GLES3만 있는 경우 추가로 Require ES3.1, Require ES3.1+AEPRequire ES3.2 체크박스가 나타납니다. 이 체크박스를 이용하여 해당 그래픽스 API를 강제 설정할 수 있습니다.
중요: Unity는 GLES2가 리스트에 없고 최소 API 레벨이 JellyBean(API 레벨 18) 이상으로 설정된 경우에만 GLES3/GLES3.1/AEP/3.2 요구 사항을 Android 매니페스트에 추가합니다. 이 경우에만 애플리케이션이 Google Play 스토어에서 지원되지 않는 기기에 나타나지 않습니다.
색 영역(Color Gamut) Android 플랫폼에서 렌더링에 사용할 색 영역을 추가하거나 제거할 수 있습니다. 더하기(+) 아이콘을 클릭하면 사용 가능한 영역의 리스트를 확인할 수 있습니다. 색 영역은 모니터나 화면과 같은 기기에서 사용 가능한 색상 범위를 지정합니다. sRGB 영역은 기본으로 지정된 필수 영역입니다. 광범위한 색 영역 디스플레이가 지원되는 기기를 타겟팅하는 경우 DisplayP3를 사용하여 디스플레이 성능을 100% 활용하십시오.
Multithreaded Rendering 그래픽스 API 호출을 Unity의 메인 스레드에서 별도 워커 스레드로 이동시키려면 이 옵션을 활성화합니다. 그러면 메인 스레드에 대한 CPU 사용량이 많은 애플리케이션의 성능을 개선할 수 있습니다.
Static Batching 빌드에 정적 배칭을 사용하려면 이 옵션을 활성화합니다(기본적으로 활성화됨).
Dynamic Batching 빌드에 동적 배칭을 사용하려면 이 옵션을 활성화합니다(기본적으로 활성화됨).
참고: 스크립터블 렌더 파이프라인이 활성화된 경우에는 동적 배칭이 아무런 영향도 미치지 않습니다. 따라서 이 설정은 그래픽스 설정에서 스크립터블 렌더 파이프라인 에셋이 설정되지 않았을 때에만 표시됩니다.
_Compute Skinning 이 옵션을 활성화하면 GPU 컴퓨트 스키닝을 사용하여 CPU 리소스를 확보할 수 있습니다. 컴퓨트 스키닝은 OpenGL ES 3.1 또는 Vulkan을 지원하는 기기에서만 지원됩니다. GPU 컴퓨트 스키닝에 대한 자세한 내용은 Wikipedia의 골격 애니메이션 페이지를 참조하십시오.
Graphics Jobs 그래픽스 작업(루프 렌더)을 다른 CPU 코어에서 실행 중인 워커 스레드에 오프로드하도록 Unity를 설정하려면 이 옵션을 활성화합니다. 그러면 메인 스레드에서 종종 병목 현상을 일으키는 Camera.Render에 소요되는 시간을 줄일 수 있습니다.
참고: Unity는 현재 Vulkan을 사용하는 경우에만 그래픽스 잡을 지원하며, 이 설정은 OpenGL ES를 사용하는 경우 영향이 없습니다.
Lightmap Encoding 라이트맵 인코딩을 Low Quality, Normal Quality 또는 High Quality 로 설정합니다. 이 설정은 라이트맵의 인코딩 방식과 압축 포맷에 영향을 줍니다.
Lightmap Streaming Enabled 필요에 따라 라이트맵 밉맵만 로드하려면 이 옵션을 활성화합니다. 현재의 게임 카메라를 렌더링하기 위해 Unity는 텍스처를 생성할 때 이 값을 라이트맵 텍스처에 적용합니다.
참고: 이 값을 사용하려면 텍스처 스트리밍 품질 설정을 활성화하십시오.
Streaming Priority 리소스 확보 경쟁이 발생할 경우 라이트맵 밉맵 스트리밍의 우선 순위를 정의합니다. 유효한 범위는 –127에서 128 사이입니다(양수는 높은 우선 순위를 의미함). 이 설정은 Lightmap Streaming Enabled 옵션을 선택한 경우에만 이용할 수 있습니다. 이 값을 사용하려면 텍스처 스트리밍 품질 설정을 활성화하십시오.
Protect Graphics Memory 그래픽스 버퍼가 하드웨어 보호 경로를 통해서만 표시되도록 강제로 설정하려면 체크박스를 선택합니다. 지원되는 기기에서만 사용할 수 있습니다.
Enable Frame Timing Stats CPU 및 GPU에서 프레임 처리에 소요되는 시간 통계를 수집합니다.

Vulkan 설정

프레임 동안 Vulkan 렌더러의 Graphics.SetSRGBWrite()가 sRGB 쓰기 모드를 토글할 수 있도록 하려면 SRGB Write Mode 옵션을 활성화합니다.

Android 플랫폼용 Vulkan 플레이어 설정
Android 플랫폼용 Vulkan 플레이어 설정

참고: 이 기능을 활성화하면 특히 타일링된 GPU의 경우 성능이 저하될 수 있습니다.

식별

Android 플랫폼용 식별 설정
Android 플랫폼용 식별 설정
프로퍼티 기능
Package Name 기기와 Google Play 스토어에서 앱을 고유하게 식별하는 애플리케이션 ID를 설정합니다. 식별자의 기본 구조는 com.CompanyName.AppName 이며 임의로 선택할 수 있습니다. 이 설정은 iOS와 Android 간에 공유됩니다.
Version 번들의 반복 횟수(릴리스되거나 릴리스되지 않음)를 식별하는 번들의 빌드 버전 번호를 입력합니다. 버전은 점으로 구분된 숫자가 포함된 문자열의 일반적인 포맷으로 지정됩니다(예: 4.3.2). (iOS와 Android 간에 공유됩니다.)
Bundle Version Code 내부 버전 번호입니다. 이 숫자는 한 버전이 다른 버전보다 더 최신인지 확인하는 데 사용되며, 숫자가 높을수록 더 최신 버전입니다. 이 버전 번호는 사용자에게 표시되지 않으며, 해당 숫자는 versionName 속성에 의해 설정됩니다. 이 값은 ’100’과 같은 정수로 설정해야 합니다. 연속되는 각 버전의 숫자가 이전 버전보다 더 높은 경우에 한해 원하는 대로 정의할 수 있습니다.

예를 들어 빌드 번호일 수도 있습니다. 아니면 하위 및 상위 16비트에서 ‘x’ 및 ’y’를 별도로 인코딩하여 ‘x.y’ 포맷의 버전 번호를 정수로 변환할 수도 있습니다. 또는 새 버전을 릴리스할 때마다 숫자를 1씩 증가시킬 수도 있습니다.

Split APKs by target architecture 가 활성화된 경우 이 숫자를 100000 미만으로 유지하십시오. 각 APK에는 고유 버전 코드가 있어야 합니다. 그래야만 Unity가 ARMv7에 대한 숫자에 100000, ARM64에 대한 숫자에 200000을 추가합니다.
Minimum API Level 애플리케이션을 실행하는 데 필요한 최소 Android 버전(API 레벨)입니다.
Target API Level 애플리케이션을 컴파일하는 데 사용할 타겟 Android 버전(API 레벨)입니다.

설정(Configuration)

Android 플랫폼용 구성 설정
Android 플랫폼용 구성 설정
설정 기능
Scripting Backend 사용할 스크립팅 백엔드를 선택합니다. 스크립팅 백엔드는 Unity가 프로젝트의 C# 코드를 컴파일하고 실행하는 방식을 결정합니다.
Mono C# 코드를 .NET 공용 중간 언어(CIL)로 컴파일하고, 공용 언어 런타임을 사용하여 해당 CIL을 실행합니다. 자세한 내용은 Mono 프로젝트 웹사이트를 참조하십시오.
IL2CPP C# 코드를 CIL로 컴파일하고, CIL을 C++로 전환한 다음 C++를 런타임에 직접 실행되는 네이티브 기계어 코드로 컴파일합니다. 자세한 내용은 IL2CPP를 참조하십시오.
API Compatibility Level 프로젝트에서 사용할 수 있는 .NET API를 선택합니다. 이 설정은 타사 라이브러리와의 호환성에 영향을 줄 수 있습니다.
: 타사 어셈블리 관련 문제가 발생하는 경우, 아래 API 호환성 레벨 섹션의 권장 사항을 시도해 보십시오.
.Net 2.0 .Net 2.0 라이브러리로, .net 호환성이 최대 수준이며 파일 크기가 가장 큽니다. 지원 중단 예정인 .NET 3.5 런타임의 일부입니다.
.Net 2.0 Subset 전체 .net 호환성의 부분 집합으로, 파일 크기는 더 작습니다. 지원 중단 예정인 .NET 3.5 런타임의 일부입니다.
.Net Standard 2.0 .NET Standard 2.0과 호환됩니다. 크기가 더 작은 빌드를 생성하며 크로스 플랫폼이 100% 지원됩니다.
.Net 4.x .NET Standard 2.0 프로파일과 추가 API의 모든 사항을 포함하는 .NET Framework 4와 호환됩니다. .NET Standard 2.0에 포함되지 않은 API에 액세스하는 라이브러리를 이용하는 경우 이 옵션을 선택하십시오. 크기가 큰 빌드를 생성하며, 일부 플랫폼의 경우 추가 API를 사용하지 못할 수 있습니다. 자세한 내용은 추가 클래스 라이브러리 어셈블리 레퍼런스를 참조하십시오.
C++ 컴파일러 설정(C++ Compiler Configuration) IL2CPP에 의해 생성된 코드를 컴파일할 때 사용할 C++ 컴파일러 설정을 선택합니다.
참고: 이 프로퍼티는 Scripting BackendIL2CPP 로 설정하지 않는 경우 비활성화됩니다.
Use incremental GC 점진적 가비지 컬렉터를 사용합니다. 점진적 가비지 컬렉터는 가비지 컬렉션을 여러 프레임에 분산하여 프레임 기간 동안 GC 관련 스파이크를 줄입니다.
Mute Other Audio Sources Unity 애플리케이션이 백그라운드에서 실행되는 애플리케이션의 오디오를 중지하게 하려면 이 옵션을 활성화합니다. 이 옵션을 활성화하지 않으면 백그라운드 애플리케이션의 오디오가 Unity 애플리케이션과 함께 계속 재생됩니다.
Target Architectures 애플리케이션을 실행할 CPU(32비트 ARM, 64비트 ARM, 32비트 Intel)를 선택합니다.
참고: 64비트 환경에서 Android 앱을 실행하면 성능상 이점이 있으며, 64비트 앱은 4GB가 넘는 메모리 공간을 처리할 수 있습니다.
Split APKs by target architecture (Experimental) Target Architectures 에서 선택된 각 CPU 아키텍처에 대해 별도의 APK를 생성하려면 이 옵션을 활성화합니다. 이렇게 하면 Google Play 스토어 사용자의 다운로드 크기가 줄어듭니다. 이 기능은 Google Play 이외의 스토어에서는 지원되지 않을 수 있습니다. 자세한 내용은 다수의 APK 지원을 참조하십시오.
Install Location 애플리케이션이 기기에 설치되는 위치를 지정합니다. 자세한 내용은 Android 개발자의 설치 위치 문서를 참조하십시오.
Automatic 운영체제가 결정하게 합니다. 사용자가 앱 설치 위치를 이동할 수 있습니다.
Prefer External 가능한 경우 애플리케이션을 SD 카드 같은 외부 저장소에 설치합니다. 운영체제는 이 동작을 보장하지 않습니다. 가능하지 않은 경우 앱이 내부 메모리에 설치됩니다.
Force Internal 애플리케이션을 강제로 내장 메모리에 설치합니다. 사용자가 앱을 외부 저장소로 이동할 수 없습니다.
Internet Access 네트워킹 API를 사용하지 않는 경우에도 네트워킹(INTERNET) 권한을 Android 매니페스트에 항상 추가할지 여부를 선택합니다. 개발용 빌드는 Require 로 기본 설정하십시오.
Auto 네트워킹 API를 사용하는 경우에만 인터넷 액세스 권한을 추가합니다.
Require 인터넷 액세스 권한을 항상 추가합니다.
Write Permission 외부 스토리지(예: SD 카드)에 대한 쓰기 권한을 허용하고 해당 권한을 Android 매니페스트에 추가할지 여부를 선택합니다. 개발용 빌드는 External(SDCard) 로 기본 설정하십시오.
Internal 내부 스토리지에 대한 쓰기 권한만 허용합니다.
External(SDCard) 외부 스토리지에 대한 쓰기 권한을 허용합니다.
Filter Touches When Obscured 표시된 다른 창이 Unity 애플리케이션을 가리고 있을 때 수신된 터치를 폐기하려면 이 옵션을 활성화합니다. 이를 통해 탭재킹(tapjacking)을 막을 수 있습니다.
Sustained Performance Mode 서멀 스로틀링 없이 장기간에 걸쳐 예측 가능하고 일관된 기기 성능 레벨을 설정하려면 이 옵션을 활성화합니다. 이 설정을 활성화하면 전체 성능이 저하될 수 있습니다. Android 지속 성능 API에 기반합니다.
Maximum Java Heap Size 빌드 시 최대 Java 힙 크기를 사용자로 설정합니다(MB). 기본값은 4096입니다.
Low Accuracy Location 낮은 정확도 값을 Android 위치 관련 API에 사용하려면 이 옵션을 활성화합니다.
Android TV Compatibility 애플리케이션을 Android TV 호환 가능으로 표시하려면 이 옵션을 활성화합니다.
Android Game 출력 패키지(APK)를 일반 애플리케이션이 아니라 게임으로 표시하려면 이 옵션을 활성화합니다.
Android Gamepad Support Level 애플리케이션이 게임 패드에 제공할 지원 수준을 선택하십시오. 이용할 수 있는 옵션은 Works with D-Pad, Supports GamepadRequires Gamepad 입니다.
Warn about App Bundle size 이 옵션을 활성화하면 Android 앱 번들 크기가 특정 임계값을 초과할 때 경고가 표시됩니다. 이 옵션은 기본적으로 선택되어 있으며, 빌드 설정에서 Build App Bundle (Google Play) 옵션을 활성화한 경우에만 설정이 가능합니다.
App Bundle size threshold 크기(단위: Mb)를 입력합니다. 앱 번들이 이 크기를 초과하면 Unity에 경고가 표시됩니다.
Scripting Define Symbols 커스텀 컴파일 플래그를 설정합니다. 자세한 내용은 플랫폼 의존 컴파일을 참조하십시오.
Allow ‘unsafe’ Code 사전 정의된 어셈블리(예: Assembly-CSharp.dll)에서 ‘안전하지 않은’ C# 코드 컴파일에 대한 지원을 활성화합니다.
어셈블리 정의 파일(.asmdef)의 경우 .asmdef 파일 중 하나를 클릭한 후 표시되는 인스펙터 창에서 이 옵션을 활성화하십시오.
액티브 입력 핸들링(Active Input Handling) 사용자의 입력을 처리하는 방식을 선택합니다.
Input Manager 기존의 입력 설정을 사용하십시오.
Input System(프리뷰) 새로운 입력 시스템을 사용합니다. 입력 시스템은 이 릴리스에서는 프리뷰 패키지로 제공됩니다. 입력 시스템의 프리뷰를 사용하려면 InputSystem 패키지를 설치하십시오.
Both 두 시스템 모두를 나란히 사용합니다.

API 호환성 레벨

모든 타겟에 모노 API 호환성 레벨을 선택할 수 있습니다. 간혹 타사 .NET 라이브러리에는 .NET 호환성 레벨을 벗어난 기능이 사용됩니다. 이런 경우 발생하는 상황과 최선의 해결책을 알아보려면 다음 권장 사항을 따르십시오.

  1. Windows용 Reflector를 설치합니다.
  2. 문제가 있는 API 호환성 수준의 .NET 어셈블리를 Reflector로 드래그합니다. .NET 어셈블리는 Frameworks/Mono/lib/mono/YOURSUBSET/에 있습니다.
  3. 타사 어셈블리를 드래그합니다.
  4. 타사 어셈블리를 마우스 오른쪽 버튼으로 클릭하고 Analyze를 선택합니다.
  5. 분석 보고서에서 Depends on 섹션을 살펴봅니다. 타사 어셈블리가 의존하고 있지만 선택한 .NET 호환성 레벨에서 사용할 수 없는 항목은 빨간색으로 강조 표시됩니다.

최적화(Optimization)

Android 플랫폼용 최적화 설정
Android 플랫폼용 최적화 설정
설정 기능
Prebake Collision Meshes 빌드 시간에 충돌 데이터를 메시에 추가하려면 이 옵션을 활성화합니다.
Keep Loaded Shaders Alive 셰이더가 언로드되지 않도록 방지하려면 이 옵션을 활성화합니다.
Preloaded Assets 시동 시 플레이어가 로드할 에셋의 배열을 설정합니다.
새 에셋을 추가하려면 Size 프로퍼티의 값을 늘린 다음 새로 표시되는 Element 상자에 로드할 에셋에 대한 레퍼런스를 설정합니다.
Strip Engine Code (IL2CPP만 해당) Unity Linker 툴이 프로젝트에서 사용하지 않는 Unity 엔진 기능의 코드를 제거할지 여부를 지정합니다.
Managed Stripping Level Unity가 미사용 관리 (C#) 코드를 얼마나 적극적으로 스트리핑할지 지정합니다.
Unity가 게임이나 애플리케이션을 빌드하는 동안 Unity Linker 프로세스는 프로젝트에서 사용되는 동적으로 연결된 관리 라이브러리에서 사용되지 않는 코드를 스트리핑할 수 있습니다. 코드 스트리핑을 통해 생성된 실행 파일의 크기를 대폭 줄일 수 있지만, 간혹 실수로 사용되는 코드를 제거하게 될 수 있습니다. 이 설정을 통해 Unity가 사용하지 않는 코드를 얼마나 적극적으로 제거할지 선택할 수 있습니다.
Disabled (Mono만 해당) 코드를 스트리핑하지 않습니다. IL2CPP 사용 시 관리되는 코드 스트리핑이 항상 활성화됩니다.
Normal 도달할 수 없는 관리되는 코드를 제거하여 빌드 크기를 줄이고 Mono/IL2CPP 빌드 시간을 단축합니다.
Aggressive (실험 기능) Normal 옵션보다 더욱 적극적으로 코드를 제거합니다. 코드 크기가 더욱 감소하나, 이러한 추가 감소로 인해 일부 메서드가 디버거에 표시되지 않으며 반사를 통해 액세스한 코드가 스트리핑되는 등 부작용이 초래될 수 있습니다. 커스텀 link.xml 파일을 만들면 일부 클래스와 메서드를 유지할 수 있습니다. 자세한 내용은 IL2CPP로 관리 바이트코드 스트리핑을 참조하십시오.
내부 프로파일러 활성화(지원 중단 예정) 프로젝트 테스트 시 Android SDK의 adblogcat 출력에서 기기의 프로파일러 데이터를 가져오려면 이 옵션을 활성화합니다. 개발 빌드에서만 사용할 수 있습니다.
Script Call Optimization 원할 경우 런타임 시점에 속도를 높이기 위해 예외 처리를 비활성화하도록 선택할 수 있습니다. 자세한 내용은 iOS 최적화를 참조하십시오.
Slow and Safe 전체 예외 처리를 사용합니다(Mono 스크립팅 백엔드를 사용하면 기기 성능에 영향을 줄 수 있음).
Fast but no Exceptions 기기에서 예외 데이터가 제공되지 않습니다(게임은 Mono 스크립팅 백엔드를 사용하면 더 빠르게 실행됨).
참고: 이 옵션을 IL2CPP 스크립팅 백엔드와 함께 사용하면 성능에는 영향을 주지 않으나, 릴리스 빌드에서 정의되지 않은 동작을 피할 수 있습니다.
Vertex Compression 버텍스 압축을 채널별로 설정합니다. 예를 들어 포지션과 라이트맵 UV를 제외한 모든 것에 압축을 사용하도록 선택할 수 있습니다. 임포트된 오브젝트별로 설정한 전체 메시 압축은 버텍스 압축이 설정된 오브젝트에서 버텍스 압축을 오버라이드하지만, 나머지는 모두 여기서 설정한 버텍스 압축 설정을 따릅니다.
Optimize Mesh Data 적용된 머티리얼에 필요 없는 데이터(예: 탄젠트, 노멀, 컬러, UV)를 메시에서 제거하려면 이 옵션을 활성화합니다.

로깅(Logging)

특정 컨텍스트에서 허용할 로깅 유형을 선택합니다.

Android 플랫폼용 로깅 설정
Android 플랫폼용 로깅 설정

스크립트 실행 시(ScriptOnly) 발생하는 각 로그 유형에 상응하는 상자를 선택하고(Error, Assert, Warning, Log, Exception), 언제나 로깅(Full) 또는 로깅하지 않음(None) 중 하나를 선택합니다.

레거시

SkinnedMeshRenderers의 블렌드 셰이프 가중치 범위를 고정하려면 Clamp BlendShapes (Deprecated) 옵션을 활성화합니다.

Android 플랫폼용 레거시 설정
Android 플랫폼용 레거시 설정

퍼블리싱 설정(Publishing Settings)

이 설정을 사용하여 Android 앱 빌드를 커스터마이즈하십시오.

참고: 보안상의 이유로 Unity는 이 페이지에 비밀번호를 저장하지 않습니다. 서명이 없는 디버그 키스토어는 기본적으로 MacOS의 ~/.android/debug.keystore와 Windows의 %USERPROFILE%\.android\debug.keystore에 있습니다.

키스토어

기존 키스토어를 사용하려면 다음 단계를 따르십시오.

  1. Use Existing Keystore 옵션을 활성화합니다.
  2. Browse Keystore 버튼을 클릭하고 파일 시스템에서 키스토어를 선택합니다.
  3. Keystore password 에 비밀번호를 입력합니다.

또는 다음 단계에 따라 새로 만들 수도 있습니다.

  1. Create a new keystore 옵션을 활성화합니다.
  2. Keystore password 에 비밀번호를 입력합니다.
  3. Confirm password 에 비밀번호를 다시 입력합니다.

Alias 드롭다운 메뉴에서 키를 선택합니다.

선택하고 나면 Password 를 입력할 수 있습니다.

빌드

Custom Gradle Template 을 활성화하면 자체 변경 사항을 다음 위치에 있는 Gradle 빌드 파일에 제공하여 Gradle 빌드 프로세스를 커스터마이즈할 수 있습니다.
Assets/Plugins/Android/mainTemplate.gradle

User Proguard File 을 활성화하면 Proguard 파일을 사용하여 앱의 크기를 줄이고 최적화를 수행할 수 있습니다. 자세한 내용은 Android용 Gradle을 참조하십시오. 이 파일은 다음 위치에 있습니다.
Assets/Plugins/Android/proguard-user.txt

축소

축소에 Proguard, Gradle (Experimental) 을 사용할지, 또는__None__ 을 사용할지 여부를 지정할 수 있습니다. ReleaseDebug 드롭다운 메뉴에서 다음 옵션 중 하나를 선택하십시오.

Split Application Binary 옵션을 활성화하면 출력 패키지를 메인(APK) 및 확장(OBB) 패키지로 분할할 수 있습니다. 이 작업은 100MB가 넘는 애플리케이션을 Google Play 스토어에 퍼블리시할 때 필요합니다.

XR 설정

참고: XR SDK에 대한 빌트인 지원은 지원이 중단될 예정이며 향후 Unity 버전에서 사라집니다. 대신에 Unity XR 플러그인 시스템을 사용하십시오. 자세한 내용은 XR 플러그인 아키텍처를 참조하십시오.

Android 플레이어용 XR 설정
Android 플레이어용 XR 설정
설정 기능
Virtual Reality Supported 애플리케이션이 가상현실 애플리케이션이라면 체크박스를 선택합니다. 그런 다음 필수 VR SDK를 목록에 추가합니다.
Virtual Reality SDKs 가상 현실 SDK를 리스트에 추가하거나 리스트에서 제거할 수 있습니다. 이 리스트는 Virtual Reality Supported 가 활성화된 경우에만 사용 가능합니다.
리스트에 SDK를 추가하려면 더하기(+) 버튼을 클릭합니다.
리스트에서 SDK를 제거하려면 해당 SDK를 선택하고 빼기(-) 버튼을 클릭합니다.
일부 SDK는 여기에 표시되는 추가 설정을 제공합니다. 자세한 내용은 XR SDK를 참조하십시오.
Stereo Rendering Mode 가상 현실 기기의 렌더링 방식을 선택합니다.
Multi Pass 정상 렌더링 모드입니다. Unity는 왼쪽 눈 이미지용으로 1번, 오른쪽 눈 이미지용으로 1번 이렇게 총 2번 씬을 렌더링합니다.
Single Pass Multiview or Instanced (Preview) 양쪽 눈 이미지를 동시에 하나의 패킹된 렌더 텍스처로 렌더링합니다. 즉, 전체 씬이 한 번만 렌더링되므로 CPU 처리 시간이 현저히 단축됩니다.


  • Unity 5.5에서 업데이트된 기능
  • Unity 2017.3에서 Sustained Performance Mode 추가됨
  • 2018.1에서 .NET 4.x 런타임 추가됨
  • Unity 2018.2에서 Android Multiple APK 기능 추가됨
  • 2019.1에서 Android용 OpenGL ES 3.2 지원 추가됨 NewIn20191
  • Unity 2019.1에 입력 시스템 프리뷰 추가됨
  • Unity 2019.1에서 Render outside safe area 추가됨
  • Unity 2019.2에서 앱 번들 크기 옵션에 대한 경고 추가됨
  • Unity 2019.3에서 GPU 스키닝의 이름이 컴퓨트 스키닝으로 변경됨
  • Unity 2019.3에서 Vuforia 제거됨
  • Unity 2019.3에서 빌트인 XR SDK에 대한 지원이 중단됨NewIn20193
Unity 리모트
Android용 앱 빌드