GeckoView API Changelog.

⚠️ breaking change

v71

• Added onBooleanScalar, onLongScalar, onStringScalar to RuntimeTelemetry.Delegate to support scalars in streaming telemetry. ⚠️ As part of this change, onTelemetryReceived has been renamed to onHistogram, and Metric now takes a type parameter. (bug 1576730)
• Added overloads of GeckoSession.loadUri that accept a map of additional HTTP request headers. (bug 1567549)
• Added support for exposing the content blocking log in ContentBlockingController. (bug 1580201)
• ⚠️ Added nativeApp to WebExtension.MessageDelegate.onMessage which exposes the native application identifier that was used to send the message. (bug 1546445)
• Added GeckoRuntime.ServiceWorkerDelegate set via setServiceWorkerDelegate to support ServiceWorkerClients.openWindow (bug 1511033)
• Added GeckoRuntimeSettings.Builder#aboutConfigEnabled to control whether or not about:config should be available. (bug 1540065)
• Added GeckoSession.ContentDelegate.onFirstContentfulPaint (bug 1578947)
• Added setEnhancedTrackingProtectionLevel to [ContentBlocking.Settings][71.14]. (bug 1580854)
• ⚠️ Added GeckoView.onTouchEventForResult and modified PanZoomController.onTouchEvent to return how the touch event was handled. This allows apps to know if an event is handled by touch event listeners in web content. The methods in PanZoomController now return int instead of boolean.
• Added GeckoSession.purgeHistory allowing apps to clear a session’s history. (bug 1583265)
• Added GeckoRuntimeSettings.Builder#forceUserScalableEnabled to control whether or not to force user scalable zooming. (bug 1540615)
• ⚠️ Moved Autofill related methods from SessionTextInput and GeckoSession.TextInputDelegate into GeckoSession and AutofillDelegate.
• Added GeckoSession.getAutofillElements(), which is a new method for getting an autofill virtual structure without using ViewStructure. It relies on a new class, AutofillElement, for representing the virtual tree.
• Added GeckoView.setAutofillEnabled for controlling whether or not the GeckoView instance participates in Android autofill. When enabled, this connects an AutofillDelegate to the session it holds.
• Changed AutofillElement.children interface to Collection to provide an efficient way to pre-allocate memory when filling ViewStructure.

v70

• Added API for session context assignment GeckoSessionSettings.Builder.contextId and deletion of data related to a session context StorageController.clearDataForSessionContext. (bug 1501108)
• Removed setSession(session, runtime) from GeckoView. With this change, GeckoView will no longer manage opening/closing of the GeckoSession and instead leave that up to the app. It’s also now allowed to call setSession with a closed GeckoSession. (bug 1510314)
• Added an overload of GeckoSession.loadUri() that accepts a referring GeckoSession. This should be used when the URI we’re loading originates from another page. A common example of this would be long pressing a link and then opening that in a new GeckoSession. (bug 1561079)
• Added capture parameter to onFilePrompt and corresponding CAPTURE_TYPE_* constants. (bug 1553603)
• Removed the obsolete success parameter from CrashReporter#sendCrashReport(Context, File, File, String) and CrashReporter#sendCrashReport(Context, File, Map, String). (bug 1570789)
• Add GeckoSession.LOAD_FLAGS_REPLACE_HISTORY. (bug 1571088)
• Complete rewrite of PromptDelegate. (bug 1499394)
• Added RuntimeTelemetry.Delegate that receives streaming telemetry data from GeckoView. (bug 1566367)
• Updated ContentBlocking to better report blocked and allowed ETP events. (bug 1567268)
• Added API for controlling Gecko logging GeckoRuntimeSettings.debugLogging (bug 1573304)
• Added WebNotification and WebNotificationDelegate for handling Web Notifications. (bug 1533057)
• Added Social Tracking Protection support to ContentBlocking. (bug 1568295)
• Added WebExtensionController and WebExtensionController.TabDelegate to handle browser.tabs.create calls by WebExtensions. (bug 1539144)
• Added onCloseTab to WebExtensionController.TabDelegate to handle browser.tabs.remove calls by WebExtensions. (bug 1565782)
• Added onSlowScript to ContentDelegate which allows handling of slow and hung scripts. (bug 1621094)
• Added support for Web Push via WebPushController, WebPushDelegate, and WebPushSubscription.
• Added ContentBlockingController, accessible via GeckoRuntime.getContentBlockingController to allow modification and inspection of a content blocking exception list.

v69

• Modified behavior of ‘setAutomaticFontSizeAdjustment’ so that it no longer has any effect on ‘setFontInflationEnabled’
• Add GeckoSession.LOAD_FLAGS_FORCE_ALLOW_DATA_URI
• Added GeckoResult.accept for consuming a result without transforming it.
• GeckoSession.setMessageDelegate callers must now specify the WebExtension that the MessageDelegate will receive messages from.
• Created onKill to ContentDelegate to differentiate from crashes.

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_AD 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>.