Config glossary (Mason OS 10)
mason-core
disable_keyguard
os.configurations.mason-core.disable_keyguard
Flag indicating whether to disable the keyguard (lock screen). When set to true, the lock screen is disabled and the device goes directly to the home screen or kiosk app on wake.
Types: boolean
Default: true
disable_status_bar
os.configurations.mason-core.disable_status_bar
Flag indicating whether to disable the status bar. When disabled, the user cannot pull down the notification shade or access quick settings.
Types: boolean
Default: false
disable_camera
os.configurations.mason-core.disable_camera
Flag indicating whether to disable camera functionality on the device.
Types: boolean
Default: false
config_location_polling
os.configurations.mason-core.config_location_polling
Whether to report device location to the Mason Dashboard.
Types: boolean
Default: true
config_locate_check_frequency
os.configurations.mason-core.config_locate_check_frequency
Frequency (in hours) of location reports when config_location_polling is enabled.
Types: integer
Default: 24
config_lockscreen_clock_size
os.configurations.mason-core.config_lockscreen_clock_size
Controls the lockscreen clock display style. When set to dynamic, the clock is large when there are no notifications and shrinks when notifications are present. When set to small, the clock is always displayed in a compact single-line format.
Types: string
Values: dynamic, small
Default: dynamic
config_lock_screen_show_notifications
os.configurations.mason-core.config_lock_screen_show_notifications
Whether to show notifications on the lockscreen.
Types: boolean
Default: true
direct_boot_package
os.configurations.mason-core.direct_boot_package
Package name to launch as the default home/kiosk app in lock task mode. Empty string disables kiosk mode.
Types: string
Default: (empty)
lock_task_packages
os.configurations.mason-core.lock_task_packages
A list of package names that are allowed to use screen pinning (lock task mode) via setLockTaskMode() or lockTaskMode in their manifest.
Types: array of strings
autogrant_runtime_permissions_packages
os.configurations.mason-core.autogrant_runtime_permissions_packages
An array of package names of apps that will be granted all requested runtime permissions automatically. Each application must also declare these permissions in its AndroidManifest.xml. Use with care as this allows for privilege escalation.
Types: array of strings
hidden_packages
os.configurations.mason-core.hidden_packages
A list of package names to hide. When a package is hidden, it is unavailable for use but the data and package file remain on the device.
Types: array of strings
config_install_prompt_package
os.configurations.mason-core.config_install_prompt_package
Normally, OTA updates (for both project configurations as well as the operating system itself) are installed automatically by the system based upon the rules specified in the mason-core section of the project configuration YML.
This configuration allows you to specify the package name of an application that will instead be responsible for being notified of and subsequently initiating OTA installations.
If the package name represents a valid application currently on the device, that application will receive an intent broadcast from the system when it is time for an OTA installation. The broadcast action will be com.bymason.platform.INSTALL_UPDATE and the intent will contain a string extra named target_uuid which must be saved for later use.
It is then up to the application specified to communicate when it is ready to do the installation by using the Mason Framework SDK FotaManagerPrivileged class method, requestInstall(target_uuid).
Notes:
- The intent is sent just prior to when the system would have normally attempted an automatic installation. Hence, any install times or check frequencies specified in the
mason-coresection of the YML will still be in effect. - If this package name does not resolve to a valid application, the system will default to the usually configured behavior defined by
mason-coresection. - There should only ever be a single system update, so whenever a new target_uuid is provided via broadcast action, any previous one may be discarded.
- Once requestInstall(target_uuid) is called, the target_uuid should be discarded.
Types: string
Default: (empty)
mason-sysconfig
allow_in_power_save_packages
os.configurations.mason-sysconfig.allow_in_power_save_packages
A list of package names that are allowed to run in the background during battery saver (power save) mode. Packages in this list are exempt from app standby restrictions when battery saver is active.
Types: array of strings
android
config_showNavigationBar
os.configurations.android.config_showNavigationBar
Controls whether the on-screen navigation bar is displayed.
Types: boolean
Default: true
config_enableScreenshotChord
os.configurations.android.config_enableScreenshotChord
Controls whether the power + volume down screenshot shortcut is enabled.
Types: boolean
Default: true
config_globalActionsList
os.configurations.android.config_globalActionsList
A list of actions shown in the Global Actions dialog (long-press power menu). Possible values include: power, restart, screenshot, bugreport, lockdown, emergency.
Types: array of strings
config_cameraDoubleTapPowerGestureEnabled
os.configurations.android.config_cameraDoubleTapPowerGestureEnabled
Controls whether double-tapping the power button launches the camera.
Types: boolean
Default: true
config_criticalBatteryWarningLevel
os.configurations.android.config_criticalBatteryWarningLevel
The battery level (percentage) at which the device shows a critical battery warning.
Types: integer
Default: 10
config_defaultListenerAccessPackages
os.configurations.android.config_defaultListenerAccessPackages
Package name that is granted notification listener access by default.
Types: string
config_longPressOnPowerBehavior
os.configurations.android.config_longPressOnPowerBehavior
Defines the behavior when the power button is long-pressed. Values: 0 (nothing), 1 (global actions menu), 2 (power off), 3 (power off with confirmation), 4 (assistant).
Types: integer
Default: 1
config_shortPressOnPowerBehavior
os.configurations.android.config_shortPressOnPowerBehavior
Defines the behavior when the power button is short-pressed. Values: 0 (nothing), 1 (sleep), 2 (really sleep — ignore wake locks), 3 (really sleep and go home), 4 (sleep and go home), 5 (dismiss dream/screensaver).
Types: integer
Default: 1
config_supportAutoRotation
os.configurations.android.config_supportAutoRotation
Controls whether the device supports auto-rotation of the screen based on the accelerometer.
Types: boolean
Default: true
config_voice_capable
os.configurations.android.config_voice_capable
Flag indicating whether the device is voice capable. If true, the device supports circuit-switched (voice) phone calls and can display the in-call UI. If false, disables Mobile Network settings and AGPS location service.
Types: boolean
Default: true