GeckoRuntime (geckoview 88.0.20210303041649 API)

Object
- org.mozilla.geckoview.GeckoRuntime

All Implemented Interfaces:: Parcelable

public final class GeckoRuntime
extends Object
implements Parcelable

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`GeckoRuntime.ActivityDelegate` This is used to allow GeckoRuntime to start activities via the embedding application (and `Activity`).
`static interface`	`GeckoRuntime.Delegate`
`static interface`	`GeckoRuntime.ServiceWorkerDelegate`

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 String`	`ACTION_CRASHED` Intent action sent to the crash handler when a crash is encountered.
`static Parcelable.Creator<GeckoRuntime>`	`CREATOR`
`static String`	`EXTRA_CRASH_FATAL` This is a key for extra data sent with `ACTION_CRASHED`.
`static String`	`EXTRA_EXTRAS_PATH` This is a key for extra data sent with `ACTION_CRASHED`.
`static String`	`EXTRA_MINIDUMP_PATH` This is a key for extra data sent with `ACTION_CRASHED`.

Fields inherited from interface android.os.Parcelable
CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`appendAppNotesToCrashReport(String notes)` Appends notes to crash report.
`void`	`attachTo(Context context)` Attach the runtime to the given context.
`void`	`configurationChanged(Configuration newConfig)` Notify Gecko that the device configuration has changed.
`static GeckoRuntime`	`create(Context context)` Create a new runtime with default settings and attach it to the given context.
`static GeckoRuntime`	`create(Context context, GeckoRuntimeSettings settings)` Create a new runtime with the given settings and attach it to the given context.
`int`	`describeContents()`
`GeckoRuntime.ActivityDelegate`	`getActivityDelegate()` Get the `GeckoRuntime.ActivityDelegate` instance set on this runtime, if any,
`ContentBlockingController`	`getContentBlockingController()` Returns the ContentBlockingController for this GeckoRuntime.
`static GeckoRuntime`	`getDefault(Context context)` Get the default runtime for the given context.
`GeckoRuntime.Delegate`	`getDelegate()` Returns the current delegate, if any.
`Autocomplete.LoginStorageDelegate`	`getLoginStorageDelegate()` Get the `Autocomplete.LoginStorageDelegate` instance set on this runtime.
`File`	`getProfileDir()` Get the profile directory for this runtime.
`ProfilerController`	`getProfilerController()` Returns a ProfilerController for this GeckoRuntime.
`GeckoRuntimeSettings`	`getSettings()`
`StorageController`	`getStorageController()` Get the storage controller for this runtime.
`WebExtensionController`	`getWebExtensionController()` Returns a WebExtensionController for this GeckoRuntime.
`WebNotificationDelegate`	`getWebNotificationDelegate()` Returns the current WebNotificationDelegate, if any
`WebPushController`	`getWebPushController()` Get the Web Push controller for this runtime.
`void`	`orientationChanged()` Notify Gecko that the screen orientation has changed.
`void`	`orientationChanged(int newOrientation)` Notify Gecko that the screen orientation has changed.
`void`	`readFromParcel(Parcel source)`
`void`	`setActivityDelegate(GeckoRuntime.ActivityDelegate delegate)` Set the `GeckoRuntime.ActivityDelegate` instance on this runtime.
`void`	`setDelegate(GeckoRuntime.Delegate delegate)` Set a delegate for receiving callbacks relevant to to this GeckoRuntime.
`void`	`setLoginStorageDelegate(Autocomplete.LoginStorageDelegate delegate)` Set the `Autocomplete.LoginStorageDelegate` instance on this runtime.
`void`	`setServiceWorkerDelegate(GeckoRuntime.ServiceWorkerDelegate serviceWorkerDelegate)` Sets the `GeckoRuntime.ServiceWorkerDelegate` to be used for Service Worker requests.
`void`	`setWebNotificationDelegate(WebNotificationDelegate delegate)` Sets the delegate to be used for handling Web Notifications.
`void`	`shutdown()` Shutdown the runtime.
`void`	`writeToParcel(Parcel out, int flags)`

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ACTION_CRASHED
```
public static final String ACTION_CRASHED
```
    Intent action sent to the crash handler when a crash is encountered.
    
    See Also:
    
    GeckoRuntimeSettings.Builder.crashHandler(Class), Constant Field Values
  - EXTRA_MINIDUMP_PATH
```
public static final String EXTRA_MINIDUMP_PATH
```
    This is a key for extra data sent with ACTION_CRASHED. It refers to a String with the path to a Breakpad minidump file containing information about the crash. Several crash reporters are able to ingest this in a crash report, including Sentry and Mozilla's Socorro.
    
    Be aware, the minidump can contain personally identifiable information. Ensure you are obeying all applicable laws and policies before sending this to a remote server.
    
    See Also:
    
    GeckoRuntimeSettings.Builder.crashHandler(Class), Constant Field Values
  - EXTRA_EXTRAS_PATH
```
public static final String EXTRA_EXTRAS_PATH
```
    This is a key for extra data sent with ACTION_CRASHED. It refers to a string with the path to a file containing extra metadata about the crash. The file contains key-value pairs in the form
```
Key=Value
```
    Be aware, it may contain sensitive data such as the URI that was loaded at the time of the crash.
    See Also:
    
    Constant Field Values
  - EXTRA_CRASH_FATAL
```
public static final String EXTRA_CRASH_FATAL
```
    This is a key for extra data sent with ACTION_CRASHED. The value is a boolean indicating whether or not the crash was fatal or not. If true, the main application process was affected by the crash. If false, only an internal process used by Gecko has crashed and the application may be able to recover.
    
    See Also:
    
    GeckoSession.ContentDelegate.onCrash(GeckoSession), Constant Field Values
  - CREATOR
```
public static final Parcelable.Creator<GeckoRuntime> CREATOR
```
- Method Detail
  - getDefault
```
@UiThread
 @NonNull
public static GeckoRuntime getDefault(@NonNull
                                                          Context context)
```
    Get the default runtime for the given context. This will create and initialize the runtime with the default settings. Note: Only use this for session-less apps. For regular apps, use create() instead.
    
    Parameters:
    
    context - An application context for the default runtime.
    
    Returns:
    
    The (static) default runtime for the context.
  - attachTo
```
@UiThread
public void attachTo(@NonNull
                               Context context)
```
    Attach the runtime to the given context.
    
    Parameters:
    
    context - The new context to attach to.
  - create
```
@UiThread
 @NonNull
public static GeckoRuntime create(@NonNull
                                                      Context context)
```
    Create a new runtime with default settings and attach it to the given context. Create will throw if there is already an active Gecko instance running, to prevent that, bind the runtime to the process lifetime instead of the activity lifetime.
    
    Parameters:
    
    context - The context of the runtime.
    
    Returns:
    
    An initialized runtime.
  - getWebExtensionController
```
@UiThread
 @NonNull
public WebExtensionController getWebExtensionController()
```
    Returns a WebExtensionController for this GeckoRuntime.
    
    Returns:
    
    an instance of WebExtensionController.
  - getContentBlockingController
```
@UiThread
 @NonNull
public ContentBlockingController getContentBlockingController()
```
    Returns the ContentBlockingController for this GeckoRuntime.
    
    Returns:
    
    An instance of ContentBlockingController.
  - getProfilerController
```
@UiThread
 @NonNull
public ProfilerController getProfilerController()
```
    Returns a ProfilerController for this GeckoRuntime.
    
    Returns:
    
    an instance of ProfilerController.
  - create
```
@UiThread
 @NonNull
public static GeckoRuntime create(@NonNull
                                                      Context context,
                                                      @NonNull
                                                      GeckoRuntimeSettings settings)
```
    Create a new runtime with the given settings and attach it to the given context. Create will throw if there is already an active Gecko instance running, to prevent that, bind the runtime to the process lifetime instead of the activity lifetime.
    
    Parameters:
    
    context - The context of the runtime.
    
    settings - The settings for the runtime.
    
    Returns:
    
    An initialized runtime.
  - shutdown
```
@AnyThread
public void shutdown()
```
    Shutdown the runtime. This will invalidate all attached sessions.
  - setDelegate
```
@UiThread
public void setDelegate(@Nullable
                                  GeckoRuntime.Delegate delegate)
```
    Set a delegate for receiving callbacks relevant to to this GeckoRuntime.
    
    Parameters:
    
    delegate - an implementation of GeckoRuntime.Delegate.
  - getDelegate
```
@UiThread
 @Nullable
public GeckoRuntime.Delegate getDelegate()
```
    Returns the current delegate, if any.
    
    Returns:
    
    an instance of GeckoRuntime.Delegate or null if no delegate has been set.
  - setLoginStorageDelegate
```
@UiThread
public void setLoginStorageDelegate(@Nullable
                                              Autocomplete.LoginStorageDelegate delegate)
```
    Set the Autocomplete.LoginStorageDelegate instance on this runtime. This delegate is required for handling login storage requests.
    
    Parameters:
    
    delegate - The Autocomplete.LoginStorageDelegate handling login storage requests.
  - getLoginStorageDelegate
```
@UiThread
 @Nullable
public Autocomplete.LoginStorageDelegate getLoginStorageDelegate()
```
    Get the Autocomplete.LoginStorageDelegate instance set on this runtime.
    
    Returns:
    
    The Autocomplete.LoginStorageDelegate set on this runtime.
  - setServiceWorkerDelegate
```
@UiThread
public void setServiceWorkerDelegate(@Nullable
                                               GeckoRuntime.ServiceWorkerDelegate serviceWorkerDelegate)
```
    Sets the GeckoRuntime.ServiceWorkerDelegate to be used for Service Worker requests.
    
    Parameters:
    
    serviceWorkerDelegate - An instance of GeckoRuntime.ServiceWorkerDelegate.
    
    See Also:
    
    Service Worker API
  - setWebNotificationDelegate
```
@UiThread
public void setWebNotificationDelegate(@Nullable
                                                 WebNotificationDelegate delegate)
```
    Sets the delegate to be used for handling Web Notifications.
    
    Parameters:
    
    delegate - An instance of WebNotificationDelegate.
    
    See Also:
    
    Web Notifications
  - getWebNotificationDelegate
```
@UiThread
 @Nullable
public WebNotificationDelegate getWebNotificationDelegate()
```
    Returns the current WebNotificationDelegate, if any
    
    Returns:
    
    an instance of WebNotificationDelegate or null if no delegate has been set
  - setActivityDelegate
```
@UiThread
public void setActivityDelegate(@Nullable
                                          GeckoRuntime.ActivityDelegate delegate)
```
    Set the GeckoRuntime.ActivityDelegate instance on this runtime. This delegate is used to provide GeckoView support for launching external activities and receiving results from those activities.
    
    Parameters:
    
    delegate - The GeckoRuntime.ActivityDelegate handling intent launching requests.
  - getActivityDelegate
```
@UiThread
 @Nullable
public GeckoRuntime.ActivityDelegate getActivityDelegate()
```
    Get the GeckoRuntime.ActivityDelegate instance set on this runtime, if any,
    
    Returns:
    
    The GeckoRuntime.ActivityDelegate set on this runtime.
  - getSettings
```
@AnyThread
 @NonNull
public GeckoRuntimeSettings getSettings()
```
  - getProfileDir
```
@UiThread
 @Nullable
public File getProfileDir()
```
    Get the profile directory for this runtime. This is where Gecko stores internal data.
    
    Returns:
    
    Profile directory
  - orientationChanged
```
@UiThread
public void orientationChanged()
```
    Notify Gecko that the screen orientation has changed.
  - configurationChanged
```
@UiThread
public void configurationChanged(@NonNull
                                           Configuration newConfig)
```
    Notify Gecko that the device configuration has changed.
    
    Parameters:
    
    newConfig - The new Configuration object, Configuration.
  - orientationChanged
```
@UiThread
public void orientationChanged(int newOrientation)
```
    Notify Gecko that the screen orientation has changed.
    
    Parameters:
    
    newOrientation - The new screen orientation, as retrieved e.g. from the current Configuration.
  - getStorageController
```
@UiThread
 @NonNull
public StorageController getStorageController()
```
    Get the storage controller for this runtime. The storage controller can be used to manage persistent storage data accumulated by GeckoSession.
    
    Returns:
    
    The StorageController for this instance.
  - getWebPushController
```
@UiThread
 @NonNull
public WebPushController getWebPushController()
```
    Get the Web Push controller for this runtime. The Web Push controller can be used to allow content to use the Web Push API.
    
    Returns:
    
    The WebPushController for this instance.
  - appendAppNotesToCrashReport
```
@AnyThread
public void appendAppNotesToCrashReport(@NonNull
                                                   String notes)
```
    Appends notes to crash report.
    
    Parameters:
    
    notes - The application notes to append to the crash report.
  - describeContents
```
@AnyThread
public int describeContents()
```
    Specified by:
    
    describeContents in interface Parcelable
  - writeToParcel
```
@AnyThread
public void writeToParcel(Parcel out,
                                     int flags)
```
    Specified by:
    
    writeToParcel in interface Parcelable
  - readFromParcel
```
@AnyThread
public void readFromParcel(@NonNull
                                      Parcel source)
```

Class GeckoRuntime

Nested Class Summary

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

Field Summary

Fields inherited from interface android.os.Parcelable

Method Summary

Methods inherited from class Object

Field Detail

ACTION_CRASHED

EXTRA_MINIDUMP_PATH

EXTRA_EXTRAS_PATH

EXTRA_CRASH_FATAL

CREATOR

Method Detail

getDefault

attachTo

create

getWebExtensionController

getContentBlockingController

getProfilerController

create

shutdown

setDelegate

getDelegate

setLoginStorageDelegate

getLoginStorageDelegate

setServiceWorkerDelegate

setWebNotificationDelegate

getWebNotificationDelegate

setActivityDelegate

getActivityDelegate

getSettings

getProfileDir

orientationChanged

configurationChanged

orientationChanged

getStorageController

getWebPushController

appendAppNotesToCrashReport

describeContents

writeToParcel

readFromParcel