org.mozilla.geckoview

Class GeckoRuntimeSettings

Object

org.mozilla.geckoview.RuntimeSettings

org.mozilla.geckoview.GeckoRuntimeSettings

All Implemented Interfaces:

Parcelable

@AnyThread
public final class GeckoRuntimeSettings
extends RuntimeSettings

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GeckoRuntimeSettings.Builder Settings builder used to construct the settings object.

Nested classes/interfaces inherited from interface android.os.Parcelable

Parcelable.ClassLoaderCreator<T>, Parcelable.Creator<T>

Field Summary

Fields

Modifier and Type	Field and Description
static int	COLOR_SCHEME_DARK A dark theme for web content is preferred.
static int	COLOR_SCHEME_LIGHT A light theme for web content is preferred.
static int	COLOR_SCHEME_SYSTEM The preferred color scheme will be based on system settings.
static Parcelable.Creator<GeckoRuntimeSettings>	CREATOR

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Method Summary

Modifier and Type	Method and Description
boolean	getAboutConfigEnabled() Gets whether about:config is enabled or not.
String[]	getArguments() Get the custom Gecko process arguments.
boolean	getAutomaticFontSizeAdjustment() Get whether or not the font sizes for web content are automatically adjusted to match the device's system font scale setting.
String	getConfigFilePath() Path to configuration file from which GeckoView will read configuration options such as Gecko process arguments, environment variables, and preferences.
boolean	getConsoleOutputEnabled() Get whether or not web console messages are sent to logcat.
ContentBlocking.Settings	getContentBlocking()
Class<? extends Service>	getCrashHandler()
Float	getDisplayDensityOverride() Gets the display density override value.
Integer	getDisplayDpiOverride() Gets the display DPI override value.
boolean	getDoubleTapZoomingEnabled() Gets whether double-tap zooming is enabled.
Bundle	getExtras() Get the custom Gecko intent extras.
boolean	getFontInflationEnabled() Get whether or not font inflation for non mobile-friendly pages is currently enabled.
float	getFontSizeFactor() Gets the currently applied font size factor.
boolean	getForceUserScalableEnabled() Gets whether or not force user scalable zooming should be enabled or not.
int	getGlMsaaLevel() Gets the current WebGL MSAA level.
boolean	getInputAutoZoomEnabled() Gets whether auto-zoom to editable fields is enabled.
boolean	getJavaScriptEnabled() Get whether JavaScript support is enabled.
String[]	getLocales() Gets the list of requested locales.
boolean	getLoginAutofillEnabled() Get whether login form autofill is enabled.
boolean	getPauseForDebuggerEnabled() Gets whether the pause-for-debugger is enabled or not.
int	getPreferredColorScheme() Gets the preferred color scheme override for web content.
boolean	getRemoteDebuggingEnabled() Get whether remote debugging support is enabled.
GeckoRuntime	getRuntime()
Rect	getScreenSizeOverride() Gets the screen size override value.
RuntimeTelemetry.Delegate	getTelemetryDelegate()
boolean	getUseMaxScreenDepth() Gets whether the compositor should use the maximum screen depth when rendering.
boolean	getUseMultiprocess() Deprecated. This method will be removed in GeckoView 82, at which point GeckoView will only operate in multiprocess mode.
boolean	getWebFontsEnabled() Get whether web fonts support is enabled.
boolean	getWebManifestEnabled() Get whether or not Web Manifest processing support is enabled.
void	readFromParcel(Parcel source)
GeckoRuntimeSettings	setAboutConfigEnabled(boolean flag) Sets whether or not about:config should be enabled.
GeckoRuntimeSettings	setAutomaticFontSizeAdjustment(boolean enabled) Set whether or not font sizes in web content should be automatically scaled according to the device's current system font scale setting.
GeckoRuntimeSettings	setConsoleOutputEnabled(boolean enabled) Set whether or not web console messages should go to logcat.
GeckoRuntimeSettings	setDoubleTapZoomingEnabled(boolean flag) Sets whether double tap zooming is enabled.
GeckoRuntimeSettings	setFontInflationEnabled(boolean enabled) Set whether or not font inflation for non mobile-friendly pages should be enabled.
GeckoRuntimeSettings	setFontSizeFactor(float fontSizeFactor) Set a font size factor that will operate as a global text zoom.
GeckoRuntimeSettings	setForceUserScalableEnabled(boolean flag) Sets whether or not pinch-zooming should be enabled when user-scalable=no is set on the viewport.
GeckoRuntimeSettings	setGlMsaaLevel(int level) Sets the WebGL MSAA level.
GeckoRuntimeSettings	setInputAutoZoomEnabled(boolean flag) Set whether auto-zoom to editable fields should be enabled.
GeckoRuntimeSettings	setJavaScriptEnabled(boolean flag) Set whether JavaScript support should be enabled.
void	setLocales(String[] requestedLocales) Set the locale.
GeckoRuntimeSettings	setLoginAutofillEnabled(boolean enabled) Set whether login forms should be filled automatically if only one viable candidate is provided via onLoginFetch.
GeckoRuntimeSettings	setPreferredColorScheme(int scheme) Sets the preferred color scheme override for web content.
GeckoRuntimeSettings	setRemoteDebuggingEnabled(boolean enabled) Set whether remote debugging support should be enabled.
GeckoRuntimeSettings	setWebFontsEnabled(boolean flag) Set whether support for web fonts should be enabled.
GeckoRuntimeSettings	setWebManifestEnabled(boolean enabled) Sets whether Web Manifest processing support is enabled.
void	writeToParcel(Parcel out, int flags)

Methods inherited from class org.mozilla.geckoview.RuntimeSettings

describeContents, updatePrefs

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

COLOR_SCHEME_LIGHT

public static final int COLOR_SCHEME_LIGHT

A light theme for web content is preferred.

See Also:

Constant Field Values

COLOR_SCHEME_DARK

public static final int COLOR_SCHEME_DARK

A dark theme for web content is preferred.

See Also:

Constant Field Values

COLOR_SCHEME_SYSTEM

public static final int COLOR_SCHEME_SYSTEM

The preferred color scheme will be based on system settings.

See Also:

Constant Field Values

CREATOR

public static final Parcelable.Creator<GeckoRuntimeSettings> CREATOR

Method Detail

getContentBlocking

@NonNull
public ContentBlocking.Settings getContentBlocking()

getRuntime

@Nullable
public GeckoRuntime getRuntime()

getUseMultiprocess

@Deprecated
public boolean getUseMultiprocess()

Deprecated. This method will be removed in GeckoView 82, at which point GeckoView will only operate in multiprocess mode.

Whether multiprocess is enabled.

Returns:

true if multiprocess is enabled, false otherwise.

getArguments

@NonNull
public String[] getArguments()

Get the custom Gecko process arguments.

Returns:

The Gecko process arguments.

getExtras

@NonNull
public Bundle getExtras()

Get the custom Gecko intent extras.

Returns:

The Gecko intent extras.

getConfigFilePath

@Nullable
public String getConfigFilePath()

Path to configuration file from which GeckoView will read configuration options such as Gecko process arguments, environment variables, and preferences.

Returns:

Path to configuration file from which GeckoView will read configuration options, or null for default location /data/local/tmp/$PACKAGE-geckoview-config.yaml.

getJavaScriptEnabled

public boolean getJavaScriptEnabled()

Get whether JavaScript support is enabled.

Returns:

Whether JavaScript support is enabled.

setJavaScriptEnabled

@NonNull
public GeckoRuntimeSettings setJavaScriptEnabled(boolean flag)

Set whether JavaScript support should be enabled.

Parameters:

flag - A flag determining whether JavaScript should be enabled.

Returns:

This GeckoRuntimeSettings instance.

getRemoteDebuggingEnabled

public boolean getRemoteDebuggingEnabled()

Get whether remote debugging support is enabled.

Returns:

True if remote debugging support is enabled.

setRemoteDebuggingEnabled

@NonNull
public GeckoRuntimeSettings setRemoteDebuggingEnabled(boolean enabled)

Set whether remote debugging support should be enabled.

Parameters:

enabled - True if remote debugging should be enabled.

Returns:

This GeckoRuntimeSettings instance.

getWebFontsEnabled

public boolean getWebFontsEnabled()

Get whether web fonts support is enabled.

Returns:

Whether web fonts support is enabled.

setWebFontsEnabled

@NonNull
public GeckoRuntimeSettings setWebFontsEnabled(boolean flag)

Set whether support for web fonts should be enabled.

Parameters:

flag - A flag determining whether web fonts should be enabled.

Returns:

This GeckoRuntimeSettings instance.

getPauseForDebuggerEnabled

public boolean getPauseForDebuggerEnabled()

Gets whether the pause-for-debugger is enabled or not.

Returns:

True if the pause is enabled.

getUseMaxScreenDepth

public boolean getUseMaxScreenDepth()

Gets whether the compositor should use the maximum screen depth when rendering.

Returns:

True if the maximum screen depth should be used.

getDisplayDensityOverride

@Nullable
public Float getDisplayDensityOverride()

Gets the display density override value.

Returns:

Returns a positive number. Will return null if not set.

getDisplayDpiOverride

@Nullable
public Integer getDisplayDpiOverride()

Gets the display DPI override value.

Returns:

Returns a positive number. Will return null if not set.

getCrashHandler

@Nullable
public Class<? extends Service> getCrashHandler()

getScreenSizeOverride

@Nullable
public Rect getScreenSizeOverride()

Gets the screen size override value.

Returns:

Returns a Rect containing the dimensions to use for the window size. Will return null if not set.

getLocales

@Nullable
public String[] getLocales()

Gets the list of requested locales.

Returns:

A list of locale codes in Gecko format ("en" or "en-US").

setLocales

public void setLocales(@Nullable
                       String[] requestedLocales)

Set the locale.

Parameters:

requestedLocales - An ordered list of locales in Gecko format ("en-US").

setWebManifestEnabled

@NonNull
public GeckoRuntimeSettings setWebManifestEnabled(boolean enabled)

Sets whether Web Manifest processing support is enabled.

Parameters:

enabled - A flag determining whether Web Manifest processing support is enabled.

Returns:

This GeckoRuntimeSettings instance.

getWebManifestEnabled

public boolean getWebManifestEnabled()

Get whether or not Web Manifest processing support is enabled.

Returns:

True if web manifest processing support is enabled.

setConsoleOutputEnabled

@NonNull
public GeckoRuntimeSettings setConsoleOutputEnabled(boolean enabled)

Set whether or not web console messages should go to logcat. Note: If enabled, Gecko performance may be negatively impacted if content makes heavy use of the console API.

Parameters:

enabled - A flag determining whether or not web console messages should be printed to logcat.

Returns:

This GeckoRuntimeSettings instance.

getConsoleOutputEnabled

public boolean getConsoleOutputEnabled()

Get whether or not web console messages are sent to logcat.

Returns:

True if console output is enabled.

setAutomaticFontSizeAdjustment

@NonNull
public GeckoRuntimeSettings setAutomaticFontSizeAdjustment(boolean enabled)

Set whether or not font sizes in web content should be automatically scaled according to the device's current system font scale setting. Enabling this will prevent modification of the font size factor. Disabling this setting will restore the previously used value for the font size factor.

Parameters:

enabled - A flag determining whether or not font sizes should be scaled automatically to match the device's system font scale.

Returns:

This GeckoRuntimeSettings instance.

getAutomaticFontSizeAdjustment

public boolean getAutomaticFontSizeAdjustment()

Get whether or not the font sizes for web content are automatically adjusted to match the device's system font scale setting.

Returns:

True if font sizes are automatically adjusted.

setFontSizeFactor

@NonNull
public GeckoRuntimeSettings setFontSizeFactor(float fontSizeFactor)

Set a font size factor that will operate as a global text zoom. All font sizes will be multiplied by this factor.

The default factor is 1.0.

Currently, any changes only take effect after a reload of the session.

This setting cannot be modified while automatic font size adjustment is enabled.

Parameters:

fontSizeFactor - The factor to be used for scaling all text. Setting a value of 0 disables both this feature and font inflation.

Returns:

This GeckoRuntimeSettings instance.

getFontSizeFactor

public float getFontSizeFactor()

Gets the currently applied font size factor.

Returns:

The currently applied font size factor.

setFontInflationEnabled

@NonNull
public GeckoRuntimeSettings setFontInflationEnabled(boolean enabled)

Set whether or not font inflation for non mobile-friendly pages should be enabled. The default value of this setting is false.

When enabled, font sizes will be increased on all pages that are lacking a <meta> viewport tag and have been loaded in a session using GeckoSessionSettings.VIEWPORT_MODE_MOBILE. To improve readability, the font inflation logic will attempt to increase font sizes for the main text content of the page only.

The magnitude of font inflation applied depends on the font size factor currently in use.

Currently, any changes only take effect after a reload of the session.

Parameters:

enabled - A flag determining whether or not font inflation should be enabled.

Returns:

This GeckoRuntimeSettings instance.

getFontInflationEnabled

public boolean getFontInflationEnabled()

Get whether or not font inflation for non mobile-friendly pages is currently enabled.

Returns:

True if font inflation is enabled.

getPreferredColorScheme

public int getPreferredColorScheme()

Gets the preferred color scheme override for web content.

Returns:

One of the COLOR_SCHEME_* constants.

setPreferredColorScheme

@NonNull
public GeckoRuntimeSettings setPreferredColorScheme(int scheme)

Sets the preferred color scheme override for web content.

Parameters:

scheme - The preferred color scheme. Must be one of the COLOR_SCHEME_* constants.

Returns:

This GeckoRuntimeSettings instance.

getInputAutoZoomEnabled

public boolean getInputAutoZoomEnabled()

Gets whether auto-zoom to editable fields is enabled.

Returns:

True if auto-zoom is enabled, false otherwise.

setInputAutoZoomEnabled

@NonNull
public GeckoRuntimeSettings setInputAutoZoomEnabled(boolean flag)

Set whether auto-zoom to editable fields should be enabled.

Parameters:

flag - True if auto-zoom should be enabled, false otherwise.

Returns:

This GeckoRuntimeSettings instance.

getDoubleTapZoomingEnabled

public boolean getDoubleTapZoomingEnabled()

Gets whether double-tap zooming is enabled.

Returns:

True if double-tap zooming is enabled, false otherwise.

setDoubleTapZoomingEnabled

@NonNull
public GeckoRuntimeSettings setDoubleTapZoomingEnabled(boolean flag)

Sets whether double tap zooming is enabled.

Parameters:

flag - true if double tap zooming should be enabled, false otherwise.

Returns:

This GeckoRuntimeSettings instance.

getGlMsaaLevel

public int getGlMsaaLevel()

Gets the current WebGL MSAA level.

Returns:

number of MSAA samples, 0 if MSAA is disabled.

setGlMsaaLevel

@NonNull
public GeckoRuntimeSettings setGlMsaaLevel(int level)

Sets the WebGL MSAA level.

Parameters:

level - number of MSAA samples, 0 if MSAA should be disabled.

Returns:

This GeckoRuntimeSettings instance.

getTelemetryDelegate

@Nullable
public RuntimeTelemetry.Delegate getTelemetryDelegate()

getAboutConfigEnabled

public boolean getAboutConfigEnabled()

Gets whether about:config is enabled or not.

Returns:

True if about:config is enabled, false otherwise.

setAboutConfigEnabled

@NonNull
public GeckoRuntimeSettings setAboutConfigEnabled(boolean flag)

Sets whether or not about:config should be enabled. This is a page that allows users to directly modify Gecko preferences. Modification of some preferences may cause the app to break in unpredictable ways -- crashes, performance issues, security vulnerabilities, etc.

Parameters:

flag - True if about:config should be enabled, false otherwise.

Returns:

This GeckoRuntimeSettings instance.

getForceUserScalableEnabled

public boolean getForceUserScalableEnabled()

Gets whether or not force user scalable zooming should be enabled or not.

Returns:

True if force user scalable zooming should be enabled, false otherwise.

setForceUserScalableEnabled

@NonNull
public GeckoRuntimeSettings setForceUserScalableEnabled(boolean flag)

Sets whether or not pinch-zooming should be enabled when user-scalable=no is set on the viewport.

Parameters:

flag - True if force user scalable zooming should be enabled, false otherwise.

Returns:

This GeckoRuntimeSettings instance.

getLoginAutofillEnabled

public boolean getLoginAutofillEnabled()

Get whether login form autofill is enabled.

Returns:

True if login autofill is enabled.

setLoginAutofillEnabled

@NonNull
public GeckoRuntimeSettings setLoginAutofillEnabled(boolean enabled)

Set whether login forms should be filled automatically if only one viable candidate is provided via onLoginFetch.

Parameters:

enabled - A flag determining whether login autofill should be enabled.

Returns:

The builder instance.

writeToParcel

public void writeToParcel(Parcel out,
                          int flags)

Specified by:

writeToParcel in interface Parcelable

Overrides:

writeToParcel in class RuntimeSettings

readFromParcel

public void readFromParcel(@NonNull
                           Parcel source)

Overrides:

readFromParcel in class RuntimeSettings