기술 자료

Unity 엔진

Unity 엔진

Android 플레이어 설정

Android 플레이어 설정에 대한 레퍼런스 문서.
읽는 시간 36분최근 업데이트: 9일 전

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

Player Settings for Android

프로퍼티에 대한 기술 자료는 플레이어 UI의 각 섹션에 따라 그룹화되어 있습니다.

아이콘

기기에서 애플리케이션을 나타내는 아이콘을 지정하려면 아이콘 섹션을 사용합니다.

Icon settings for Android.

설정

설명

적응형Android 8.0(API 레벨 26) 이상을 실행하는 기기에서 애플리케이션을 나타내는 다양한 크기의 텍스처를 지정합니다. 자세한 내용은 어댑티브 아이콘에 대한 Android 문서를 참조하십시오.
RoundAndroid 7.1(API 레벨 25) 이상을 실행하는 기기에서 애플리케이션을 나타내는 다양한 크기의 텍스처를 지정합니다.
레거시Android 7.1 이전 버전(API 레벨 25)을 실행하는 기기에서 애플리케이션을 나타내는 다양한 크기의 텍스처를 지정합니다.

Android 배너 활성화

활성화하면 Android TV가 Android 배너를 사용하여 홈 화면 애플리케이션을 나타냅니다. Unity APK 파일 또는 익스포트한 프로젝트 리소스에 배너 텍스처를 포함합니다.
참고
이 프로퍼티는 Other Settings > Android Application Configuration에서 Android TV 호환성을 활성화한 경우에만 표시됩니다.

해상도 및 프레젠테이션

해상도 및 프레젠테이션 섹션에서 다음 설정을 사용하여 화면의 모양을 커스터마이즈하십시오.

해결 방법

해상도 섹션을 사용하여 화면 모드와 기본 크기를 커스터마이즈합니다.
프로퍼티

설명

초점 없이 실행
이 프로퍼티를 활성화하면 분할 화면 모드를 지원하는 기기처럼 애플리케이션이 포커스에 있지 않지만 표시되는 경우에도 계속 실행됩니다. 비활성화하면 애플리케이션이 일시 중지되지만 계속 표시됩니다.
전체 화면 모드
기기에 창이 표시되는 방법을 지정합니다. 시작 시 기본 창 모드를 설정합니다.
  • 전체 화면 창: 애플리케이션 창은 기기의 전체 화면 네이티브 해상도를 채웁니다. 전체 화면 창을 채우기 위해 Unity 애플리케이션 콘텐츠를 스케일합니다. Resolution Scaling Mode는 Unity 콘텐츠를 스케일하는 방식을 제어합니다.
  • Windowed: 애플리케이션은 전체 화면이 아닌 이동 가능한 표준 창을 사용합니다. 창의 크기는 애플리케이션의 해상도에 따라 다릅니다. 이 모드에서는 애플리케이션의 크기를 기본적으로 조절할 수 있습니다. 애플리케이션 크기 조절을 방지하려면 크기 조절 가능 활동을 비활성화합니다.
크기 조절 가능 활동
사용자가 애플리케이션의 크기를 조절할 수 있는지 여부를 나타냅니다.
이 설정은 Android 휴대폰 및 태블릿의 애플리케이션에서 다중 창 기능을 활성화합니다. 자세한 내용은 Google 개발자 기술 자료를 참고하십시오.
기본 창 너비
애플리케이션 창의 기본 너비(픽셀 단위)입니다. 이 옵션은 Fullscreen Mode가 Windowed로 설정된 경우에만 사용할 수 있습니다.
기본 창 높이
애플리케이션 창의 기본 높이(픽셀 단위)입니다. 이 옵션은 Fullscreen Mode가 Windowed로 설정된 경우에만 사용할 수 있습니다.
최소 창 너비
애플리케이션 창의 최소 너비(픽셀 단위)입니다. 이 옵션은 Fullscreen Mode가 Windowed로 설정된 경우에만 사용할 수 있습니다.
최소 창 높이
애플리케이션 창의 최소 높이(픽셀 단위)입니다. 이 옵션은 Fullscreen Mode가 Windowed로 설정된 경우에만 사용할 수 있습니다.
내비게이션 바 숨기기
화면 하단에 표시되는 내비게이션 바를 숨길지 여부를 나타냅니다.
참고: 애플리케이션이 전체 화면 모드로 자동으로 전환되지 않도록 하려면 이 설정을 비활성화합니다.
세이프 영역 외부 렌더링
이 옵션을 활성화하면 애플리케이션이 컷아웃(노치)된 디스플레이 영역을 포함하여 사용 가능한 모든 스크린 공간 렌더링할 수 있습니다. 자세한 내용은 Android의 디스플레이 컷아웃 지원 문서를 참조하십시오. 이 설정의 동작은 다음 표에 설명된 대로 Android 버전에 따라 다릅니다.
  • Android 15 이상: 이 설정은 애플리케이션이 기본적으로 전체 스크린 공간 사용하므로 효과가 없습니다. 자세한 내용은 Android 문서를 참조하십시오.
  • Android 11 to 14: 활성화하면 애플리케이션이 사용 가능한 전체 스크린 공간 사용합니다. 비활성화하면 애플리케이션은 컷아웃 주변 공간을 시스템 바(기기의 상단 또는 하단) 내에 있는 경우에만 사용합니다. 그렇지 않으면 애플리케이션이 컷아웃 영역 위에 검은색 막대를 표시합니다. 애플리케이션이 컷아웃 주변 공간을 사용하는 시점에 대한 자세한 내용은 Android 문서를 참조하십시오.
  • Android 10 이상: 이 옵션을 활성화하면 애플리케이션은 기기의 짧은 가장자리(위 또는 하단 등)에서 컷아웃 주변의 스크린 공간 사용합니다. 하지만 애플리케이션은 기기의 더 긴 가장자리(예: 측면)의 컷아웃을 검은색 막대로 차단합니다. 애플리케이션이 짧은 모서리에서 컷아웃 주변 공간을 사용하는 방법에 대한 자세한 내용은 Android 문서를 참조하십시오. 비활성화하면 애플리케이션은 컷아웃 주변 공간을 시스템 바 내에 있는 경우에만 사용합니다. 그렇지 않으면 애플리케이션이 컷아웃 영역 위에 검은색 막대를 표시합니다. 애플리케이션이 컷아웃 주변 공간을 사용하는 시점에 대한 자세한 내용은 Android 문서를 참조하십시오.
최적화된 프레임 빈도
이 옵션을 활성화하면 Unity 프레임 속도의 변동을 줄이기 위해 프레임을 균등하게 분배하고 더 원활한 경험을 구현할 수 있습니다.

해상도 스케일링

화면 해상도 스케일링과 관련된 설정을 커스터마이즈하려면 해상도 스케일링 섹션을 사용합니다. 기기의 기본 해상도보다 낮은 해상도를 사용하면 성능과 배터리 수명을 향상시킬 수 있습니다.
프로퍼티

설명

해상도 스케일링 모드
애플리케이션이 해상도를 스케일하는지 여부와 방법을 지정합니다. 스케일링을 네이티브 화면 해상도보다 낮게 설정할 수 있습니다. 낮은 해상도를 사용하면 성능과 배터리 수명을 개선할 수 있습니다.
Disabled 해상도 스케일링을 적용하지 않고 애플리케이션이 기기의 네이티브 화면 해상도로 렌더링합니다.
  • FixedDPI: 타겟 DPI를 사용하여 해상도 스케일링을 적용합니다. 성능과 배터리 수명을 최적화하거나 특정 DPI 설정을 타게팅하는 데 사용합니다.
  • Letterboxed: 콘텐츠가 늘어나지 않도록 렌더링된 출력에 검은색 막대를 추가합니다. 이 프로세스를 레터박싱)이라고 합니다.
타겟 DPI
애플리케이션의 해상도입니다. 기기의 네이티브 화면 DPI가 이 값보다 높으면 Unity 이 설정과 일치하도록 애플리케이션의 해상도를 다운스케일합니다. Unity는 다음을 사용하여 스케일을 계산합니다. min(Target DPI * Factor / Screen DPI, 1). 여기서 Factor는 품질 설정의 Resolution Scaling Fixed DPI Factor입니다.
참고: 이 옵션은 Resolution Scaling Mode를 Fixed DPI로 설정한 경우에만 표시됩니다.
창 크기 조절 시 해상도 재설정
네이티브 창 크기가 변경될 때 화면 해상도를 새로운 네이티브 창 크기로 설정할지 여부를 나타냅니다. Resolution Scaling Mode를 Fixed DPI로 설정하면 Unity Fixed DPI 프로퍼티를 기반으로 해상도를 다시 계산합니다.
블릿 타입
blit을 사용하여 최종 이미지를 화면에 렌더링할지 여부를 제어합니다. blit을 사용하는 것은 대부분의 기기와 호환되지만 일반적으로 blit을 사용하지 않는 것보다 느립니다.
  • Always: Unity 오프스크린 버퍼로 렌더링한 다음 blit을 사용하여 버퍼 콘텐츠를 기기의 프레임버퍼로 복사합니다. 이는 대부분의 기기와 호환되지만 일반적으로 blit을 사용하지 않는 것보다 느립니다.
  • Never: Unity 기기의 운영체제에서 제공하는 프레임버퍼로 렌더링합니다. 이 작업이 실패하면 애플리케이션이 기기 로그에 일회성 경고를 출력합니다. 일반적으로 blit을 사용하는 것보다 빠르지만, 일부 기기에서 호환되지 않습니다. 자동 가능하면 Unity 기기의 운영체제에서 제공하는 프레임버퍼로 렌더링합니다. 이 작업이 실패하면 Unity 기기 콘솔에 경고를 출력하고 blit을 사용하여 최종 이미지를 화면에 렌더링합니다.

지원되는 종횡비

지원되는 종횡비 섹션을 사용하여 지원할 기기 종횡비와 관련된 설정을 커스터마이즈합니다.
프로퍼티

설명

종횡비 모드
애플리케이션이 지원하는 가장 큰 종횡비를 지정합니다. 기기의 종횡비가 이 종횡비보다 크면 Unity 애플리케이션에 이 종횡비를 사용하고 애플리케이션이 늘어나지 않도록 검은색 막대를 추가합니다.
  • 레거시 와이드스크린 (1.86): 애플리케이션은 Android 레거시 와이드스크린 종횡비까지의 종횡비를 지원합니다.
  • 네이티브 종횡비: 애플리케이션은 Android 기본 종횡비까지의 종횡비를 지원합니다. Custom 애플리케이션은 Maximum에서 설정한 종횡비까지의 종횡비를 지원합니다.
최소
커스텀 최소 종횡비입니다. 이 값은 Maximum보다 작아야 합니다.
참고: 이 설정은 Aspect Ratio Mode를 Custom으로 설정한 경우에만 표시됩니다.
최대
커스텀 최대 종횡비입니다. 이 값은 Minimum보다 커야 합니다.
참고: 이 설정은 Aspect Ratio Mode를 Custom으로 설정한 경우에만 표시됩니다.

기타

프로퍼티

설명

로딩 인디케이터 표시
로딩 표시가 표시되는지 여부와 방법을 지정합니다.
  • Don't Show: 로딩 표시기가 나타나지 않습니다. Large 큰 로딩 표시기가 나타납니다.
  • Inversed Large: 큰 로딩 표시기가 반전 컬러로 표시됩니다. Small 작은 로딩 표시기가 나타납니다.
  • Inversed Small: 작은 로딩 표시기가 반전된 컬러로 표시됩니다.
표시 옵션
런타임 시 애플리케이션이 Android 기기에서 렌더링되는 방식을 결정하는 Android 디스플레이 설정을 정의합니다.
없음 설정된 모든 디스플레이 설정을 비활성화합니다. 이 옵션을 선택하면 자동 렌더링이 비활성화되고 두 번째 화면에서 수동으로 렌더링을 처리해야 합니다. 예를 들어 Unity as-a-library(UaaL) 기반 애플리케이션을 만듭니다.
  • Detect Presentation Display: 두 번째 화면에서 카메라 출력의 자동 렌더링을 활성화합니다. 자동 렌더링은 Android 시스템이 프레젠테이션 디스플레이로 식별하는 화면과 Unity 에디터에서 타겟 디스플레이가
    2
    로 설정된 경우에만 지원됩니다. Unity 플레이어 애플리케이션이 백그라운드에서 실행 중인 경우에도 전체 화면으로 카메라 출력을 렌더링합니다. 이 옵션은 기본적으로 선택되어 있습니다.

orientation:

프로퍼티

설명

디폴트 방향
기기 화면 내에서 애플리케이션 창의 방향을 지정합니다.
참고: Unity Android, iOS, UWP 간에 이 설정에 대해 설정한 값을 공유합니다.
  • Portrait 애플리케이션 하단이 화면 하단과 정렬되는 세로 방향입니다.
  • 세로 거꾸로 아래로: 애플리케이션 하단이 화면 상단과 정렬되는 세로 방향입니다.
  • 가로 오른쪽: 애플리케이션의 오른쪽이 화면 상단과 정렬되는 가로 방향입니다.
  • 랜드스케이프 왼쪽: 애플리케이션의 왼쪽이 화면 상단과 정렬되는 가로 방향입니다.
자동 회전 동작
Default Orientation이 Auto Rotation으로 설정된 경우 애플리케이션 창이 기기의 회전 센서 및 방향 설정을 기반으로 방향을 조정하는 방식을 지정합니다.
참고: 이 프로퍼티는 Default Orientation을 Auto Rotation으로 설정한 경우에만 표시됩니다. 기본적으로 이 프로퍼티는 User로 설정됩니다.
User 애플리케이션 창은 기기의 방향 설정에 따라 방향을 조정합니다. 사용자가 기기의 자동 회전 방향 설정을 잠그면 애플리케이션 창이 Allowed Orientations for Auto Rotation 섹션에 설정된 환경 설정을 따르지 않습니다. 사용자가 기기의 자동 회전 방향 설정을 끄면 애플리케이션 창이 설정된 환경 설정에 따라만 회전합니다.
  • Sensor: 애플리케이션 창은 기기의 방향 설정과 관계없이 기기의 회전 센서에 따라 방향을 조정합니다. 하지만 애플리케이션 창은 Allowed Orientations for Auto Rotation 섹션에 설정된 환경 설정에 따라만 회전합니다.

자동 회전 허용 방향

Default Orientation을 Auto Rotation으로 설정할 때 애플리케이션이 지원하는 방향을 지정하려면 Allowed Orientations for Auto Rotation 섹션을 사용합니다. 예를 들어 애플리케이션을 가로 방향으로 고정할 때 유용하지만 사용자가 가로 왼쪽과 가로 오른쪽 사이를 변경할 수 있습니다.
참고
이 섹션은 Orientation 섹션의 Default Orientation을 Auto Rotation으로 설정한 경우에만 표시됩니다.
프로퍼티

설명

Portrait
애플리케이션 하단이 화면 하단과 일치하는 세로 방향을 허용합니다.
세로 거꾸로
애플리케이션 하단과 화면 상단이 정렬된 세로 방향을 허용합니다.
가로 오른쪽
애플리케이션의 오른쪽이 화면 상단에 정렬된 가로 방향을 허용합니다.
가로 왼쪽
애플리케이션의 왼쪽이 화면 상단에 정렬된 가로 방향을 허용합니다.

추가 해상도 및 프레젠테이션 설정

프로퍼티

설명

32비트 디스플레이 버퍼 사용
디스플레이 버퍼가 16비트 컬러 값 대신 32비트 컬러 값을 포함하는지 여부를 나타냅니다. 밴딩이 표시되거나 포스트 프로세싱 효과에서 알파 값이 필요한 경우 이 설정을 활성화합니다. 일부 포스트 프로세싱 효과는 디스플레이 버퍼와 동일한 포맷의 렌더 텍스처를 생성하기 때문에 이를 필요로 합니다.
뎁스 및 Stencil 비활성화
뎁스 및 스텐실 버퍼를 비활성화합니다.
네이티브 UI로 렌더링
애플리케이션이 네이티브 UI 위에 렌더링되도록 합니다. 이 설정을 적용하려면 카메라의 Clear Flags가 알파 값이 1보다 작은 단색을 사용하도록 설정합니다.

스플래시 이미지(Splash Image)

가상 현실 스플래시 이미지 설정을 사용하여 가상 현실 디스플레이에 대한 커스텀 스플래시 이미지를 선택합니다. 일반적인 스플래시 화면 설정에 대한 자세한 내용은 스플래시 화면을 참조하십시오.

Splash screen settings for virtual reality

일반적인 스플래시 화면 설정 아래에서 Android 전용 정적 스플래시 이미지를 설정할 수 있습니다.

Splash screen settings for Android

프로퍼티

설명

이미지
애플리케이션이 Android 스플래시 화면에 사용하는 텍스처를 지정합니다. 스플래시 화면 이미지의 표준 크기는 320x480입니다.
스케일링
기기의 화면에 맞게 스플래시 이미지를 스케일하는 방법을 지정합니다.
  • 중앙(축소 전용): 이미지가 너무 크지 않으면 네이티브 크기로 이미지를 그립니다. 이 경우 Unity 이미지의 크기를 적절하게 축소합니다.
  • Scale to Fit(문자 상자): 이미지를 확대/축소하여 더 긴 크기가 화면 크기에 정확하게 맞도록 만듭니다. Unity 측면 주변의 빈 공간을 검정색으로 짧은 차원으로 채웁니다.
  • Scale to Fill(컷): 더 짧은 크기가 화면 크기에 정확히 맞도록 이미지를 스케일합니다. Unity 이미지를 더 긴 차원으로 자릅니다.

기타 설정

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

렌더링

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

설명

색 공간
렌더링에 사용할 색 공간 선택합니다. 자세한 내용은 색 공간을 참조하십시오.
  • Gamma: 감마 색 공간 일반적으로 프레임버퍼 포맷에 대해 채널당 8비트로 제한된 구형 하드웨어의 조명을 계산하는 데 사용됩니다. 오늘날 모니터는 디지털이지만 여전히 감마로 인코딩된 신호를 입력으로 받습니다.
  • Linear: 선형 색 공간 렌더링은 더 정확한 결과를 제공합니다. 선형 색 공간에서 작업하도록 선택하면 에디터는 sRGB 샘플링을 사용하도록 기본 설정합니다. 선형 색 공간에 있는 텍스처의 경우 선형 색 공간에서 작업하고 각 텍스처에 대해 sRGB 샘플링을 비활성화해야 합니다.
자동 그래픽스 API
그래픽스 API를 수동으로 선택하고 순서를 변경하려면 이 옵션을 비활성화합니다. 기본적으로 이 옵션은 활성화되어 있으며, Unity Vulkan을 사용하려고 시도합니다. 기기가 Vulkan을 지원하지 않으면 Unity GLES3.2, GLES3.1 또는 GLES3.0으로 폴백합니다.
중요
Unity **Auto 그래픽스 API 활성화하거나 Graphics API에 OpenGLES3가 포함된 경우에만 Android 앱 매니페스트에 GLES3.1/GLES3.1+AEP/GLES3.2 요구 사항을 추가합니다.
그래픽스 API
애플리케이션이 지원하는 그래픽스 API를 지정합니다. Unity는 목록 상단에 있는 그래픽스 API를 먼저 사용하려고 합니다. 기기가 지원하지 않으면 목록의 다음 그래픽스 API로 다시 폴백합니다.
  • Vulkan: 타게팅할 API Vulkan을 추가합니다.
  • OpenGLES3: 타게팅할 API OpenGLES 3을 추가합니다.
참고
이 프로퍼티는 Auto 그래픽스 API false로 설정된 경우에만 표시됩니다.
ES3.1 필요
최소 OpenGL ES 3 부 버전이 3.1인지 여부를 지정합니다.
이 프로퍼티는 Auto 그래픽스 API를 활성화하거나 Graphics API에 OpenGLES3이 포함된 경우에만 표시됩니다.
Require ES3.1+AEP
최소 OpenGL ES 3 부 버전이 3.1+AEP인지 여부를 나타냅니다.
이 프로퍼티는 Auto 그래픽스 API를 활성화하거나 Graphics API에 OpenGLES3이 포함된 경우에만 표시됩니다.
ES3.2 필요
최소 OpenGL ES 3 부 버전이 3.2인지 여부를 지정합니다.
이 프로퍼티는 Auto 그래픽스 API를 활성화하거나 Graphics API에 OpenGLES3이 포함된 경우에만 표시됩니다.
컬러 감마
렌더링에 사용할 컬러 영역을 추가하거나 제거할 수 있습니다. 더하기(+) 아이콘을 클릭 수 사용 가능한 영역 리스트가 표시됩니다. 색 영역은 특정 기기(예: 모니터 또는 스크린)에서 사용할 수 있는 다양한 컬러를 정의합니다. sRGB 영역은 기본 및 필수 영역입니다.
멀티스레드 렌더링
그래픽스 API 호출을 Unity 메인 스레드 별도의 워커 스레드로 이동하려면 이 옵션을 활성화합니다. 이는 메인 스레드 CPU 사용량이 높은 애플리케이션의 성능을 개선하는 데 도움이 될 수 있습니다.
정적 배칭
정적 배칭을 사용하려면 이 옵션을 활성화합니다.
동적 배칭
빌드에서 동적 배칭을 사용합니다(기본적으로 활성화됨).
참고: 스크립터블 렌더 파이프라인이 활성화된 경우 동적 배칭에는 영향이 없습니다. 따라서 이 설정은 스크립터블 렌더 파이프라인 에셋 그래픽스 설정이 비어 있는 경우에만 표시됩니다.
스프라이트 배칭 임계값
배칭 시 사용되는 최대 버텍스 임계값을 제어합니다.
GPU 스키닝
셰이더를 통해 GPU의 메시 스키닝과 블렌드 셰이프를 계산하여 CPU 리소스를 확보하고 성능을 향상합니다.
  • CPU: 메시 스키닝과 CPU의 블렌드 셰이프 계산을 수행하려면 이 옵션을 선택합니다.
  • GPU: GPU에서 메시 스키닝과 블렌드 셰이프 계산을 수행하려면 이 옵션을 선택합니다.
  • GPU(배칭): 배칭 및 순서 변경을 사용하여 GPU에서 메시 스키닝과 블렌드 셰이프 계산을 수행하려면 이 옵션을 선택합니다. 배칭은 GPU에 대한 디스패치 호출 횟수를 줄이고 성능을 향상시킬 수 있습니다.
그래픽스 잡(실험 단계)
그래픽스 작업(루프 렌더링)을 다른 CPU 코어에서 실행되는 워커 스레드에 오프로드하도록 Unity 지시하려면 이 옵션을 활성화합니다. 이는 종종 병목 현상인 메인 스레드의
Camera.Render
에 소요되는 시간을 줄이기 위한 것입니다.
참고
이 기능은 실험 단계입니다. 프로젝트의 성능이 개선되지 않을 수 있으며, 새로운 크래시가 발생할 수 있습니다.
그래픽스 잡 모드
애플리케이션에 사용할 그래픽스 작업 모드를 지정합니다. Unity의 잡에 대한 자세한 내용은 잡 시스템 개요를 참조하십시오.
참고: 이 옵션은 Graphics Jobs가 활성화되고 Graphics APIs가 Vulkan으로 설정된 경우에만 사용할 수 있습니다.
  • *메인 스레드 워커 스레드용 Unity 그래픽스 커맨드를 작성합니다. 워커 스레드는 렌더 스레드가 소비하는 작업 실행자에 커맨드를 작성합니다.
  • 메인 스레드 워커 스레드용 Unity 그래픽스 커맨드를 작성합니다. 워커 스레드는 렌더 스레드에 커맨드를 직접 작성합니다. 렌더 스레드는 Unity 그래픽스 커맨드를 읽고 네이티브 그래픽스 커맨드로 전환합니다.
  • 메인 스레드 워커 스레드용 Unity 그래픽스 커맨드를 작성합니다. 렌더 스레드는 Unity 그래픽스 커맨드를 읽고 네이티브 그래픽스 커맨드로 전환합니다. 그런 다음 렌더 스레드는 워커 스레드를 시작하여 네이티브 그래픽스 커맨드를 작성합니다.
참고: 이 옵션은 Graphics Jobs가 활성화되고 Graphics APIs가 Vulkan으로 설정된 경우에만 사용할 수 있습니다.
텍스처 압축 포맷
ASTC, ETC2 및 ETC(RGB 경우 ETC1, RGBA 경우 ETC2), DXTC, DXT + RGTC(BC4, BC5) 중에서 선택할 수 있습니다. 올바른 형식을 선택하는 방법에 대한 자세한 내용은 텍스처 압축 포맷 개요를 참조하십시오. 텍스처 압축 타게팅 지원을 위해 이 리스트에 여러 텍스처 압축 포맷을 추가할 수 있지만, 이 리스트에 DXT와 DXT + RGTC(BC4, BC5)를 모두 포함할 수는 없습니다. 텍스처 압축 타게팅을 활성화하는 경우 Unity 애플리케이션 바이너리 분할도 활성화합니다.
빌드 설정의 텍스처 압축 설정과 상호작용하는 방법에 대한 자세한 내용은 텍스처 압축 설정을 참조하십시오.
참고: 애플리케이션을 APK로 익스포트하거나 빌드하는 경우 Unity는 이 리스트의 첫 번째 텍스처 압축 포맷만 사용합니다.
노멀 맵 인코딩**
노멀 맵 인코딩을 설정하려면 XYZ 또는 DXT5nm-style을 선택합니다. 이 설정은 노멀 맵에 사용되는 인코딩 체계와 압축 포맷에 영향을 줍니다. DXT5nm-style 노멀 맵은 품질이 더 높지만 셰이더에서 디코딩하는 데 리소스가 더 많이 사용됩니다.
라이트맵 인코딩
라이트맵의 인코딩 방식과 압축 포맷을 정의합니다.
Low Quality, Normal Quality 또는 High Quality 중에서 선택할 수 있습니다.
HDR 큐브맵 인코딩
HDR 큐브맵의 인코딩 방식 및 압축 포맷을 정의합니다.
Low Quality, Normal Quality, High Quality 중에서 선택할 수 있습니다. 자세한 내용은 라이트맵: 기술 정보.
라이트맵 스트리밍
이 옵션을 활성화하면 라이트맵에 Mipmap Streaming을 사용합니다. Unity 이를 생성할 때 모든 라이트맵에 이 설정을 적용합니다.
참고: 이 설정을 사용하려면 텍스처 맵 스트리밍 품질 설정을 활성화해야 합니다.
스트리밍 우선 순위
모든 라이트맵에 대한 우선 순위를 설정하십시오. Mipmap Streaming 시스템. Unity 이를 생성할 때 모든 라이트맵에 이 설정을 적용합니다.
양수는 우선순위가 더 높습니다. 유효한 값의 범위는
-128
에서
127
입니다.
프레임 타이밍 통계
FrameTimingManager API를 사용하여 CPU 및 GPU 프레임 타이밍 데이터를 수집하려면 이 프로퍼티를 활성화합니다. 이 프로퍼티를 비활성화하면 다이내믹 해상도 카메라 설정이 이 데이터를 사용하여 GPU 워크로드를 줄이기 위해 해상도를 동적으로 조정할 수 없습니다.
OpenGL: 프로파일러 GPU 레코더
OpenGL로 렌더링할 때 프로파일러 레코더를 활성화할지 여부를 나타냅니다. 이 옵션은 다른 렌더링 API에 대해 항상 활성화되지만, 프레임 타이밍 통계 및 GPU 프로파일러와의 호환성 문제로 DUE OpenGL에서는 선택 사항입니다.
HDR 디스플레이 출력 허용
애플리케이션이 실행될 때 HDR 모드 출력을 활성화합니다. 이 기능을 지원하는 디스플레이에서만 작동합니다. 디스플레이가 HDR 모드를 지원하지 않으면 게임이 표준 모드로 실행됩니다.
HDR 디스플레이 출력 사용
메인 디스플레이가 HDR 지원하는지 확인하고, 지원하는 경우 애플리케이션이 실행될 때 HDR 출력으로 전환합니다.
참고
이 옵션은 Allow HDR Display Output이 활성화된 경우에만 사용할 수 있습니다.
가상 텍스처링(실험 단계)
가상 텍스처링을 활성화할지 여부를 나타냅니다.
참고
가상 텍스처링은 Android 호환되지 않습니다.
360개 스테레오 캡처
Unity 양안 360도 이미지 및 비디오를 캡처할 수 있는지 여부를 지정합니다.
참고
360 양안 캡처는 Android 호환되지 않습니다.
로드/저장 작업 디버그 모드
모바일 플랫폼에서 렌더링 문제를 일으킬 수 있는 정의되지 않은 픽셀을 강조 표시합니다. 이는 Unity 에디터 게임 뷰와 Build Profiles 창의 Platform Settings 섹션에서 Development Build를 선택하는 경우 빌드된 애플리케이션에 영향을 줍니다. 자세한 내용은 LoadStoreActionDebugModeSettings를 참조하십시오.
에디터 전용
Load/Store Action 디버그 모드 Unity 에디터 실행되는지 여부를 나타냅니다.
참고
이 프로퍼티는 Load/Store Action 디버그 모드 true로 설정된 경우에만 표시됩니다.

Vulkan 설정

프로퍼티

설명

SRGB Write Mode
이 옵션을 활성화하면
Graphics.SetSRGBWrite()
렌더러가 런타임 동안 sRGB 쓰기 모드를 토글할 수 있습니다. 즉, 선형-sRGB 쓰기 컬러 변환을 일시적으로 비활성화하려는 경우 이 프로퍼티를 사용하여 이를 구현할 수 있습니다. 활성화하면 모바일 타일 기반 GPU의 성능에 부정적인 영향을 미치므로 모바일에서는 활성화하지 마십시오.
Swapchain 버퍼 수
이 옵션을 이중 버퍼링의 경우 2로 설정하고, Vulkan 렌더러와 함께 사용하는 삼중 버퍼링의 경우 3로 설정합니다. 이 설정은 일부 플랫폼에서 지연에 도움이 될 수 있지만, 대부분의 경우 기본값인 3에서 변경하면 안 됩니다. 이중 버퍼링은 성능에 부정적인 영향을 미칠 수 있습니다. Android 이 설정을 사용하지 않습니다.
Swapchain Image Get as late as possible
활성화하면 Vulkan이 프레임을 오프스크린 이미지로 렌더링할 때까지 백버퍼를 획득하는 작업을 지연시킵니다. 이를 위해 Vulkan은 스테이징 이미지를 사용합니다. 이 설정을 활성화하면 백버퍼를 표시할 때 추가 blit이 발생합니다. 이 설정은 이중 버퍼링과 함께 성능을 개선할 수 있습니다. 하지만 추가 blit이 대역폭을 차지하기 때문에 성능 문제가 발생할 수도 있습니다.
재사용 커맨드 버퍼
Unity가 실행한 후 커맨드 버퍼를 재활용할지 여부를 나타냅니다.
렌더링 동안 디스플레이 회전 적용
디스플레이의 네이티브 방향으로 모든 렌더링을 수행하려면 이 옵션을 활성화합니다. 이는 여러 기기에서 성능상의 이점을 제공합니다. 자세한 내용은 프레임버퍼 방향 문서를 참조하십시오.
Android Vulkan 거부 필터 목록
Unity 애플리케이션을 실행할 때 Vulkan API 사용하지 않아야 하는 Android 기기를 식별하는 기준을 지정합니다.
다음 파라미터 세트를 사용하여 거부 기준을 정의합니다. 모든 파라미터는 선택 사항입니다. Vulkan API 버전과 드라이버 버전 파라미터를 제외하고 일반 표현식을 사용하여 파라미터를 설정할 수 있습니다. Unity 에디터 잘못된 정규 표현식에 대한 오류가 표시됩니다.
자세한 내용은 Vulkan API 사용 허용 또는 거부 문서를 참조하십시오.
참고
플레이어 설정에 OpenGLES3와 같은 대체 그래픽스 API 포함하지 않으면 거부 기준을 충족하는 기기에서는 애플리케이션이 실행되지 않습니다.
  • 공급업체: Android 기기에서 사용되는 GPU 하드웨어의 공급업체 이름입니다. 예를 들어, Qualcomm, ARM. device.name Android 기기에서 사용되는 GPU 모델의 이름입니다. Adreno(TM) 740을 예로 들 수 있습니다.
  • Brand: Android 디바이스의 제조업체 이름입니다. 예를 들면 Google, Samsung
  • 제품 이름: Android 디바이스의 제품 코드명입니다. 예를 들면 Barbet, Mermaid입니다
  • Android OS 버전: 기기가 실행되는 Android 운영 체제 버전입니다. 예제는 아래와 같습니다.
  • Vulkan API 버전: Android 기기에서 사용할 수 있는 최소 필요한 Vulkan API 버전입니다. 다음 포맷 중 하나로 버전 번호를 입력합니다.
    • MinorVersion과 PatchVersion이 선택 사항인
      MajorVersion.MinorVersion.PatchVersion
      예:
      1.1.128
    • 최대 8자리
      0x
      로 시작하는 16진수 포맷 예:
      0x00401080
    참고
    이 파라미터에는 정규 표현식이 허용되지 않습니다.
  • 드라이버 버전: 필요한 최소 Vulkan 디바이스 드라이버 버전입니다. 다음 포맷 중 하나로 버전 번호를 입력합니다.
    • MinorVersion
      및
      PatchVersion
      가 선택 사항인
      MajorVersion.MinorVersion.PatchVersion
      예:
      0.676.0
    • 최대 8자리
      0x
      로 시작하는 16진수 포맷 예:
      0x002a4000
    참고
    이 파라미터에는 정규 표현식이 허용되지 않습니다.
Android Vulkan 허용 필터 목록
Unity 애플리케이션을 실행할 때 언제든지 Vulkan 그래픽스 API 사용해야 하는 Android 기기를 식별하기 위한 기준을 지정합니다.
기기가 거부 및 허용 필터 리스트에 모두 포함된 경우 Allow Filter가 우선권을 갖고 기기가 Vulkan API 사용합니다. 이러한 리스트를 사용하여 성능이 저하된 대규모 기기 카테고리를 Vulkan API 사용으로 제한할 수 있지만, Vulkan API 사용하여 성능이 더 나은 카테고리 내 기기를 허용할 수 있습니다. 거부 리스트와 허용 필터 리스트 모두에 동일한 값이 포함된 경우 Unity 리스트에 지정된 기준을 무시합니다.
자세한 내용은 Vulkan API 사용 허용 또는 거부 문서를 참조하십시오.
참고
기준을 정의하는 데 사용되는 파라미터에 대한 설명은 Android Vulkan 거부 필터 목록을 참조하십시오.

식별

Identification settings for the Android platform

프로퍼티

설명

오버라이드 기본 패키지 이름
애플리케이션의 기본 패키지 이름을 오버라이드할지 여부를 나타냅니다. 이 프로퍼티를 활성화하면 다음 프로퍼티도 활성화됩니다.
  • 패키지 이름: 기기와 Google Play 스토어에서 앱을 고유하게 식별하는 애플리케이션 ID를 설정합니다. 신청서 ID는 규약
    com.YourCompanyName.YourProductName
    에 따라야 하며 영숫자와 밑줄 문자만 포함해야 합니다. 각 세그먼트는 알파벳 문자로 시작해야 합니다. 자세한 내용은 애플리케이션 ID 설정을 참조하십시오.
    중요: Unity 입력한 잘못된 문자를 자동으로 제거합니다.
참고: 이 설정은 macOS, iOS, tvOS 및 Android 영향을 줍니다.
version
번들의 반복 작업(릴리스 또는 릴리스되지 않음)을 식별하는 번들의 빌드 버전 번호를 입력합니다. 버전은 점으로 구분된 숫자가 포함된 문자열의 공통 포맷으로 지정됩니다(예: 4.3.2). (iOS와 Android 간에 공유됨)
번들 버전 코드
내부 버전 번호입니다. 이 숫자는 한 버전이 다른 버전보다 최신 버전인지 여부를 결정하는 데만 사용되며 숫자가 클수록 최신 버전을 나타냅니다. 사용자에게 표시되는 버전 번호는 아닙니다. 해당 번호는
versionName
속성으로 설정됩니다. 값은 "100"과 같이 정수로 설정해야 합니다. 연속된 각 버전의 수가 더 많으면 원하는 대로 정의할 수 있습니다.
예를 들어 빌드 번호일 수 있습니다 또는 "x.y" 포맷의 버전 번호를 "x"와 "y"를 16비트 하위 및 상위로 별도로 인코딩하여 정수로 변환할 수도 있습니다. 또는 새 버전이 릴리스될 때마다 숫자를 하나씩 늘릴 수도 있습니다.
Split APKs by target architecture가 활성화된 경우 이 숫자를 100000 미만으로 유지합니다. 각 APK에는 고유한 버전 코드가 있어야 Unity ARMv7에 100000, ARM64에 200000을 추가합니다.
최소 API 레벨
애플리케이션을 실행하는 데 필요한 최소 Android 버전(API 레벨)입니다.
타겟 API 레벨
애플리케이션을 컴파일할 대상 Android 버전(API 레벨)입니다.

설정

프로퍼티

설명

스크립팅 백엔드:
사용할 스크립팅 백엔드를 선택합니다. 스크립팅 백엔드는 Unity 프로젝트에서 C# 코드를 컴파일하고 실행하는 방식을 결정합니다.
  • Mono: C# 코드를 .NET 공용 중간 언어(CIL)로 컴파일하고 공용 언어 런타임을 사용하여 해당 CIL을 실행합니다. 자세한 내용은 Mono 를 참조하십시오.
  • IL2CPP

    ?

    : C# 코드를 CIL로 컴파일하고 CIL을 C++로 전환한 다음 해당 C++를 런타임 시 직접 실행되는 네이티브 기계어 코드 컴파일합니다. 자세한 내용은 IL2CPP를 참조하십시오.
API 호환성 수준
프로젝트에 사용할 .NET API를 선택합니다. 이 설정은 타사 라이브러리와의 호환성에 영향을 미칠 수 있습니다. 하지만 에디터 전용 코드(에디터 디렉토리 또는 에디터 전용 어셈블리 정의 내 코드)에는 영향을 미치지 않습니다.
팁 타사 어셈블리에 문제가 있는 경우 API 호환성 수준 섹션에서 제안을 시도해 보십시오.
  • .Net Framework: .NET Framework 4와 호환됩니다(.NET Standard 2.0 프로파일의 모든 사항과 추가 API 포함). .NET Standard 2.0에 포함되지 않은 API에 액세스하는 라이브러리를 사용하는 경우 이 옵션을 선택합니다. 대형 빌드를 생성하며 사용 가능한 추가 API는 반드시 모든 플랫폼에서 지원되지 않습니다. 자세한 내용은 추가 클래스 라이브러리 어셈블리 참조를 참조하십시오.
  • .Net Standard 2.1: 소형 빌드를 생성하고 크로스 플랫폼 완벽하게 지원합니다.
에디터 어셈블리 호환성 레벨
에디터 어셈블리에 사용할 .NET API를 선택합니다.
  • .NET 프레임워크: .NET Framework 4와 호환됩니다(.NET Standard 2.1 프로파일의 모든 사항과 추가 API 포함). .NET Standard 2.1에 포함되지 않은 API에 액세스하는 라이브러리를 사용하는 경우 이 옵션을 선택합니다. 대형 빌드를 생성하며 사용 가능한 추가 API는 반드시 모든 플랫폼에서 지원되지 않습니다. 자세한 내용은 추가 클래스 라이브러리 어셈블리 참조를 참조하십시오.
  • .NET Standard: .NET Standard 2.1 와 호환됩니다. 소형 빌드를 생성하고 크로스 플랫폼 완벽하게 지원합니다.
IL2CPP 코드 생성
Unity IL2CPP 코드 생성을 관리하는 방법을 정의합니다.
참고: 이를 사용하려면 스크립팅 백엔드를 IL2CPP로 설정합니다.
C++ 컴파일러 설정
IL2CPP 생성 코드를 컴파일할 때 사용할 C++ 컴파일러 설정을 선택합니다.
  • --debug 디버그 구성은 모든 최적화를 해제하여 코드를 더 빠르게 빌드할 수 있지만 실행 속도가 느려집니다.
  • ** !release 릴리스 구성을 사용하면 컴파일된 코드가 더 빠르게 실행되고 바이너리 크기가 줄어들지만 컴파일 시간이 더 오래 걸립니다.
  • master 마스터 구성을 사용하면 가능한 모든 최적화를 수행하여 성능을 최대한 높일 수 있습니다. 예를 들어 MSVC++ 컴파일러를 사용하는 플랫폼에서 이 옵션은 링크 타임 코드 생성을 활성화합니다. 이 구성을 사용하여 코드를 컴파일하는 데는 릴리스 구성을 사용하는 것보다 훨씬 오래 걸릴 수 있습니다. 빌드 시간이 늘어날 수 있는 경우 마스터 구성을 사용하여 게임의 출시 버전을 빌드하는 것이 좋습니다.
IL2CPP 스택트레이스 정보
스택 추적에 포함할 정보를 선택합니다. 정보 유형에 대한 자세한 내용은 IL2CPP를 사용한 관리 스택 추적을 참조하십시오.
  • 메서드 이름: 스택 추적에 각 관리되는 메서드를 포함합니다.
  • 메서드 이름, 파일 이름 및 줄 번호: 스택 추적에 각 관리되는 메서드와 파일 및 줄 번호 정보를 포함시킵니다.
    참고: 이 옵션을 사용하면 빌드된 프로그램의 빌드 시간과 최종 크기를 모두 늘릴 수 있습니다.
증분 GC 사용
점진적 가비지 컬렉터 사용합니다. 점진적 가비지 컬렉터는 가비지 컬렉션 여러 프레임에 분산하여 프레임 기간의 가비지 컬렉션 관련 스파이크를 줄입니다. 자세한 내용은 자동 메모리 관리를 참조하십시오.
HTTP를 통한 다운로드 허용
HTTP를 통해 콘텐츠를 다운로드할지 여부를 지정합니다. 기본 옵션은 권장되는 프로토콜이 더 안전한 HTTPS이므로 허용되지 않음입니다.
  • 허용 안 함: HTTP를 통한 다운로드를 허용하지 않습니다.
  • 개발용 빌드에서 허용됨: 개발 빌드에서 HTTP를 통한 다운로드만 허용합니다.
  • 항상 허용됨: 개발 및 릴리스 빌드에서 HTTP를 통한 다운로드를 허용합니다.
기타 오디오 소스 음소거
백그라운드에서 실행 중인 애플리케이션의 오디오가 Unity 애플리케이션에서 중지되는지 여부를 나타냅니다. 그렇지 않으면 백그라운드 애플리케이션의 오디오가 Unity 애플리케이션과 함께 계속 재생됩니다.

Android 애플리케이션 구성

프로퍼티

설명

타겟 아키텍처
타게팅할 아키텍처를 지정합니다.
  • ARMv7: ARMv7 아키텍처에 대한 지원을 활성화합니다.
  • ARM64: ARM64 아키텍처에 대한 지원을 활성화합니다.
    참고: 이 프로퍼티는 스크립팅 백엔드를 IL2CPP로 설정한 경우에만 활성화됩니다.
  • x86–64(Magic Leap 2): x86–64 아키텍처에 대한 지원을 활성화합니다.
    참고: 이 프로퍼티는 스크립팅 백엔드를 IL2CPP로 설정한 경우에만 활성화됩니다.
  • Arm64용 Armv9 보안 기능 활성화: ARM64 빌드에 대해 Pointer Authentication(PAuth, PAC) 및 Branch Target Identification(BTI)을 활성화합니다.
    참고: 이 프로퍼티는 ARM64를 타겟 아키텍처로 설정한 경우에만 활성화됩니다.
타겟 아키텍처로 APK 분할
Target Architectures에서 선택된 각 CPU 아키텍처에 대해 별도의 APK를 생성하려면 이 옵션을 활성화합니다. 이렇게 하면 Google Play 스토어 사용자의 다운로드 크기가 작아집니다. 이는 주로 Google Play 스토어 기능이며 다른 스토어에서 작동하지 않을 수 있습니다. 자세한 내용은 다중 APK 지원을 참조하십시오.
설치 위치
기기에서 애플리케이션 설치 위치를 지정합니다. 자세한 내용은 [Android 개발자 설치 위치 문서](http://developer. android.com/guide/appendix/install-location.html)를 참조하십시오.
자동 운영체제가 결정하도록 합니다. 사용자는 앱을 앞뒤로 이동할 수 있습니다.
  • Prefer External: 가능하면 외부 스토리지(SD 카드)에 애플리케이션을 설치합니다. 운영체제는 이를 보장하지 않으며, 가능하지 않으면 앱이 내부 메모리에 설치됩니다.
  • Force Internal: 애플리케이션을 강제로 내부 메모리에 설치합니다. 사용자가 앱을 외부 스토리지로 이동할 수 없습니다.
인터넷 액세스
네트워킹 API를 사용하지 않더라도 항상 네트워킹(
INTERNET
) 권한을 Android 앱 매니페스트에 추가할지 여부를 선택합니다. 개발 빌드의 경우 기본적으로 Require로 설정합니다.
자동 네트워킹 API 사용하는 경우에만 인터넷 액세스 권한을 추가합니다.
  • 필요: 항상 인터넷 액세스 권한을 추가합니다.
쓰기 권한
외부 저장소(예: SD 카드)에 대한 쓰기 액세스를 활성화할지 여부를 선택하고 해당 권한을 Android 앱 매니페스트에 추가합니다. 개발 빌드의 경우 External(SDCard)로 기본 설정합니다.
  • Internal: 내부 스토리지에 대한 쓰기 권한만 부여합니다.
  • External(SDCard): 외부 스토리지에 대한 쓰기 권한을 활성화합니다.
숨을 받으면 필터 터치
다른 가시 창이 Unity 애플리케이션을 덮을 때 수신된 터치를 폐기하려면 이 옵션을 활성화합니다. 탭재킹을 방지하는 데 사용됩니다.
지원 성능 모드
이 옵션을 활성화하면 열 스로틀링 없이 장기간 동안 예측 가능한 일관된 기기 성능 수준을 설정할 수 있습니다. 이 설정을 활성화하면 전반적인 성능이 저하될 수 있습니다. [Android 지속 성능 API](https://developer.android.com/about/versions/nougat/android-7.0.html#sustained_performance_api)를 기반으로 합니다.
최대 Java 힙 크기
빌드할 최대 Java 힙 크기를 사용자로 설정합니다(메가바이트 단위). 기본값은 20입니다.
낮은 정확도 위치
낮은 정확도 값을 Android 위치 API와 함께 사용하려면 이 옵션을 활성화합니다.
예측 백 제스처 지원
Android 13 이상에서 백 이벤트를 처리하기 위해 Android의 OnBackInvokedCallback을 사용하려면 이 옵션을 활성화합니다.
앱 카테고리
빌드할 애플리케이션 타입을 지정합니다. androidIsGame이 false로 설정된 기존 Unity 프로젝트의 경우 이 프로퍼티는 기본적으로 비활성화됩니다. 활성화되면 드롭다운에서 애플리케이션의 기본 기능에 가장 적합한 카테고리를 선택합니다. 사용 가능한 카테고리에 대한 자세한 내용은 Android 문서를 참조하십시오.
참고 사항
  • 필수 카테고리가 드롭다운 목록에 없는 경우 Other를 선택하여 카테고리 이름을 수동으로 입력합니다. 입력한 이름은 Android에서 정의한 유효한 appCategory여야 합니다. 잘못된 이름을 입력하면 프로젝트 빌드가 실패합니다.
  • 새로운 Unity 프로젝트의 경우 이 프로퍼티가 활성화되고 기본적으로 Game으로 설정됩니다. 애플리케이션을 게임으로 분류하면 애플리케이션이 Android 16 동작 변경 사항으로부터 제외됩니다. 자세한 내용은 대형 화면 기기용 Android 16 동작 변경 문서를 참조하십시오.
  • 프로젝트가 Adaptive Performance 패키지 또는 GameMode API를 사용하는 경우 App Category를 Game으로 선택해야 합니다.
  • 프로퍼티를 활성화하고 카테고리를 선택하지 않으면 프로젝트 빌드가 실패합니다.
카테고리 이름
Android에서 정의한 appCategory 옵션 중 하나와 일치하는 유효한 애플리케이션 카테고리 이름을 입력합니다. Android 정의되지 않은 커스텀 카테고리 이름은 지원되지 않습니다.
참고
이 프로퍼티는 App Category를 Other로 설정한 경우에만 표시됩니다.
Android TV 호환성
애플리케이션을 Android TV 호환으로 표시하려면 이 옵션을 활성화합니다.
Android 게임패드 지원 수준
애플리케이션이 게임패드에 제공하는 지원 수준을 선택합니다.
참고
이 프로퍼티는 Android TV 호환성이 true로 설정된 경우에만 표시됩니다.
  • D-패드로 작동: 애플리케이션은 D패드를 사용하여 완벽하게 작동할 수 있습니다. 게임패드가 필요하지 않습니다.
  • 게임패드 지원: 애플리케이션은 게임패드로 작동하지만 필요하지는 않습니다.
  • 필요 게임패드: 애플리케이션을 사용하려면 게임패드가 필요합니다.
앱 번들 크기에 대한 경고
Android 앱 번들의 크기가 특정 임계값을 초과할 때 경고를 수신하려면 이 옵션을 활성화합니다. 이 옵션은 기본적으로 선택되며 Build Type을 Release로 선택하고 빌드 설정에서 Build App Bundle (Google Play) 옵션을 활성화한 경우에만 구성할 수 있습니다.
  • 앱 번들 크기 임계값: 크기를 MB 단위로 입력합니다. 앱 번들이 이 크기를 초과하면 Unity는 경고를 표시하고 Google Play 최대 크기 제한에 따라 생성된 릴리스 앱 번들에 대한 전체 크기 확인을 수행할 것을 권장합니다.
심볼 크기에 대한 경고
Android 앱 번들 내에 포함된 기호 또는 기호의 크기가 특정 임계값을 초과할 때 경고를 수신하려면 이 옵션을 활성화합니다. 이 옵션은 기본적으로 선택되며, 빌드 설정에서 Debug Symbols to Public/Debugging을 설정한 경우에만 구성할 수 있습니다.
  • 심볼 크기 임계값: 크기를 MB 단위로 입력합니다. 심볼 패키지가 이 크기를 초과하면 Unity 경고가 표시됩니다.
애플리케이션 엔트리 포인트
애플리케이션에 대해 생성할 애플리케이션 엔트리 포인트입니다. 자세한 내용은 Android 애플리케이션 엔트리 포인트를 참조하십시오.
활성 입력 처리
사용자의 입력을 처리하는 방식을 선택합니다.
  • 입력 관리자(이전): 원래의 입력 설정을 사용합니다.
Both 두 시스템 모두 사용합니다. 이 옵션은 Android 지원되지 않습니다.

API 호환성 수준

모든 타겟에 대한 Mono API 호환성 레벨을 선택할 수 있습니다. 타사 .NET 라이브러리가 .NET 호환성 레벨을 벗어난 기능을 사용하는 경우도 있습니다. 이러한 경우 발생하는 상황과 문제를 해결하는 방법을 이해하려면 다음 제안을 따르십시오.
  1. Windows용 ILSpy 설치.
  2. 문제가 있는 API 호환성 수준의 .NET 어셈블리를 ILSpy로 드래그합니다.
    Frameworks/Mono/lib/mono/YOURSUBSET/
    아래에서 찾을 수 있습니다.
  3. 타사 어셈블리를 드래그합니다.
  4. 타사 어셈블리를 오른쪽 클릭하고 분석을 선택합니다.
  5. 분석 보고서에서 종속성 섹션을 확인합니다. 리포트에는 타사 어셈블리가 의존하지만 선택한 .NET 호환성 레벨에서 사용할 수 없는 항목이 빨간색으로 강조 표시됩니다.

셰이더 설정

프로퍼티

설명

셰이더 정밀도 모델
사용하는 기본 정밀도 셰이더를 선택합니다. 자세한 내용은 셰이더에서 16비트 정밀도 사용을 참고하십시오.
  • 플랫폼 기본값: 모바일 플랫폼에서는 더 낮은 정밀도를 사용하고, 다른 플랫폼에서는 최대 정밀도를 사용합니다.
  • 통합: 플랫폼에서 지원하는 경우 더 낮은 정밀도를 사용합니다.
Strict 셰이더 배리언트 일치
셰이더 배리언트가 플레이어 빌드에 누락된 경우 오류 셰이더 렌더링에 사용하고 콘솔에 오류를 표시하려면 이 옵션을 활성화합니다. 오류는 셰이더 배리언트 검색에 사용되는 셰이더, 서브셰이더 인덱스, 패스 및 키워드를 지정합니다.
로드된 셰이더 활성 상태 유지
로드된 모든 셰이더를 활성 상태로 유지하고 언로드를 방지합니다.

셰이더 배리언트 로딩 설정

이 설정을 사용하여 런타임 시 셰이더가 사용하는 메모리 양을 제어합니다.

프로퍼티

설명

기본 청크 크기(MB)모든 플랫폼에서 Unity 빌드된 애플리케이션에 저장하는 압축된 셰이더 배리언트 데이터 청크의 최대 크기를 설정합니다. 기본값은
16
입니다. 자세한 내용은 셰이더 로딩을 참고하십시오.
기본 청크 수Unity 모든 플랫폼에서 메모리에 보관하는 압축 해제된 청크의 기본 제한을 설정합니다. 기본값은
0
이므로 제한이 없습니다.
오버라이드이 빌드 타겟에 대해 기본 청크 크기 및 기본 청크 수를 오버라이드할 수 있습니다.
Chunk size(MB)이 빌드 타겟의 기본 청크 크기(MB) 값을 오버라이드합니다.
Chunk count이 빌드 타겟의 기본 청크 수 값을 오버라이드합니다.

스크립트 컴파일

Script compilation settings for the Android platform

프로퍼티

설명

스크립팅 정의 기호커스텀 컴파일 플래그를 설정합니다.

자세한 내용은 플랫폼별 컴파일을 참조하십시오.
추가 컴파일러 인자Roslyn C# 컴파일러에 전달할 추가 인자를 지정합니다. 리스트 엔트리당 하나의 유효한 컴파일러 인자를 입력합니다. 새 항목을 만들려면 **추가(+)**를 선택합니다. 항목을 제거하려면 **제거(-)**를 선택합니다. 새로 추가된 인자를 향후 컴파일에 포함하려면 적용을 선택합니다. 목록을 가장 최근에 적용된 상태로 초기화하려면 Revert를 선택합니다. 인수는
csc.exe
구문(예:
-warnaserror
)을 사용해야 합니다. 지원되는 Roslyn 컴파일러 옵션의 전체 목록은 Microsoft 문서의 C# 컴파일러 옵션을 참조하십시오.

또한 프로젝트의
Assets
폴더에 있는
csc.rsp
리스폰스 파일을 사용하여 C# 컴파일러에 추가 커맨드 라인 인자를 제공할 수도 있습니다. 응답 파일 생성에 대한 자세한 내용은 응답 파일 생성을 참조하십시오. 참고: 추가 컴파일러 인자 리스트와 응답 파일 모두에서 동일한 인자를 정의하면 오류와 의도치 않은 동작이 발생할 수 있습니다.
일반적인 경고 해제C# 경고 CS0169 및 CS0649를 표시할지 여부를 나타냅니다.
'안전하지 않은' 코드 허용사전 정의된 어셈블리(예:
Assembly-CSharp.dll
)에서 '안전하지 않은' C# 코드 컴파일에 대한 지원을 활성화합니다.
어셈블리 정의 파일(
.asmdef
)의 경우,
.asmdef
파일 중 하나를 클릭하고 인스펙터 창에 있는 옵션을 활성화합니다.
결정적 컴파일 사용
-deterministic
C# 플래그로 컴파일을 방지할지 여부를 나타냅니다. 이 설정을 활성화하면 컴파일된 어셈블리는 컴파일될 때마다 바이트당 동일합니다.

자세한 내용은 코드 생성을 제어하는 C# 컴파일러 옵션을 참조하십시오.

최적화

프로퍼티

설명

충돌 메시 사전 베이크
빌드 시 충돌 데이터를 메시에 추가합니다.
사전 로드된 에셋
시작 시 플레이어가 로드할 에셋 배열을 설정합니다.
새 에셋을 추가하려면 Size 프로퍼티의 값을 늘린 후 나타나는 새 Element 상자에 로드할 에셋에 대한 레퍼런스를 설정합니다.
엔진 코드 스트립
프로젝트가 사용하지 않는 Unity 엔진 기능에 대한 코드를 Unity Linker 툴에서 제거하려면 이 옵션을 활성화합니다. 이 설정은 IL2CPP 스크립팅 백엔드에서만 사용할 수 있습니다. 대부분의 앱 사용 가능한 모든 DLL을 사용하지 않습니다. 이 옵션은 앱이 빌드된 플레이어의 크기를 줄이기 위해 사용하지 않는 DLL을 제외합니다. 앱에서 현재 설정에서 일반적으로 스트리핑되는 클래스를 하나 이상 사용 중인 경우 앱을 빌드하려고 할 때 Unity 디버그 메시지를 표시합니다.
관리되는 스트리핑 레벨
Unity 사용되지 않는 관리되는(C#) 코드를 얼마나 적극적으로 스트리핑할지 선택합니다. Unity 앱을 빌드할 때 Unity Linker 프로세스는 프로젝트에서 사용하는 관리되는 DLL에서 사용되지 않는 코드를 스트리핑할 수 있습니다. 코드를 스트리핑하면 결과 실행 파일이 작아질 수 있지만, 사용 중인 코드를 제거할 수도 있습니다.
이러한 옵션과 IL2CPP로 바이트코드 스트리핑에 대한 자세한 내용은 ManagedStrippingLevel을 참조하십시오.
  • 최소 클래스 라이브러리, UnityEngine, Windows 런타임 어셈블리를 스트리핑하고 다른 모든 어셈블리를 복사할 때 사용합니다.
  • 낮음 도달할 수 없는 관리되는 코드를 제거하여 빌드 크기와 Mono/IL2CPP 빌드 시간을 단축합니다.
  • 중급 UnityLinker를 실행하여 Low를 초과하여 코드 크기를 줄입니다. 커스텀 link.xml 파일을 지원해야 할 수 있으며 일부 반사 코드 경로는 동일하게 동작하지 않을 수 있습니다.
  • High UnityLinker는 최대한 많은 코드를 스트리핑합니다. 이렇게 하면 Medium이 달성할 수 있는 것 이상으로 코드 크기를 줄일 수 있지만 일부 메서드의 관리되는 코드 디버깅은 더 이상 작동하지 않을 수 있습니다. 커스텀 link.xml 파일을 지원해야 할 수 있으며 일부 반사 코드 경로는 동일하게 동작하지 않을 수 있습니다.
내부 프로파일러 활성화(사용 중단 예정)
이 기능은 지원이 중단되어 향후 Unity 버전에서 지원이 중단될 예정입니다. 대신 프로파일러 창을 사용합니다(메뉴: Window > Analytics > Profiler).
프로파일러가 애플리케이션 퍼포먼스 데이터 수집하고 콘솔에 보고서를 출력합니다. 이 보고서에는 각 Unity 하위 시스템이 각 프레임에서 실행하는 데 걸리는 밀리초 수가 포함되어 있으며, 평균 30프레임에 걸쳐 표시됩니다.
버텍스 압축
채널당 버텍스 압축을 설정합니다. 이는 프로젝트의 모든 메시에 영향을 줍니다.
일반적으로 버텍스 압축은 메모리의 메시 데이터 크기를 줄이고 파일 크기를 줄이고 GPU 성능을 개선하는 데 사용됩니다.
버텍스 압축을 구성하는 방법과 이 설정의 제한 사항에 대한 자세한 내용은 메시 데이터 압축을 참조하십시오.
메시 데이터 최적화
빌드에 사용된 메시에서 미사용 버텍스 속성을 스트리핑하려면 이 옵션을 활성화합니다. 메시의 데이터 양을 줄여 빌드 크기, 로딩 시간, 런타임 메모리 사용량을 줄일 수 있습니다.
경고: 이 설정을 활성화한 경우 런타임 시 머티리얼 또는 셰이더 설정을 변경하지 마십시오.
자세한 내용은 PlayerSettings.stripUnusedMeshComponents를 참조하십시오.
텍스처 밉맵 스트리핑
모든 플랫폼에 대해 밉맵 스트리핑을 활성화합니다. 이는 빌드 시 텍스처에서 미사용 밉맵 레벨을 스트리핑합니다.
Unity는 현재 플랫폼에 대한 품질 설정과 비교하여 사용되지 않는 칠맵 레벨을 결정합니다. 현재 플랫폼의 모든 품질 설정에서 밉맵 레벨이 제외된 경우 Unity 빌드 시 빌드 시 해당 밉맵 레벨을 빌드에서 스트리핑합니다.
QualitySettings.globalTextureMipmapLimit
값이 스트리핑되었을 때는 Unity가 스트리핑되지 않은 값을 스트리핑되지 않은 가장 가까운 값으로 설정합니다.

Stack Trace

필요한 로깅 타입에 따라 각 로그 타입에 해당하는 옵션(Error, Assert, Warning, Log, Exception)을 활성화하여 원하는 스택 추적 방법을 선택합니다. 자세한 내용은 스택 추적 로깅을 참조하십시오.

프로퍼티

설명

없음어떤 로그도 기록되지 않습니다.
ScriptOnly스크립트를 실행할 때만 로그합니다.
full항상 로깅합니다.
자세한 내용은 스택 추적 로깅을 참조하십시오.

레거시

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

퍼블리싱 설정(Publishing Settings)

다음의 퍼블리싱 설정을 사용하여 Unity Android 애플리케이션을 빌드하는 방식을 설정합니다.

Android publishing panel

참고
보안상의 이유로 Unity 키스토어 또는 프로젝트 키 비밀번호를 저장하지 않습니다.
키스토어 관리자 창을 사용하여 키와 키스토어를 만들고, 설정하고, 로드합니다. 키스토어 관리자 또는 메인 Android 퍼블리싱 패널에서 기존 키스토어와 키를 로드할 수 있습니다. 키스토어 관리자 내부에서 이를 로드하는 경우 Unity 프로젝트 키스토어 및 프로젝트 키 필드를 자동으로 채웁니다. 자세한 내용은 키스토어 관리자 기술 자료를 참조하십시오.

프로젝트 키스토어

키스토어는 애플리케이션 보안을 위해 서명 키를 보관하는 컨테이너입니다. 자세한 내용은 Android 개발자 문서를 참조하십시오. Android 키스토어 시스템.
열린 프로젝트에 사용할 키스토어를 선택하려면 프로젝트 키스토어 설정을 사용합니다. 키스토어를 로드하면 Unity 해당 키스토어의 모든 키를 로드합니다. 열린 프로젝트에서 기존 키스토어를 로드하고 사용하는 방법은 다음과 같습니다.
  1. Custom Keystore를 활성화합니다.
  2. 선택 드롭다운을 열고 검색을 선택하고 파일 시스템에서 키스토어를 선택합니다.
  3. 키스토어 비밀번호를 입력합니다.
기존 키스토어가 없으면 Custom Keystore를 비활성화 상태로 둡니다.
Unity 디버그 키스토어를 사용하여 애플리케이션에 서명합니다. 디버그 키스토어는 작동하는 키스토어입니다. 이를 통해 애플리케이션에 서명하고 로컬에서 테스트할 수 있습니다. 하지만 앱 스토어 이러한 방식으로 로그인한 앱 거부합니다. 이는 앱 스토어 디버그 키스토어를 사용하여 애플리케이션의 유효성과 소유권을 확인할 수 없기 때문입니다.
키스토어를 로드하면 Unity 해당 키스토어의 모든 키를 로드합니다. 열려 있는 프로젝트의 활성 키로 사용할 키 저장소에서 키 하나를 선택하려면 키 별칭 드롭다운을 사용합니다.

프로퍼티

설명

커스텀 키스토어기존 키스토어를 로드하고 사용하려면 Custom Keystore를 활성화합니다.
**을 선택합니다.커스텀 키스토어가 활성화되면 사용하려는 키스토어를 선택합니다. 선택 드롭다운의 파티션 아래에 있는 키스토어는 미리 지정된 전용 위치에 저장됩니다. 자세한 내용은 키스토어 위치 선택을 참조하십시오.
키스토어 경로키스토어 경로를 입력할 필요는 없습니다. Unity 선택한 키스토어에 따라 이를 제공합니다.
키스토어 비밀번호선택한 키스토어를 로드하려면 키스토어 비밀번호를 입력합니다.
키 별칭열린 프로젝트에 사용할 키를 선택합니다.
키 비밀번호키 비밀번호를 입력합니다.

빌드

기본적으로 Unity Unity 설치와 함께 제공된 매니페스트 파일, Gradle 템플릿, ProGuard 파일을 사용하여 애플리케이션을 빌드합니다. Android 퍼블리싱 설정의 빌드 섹션을 사용하여 변경합니다.
커스텀 매니페스트 파일, Gradle 템플릿 또는 ProGuard 파일을 사용하려면 다음 단계를 따르십시오.
  1. 적절한 체크박스를 활성화합니다. Unity 프로젝트에 기본 파일을 생성하고 파일 위치가 체크박스 아래에 표시됩니다.
  2. 새 파일을 열고 변경 사항을 적용합니다.
  3. 변경 사항을 이 파일에 저장합니다. Unity 다음에 애플리케이션을 빌드할 때 이 파일에 저장된 변경 사항을 자동으로 사용합니다.
Build 섹션의 설정은 현재 프로젝트의 빌드 프로세스에만 적용됩니다.

프로퍼티

설명

커스텀 메인 매니페스트Android
LibraryManifest.xml
파일의 커스터마이즈 가능 버전입니다. 이 파일에는 Android 애플리케이션에 대한 중요한 메타데이터가 포함되어 있습니다. 메인/Unity 라이브러리 매니페스트의 책임에 대한 자세한 내용은 Unity 라이브러리 매니페스트를 참조하십시오.
커스텀 런처 매니페스트Android
LauncherManifest.xml
파일의 커스터마이즈 가능 버전입니다. 이 파일에는 Android 애플리케이션의 런처에 대한 중요한 메타데이터가 포함되어 있습니다. Unity 런처 매니페스트의 책임에 대한 자세한 내용은 Unity 런처 매니페스트를 참조하십시오.
커스텀 메인 Gradle 템플릿사용자 정의 가능한 버전의
mainTemplate.gradle
파일. 이 파일에는 Android 애플리케이션을 라이브러리로 빌드하는 방법에 대한 정보가 포함되어 있습니다. 자세한 내용은 Gradle 프로젝트 파일에 대한 기술 자료를 참고하십시오.
커스텀 런처 Gradle 템플릿사용자 정의 가능한 버전의
launcherTemplate.gradle
파일. 이 파일에는 Android 애플리케이션을 빌드하는 방법에 대한 지침이 포함되어 있습니다. 자세한 내용은 Gradle 프로젝트 파일에 대한 기술 자료를 참고하십시오.
커스텀 기본 Gradle 템플릿사용자 정의 가능한 버전의
baseProjectTemplate.gradle
파일. 이 파일에는 다른 모든 템플릿과 Gradle 프로젝트 간에 공유되는 구성이 포함되어 있습니다. 자세한 내용은 Gradle 프로젝트 파일에 대한 기술 자료를 참고하십시오.
커스텀 Gradle 속성 템플릿사용자 정의 가능한 버전의
gradle.properties
파일. 이 파일에는 Gradle 빌드 환경에 대한 구성 설정이 포함되어 있습니다. 지원되는 정보는 다음과 같습니다.
  • JVM(Java Virtual Machine) 메모리 설정입니다.
  • Gradle 여러 JVM을 사용하여 빌드할 수 있도록 하는 프로퍼티입니다.
  • 축소를 수행할 툴을 선택하기 위한 프로퍼티입니다.
  • 앱 번들을 빌드할 때 네이티브 라이브러리를 압축하지 않는 프로퍼티입니다.
커스텀 Gradle 설정 템플릿사용자 정의 가능한 버전의
settingsTemplate.gradle
파일. 이 파일에는 애플리케이션에 필요한 외부 종속성을 해결하기 위한 아티팩트 저장소 선언이 포함되어 있습니다.
커스텀 ProGuard 파일사용자 정의 가능한 버전의
proguard.txt
파일. 이 파일에는 축소 프로세스의 구성 설정이 포함되어 있습니다. 축소하면 유지해야 하는 일부 Java 코드가 제거되면 해당 코드를 이 파일에 유지할 규칙을 추가합니다. 자세한 내용은 축소 기술 자료를 참고하십시오.

축소

축소는 애플리케이션의 코드를 축소, 난독화, 최적화하는 프로세스입니다. 코드 크기를 줄이고 코드를 분할하기 어려울 수 있습니다. 하지만 축소는 실제로 필요한 코드를 제거할 수 있으므로 이 프로세스를 올바르게 구성해야 합니다. Unity ProGuard를 축소에 사용합니다. Minify 설정을 사용하여 Unity가 빌드에 축소를 적용할 시기와 방법을 정의합니다. Proguard에 대한 자세한 내용은 Proguard 매뉴얼을 참조하십시오.
대부분의 경우 디버그 빌드가 아닌 릴리스 빌드에 축소만 적용하는 것이 좋습니다. 축소하는 데 시간이 걸리고 빌드 속도가 느려질 수 있기 때문입니다. 코드의 최적화로 DUE 디버깅이 더 복잡해질 수도 있습니다.
참고
Java 코드가 리플렉션을 통해 참조되는 경우 축소 프로세스는 코드가 사용 중임을 추론하고 해당 코드를 스트리핑할 수 없습니다. 커스텀 ProGuard 파일을 사용하여 필요한 코드를 유지할 수 있습니다.
Minify 섹션의 설정은 현재 프로젝트의 빌드 프로세스에만 적용됩니다.

프로퍼티

설명

릴리스Unity 릴리스 빌드에서 애플리케이션의 코드를 축소하도록 지시합니다.
디버그Unity 디버그 빌드에서 애플리케이션 코드를 축소하도록 지시합니다.

애플리케이션 바이너리 분할

출력 애플리케이션의 초기 설치 크기를 최적화하려면 애플리케이션 바이너리 분할 옵션을 활성화합니다. 100MB보다 큰 애플리케이션을 퍼블리시하려면 Google Play 스토어에서 이 옵션이 필요합니다.
활성화하면 Unity 포맷에 따라 출력 애플리케이션을 다르게 최적화합니다.
  • APK*:

    ?

    : Unity 출력 애플리케이션을 메인 APK와 확장 파일(OBB)로 분할
  • AAB: Unity가 기본 모듈과 에셋 팩을 포함하는 단일 AAB 파일을 생성합니다.
자세한 내용은 자산 분할 소개를 참고하십시오.

App Bundle의 종속성 리포트

google play Android 앱 번들(AAB)로 애플리케이션을 빌드하려는 경우 앱 번들에 종속성에 대한 정보를 포함하려면 이 옵션을 활성화합니다. 자세한 내용은 보고서 앱 종속성 섹션을 참조하십시오.
참고
Android 빌드 설정에서 Build App Bundle (Google Play) 옵션을 활성화한 경우에만 이 설정과 상호작용할 수 있습니다.