org.mozilla.geckoview

Class WebExtensionController

Object

org.mozilla.geckoview.WebExtensionController

public class WebExtensionController
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WebExtensionController.EnableSource Contains the possible values for the source parameter in enable(org.mozilla.geckoview.WebExtension, int) and disable(org.mozilla.geckoview.WebExtension, int).
static interface	WebExtensionController.PromptDelegate This delegate will be called whenever an extension is about to be installed or it needs new permissions, e.g during an update or because it called permissions.request
static interface	WebExtensionController.TabDelegate

Method Summary

Modifier and Type	Method and Description
GeckoResult<WebExtension>	disable(WebExtension extension, int source) Disable an extension that is enabled.
GeckoResult<WebExtension>	enable(WebExtension extension, int source) Enable an extension that has been disabled.
WebExtensionController.PromptDelegate	getPromptDelegate()
WebExtensionController.TabDelegate	getTabDelegate()
GeckoResult<WebExtension>	install(String uri) Install an extension.
GeckoResult<List<WebExtension>>	list() List installed extensions for this GeckoRuntime.
void	setPromptDelegate(WebExtensionController.PromptDelegate delegate) Set the WebExtensionController.PromptDelegate for this instance.
void	setTabActive(GeckoSession session, boolean active) Notifies extensions about a active tab change over the `tabs.onActivated` event.
void	setTabDelegate(WebExtensionController.TabDelegate delegate)
GeckoResult<Void>	uninstall(WebExtension extension) Uninstall an extension.

Methods inherited from class Object

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

Method Detail

getTabDelegate

@UiThread
 @Nullable
public WebExtensionController.TabDelegate getTabDelegate()

setTabDelegate

@UiThread
public void setTabDelegate(@Nullable
                                     WebExtensionController.TabDelegate delegate)

getPromptDelegate

@UiThread
 @Nullable
public WebExtensionController.PromptDelegate getPromptDelegate()

Returns:

the current WebExtensionController.PromptDelegate instance.

See Also:

WebExtensionController.PromptDelegate

setPromptDelegate

@UiThread
public void setPromptDelegate(@Nullable
                                        WebExtensionController.PromptDelegate delegate)

Set the WebExtensionController.PromptDelegate for this instance. This delegate will be used to be notified whenever an extension is being installed or needs new permissions.

Parameters:

delegate - the delegate instance.

See Also:

WebExtensionController.PromptDelegate

install

@NonNull
 @AnyThread
public GeckoResult<WebExtension> install(@NonNull
                                                              String uri)

Install an extension. An installed extension will persist and will be available even when restarting the GeckoRuntime. Installed extensions through this method need to be signed by Mozilla, see Distributing your add-on . When calling this method, the GeckoView library will download the extension, validate its manifest and signature, and give you an opportunity to verify its permissions through installPrompt(org.mozilla.gecko.util.GeckoBundle, org.mozilla.gecko.util.EventCallback), you can use this method to prompt the user if appropriate.

Parameters:

uri - URI to the extension's .xpi package. This can be a remote https: URI or a local file: or resource: URI. Note: the app needs the appropriate permissions for local URIs.

Returns:

A GeckoResult that will complete when the installation process finishes. For successful installations, the GeckoResult will return the WebExtension object that you can use to set delegates and retrieve information about the WebExtension using WebExtension.metaData. If an error occurs during the installation process, the GeckoResult will complete exceptionally with a InstallException that will contain the relevant error code in InstallException#code.

See Also:

installPrompt(org.mozilla.gecko.util.GeckoBundle, org.mozilla.gecko.util.EventCallback), WebExtension.InstallException.ErrorCodes, WebExtension.metaData

uninstall

@NonNull
 @AnyThread
public GeckoResult<Void> uninstall(@NonNull
                                                        WebExtension extension)

Uninstall an extension. Uninstalling an extension will remove it from the current GeckoRuntime instance, delete all its data and trigger a request to close all extension pages currently open.

Parameters:

extension - The WebExtension to be uninstalled.

Returns:

A GeckoResult that will complete when the uninstall process is completed.

enable

@AnyThread
 @NonNull
public GeckoResult<WebExtension> enable(@NonNull
                                                             WebExtension extension,
                                                             int source)

Enable an extension that has been disabled. If the extension is already enabled, this method has no effect.

Parameters:

extension - The WebExtension to be enabled.

source - The agent that initiated this action, e.g. if the action has been initiated by the user,use WebExtensionController.EnableSource.USER.

Returns:

the new WebExtension instance, updated to reflect the enablement.

disable

@AnyThread
 @NonNull
public GeckoResult<WebExtension> disable(@NonNull
                                                              WebExtension extension,
                                                              int source)

Disable an extension that is enabled. If the extension is already disabled, this method has no effect.

Parameters:

extension - The WebExtension to be disabled.

source - The agent that initiated this action, e.g. if the action has been initiated by the user, use WebExtensionController.EnableSource.USER.

Returns:

the new WebExtension instance, updated to reflect the disablement.

list

@AnyThread
 @NonNull
public GeckoResult<List<WebExtension>> list()

List installed extensions for this GeckoRuntime. The returned list can be used to set delegates on the WebExtension objects using WebExtension.setActionDelegate(org.mozilla.geckoview.WebExtension.ActionDelegate), WebExtension.setMessageDelegate(org.mozilla.geckoview.WebExtension.MessageDelegate, java.lang.String).

Returns:

a GeckoResult that will resolve when the list of extensions is available.

setTabActive

@AnyThread
public void setTabActive(@NonNull
                                    GeckoSession session,
                                    boolean active)

Notifies extensions about a active tab change over the `tabs.onActivated` event.

Parameters:

session - The GeckoSession of the newly selected session/tab.

active - true if the tab became active, false if the tab became inactive.