Android 14 QPR1에서는 사용자가 앱의 화면 비율을 변경하여 큰 화면에서 앱이 표시되는 방식을 개선할 수 있는 새로운 구성 메뉴가 도입되었습니다. 이 메뉴는 일부 대형 화면 기기의 기기 설정에 구현되어 있습니다.
구성 메뉴를 구현한 기기에서 사용자는 앱 목록에서 선택한 후 앱 가로세로 비율을 4:3, 16:9, 전체 화면과 같은 다양한 값으로 설정합니다 (가로세로 비율 값은 기기 제조업체에서 구성함). 사용자는 앱 기본값으로 화면 비율을 재설정할 수도 있습니다. 이는 기기 제조업체에서 앱별 재정의 (OVERRIDE_MIN_ASPECT_RATIO 참고)로 지정한 값 또는 재정의가 적용되지 않았거나 앱에서 재정의를 사용 중지한 경우 앱 매니페스트의 값입니다.
재정의 사용 중지
Android 14 QPR1은 다음 PackageManager.Property 태그를 지원하므로 재정의를 구현한 기기에서 가로세로 비율 구성 메뉴를 사용 중지하거나 수정할 수 있습니다.
PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE
사용자 가로세로 비율 호환성 재정의를 사용 중지하려면 앱 매니페스트에 속성을 추가하고 값을 false로 설정합니다.
구성 메뉴를 구현한 기기에서는 전체 화면 옵션이 기기 설정의 화면 비율 옵션 목록에서 삭제됩니다. 사용자가 앱에 전체 화면 재정의를 적용할 수 없습니다.
이 속성을 true로 설정해도 효과가 없습니다.
대형 화면에 맞게 앱 최적화: 앱에서 가로세로 비율 제한을 설정하지 마세요. 창 크기 클래스를 사용하여 사용 가능한 디스플레이 공간의 크기에 따라 다양한 레이아웃을 지원하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-27(UTC)"],[],[],null,["Android provides overrides that change the configured behavior of apps.\n\nDevice manufacturers can apply overrides to apps on select large screen devices. Android 14 QPR1 introduces user overrides, which enable users to apply overrides to apps through device settings.\n\nPer-app overrides are intended to improve the user experience on large screen devices. Apps can disable some overrides.\n\nFor more information about per-app overrides, see [Device compatibility mode](/guide/practices/device-compatibility-mode#user_per-app_overrides).\n| **Note:** To enable your app to provide the best user experience without relying on device manufacturer or user overrides, follow the [Large screen app quality](/docs/quality-guidelines/large-screen-app-quality) guidelines.\n\nUser overrides\n\nAndroid 14 QPR1 introduces a new configuration menu that enables users to change the aspect ratio of apps to improve how apps display on large screens. The menu is implemented in device settings on select large screen devices.\n\nOn devices that have implemented the configuration menu, users choose from a list of apps and then set the app aspect ratio to various values, such as 4:3, 16:9, and full screen (aspect ratio values are configured by the device manufacturer). Users can also reset the aspect ratio to the app default, which is the value specified by a device manufacturer per‑app override (see [`OVERRIDE_MIN_ASPECT_RATIO`](/guide/topics/large-screens/large-screen-compatibility-mode#override_min_aspect_ratio)) or, if no override has been applied or the app has disabled the override, the value in the app manifest.\n\nDisable the overrides\n\nAndroid 14 QPR1 supports the following [`PackageManager.Property`](/reference/android/content/pm/PackageManager.Property) tags, which enable you to disable or modify the aspect ratio configuration menu on devices that have implemented the override:\n| **Note:** The property tags are Jetpack WindowManager [WindowProperties](/reference/kotlin/androidx/window/WindowProperties) constants, which may not be available or tested on all devices.\n\n\u003cbr /\u003e\n\n- **PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE**\n\n To disable the user aspect ratio compatibility override, add the property to your app manifest and set the value to `false`: \n\n \u003capplication\u003e\n \u003cproperty\n android:name=\"android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE\"\n android:value=\"false\"/\u003e\n \u003c/application\u003e\n\n On devices that have implemented the configuration menu, your app is excluded from the list of apps in device settings; and so, users are not able to override the app's aspect ratio.\n\n Setting the property to `true` has no effect.\n\n \u003cbr /\u003e\n\n- **PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE**\n\n To disable the full-screen option of the user aspect ratio compatibility override, add the property to your app manifest and set the value to `false`: \n\n \u003capplication\u003e\n \u003cproperty\n android:name=\"android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE\"\n android:value=\"false\"/\u003e\n \u003c/application\u003e\n\n On devices that have implemented the configuration menu, the full‑screen option is removed from the list of aspect ratio options in device settings. Users are not able to apply the full‑screen override to your app.\n\n Setting this property to `true` has no effect.\n | **Caution:** If [`PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE`](#aspect_ratio_override) is set to `false`, this property has no effect.\n\n| **Note:** To implement the property tags, your app must include the Jetpack [WindowManager](/jetpack/androidx/releases/window) library dependency.\n\n**Optimize your app for large screens:** Don't set aspect ratio restrictions in your app. Use [window size classes](/develop/ui/compose/layouts/adaptive/window-size-classes) to support different layouts based on the amount of available display space."]]
