Substituições por app de usuários em telas grandes
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Android oferece substituições que mudam o comportamento configurado dos apps.
Os fabricantes de dispositivos podem aplicar substituições a apps em dispositivos de tela grande selecionados. O QPR1 do Android 14 apresenta substituições de usuário, que permitem aplicar substituições a apps nas configurações do dispositivo.
As substituições por app têm o objetivo de melhorar a experiência do usuário em dispositivos de tela grande. Os apps podem desativar algumas substituições.
O Android 14 QPR1 apresenta um novo menu de configuração que permite aos usuários mudar a proporção dos apps para melhorar a exibição em telas grandes. O menu é implementado nas configurações do dispositivo em alguns aparelhos de tela grande.
Em dispositivos que implementaram o menu de configuração, os usuários escolhem em uma lista de apps e definem a proporção da tela do app para vários valores, como 4:3, 16:9 e tela cheia. Os valores de proporção da tela são configurados pelo fabricante do dispositivo. Os usuários também podem redefinir a proporção para o padrão do app, que é o valor especificado por uma substituição por app do fabricante do dispositivo (consulte OVERRIDE_MIN_ASPECT_RATIO) ou, se nenhuma substituição foi aplicada ou o app desativou a substituição, o valor no manifesto do app.
Desativar as substituições
O QPR1 do Android 14 é compatível com as seguintes tags PackageManager.Property, que permitem desativar ou modificar o menu de configuração da proporção da tela em dispositivos que implementaram a substituição:
PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE
Para desativar a substituição de compatibilidade de proporção da tela do usuário, adicione a propriedade ao manifesto do app e defina o valor como false:
Em dispositivos que implementaram o menu de configuração, o app é excluído da lista de apps nas configurações do dispositivo. Assim, os usuários não podem substituir a proporção da tela do app.
Para desativar a opção de tela cheia da substituição de compatibilidade de proporção da tela do usuário, adicione a propriedade ao manifesto do app e defina o valor como false:
Em dispositivos que implementaram o menu de configuração, a opção de tela cheia é removida da lista de opções de proporção da tela nas configurações do dispositivo. Os usuários não conseguem aplicar a substituição de tela cheia ao seu app.
Definir essa propriedade como true não tem efeito.
Otimize seu app para telas grandes:não defina restrições de proporção no seu app. Use classes de tamanho de janela para oferecer suporte a diferentes layouts com base no espaço de exibição disponível.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-08-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]