GeckoView API Changelog.

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)

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.
• Added WebExtensionController and TabDelegate to handle browser.tabs.create calls by WebExtensions.
• Created onKill to ContentDelegate to differentiate from crashes.
• Added onCloseTab to WebExtensionController.TabDelegate to handle browser.tabs.remove calls by WebExtensions.

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