To help OEM partners address hardware-related large-screen app compatibility issues for per-device customizations, the system supports the following large-screen configuration overlays:
- Display: Configuration settings that affect display-level configuration.
- Aspect ratio: Configuration settings that affect activity-level window configuration for aspect ratio.
- Camera: Configuration settings that affect apps upon the
onCameraOpenedcallback. These settings can affect display, activity, and camera configuration. - Background and UI: Configuration settings applied to the surface of the letterbox layer for UI customization, or at the activity level.
- Reachability and positioning: Configuration settings applied to activity-level window configuration for accessibility.
- Settings: Configuration settings for customizing and enabling user aspect ratio settings in Settings > Apps > Aspect ratio.
- Education: Configuration settings for educating users about app compatibility features.
Override default configuration
To override the default configuration, create an XML file to replace the
default resource overlay for the device. If a resource overlay exists for a
specific device type, the resource overlay replaces the default AOSP resource
value. For example, to overlay resources for the Settings app, located
at /packages/app/Settings, create a resource overlay for a device
at
vendor/DEVICE_NAME/overlay/packages/app/Settings,
where DEVICE_NAME is the device name that uses the
overlay value. Resource values at build time override the resources with the
same name.
For more information, see Resource overlay.