# Android 플레이어 설정 > Reference documentation for Android Player settings. 이 페이지에서는 Android 플랫폼용 플레이어 설정에 대해 자세히 설명합니다. 일반적인 플레이어 설정에 대한 자세한 내용은 [플레이어 설정](/engine/6000.0/manual/unity-editor/editor-features/comp-manager-group/class-player-settings.md)을 참조하십시오. **Android용 플레이어 설정:** ![](/api/media?file=/engine/6000.0/media/images/class-PlayerSettingsAndroid.png) 프로퍼티 문서는 플레이어 UI 섹션에 나열된 순서대로 그룹화되었습니다. * [아이콘](#Icon) * [해상도 및 프레젠테이션](#Resolution) * [스플래시 이미지](#Splash) * [기타 설정](#Other) * [퍼블리싱 설정](#Publishing) ## 아이콘##icon **Icon** 섹션을 통해 기기에서 애플리케이션을 나타내는 아이콘을 지정합니다. **Android용 아이콘 설정:** ![](/api/media?file=/engine/6000.0/media/images/PlayerSetAndroidIcon.png) | **설정** | **설명** | | ------------ | -------------------------------------------------------------------------- | | **Adaptive** | Android 8.0(API 레벨 26) 이상 버전이 탑재된 기기에서 애플리케이션을 나타내기 위해 다양한 크기의 텍스처를 지정합니다. | | **Round** | Android 7.1(API 레벨 25) 이상을 실행하는 기기에서 애플리케이션을 나타내기 위해 다양한 크기의 텍스처를 지정합니다. | | **Legacy** | Android 7.1(API 레벨 25) 이전 버전이 탑재된 기기에서 애플리케이션을 나타내기 위해 다양한 크기의 텍스처를 지정합니다. | ## 해상도 및 프레젠테이션##resolution-and-presentation **Resolution and Presentation** 섹션의 다음 설정을 사용하여 화면이 어떻게 표시되는지를 커스터마이즈할 수 있습니다. * [Resolution](#Resolution) * [Resolution Scaling](#Scaling) * [Supported Aspect Ratio](#Aspect) * [Orientation](#Orientation) * [Allowed Orientations for Auto Rotation](#supportedOris) * [Miscellaneous](#OtherRes) ### Resolution##enable-android-banner **Resolution** 섹션에서는 스크린 모드와 기본 크기를 커스터마이즈할 수 있습니다. | **설정** | **설명** | | | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Run Without Focus** | 이 프로퍼티를 활성화하면 분할 화면 모드를 지원하는 기기처럼 애플리케이션에 포커스가 있지 않지만 표시되는 경우에도 계속 실행됩니다. 비활성화하면 애플리케이션이 일시 중지되지만 계속 표시됩니다. | | | **Fullscreen Mode** | 기기에 창이 표시되는 방식을 지정합니다. 시작 시 기본 창 모드를 설정합니다. | | | | **Fullscreen Window** | 애플리케이션 창이 기기의 전체 화면 기본 해상도로 채워집니다. 전체 화면 창을 채우기 위해 Unity는 애플리케이션 콘텐츠의 크기를 조절합니다. **Resolution Scaling Mode**는 Unity가 콘텐츠의 크기를 조절하는 방식을 제어합니다. 이 모드에서는 내비게이션 바가 항상 숨겨져 있습니다. | | | **Windowed** | 애플리케이션이 전체 화면이 아닌 이동 가능한 표준 창을 사용합니다. 창의 크기는 애플리케이션의 해상도에 따라 다릅니다. 이 모드에서는 기본적으로 애플리케이션의 크기를 조절할 수 있습니다. 애플리케이션 크기 조절을 방지하려면 [Resizeable Activity](#resizeable)를 비활성화합니다. | | **Resizeable Activity** | 사용자가 애플리케이션의 크기를 조절할 수 있는지를 나타냅니다.이 설정은 Android 스마트폰 및 태블릿에서 애플리케이션의 다중 창 기능을 활성화합니다. 자세한 내용은 [Google 개발자 기술 자료](https://developer.android.com/guide/topics/ui/multi-window)를 참조하십시오. | | | **Default Window Width** | 애플리케이션 창의 기본 너비(픽셀 단위)입니다. 이 옵션은 **Fullscreen Mode**가 **Windowed**로 설정된 경우에만 사용할 수 있습니다. | | | **Default Window Height** | 애플리케이션 창의 기본 높이(픽셀 단위)입니다. 이 옵션은 **Fullscreen Mode**가 **Windowed**로 설정된 경우에만 사용할 수 있습니다. | | | **Minimum Window Width** | 애플리케이션 창의 최소 너비(픽셀 단위)입니다. 이 옵션은 **Fullscreen Mode**가 **Windowed**로 설정된 경우에만 사용할 수 있습니다. | | | **Minimum Window Height** | 애플리케이션 창의 최소 높이(픽셀 단위)입니다. 이 옵션은 **Fullscreen Mode**가 **Windowed**로 설정된 경우에만 사용할 수 있습니다. | | | **Hide Navigation Bar** | 창 상단에 표시되는 내비게이션 바를 숨길지 여부를 나타냅니다. | | | **Render outside safe area** | 이 옵션을 활성화하면 컷아웃된(노치된) 디스플레이 영역을 포함하여 애플리케이션이 사용 가능한 모든 스크린 공간을 렌더링에 사용할 수 있습니다. 자세한 내용은 Android의 [디스플레이 컷아웃 지원](https://developer.android.com/guide/topics/display-cutout) 기술 자료를 참조하십시오. 다음 표와 같이 이 설정의 동작은 Android 버전에 따라 다릅니다. | | | | **Android 15 and newer** | 이 설정은 애플리케이션이 기본적으로 전체 스크린 공간을 사용하면 효과가 없습니다. 자세한 내용은 [Android 기술 자료](https://developer.android.com/reference/android/view/WindowManager.LayoutParams?_gl=1*1x8u5ar*_up*MQ..*_ga*MjQ0MTQ3Nzk4LjE3MjE5OTAzMDE.*_ga_6HH9YJMN9M*MTcyMTk5MDMwMC4xLjAuMTcyMTk5MDMwMC4wLjAuMA..#LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS)를 참조하십시오. | | | **Android 11 to 14** | 애플리케이션이 사용 가능한 전체 스크린 공간을 사용합니다. 비활성화하면 애플리케이션은 컷아웃 주변 공간을 시스템 바(기기의 상단 또는 하단) 내에 있는 경우에만 사용합니다. 그렇지 않으면 애플리케이션이 컷아웃 영역 위에 검은색 바를 표시합니다. 애플리케이션이 컷아웃 주변 공간을 사용하는 시점에 대한 자세한 내용은 [Android 기술 자료](https://developer.android.com/reference/android/view/WindowManager.LayoutParams?_gl=1*1x8u5ar*_up*MQ..*_ga*MjQ0MTQ3Nzk4LjE3MjE5OTAzMDE.*_ga_6HH9YJMN9M*MTcyMTk5MDMwMC4xLjAuMTcyMTk5MDMwMC4wLjAuMA..#LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT)를 참조하십시오. | | | **Android 10 and older** | 이 옵션을 활성화하면 애플리케이션은 기기의 짧은 가장자리(위 또는 하단 등)에 있는 컷아웃 주변의 스크린 공간을 사용합니다. 하지만 애플리케이션은 기기의 긴 가장자리(측면 등)에 있는 컷아웃을 검은색 바로 가립니다. 애플리케이션이 짧은 가장자리의 컷아웃 주변 공간을 사용하는 방법에 대한 자세한 내용은 [Android 기술 자료](https://developer.android.com/reference/android/view/WindowManager.LayoutParams?_gl=1*1x8u5ar*_up*MQ..*_ga*MjQ0MTQ3Nzk4LjE3MjE5OTAzMDE.*_ga_6HH9YJMN9M*MTcyMTk5MDMwMC4xLjAuMTcyMTk5MDMwMC4wLjAuMA..#LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES)를 참조하십시오. 비활성화하면 애플리케이션은 컷아웃 주변 공간을 시스템 바 내에 있는 경우에만 사용합니다. 그렇지 않으면 애플리케이션이 컷아웃 영역 위에 검은색 막대를 표시합니다. 애플리케이션이 컷아웃 주변 공간을 사용하는 시점에 대한 자세한 내용은 [Android 기술 자료](https://developer.android.com/reference/android/view/WindowManager.LayoutParams?_gl=1*1x8u5ar*_up*MQ..*_ga*MjQ0MTQ3Nzk4LjE3MjE5OTAzMDE.*_ga_6HH9YJMN9M*MTcyMTk5MDMwMC4xLjAuMTcyMTk5MDMwMC4wLjAuMA..#LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT)를 참조하십시오. | | **Optimized Frame Pacing** | 이 옵션을 활성화하면 Unity가 프레임 속도의 편차를 줄이기 위해 프레임을 균등하게 분배하도록 하여 더 원활한 경험을 구현할 수 있습니다. | | ### Resolution Scaling##resolution 화면 해상도 스케일링과 관련된 설정을 커스터마이즈하려면 **Resolution Scaling** 섹션을 사용합니다. 기기의 기본 해상도보다 낮은 해상도를 사용하면 성능과 배터리 수명을 향상시킬 수 있습니다. | **설정** | **설명** | | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | **Resolution Scaling Mode** | 애플리케이션이 해상도를 스케일하는지 여부와 방식을 지정합니다. 기본 화면 해상도 이하가 되도록 스케일링을 설정할 수 있습니다. 낮은 해상도를 사용하면 성능과 배터리 수명을 향상할 수 있습니다. | | | | **Disabled** | 해상도 스케일링을 적용하지 않고 애플리케이션이 기기의 네이티브 화면 해상도로 렌더링됩니다. | | | **FixedDPI** | 타겟 DPI를 사용하여 해상도 스케일링을 적용합니다. 성능과 배터리 수명을 최적화하거나 특정 DPI 설정을 타게팅하는 데 사용합니다. | | | **Letterboxed** | 콘텐츠가 늘어나지 않도록 렌더링된 출력에 검은색 바를 추가합니다. 이 프로세스를 [레터박싱](https://en.wikipedia.org/wiki/Letterboxing_\(filming\))이라고 합니다. | | **Target DPI** | 애플리케이션의 해상도입니다. 기기의 기본 화면 DPI가 이 값보다 높으면 Unity는 이 설정과 일치하도록 애플리케이션의 해상도를 다운스케일합니다. Unity는 \*\*min(Target DPI \* Factor / Screen DPI, 1)\*\*을 사용하여 스케일을 계산합니다. 여기서 **Factor**는 [품질 설정](/engine/6000.0/manual/unity-editor/editor-features/comp-manager-group/class-quality-settings.md)의 **Resolution Scaling Fixed DPI Factor**입니다.**참고:** 이 옵션은 **Resolution Scaling Mode**가 **Fixed DPI**로 설정된 경우에만 표시됩니다. | | | **Reset resolution on window resize** | 기본 창 크기가 변경될 때 화면 해상도를 새로운 기본 창 크기로 설정할지 여부를 나타냅니다. **Resolution Scaling Mode**를 **Fixed DPI**로 설정하면 Unity는 **Fixed DPI** 프로퍼티에 따라 해상도를 다시 계산합니다. | | | **Blit Type** | blit을 사용해 최종 이미지를 화면에 렌더링할지 여부를 제어합니다. blit을 사용하면 대부분의 기기와 호환되지만 일반적으로 blit을 사용하지 않을 때보다 느립니다. | | | | **Always** | Unity는 오프스크린 버퍼로 렌더링한 후 blit을 사용하여 버퍼의 콘텐츠를 기기의 프레임버퍼에 복사합니다. 이렇게 하면 대부분의 기기와 호환되지만 일반적으로 blit을 사용하지 않을 때보다 느립니다. | | | **Never** | Unity가 기기의 운영 체제에서 제공하는 프레임버퍼로 렌더링합니다. 이 작업이 실패하면 애플리케이션이 기기 로그에 일회성 경고를 출력합니다. 일반적으로 blit을 사용하는 것보다 빠르지만, 일부 기기에서는 호환되지 않습니다. | | | **Auto** | 가능하면 Unity가 기기의 운영 체제에서 제공하는 프레임버퍼로 렌더링합니다. 이 작업이 실패하면 Unity는 기기 콘솔에 경고를 출력하고 blit을 사용하여 최종 이미지를 화면에 렌더링합니다. | ### Supported Aspect Ratio##resolution-scaling **Supported Aspect Ratio** 섹션을 사용하여 지원할 기기의 종횡비와 관련된 설정을 커스터마이즈합니다. | **설정** | **설명** | | | --------------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | **Aspect Ratio Mode** | 애플리케이션이 지원하는 가장 큰 종횡비를 지정합니다. 기기의 종횡비가 이 종횡비보다 큰 경우 Unity는 애플리케이션에 이 종횡비를 사용하고 애플리케이션이 늘어나지 않도록 검은색 바를 추가합니다. | | | | **Legacy Wide Screen (1.86)** | 애플리케이션이 Android의 레거시 와이드 스크린 종횡비까지 지원합니다. | | | **Native Aspect Ratio** | 애플리케이션이 Android의 네이티브 종횡비까지 지원합니다. | | | **Custom** | 애플리케이션이 **Maximum**에 설정한 종횡비까지 지원합니다. | | **Minimum** | 커스텀 최소 종횡비입니다. 이 값은 **Maximum**보다 작아야 합니다.**참고**: **Aspect Ratio Mode**를 **Custom**으로 설정한 경우에만 표시됩니다. | | | **Maximum** | 커스텀 최대 종횡비입니다. 이 값은 **Minimum**보다 커야 합니다.**참고**: **Aspect Ratio Mode**를 **Custom**으로 설정한 경우에만 표시됩니다. | | ### Miscellaneous##supported-aspect-ratio | **설정** | **설명** | | | -------------------------- | ------------------------------ | ------------------------- | | **Show Loading Indicator** | 로딩 표시가 나타나는지 여부와 표시 방법을 지정합니다. | | | | **Don't Show** | 로딩 표시를 나타내지 않습니다. | | | **Large** | 로딩 표시를 크게 나타냅니다. | | | **Inversed Large** | 로딩 표시의 색을 반전시키고 크게 나타냅니다. | | | **Small** | 로딩 표시를 작게 나타냅니다. | | | **Inversed Small** | 로딩 표시의 색을 반전시키고 작게 나타냅니다. | ### Orientation##miscellaneous { /* This table uses single sourcing. For information on how to edit it, see https://confluence.unity3d.com/display/DOCS/Single-sourcing+table+rows. */ } | **프로퍼티** | **설명** | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Auto Rotation Behavior** | **Default Orientation**이 **Auto Rotation**으로 설정된 경우 기기의 회전 센서 및 방향 설정에 따라 애플리케이션 창의 방향을 조정하는 방식을 지정합니다.**참고**: **Default Orientation**을 **Auto Rotation**으로 설정한 경우에만 이 프로퍼티가 표시됩니다. 기본적으로 이 프로퍼티는 **User**로 설정되어 있습니다. | | **User** | 애플리케이션 창의 방향이 기기의 방향 설정에 따라 조정됩니다. 사용자가 기기의 자동 회전 방향 설정을 잠그면 애플리케이션 창이 **Allowed Orientations for Auto Rotation** 섹션에 설정한 환경 설정을 따르지 않습니다. 사용자가 기기의 자동 회전 방향 설정을 끄면 애플리케이션 창이 설정된 환경 설정에 따라서만 회전합니다. | | **Sensor** | 애플리케이션 창의 방향이 기기의 방향 설정과 관계없이 기기의 회전 센서에 따라 조정됩니다. 하지만 애플리케이션 창은 **Allowed Orientations for Auto Rotation** 섹션에서 설정한 환경 설정에 따라서만 회전합니다. | ### Allowed Orientations for Auto Rotation##orientation **Default Orientation**을 **Auto Rotation**으로 설정할 때 애플리케이션이 지원하는 방향을 지정하려면 **Allowed Orientations for Auto Rotation** 섹션을 사용합니다. 예를 들어 애플리케이션을 가로 방향으로 고정하되 사용자가 가로 왼쪽과 가로 오른쪽 간에 변경할 수 있도록 하는 데 사용합니다. **참고**: 이 섹션은 Orientation 섹션의 **Default Orientation**을 **Auto Rotation**으로 설정한 경우에만 표시됩니다. { /* This table uses single sourcing. For information on how to edit it, see https://confluence.unity3d.com/display/DOCS/Single-sourcing+table+rows. */ } | **프로퍼티** | **설명** | | -------- | ------ | ### 추가 해상도 및 프레젠테이션 설정##allowed-orientations-for-auto-rotation { /* This table uses single sourcing. For information on how to edit it, see https://confluence.unity3d.com/display/DOCS/Single-sourcing+table+rows. */ } | **프로퍼티** | **설명** | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Use 32-bit Display Buffer** | 디스플레이 버퍼가 16비트 컬러 값이 아닌 32비트 컬러 값을 포함하는지를 나타냅니다. 밴딩이 있거나 [포스트 프로세싱 효과](/engine/6000.0/manual/rendering-and-post-processing/post-processing-and-full-screen-effects/overview.md)에서 알파 값이 필요한 경우 이 설정을 활성화합니다. 일부 포스트 프로세싱 효과는 디스플레이 버퍼와 동일한 포맷의 [렌더 텍스처](/engine/6000.0/manual/materials-and-shaders/textures/textures-reference/class-render-texture.md)를 생성하기 때문에 이를 필요로 합니다. | \## 스플래시 이미지 [가상 현실](/engine/6000.0/manual/platform-specific/xr.md) 디스플레이에 표시될 커스텀 스플래시 이미지를 선택하려면 **Virtual Reality Splash Image** 설정을 사용하십시오. 일반적인 스플래시 화면 설정에 대한 자세한 내용은 [스플래시 화면](/engine/6000.0/manual/unity-editor/editor-features/comp-manager-group/class-player-settings/splash-screen.md)을 참조하십시오. **가상 현실용 스플래시 화면 설정:** ![](/api/media?file=/engine/6000.0/media/images/PlayerSetAndroidSplash.png) 일반 스플래시 화면 설정 아래에서 Android 전용 **Static Splash Image** 를 설정할 수 있습니다. **Android용 스플래시 화면 설정:** ![](/api/media?file=/engine/6000.0/media/images/PlayerSetAndroidSplashStory.png) | **설정** | **설명** | | | ----------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | **Image** | 애플리케이션이 Android 스플래시 화면에 사용하는 텍스처를 지정합니다. 스플래시 화면 이미지의 표준 크기는 320x480입니다. | | | **Scaling** | 기기 화면에 맞게 스플래시 이미지의 크기를 스케일하는 방법을 지정합니다. | | | | **Center (only scale down)** | 이미지가 너무 크지 않다면 네이티브 크기로 이미지를 드로우합니다. 이 경우 Unity는 이미지를 크기에 맞게 축소합니다. | | | **Scale to Fit (letter-boxed)** | 더 긴 쪽이 화면 크기에 정확히 맞도록 이미지의 크기를 조정합니다. Unity가 짧은 치수의 측면 빈 공간을 검정색으로 채웁니다. | | | **Scale to Fill (cropped)** | 더 짧은 쪽이 화면 크기에 정확히 맞도록 이미지의 크기를 조정합니다. Unity가 긴 치수를 기준으로 이미지를 자릅니다. | ## 기타 설정##splash-image 이 섹션에서는 다음 그룹으로 분류된 다양한 옵션을 커스터마이즈할 수 있습니다. * [Rendering](#Rendering) * [Vulkan Settings](#Vulkan) * [Identification](#Identification) * [Configuration](#Configuration) * [Shader Settings](#ShaderSettings) * [Shader Variant Loading Settings](#ShaderVariantLoading) * [Script Compilation](#ScriptCompilation) * [Script Compilation](#Optimization) * [Stack Trace](#Logging) * [Legacy](#Legacy) ### 렌더링##additional-resolution-and-presentation-settings 다음 설정을 사용하여 Unity가 Android 플랫폼용으로 게임을 렌더링하는 방법을 커스터마이즈합니다. { /* This table uses single sourcing. For information on how to edit it, see https://confluence.unity3d.com/display/DOCS/Single-sourcing+table+rows. */ } | **프로퍼티** | **설명** | | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Auto Graphics API** | 그래픽스 API를 수동으로 선택하고 순서를 변경하려면 이 옵션을 비활성화합니다. 기본적으로 이 옵션은 활성화되어 있으며, Unity는 Vulkan을 사용하려고 시도합니다. 기기가 Vulkan을 지원하지 않으면 Unity는 GLES3.2, GLES3.1, GLES3.0으로 폴백합니다.**중요**: Unity는 **Auto Graphics API**를 활성화하거나 **Graphics API**에 **OpenGLES3**가 포함된 경우에만 Android 앱 매니페스트에 GLES3.1/GLES3.1+AEP/GLES3.2 요구 사항을 추가합니다. | | **Graphics APIs** | 애플리케이션에서 지원하는 그래픽스 API를 지정합니다. Unity는 리스트 상단에 있는 그래픽스 API를 먼저 사용하려고 시도하며, 기기가 지원하지 않으면 리스트의 다음 그래픽스 API로 다시 폴백합니다.**참고**: 이 프로퍼티는 Auto Graphics API가 false로 설정된 경우에만 표시됩니다. | | **Vulkan** | 타겟에 Vulkan을 API로 추가합니다. | | **OpenGLES3** | 타겟에 OpenGLES 3를 API로 추가합니다. | | **Require ES3.1** | 최소 OpenGL ES 3 마이너 버전이 3.1인지를 나타냅니다.이 프로퍼티는 **Auto Graphics API**를 활성화하거나 **Graphics APIs**에 **OpenGLES3**가 포함된 경우에만 표시됩니다. | | **Require ES3.1+AEP** | 최소 OpenGL ES 3 마이너 버전이 3.1+AEP인지를 나타냅니다.이 프로퍼티는 **Auto Graphics API**를 활성화하거나 **Graphics APIs**에 **OpenGLES3**가 포함된 경우에만 표시됩니다. | | **Require ES3.2** | 최소 OpenGL ES 3 마이너 버전이 3.2인지를 나타냅니다.이 프로퍼티는 **Auto Graphics API**를 활성화하거나 **Graphics APIs**에 **OpenGLES3**가 포함된 경우에만 표시됩니다. | | **Graphics Jobs Mode** | 애플리케이션에 사용할 그래픽스 잡 모드를 지정합니다. Unity의 잡에 대한 자세한 내용은 [잡 시스템 개요](/engine/6000.0/manual/scripting/optimization/job-system/overview.md)를 참조하십시오.**참고**: 이 옵션은 **Graphics Jobs**가 활성화되고 **Graphics APIs**가 Vulkan으로 설정된 경우에만 사용할 수 있습니다. | | **Native** | 메인 스레드가 워커 스레드에 대한 Unity 그래픽스 커맨드를 작성합니다. 워커 스레드는 렌더 스레드가 소비하는 작업 실행자에 커맨드를 작성합니다. | | **Legacy** | 메인 스레드가 워커 스레드에 대한 Unity 그래픽스 커맨드를 작성합니다. 워커 스레드는 렌더 스레드에 커맨드를 직접 작성합니다. 렌더 스레드는 Unity 그래픽스 커맨드를 읽고 이를 네이티브 그래픽스 커맨드로 전환합니다. | | **Split** | 메인 스레드가 워커 스레드에 대한 Unity 그래픽스 커맨드를 작성합니다. 렌더 스레드는 Unity 그래픽스 커맨드를 읽고 이를 네이티브 그래픽스 커맨드로 전환합니다. 그런 다음 렌더 스레드는 워커 스레드를 시작하여 네이티브 그래픽스 커맨드를 작성합니다. | | **Texture compression formats** | ASTC, ETC2, ETC(RGB는 ETC1, RGBA는 ETC2) 및 DXTC, DXT + RGTC(BC4, BC5) 중에서 선택할 수 있습니다. 올바른 포맷을 선택하는 방법에 대한 자세한 내용은 [텍스처 압축 포맷 개요](/engine/6000.0/manual/class-texture-importer-override.md#android)를 참조하십시오. 이 리스트에 [텍스처 압축 타게팅](/engine/6000.0/manual/platform-specific/android/building-and-delivering/distribution/google-play.md#texture-compression-targeting)을 지원할 여러 텍스처 압축 포맷을 추가할 수 있지만, 이 리스트에 DXT와 DXT + RGTC(BC4, BC5)를 둘 다 포함할 수는 없습니다. 텍스처 압축 타게팅을 활성화하는 경우 Unity는 [애플리케이션 바이너리 분할](#splitapplicationbinary)도 활성화합니다.[빌드 설정](/engine/6000.0/manual/platform-specific/android/building-and-delivering/build-settings.md)의 텍스처 압축 설정과 상호 작용하는 방법에 대한 자세한 내용은 [텍스처 압축 설정](/engine/6000.0/manual/platform-specific/android/introducing/requirements-and-compatibility.md#texture-compression)을 참조하십시오.**참고**: 애플리케이션을 APK로 [익스포트](/engine/6000.0/manual/platform-specific/android/building-and-delivering/export-process.md)하거나 빌드하는 경우 Unity는 이 리스트의 첫 번째 텍스처 압축 포맷만 사용합니다. | | **OpenGL: Profiler GPU Recorders** | OpenGL로 렌더링할 때 프로파일러 레코더를 활성화할지를 나타냅니다. 이 옵션은 다른 렌더링 API에 대해 항상 활성화되어 있지만, 프레임 타이밍 통계 및 GPU 프로파일러와의 호환성 문제로 인해 OpenGL에서는 선택 사항입니다. | | **Virtual Texturing (Experimental)** | [가상 텍스처링](/engine/6000.0/manual/materials-and-shaders/textures/texture-loading/svt-streaming-virtual-texturing.md) 활성화 여부를 나타냅니다.**참고**: 가상 텍스처링은 Android와 호환되지 않습니다. | | **360 Stereo Capture** | Unity가 스테레오스코픽 360 이미지 및 동영상을 캡처할 수 있는지 지정합니다.**참고**: 360 스테레오스코픽 캡처는 Android와 호환되지 않습니다. | ### Vulkan 설정##rendering | **프로퍼티** | **설명** | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Android Vulkan Deny Filter List** | Unity 애플리케이션을 실행할 때 Vulkan API를 사용하지 않아야 하는 Android 기기를 식별하는 기준을 지정합니다.다음 파라미터 세트를 사용하여 거부 기준을 정의합니다. 모든 파라미터는 선택 사항입니다. Vulkan API 버전과 드라이버 버전 파라미터를 제외하고 [정규 표현식](https://learn.microsoft.com/en-us/dotnet/standard/base-types/regular-expressions)을 사용하여 파라미터를 설정할 수 있습니다. Unity 에디터에 잘못된 정규 표현식에 대한 오류가 표시됩니다.자세한 내용은 [Vulkan API 사용 허용 또는 거부](/engine/6000.0/manual/platform-specific/android/developing/graphics/allow-deny-vulkan-usage.md) 기술 자료를 참조하십시오.**참고**: 플레이어 설정에 OpenGLES3 같은 대체 그래픽스 API를 포함하지 않으면 거부 기준을 충족하는 기기에서는 애플리케이션이 실행되지 않습니다. | | **Vendor** | Android 기기에서 사용되는 GPU 하드웨어의 공급업체 이름입니다. 예: Qualcomm, ARM | | **Device Name** | Android 기기에서 사용되는 GPU 모델 이름입니다. 예: Adreno (TM) 740 | | **Brand** | Android 기기의 제조사 이름입니다. 예: Google, Samsung | | **Product Name** | Android 기기의 제품 코드명입니다. 예: Barbet, Mermaid | | **Android OS version** | 기기가 실행되는 Android 운영 체제 버전입니다. 예: 13 | | **Vulkan API version** | Android 기기에서 사용할 수 있는 최소 Vulkan API 버전입니다. 다음 포맷 중 하나로 버전 번호를 입력합니다.• MinorVersion과 PatchVersion이 선택 사항인 `MajorVersion.MinorVersion.PatchVersion`. 예: `1.1.128`• 최대 8자리고 `0x`로 시작하는 16진수 포맷 예: `0x00401080`**참고**: 이 파라미터에는 정규 표현식이 허용되지 않습니다. | | **Driver version** | 필요한 최소 Vulkan 기기 드라이버 버전입니다. 다음 포맷 중 하나로 버전 번호를 입력합니다.• `MinorVersion`과 `PatchVersion`이 선택 사항인 `MajorVersion.MinorVersion.PatchVersion`. 예: `0.676.0`.• 최대 8자리고 `0x`로 시작하는 16진수 포맷 예: `0x002a4000`**참고**: 이 파라미터에는 정규 표현식이 허용되지 않습니다. | | **Android Vulkan Allow Filter List** | Unity 애플리케이션을 실행할 때 언제든지 Vulkan 그래픽스 API를 사용해야 하는 Android 기기를 식별하기 위한 기준을 지정합니다.기기가 거부 및 허용 필터 리스트에 모두 포함된 경우 허용 필터를 우선 적용하고 기기는 Vulkan API를 사용합니다. 이러한 리스트를 사용하여 성능이 저하된 큰 카테고리의 기기는 Vulkan API를 사용하지 못하도록 제한하고, 해당 카테고리 내 기기 중 성능이 더 나은 기기는 Vulkan API를 사용하도록 허용할 수 있습니다. 거부 및 허용 필터 리스트 모두에 동일한 값이 포함된 경우 Unity는 리스트에 지정된 기준을 무시합니다.자세한 내용은 [Vulkan API 사용 허용 또는 거부](/engine/6000.0/manual/platform-specific/android/developing/graphics/allow-deny-vulkan-usage.md) 기술 자료를 참조하십시오.**참고**: 기준을 정의하는 데 사용되는 파라미터에 대한 설명은 [Android Vulkan 거부 필터 리스트](#DenyFilterList)를 참조하십시오. | ### 식별##vulkan-settings **Android 플랫용 식별 설정:** ![](/api/media?file=/engine/6000.0/media/images/android-identification.png) | **프로퍼티** | **기능** | | | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Override Default Package Name** | 애플리케이션의 기본 패키지 이름을 오버라이드할지 여부를 나타냅니다.**참고:** 이 설정은 macOS, iOS, tvOS, Android에 영향을 줍니다. | | | | **Package Name** | 기기와 Google Play 스토어에서 앱을 고유하게 식별하는 애플리케이션 ID를 설정합니다. 애플리케이션 ID는 `com.YourCompanyName.YourProductName` 규칙을 따라야 하며 영숫자와 밑줄 문자만 포함해야 합니다. 각 세그먼트는 알파벳 문자로 시작해야 합니다. 자세한 내용은 [애플리케이션 ID 설정](https://developer.android.com/studio/build/configure-app-module#set-application-id)을 참조하십시오.**중요**: Unity는 잘못된 문자가 입력되면 자동으로 제거합니다.이 프로퍼티를 설정하려면 **Override Default Package Name**을 활성화합니다. | | **Version** | 번들의 반복 작업(릴리스 또는 릴리스되지 않음)을 식별하는 번들의 빌드 버전 번호를 입력합니다. 버전은 점으로 구분된 숫자가 포함된 문자열의 공통 포맷으로 지정됩니다(예: 4.3.2). (iOS와 Android 간에 공유됨) | | | **Bundle Version Code** | 내부 버전 번호입니다. 이 숫자는 한 버전이 다른 버전보다 최신 버전인지를 파악하는 데만 사용되며 숫자가 클수록 최신 버전을 나타냅니다. 이는 사용자에게 표시되는 버전 번호가 아닙니다. 해당 번호는 `versionName` 속성으로 설정됩니다. 이 값은 ‘100’ 같은 정수로 설정해야 합니다. 원하는 대로 정의할 수 있지만, 각 후속 버전의 숫자가 더 커야 합니다.빌드 번호일 수 있습니다. 또는 버전 번호가 ‘x.y’ 포맷인 경우 ‘x’와 ‘y’를 16비트에서 하위 및 상위로 별도로 인코딩하여 정수로 변환할 수도 있습니다. 또는 새 버전이 릴리스될 때마다 숫자를 하나씩 높일 수도 있습니다.**Split APKs by target architecture**가 활성화된 경우 이 값을 100000 미만으로 유지하십시오. 각 APK에는 고유한 버전 코드가 있어야 하므로 Unity는 ARMv7에 100000을, ARM64에 200000을 추가합니다. | | | **Minimum API Level** | 애플리케이션을 실행하는 데 필요한 최소 Android 버전(API 레벨)입니다. | | | **Target API Level** | 애플리케이션을 컴파일하는 데 사용할 타겟 Android 버전(API 레벨)입니다. | | ### 설정##identification { /* This table uses single sourcing. For information on how to edit it, see https://confluence.unity3d.com/display/DOCS/Single-sourcing+table+rows. */ } | **프로퍼티** | **설명** | | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Target Architectures** | 타겟팅할 아키텍처를 지정합니다. | | **ARMv7** | ARMv7 아키텍처에 대한 지원을 활성화합니다. | | **ARM64** | ARM64 아키텍처에 대한 지원을 활성화합니다.**참고**: 이 프로퍼티는 **Scripting Backend**를 **IL2CPP**로 설정한 경우에만 활성화됩니다. | | **x86–64 (Magic Leap 2)** | x86–64 아키텍처에 대한 지원을 활성화합니다.**참고**: 이 프로퍼티는 **Scripting Backend**를 **IL2CPP**로 설정한 경우에만 활성화됩니다. | | **Enable Armv9 Security Features for Arm64** | ARM64 빌드에 PAuth, PAC(포인터 인증) 및 BTI(브랜치 타겟 식별)를 활성화합니다.**참고**: 이 프로퍼티는 **ARM64**를 타겟 아키텍처로 설정한 경우에만 활성화됩니다. | | **Split APKs by target architecture** | **Target Architectures** 에서 선택한 각 CPU 아키텍처에 별도의 APK를 생성하려면 이 옵션을 활성화합니다. 이렇게 하면 Google Play 스토어 사용자의 다운로드 크기가 작아집니다. 이는 주로 Google Play 스토어 기능이며 다른 스토어에서는 작동하지 않을 수 있습니다. 자세한 내용은 [다중 APK 지원](https://developer.android.com/google/play/publishing/multiple-apks.html)을 참조하십시오. | | **Install Location** | 애플리케이션이 기기에 설치되는 위치를 지정합니다. 자세한 내용은 [설치 위치에 대한 Android 개발자 기술 자료](http://developer.android.com/guide/appendix/install-location.html)를 참조하십시오. | | **Automatic** | 운영 체제가 자동으로 결정하도록 합니다. 사용자는 앱을 앞뒤로 이동할 수 있습니다. | | **Prefer External** | 가능하면 애플리케이션을 외부 스토리지(SD 카드)에 설치합니다. 운영 체제에서 이 동작은 보장되지 않습니다. 가능하지 않은 경우 앱이 내부 메모리에 설치됩니다. | | **Force Internal** | 애플리케이션을 내부 메모리에 설치하도록 강제합니다. 사용자가 앱을 외부 스토리지로 이동할 수 없습니다. | | **Internet Access** | 네트워킹 API를 사용하지 않는 경우에도 네트워킹(`INTERNET`) 권한을 [Android 앱 매니페스트](/engine/6000.0/manual/platform-specific/android/introducing/manifest.md)에 항상 추가할지 선택합니다. 개발용 빌드의 경우 기본적으로 \_Require\_로 설정합니다. | | **Auto** | 네트워킹 API를 사용하는 경우에만 인터넷 액세스 권한을 추가합니다. | | **Require** | 인터넷 액세스 권한을 항상 추가합니다. | | **Write Permission** | 외부 스토리지(예: SD 카드)에 쓰기 액세스를 활성화하고 해당 권한을 Android 앱 매니페스트에 추가할지 선택합니다. 개발 빌드의 경우 기본적으로 External(SDCard)로 설정합니다. | | **Internal** | 내부 스토리지에 대한 쓰기 권한만 허용합니다. | | **External(SDCard)** | 외부 스토리지에 대한 쓰기 권한을 허용합니다. | | **Filter Touches When Obscured** | 표시된 다른 창이 Unity 애플리케이션을 가리고 있을 때 수신된 터치를 폐기하려면 이 옵션을 활성화합니다. 탭재킹을 방지하는 데 사용됩니다. | | **Sustained Performance Mode** | 열 스로틀링 없이 장기간 동안 예측 가능한 일관된 기기 성능을 유지하도록 설정하려면 이 옵션을 활성화합니다. 이 설정을 활성화하면 전반적인 성능이 저하될 수 있습니다. [Android 지속 성능 API](https://developer.android.com/about/versions/nougat/android-7.0.html#sustained_performance_api)를 기반으로 합니다. | | **Maximum Java Heap Size** | 빌드 시 최대 Java 힙 크기를 사용자가 지정한 크기로 설정합니다(MB). 기본값은 4096입니다. | | **Low Accuracy Location** | 낮은 정확도 값을 Android 위치 관련 API에 사용하려면 이 옵션을 활성화합니다. | | **Predictive Back Gesture Support** | Android 13 이상에서 백 이벤트를 처리하기 위해 Android의 [OnBackInvokedCallback](https://developer.android.com/guide/navigation/predictive-back-gesture)을 사용하려면 이 옵션을 활성화합니다. | | **Android TV Compatibility** | 애플리케이션을 Android TV 호환 가능으로 표시하려면 이 옵션을 활성화합니다. | | **Android Game** | 출력 패키지(APK)를 일반 애플리케이션이 아니라 게임으로 표시하려면 이 옵션을 활성화합니다.**참고**: 이 프로퍼티는 **Android TV Compatibility**가 true로 설정된 경우에만 표시됩니다. | | **Android Gamepad Support Level** | 애플리케이션이 게임패드에 제공하는 지원 수준을 선택합니다.**참고**: 이 프로퍼티는 **Android TV Compatibility**가 true로 설정된 경우에만 표시됩니다. | | **Works with D-Pad** | 애플리케이션이 D패드를 사용하여 완벽하게 작동합니다. 게임패드가 필요하지 않습니다. | | **Supports Gamepad** | 애플리케이션이 게임패드로 작동하지만 필수는 아닙니다. | | **Requires Gamepad** | 애플리케이션을 사용하려면 게임패드가 필요합니다. | | **Warn about App Bundle size** | [Android 앱 번들](https://developer.android.com/platform/technology/app-bundle)의 크기가 특정 임곗값을 초과할 때 경고를 수신하려면 이 옵션을 활성화합니다. 이 옵션은 기본적으로 선택되어 있으며 Build Type을 **Release**로 선택하고 [빌드 설정](/engine/6000.0/manual/platform-specific/android/building-and-delivering/build-settings.md)에서 **Build App Bundle (Google Play)** 옵션을 활성화한 경우에만 설정할 수 있습니다. | | **App Bundle size threshold** | 크기를 MB 단위로 입력합니다. 앱 번들이 이 크기를 초과하면 Unity는 경고를 표시하고 [Google Play 최대 크기 제한](https://support.google.com/googleplay/android-developer/answer/9859372#size_limits)에 따라 생성된 릴리스 앱 번들에 대한 전체 크기 확인을 수행할 것을 권장합니다. | | **Warn about Symbols size** | [Android 앱 번들](https://developer.android.com/platform/technology/app-bundle) 내 심볼 zip 패키지 또는 내장 심볼의 크기가 특정 임곗값을 초과할 때 경고를 수신하려면 이 옵션을 활성화합니다. 이 옵션은 기본적으로 선택되어 있으며 [빌드 설정](/engine/6000.0/manual/platform-specific/android/building-and-delivering/build-settings.md)에서 **Debug Symbols를 Public/Debugging**으로 설정한 경우에만 설정할 수 있습니다. | | **Symbols size threshold** | 크기를 MB 단위로 입력합니다. 심볼 패키지가 이 크기를 초과하면 Unity에 경고가 표시됩니다. | | **Application Entry Point** | 애플리케이션에 생성할 애플리케이션 엔트리 포인트입니다. 자세한 내용은 [Android 애플리케이션 엔트리 포인트](/engine/6000.0/manual/platform-specific/android/developing/application-entries.md)를 참조하십시오. | | **Activity** | [활동 애플리케이션 엔트리 포인트](/engine/6000.0/manual/platform-specific/android/developing/application-entries/activity.md)를 생성합니다. | | **GameActivity** | [GameActivity 애플리케이션 엔트리 포인트](/engine/6000.0/manual/platform-specific/android/developing/application-entries/game-activity.md)를 생성합니다. | | **Active Input Handling** | 사용자의 입력을 처리하는 방식을 선택합니다. | | **Input Manager (Old)** | 기존의 [입력](/engine/6000.0/manual/working-in-unity/input/legacy/class-input-manager.md) 설정을 사용합니다. | | **Input System Package (New)** | [입력](/engine/6000.0/script-reference/unity-engine/input.md) 시스템을 사용합니다. 이 옵션을 사용하려면 [InputSystem 패키지](https://github.com/Unity-Technologies/InputSystem)를 설치해야 합니다. | | **Both** | 두 시스템을 모두 사용합니다.**참고**: 이 옵션은 Android에서 지원되지 않습니다. | #### API 호환성 수준##api-compatibility-level 모든 타겟에 모노 API 호환성 레벨을 선택할 수 있습니다. 타사 .NET 라이브러리가 .NET 호환성 레벨을 벗어난 기능을 사용하는 경우도 있습니다. 이러한 경우 발생하는 상황과 문제 해결 방법을 이해하려면 다음 권장 해결 방법을 따르십시오. 1. Windows용 [ILSpy](https://www.microsoft.com/en-us/p/ilspy/9mxfbkfvsq13?cid=msft_web_chart\&activetab=pivot:overviewtab)를 설치합니다. 2. 문제가 있는 API 호환성 수준의 .NET 어셈블리를 ILSpy로 드래그합니다. `Frameworks/Mono/lib/mono/YOURSUBSET/`에서 찾을 수 있습니다. 3. 타사 어셈블리를 드래그합니다. 4. 타사 어셈블리를 오른쪽 클릭하고 **Analyze**를 선택합니다. 5. 분석 보고서에서 **Depends on** 섹션을 살펴봅니다. 타사 어셈블리가 의존하고 있지만 선택한 .NET 호환성 레벨에서 사용할 수 없는 항목은 빨간색으로 강조 표시됩니다. ### 셰이더 설정##configuration | **프로퍼티** | **설명** | | -------- | ------ | ### 셰이더 배리언트 로딩 설정##android-application-configuration 이 설정을 사용하여 런타임에 셰이더가 사용하는 메모리 양을 제어할 수 있습니다. | **프로퍼티** | **설명** | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Default chunk size (MB)** | 모든 플랫폼에 Unity가 빌드된 애플리케이션에 저장하는 압축된 셰이더 배리언트 데이터 청크의 최대 크기를 설정합니다. 기본값은 `16`입니다. 자세한 내용은 [셰이더 로딩](/engine/6000.0/manual/materials-and-shaders/shaders/shader-troubleshooting/shader-reduce-stalling/shader-loading.md.md#dynamicloading)을 참조하십시오. | | **Default chunk count** | Unity가 모든 플랫폼에서 메모리에 보관하는 압축 해제된 청크의 기본 제한을 설정합니다. 기본값은 `0`이므로 제한이 없습니다. | | **Override** | 이 빌드 타겟에 **Default chunk size** 및 **Default chunk count** 를 오버라이드할 수 있습니다. | | **Chunk size (MB)** | 이 빌드 타겟에서 **Default chunk size (MB)** 값을 오버라이드합니다. | | **Chunk count** | 이 빌드 타겟에서 **Default chunk count** 값을 오버라이드합니다. | ### 스크립트 컴파일##shader-settings **Android 플랫폼용 스크립트 컴파일 설정:** ![](/api/media?file=/engine/6000.0/media/images/ProjectSettingsScriptCompilation.png) | **프로퍼티** | **설명** | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Scripting Define Symbols** | 커스텀 컴파일 플래그를 설정합니다.자세한 내용은 [플랫폼별 컴파일](/engine/6000.0/manual/platform-dependent-compilation.md.md)을 참조하십시오. | | **Additional Compiler Arguments** | 이 리스트에 엔트리를 추가하여 Roslyn 컴파일러에 추가 인자를 전달합니다. 각 추가 인수에 하나의 새 엔트리를 사용합니다.새 항목을 만들려면 **Add**(**+**)를 클릭합니다. 항목을 제거하려면 **Remove**(**-**)를 클릭합니다.원하는 인자를 모두 추가한 후, 추가 인자를 향후 컴파일에 포함하려면 **Apply**를 클릭합니다. 이 리스트를 가장 최근에 적용된 상태로 초기화하려면 **Revert**를 클릭합니다. | | **Suppress Common Warnings** | C# 경고 [CS0169](https://docs.microsoft.com/en-us/dotnet/csharp/misc/cs0169) 및 [CS0649](https://docs.microsoft.com/en-us/dotnet/csharp/misc/CS0649)를 표시할지 여부를 나타냅니다. | | **Allow 'unsafe' Code** | 사전 정의된 어셈블리(예: `Assembly-CSharp.dll`)에서 ['안전하지 않은' C# 코드](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/unsafe) 컴파일에 대한 지원을 활성화합니다.어셈블리 정의 파일(`.asmdef`)의 경우 `.asmdef` 파일 중 하나를 클릭하고 인스펙터 창에 표시되는 옵션을 활성화합니다. | | **Use Deterministic Compilation** | -deterministic C# 플래그로 컴파일을 방지할지 여부를 나타냅니다. 이 설정을 활성화하면 컴파일된 어셈블리는 컴파일될 때마다 바이트단위로 동일합니다.자세한 내용은 [코드 생성을 제어하는 C# 컴파일러 옵션](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/compiler-options/deterministic-compiler-option)을 참조하십시오. | ### 최적화##shader-variant-loading-settings { /* This table uses single sourcing. For information on how to edit it, see https://confluence.unity3d.com/display/DOCS/Single-sourcing+table+rows. */ } | **프로퍼티** | **설명** | | -------- | ------ | ### 스택 추적##script-compilation 필요한 로깅 유형에 따라 각 로그 유형(**Error**, **Assert**, **Warning**, **Log**, **Exception**)에 해당하는 옵션을 활성화하여 원하는 스택 추적 메서드를 선택합니다. **Android 플랫폼용 로깅 설정:** ![](/api/media?file=/engine/6000.0/media/images/PlayerSetPCOther-Logging.png) | **프로퍼티** | **설명** | | -------------- | ----------------------- | | **None** | 어떤 로그도 기록하지 않습니다. | | **ScriptOnly** | 스크립트를 실행할 때만 로그를 기록합니다. | | **Full** | 항상 로그를 기록합니다. | 자세한 내용은 [스택 추적 로깅](/engine/6000.0/manual/scripting/debugging-and-diagnostics/stack-trace.md)을 참조하십시오. ### 레거시##optimization [SkinnedMeshRenderers](/engine/6000.0/manual/working-in-unity/working-with-gameobjects/mesh/components-reference/class-skinned-mesh-renderer.md)의 블렌드 셰이프 가중치 범위를 고정하려면 **Clamp BlendShapes (Deprecated)** 옵션을 활성화합니다. ## 퍼블리싱 설정##other-settings 다음 퍼블리싱 설정을 사용하여 Unity가 Android 애플리케이션을 빌드하는 방법을 설정합니다. * [Project Keystore](#projectkeystore) * [Project Key](#projectkey) * [Build](#build) * [Minify](#minify) * [Split Application Binary](#splitapplicationbinary) * [Report Dependencies in App Bundle](#reportDependencies) **Android 퍼블리싱 패널:** ![](/api/media?file=/engine/6000.0/media/images/Android-publishing-page.png) **참고**: 보안상의 이유로 Unity는 키스토어 또는 프로젝트 키 비밀번호를 저장하지 않습니다. Keystore Manager 창을 사용하여 키와 키스토어를 생성, 설정, 로드합니다. Keystore Manager 또는 메인 Android Publishing 패널에서 기존 키스토어와 키를 로드할 수 있습니다. 키스토어 관리자 내부에서 이를 로드하는 경우 Unity는 Project Keystore 및 Project Key 필드를 자동으로 채웁니다. 자세한 내용은 [키스토어 관리자](/engine/6000.0/manual/platform-specific/android/getting-started/keystore/manager.md) 기술 자료를 참조하십시오. ### Project Keystore##stack-trace 키스토어는 애플리케이션 보안을 위해 서명 키를 보관하는 컨테이너입니다. 자세한 내용은 Android 개발자 기술 자료 [Android 키스토어 시스템](https://developer.android.com/training/articles/keystore)을 참조하십시오. 열린 프로젝트에 사용할 키스토어를 선택하려면 **Project Keystore** 설정을 사용합니다. 키스토어를 로드하면 Unity는 해당 키스토어의 모든 키를 로드합니다. 열린 프로젝트에서 기존 키스토어를 로드하고 사용하는 방법은 다음과 같습니다. 1. **Custom Keystore**를 활성화합니다. 2. **Select** 드롭다운에서 **Browse**를 선택한 후 파일 시스템에서 키스토어를 선택합니다. 3. **키스토어 비밀번호**를 입력합니다. 기존 키스토어가 없으면 **Custom Keystore**를 비활성화 상태로 두십시오. Unity는 디버그 키스토어를 사용하여 애플리케이션에 서명합니다. 디버그 키스토어는 작동하는 키스토어입니다. 이를 통해 애플리케이션에 서명하고 로컬에서 테스트할 수 있습니다. 하지만 앱 스토어는 이러한 방식으로 로그인한 앱을 거부합니다. 이는 앱 스토어가 디버그 키스토어를 사용하여 애플리케이션의 유효성과 소유권을 확인할 수 없기 때문입니다. | **프로퍼티** | **설명** | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Custom Keystore** | **Custom Keystore**를 활성화하면 기존 키스토어를 로드하여 사용할 수 있습니다. | | **Select** | **Custom Keystore**가 활성화되면 사용하려는 키스토어를 선택합니다. **Select** 드롭다운의 파티션 아래에 있는 키스토어는 미리 지정한 전용 위치에 저장됩니다. 자세한 내용은 [키스토어 위치 선택](/engine/6000.0/manual/platform-specific/android/getting-started/keystore/create.md#choose-the-keystore-location)을 참조하십시오. | | **Path** | 키스토어 경로를 입력할 필요는 없습니다. Unity는 선택한 키스토어에 따라 이를 제공합니다. | | **Password** | 선택한 키스토어를 로드하기 위한 키스토어 비밀번호를 입력합니다. | ### Project Key##legacy 키스토어를 로드하면 Unity는 해당 키스토어의 모든 키를 로드합니다. **Project Key** 설정을 사용하여 해당 키스토어에서 열린 프로젝트의 활성 키로 사용할 키를 하나 선택합니다. | **프로퍼티** | **설명** | | ------------ | ---------------------- | | **Alias** | 열린 프로젝트에 사용할 키를 선택합니다. | | **Password** | 키 비밀번호를 입력합니다. | ### Build##project-keystore 기본적으로 Unity는 Unity 설치 시 함께 제공되는 매니페스트 파일, Gradle 템플릿, Proguard 파일을 사용하여 애플리케이션을 빌드합니다. Android Publishing Settings의 **Build** 섹션을 사용하여 변경합니다. 커스텀 매니페스트 파일이나 Gradle 템플릿 또는 Proguard 파일을 사용하려면 다음 단계를 따르십시오. 1. 해당 체크박스를 활성화합니다. 그러면 Unity가 프로젝트에 기본 파일을 생성하고, 해당 파일 위치가 체크박스 아래에 표시됩니다. 2. 새 파일을 열고 변경 작업을 수행합니다. 3. 이 파일의 변경 사항을 저장합니다. Unity는 다음 번에 애플리케이션을 빌드할 때 이 파일에 저장된 변경 사항을 자동으로 사용합니다. Build 섹션의 설정은 현재 프로젝트의 빌드 프로세스에만 적용됩니다. { /* Temporarily removing the below setting from the table as it is now hidden in the Editor until compatibility issues are resolved. |**Upgrade templates to C#**|Opens the [Android Templates Upgrader window](android-templates-upgrader-window) which you can use to upgrade your custom Gradle template files to use the [Android Project Configuration Manager](android-modify-gradle-project-files-methods#agp).| */ } | **프로퍼티** | **설명** | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Custom Main Manifest** | Android `LibraryManifest.xml` 파일의 커스터마이즈 가능 버전입니다. 이 파일에는 Android 애플리케이션에 대한 중요한 메타데이터가 포함되어 있습니다. 메인/Unity 라이브러리 매니페스트의 책임에 대한 자세한 내용은 [Unity 라이브러리 매니페스트](/engine/6000.0/manual/platform-specific/android/introducing/library-manifest.md)를 참조하십시오. | | **Custom Launcher Manifest** | Android `LauncherManifest.xml` 파일의 커스터마이즈 가능 버전입니다. 이 파일에는 Android 애플리케이션 런처에 대한 중요한 메타데이터가 포함되어 있습니다. Unity 런처 매니페스트의 책임에 대한 자세한 내용은 [Unity 런처 매니페스트](/engine/6000.0/manual/platform-specific/android/introducing/launcher-manifest.md)를 참조하십시오. | | **Custom Main Gradle Template** | `mainTemplate.gradle` 파일의 커스터마이즈 가능 버전입니다. 이 파일에는 Android 애플리케이션을 라이브러리로 빌드하는 방법에 대한 정보가 포함되어 있습니다. 자세한 내용은 [Gradle 프로젝트 파일](/engine/6000.0/manual/platform-specific/android/introducing/gradle-overview.md#gradle-project-files)에 대한 기술 자료를 참조하십시오. | | **Custom Launcher Gradle Template** | `launcherTemplate.gradle` 파일의 커스터마이즈 가능 버전입니다. 이 파일에는 Android 애플리케이션을 빌드하는 방법에 대한 지침이 포함되어 있습니다. 자세한 내용은 [Gradle 프로젝트 파일](/engine/6000.0/manual/platform-specific/android/introducing/gradle-overview.md#gradle-project-files)에 대한 기술 자료를 참조하십시오. | | **Custom Base Gradle Template** | `baseProjectTemplate.gradle` 파일의 커스터마이즈 가능 버전입니다. 이 파일에는 다른 모든 템플릿과 Gradle 프로젝트 간에 공유되는 구성이 포함되어 있습니다. 자세한 내용은 [Gradle 프로젝트 파일](/engine/6000.0/manual/platform-specific/android/introducing/gradle-overview.md#gradle-project-files)에 대한 기술 자료를 참조하십시오. | | **Custom Gradle Properties Template** | `gradle.properties` 파일의 커스터마이즈 가능 버전입니다. 이 파일에는 Gradle 빌드 환경에 대한 구성 설정이 포함되어 있습니다. 이 경우는 다음과 같습니다.• JVM(Java 가상 머신) 메모리 설정• Gradle이 여러 JVM을 사용하여 빌드할 수 있도록 하는 프로퍼티• 축소를 수행할 툴을 선택하는 프로퍼티• 앱 번들을 빌드할 때 네이티브 라이브러리를 압축하지 않는 프로퍼티 | | **Custom Gradle Settings Template** | `settingsTemplate.gradle` 파일의 커스터마이즈 가능 버전입니다. 이 파일에는 애플리케이션에 필요한 외부 종속성을 해결하기 위한 아티팩트 저장소 선언이 포함되어 있습니다. | | **Custom Proguard File** | proguard.txt 파일의 커스터마이즈 가능 버전입니다. 이 파일에는 축소 프로세스의 구성 설정이 포함되어 있습니다. 축소로 인해 유지해야 하는 일부 Java 코드가 제거되는 경우 이 파일에 해당 코드를 유지하도록 규칙을 추가해야 합니다. 자세한 내용은 [축소](#minify) 기술 자료를 참조하십시오. | ### Minify##build 축소는 애플리케이션의 코드를 축소하고 복잡하게 하고 최적화하는 프로세스입니다. 코드 크기를 줄이고 코드를 분할하기 어렵게 만들 수 있습니다. Minify 설정을 사용하여 Unity가 빌드에 축소를 적용할 시기와 방식을 정의합니다. 대부분의 경우 디버그 빌드가 아닌 릴리스 빌드에만 축소를 적용하는 것이 좋습니다. 축소하는 데 시간이 걸리고 빌드 속도가 느려질 수 있기 때문입니다. 코드 최적화로 인해 디버깅이 더 복잡해질 수도 있습니다. **참고**: Java 코드가 리플렉션을 통해 참조되는 경우, 축소 프로세스(R8/Proguard)는 코드가 사용 중임을 추측할 수 없어 해당 코드를 제거합니다. [커스텀 Proguard 파일](#customproguard)을 사용하여 필요한 코드를 유지할 수 있습니다. Minify 섹션의 설정은 현재 프로젝트의 빌드 프로세스에만 적용됩니다. | **프로퍼티** | **설명** | | ----------- | ----------------------------------------------------- | | **Release** | Unity가 릴리스 빌드에서 애플리케이션 코드를 축소하도록 만들려면 이 체크박스를 활성화합니다. | | **Debug** | Unity가 디버그 빌드에서 애플리케이션 코드를 축소하도록 만들려면 이 체크박스를 활성화합니다. | ### Split Application Binary##minify 출력 패키지를 메인(APK) 및 확장(OBB) 패키지로 분할하려면 **Split Application Binary** 옵션을 활성화합니다. 100MB보다 큰 애플리케이션을 퍼블리시하려면 Google Play 스토어에서 이 옵션을 요구합니다. ### Report Dependencies in App Bundle##split-application-binary Google Play용 AAB(Android 앱 번들)로 애플리케이션을 빌드하려는 경우 앱 번들에 종속성에 대한 정보를 포함하려면 이 옵션을 활성화합니다. 자세한 내용은 [앱 종속성 보고](/engine/6000.0/manual/platform-specific/android/building-and-delivering/distribution/google-play.md#reportappdependencies) 섹션을 참조하십시오. **참고**: [Android Build Settings](/engine/6000.0/manual/platform-specific/android/building-and-delivering/build-settings.md)에서 **Build App Bundle (Google Play)** 옵션을 활성화한 경우에만 이 설정과 상호 작용할 수 있습니다. *** * * * * * * * * * * * *