GeckoView API Changelog.

v68

• Added GeckoRuntime#configurationChanged to notify the device configuration has changed.

• Added onSessionStateChange to ProgressDelegate and removed saveState.

• Added ContentBlocking#AT_CRYPTOMINING for cryptocurrency miner blocking.

• Added ContentBlocking#AT_DEFAULT, ContentBlocking#AT_STRICT, ContentBlocking#CB_DEFAULT and ContentBlocking#CB_STRICT for clearer app default selections.

• Added GeckoSession.SessionState.fromString. This can be used to deserialize a GeckoSession.SessionState instance previously serialized to a String via GeckoSession.SessionState.toString.

• Added GeckoRuntimeSettings#setPreferredColorScheme to override the default color theme for web content (“light” or “dark”).

• Added @NonNull or @Nullable to all fields.

• RuntimeTelemetry#getSnapshots returns a JSONObject now.

• Removed all org.mozilla.gecko references in the API.

• Added ContentBlocking#AT_FINGERPRINTING to block fingerprinting trackers.

• Added HistoryItem and HistoryList interfaces and onHistoryStateChange to HistoryDelegate and added gotoHistoryIndex to GeckoSession.

• GeckoView will not create a GeckoSession anymore when attached to a window without a session.

• Added GeckoRuntimeSettings.Builder#configFilePath to set a path to a configuration file from which GeckoView will read configuration options such as Gecko process arguments, environment variables, and preferences.

• Added unregisterWebExtension to unregister a web extension.

• Added messaging support for WebExtension. setMessageDelegate allows embedders to listen to messages coming from a WebExtension. Port allows bidirectional communication between the embedder and the WebExtension.

• Expose the following prefs in GeckoRuntimeSettings: setAutoZoomEnabled, setDoubleTapZoomingEnabled, setGlMsaaLevel.

• Added new constant for requesting external storage Android permissions, PERMISSION_PERSISTENT_STORAGE

• Added setVerticalClipping to GeckoDisplay and GeckoView to tell Gecko how much of its vertical space is clipped.

• Added StorageController API for clearing data.

• Added onRecordingStatusChanged to MediaDelegate to handle events related to the status of recording devices.

• Removed redundant constants in MediaSource

v67

• Added setAutomaticFontSizeAdjustment to GeckoRuntimeSettings for automatically adjusting font size settings depending on the OS-level font size setting.

• Added setFontSizeFactor to GeckoRuntimeSettings for setting a font size scaling factor, and for enabling font inflation for non-mobile-friendly pages.

• Updated video autoplay API to reflect changes in Gecko. Instead of being a per-video permission in the PermissionDelegate, it is a runtime setting that either allows or blocks autoplay videos.

• Change ContentBlocking.AT_ALL and ContentBlocking.SB_ALL values to mirror the actual constants they encompass.

• Added nested ContentBlocking runtime settings.

• Added RuntimeSettings base class to support nested settings.

• Added baseUri to ContentDelegate.ContextElement and changed linkUri to absolute form.

• Added scrollBy and scrollTo to PanZoomController.

• Added GeckoSession.getDefaultUserAgent to expose the build-time default user agent synchronously.

• Changed WebResponse.body from a ByteBuffer to an InputStream. Apps that want access to the entire response body will now need to read the stream themselves.

• Added GeckoWebExecutor.FETCH_FLAGS_NO_REDIRECTS, which will cause GeckoWebExecutor.fetch() to not automatically follow HTTP redirects (e.g., 302).

• Moved GeckoVRManager into the org.mozilla.geckoview package.

• Initial WebExtension support. GeckoRuntime#registerWebExtension allows embedders to register a local web extension.

• Added API to GeckoView to take screenshot of the visible page. Calling capturePixels returns a ‘GeckoResult’ that completes to a Bitmap of the current Surface contents, or an IllegalStateException if the GeckoSession is not ready to render content.

• Added API to capture a screenshot to GeckoDisplay. capturePixels returns a ‘GeckoResult’ that completes to a Bitmap of the current Surface contents, or an IllegalStateException if the GeckoSession is not ready to render content.

• Add missing @Nullable annotation to return value for GeckoSession.PromptDelegate.ChoiceCallback.onPopupResult()

• Added default implementations for all non-functional interfaces.

• Added ContentDelegate.onWebAppManifest, which will deliver the contents of a parsed and validated Web App Manifest on pages that contain one.

v66

• Removed redundant field trackingMode from SecurityInformation. Use TrackingProtectionDelegate.onTrackerBlocked for notification of blocked elements during page load.

• Added @NonNull or @Nullable to all APIs.

• Added methods for each setting in GeckoSessionSettings

• Added GeckoSessionSettings for enabling desktop viewport. Desktop viewport is no longer set by USER_AGENT_MODE_DESKTOP and must be set separately.

• Added @UiThread to GeckoSession.releaseSession and GeckoSession.setSession

v65

• Added experimental ad-blocking category to GeckoSession.TrackingProtectionDelegate.

• Moved CompositorController, DynamicToolbarAnimator, OverscrollEdgeEffect, PanZoomController from org.mozilla.gecko.gfx to org.mozilla.geckoview

• Added @UiThread, @AnyThread annotations to all APIs

• Changed GeckoRuntimeSettings#getLocale to getLocales and related APIs.

• Merged org.mozilla.gecko.gfx.LayerSession into GeckoSession

• Added GeckoSession.MediaDelegate and MediaElement. This allow monitoring and control of web media elements (play, pause, seek, etc).

• Removed unused access parameter from GeckoSession.PermissionDelegate#onContentPermissionRequest

• Added WebMessage, WebRequest, WebResponse, and GeckoWebExecutor. This exposes Gecko networking to apps. It includes speculative connections, name resolution, and a Fetch-like HTTP API.

• Added GeckoSession.HistoryDelegate. This allows apps to implement their own history storage system and provide visited link status.

• Added ContentDelegate#onFirstComposite to get first composite callback after a compositor start.

• Changed LoadRequest.isUserTriggered to isRedirect.

• Added GeckoSession.LOAD_FLAGS_BYPASS_CLASSIFIER to bypass the URI classifier.

• Added a protected empty constructor to all field-only classes so that apps can mock these classes in tests.

• Added ContentDelegate.ContextElement to extend the information passed to ContentDelegate#onContextMenu. Extended information includes the element’s title and alt attributes.

• Changed ContentDelegate.ContextElement TYPE_ constants to public access.

• Changed ContentDelegate.ContextElement, GeckoSession.FinderResult to non-final class.

• Update CrashReporter#sendCrashReport to return the crash ID as a GeckoResult<String>.