e842bb5c42
This patch adds engine support for translate and restoring the page after a translation. `requestTranslate` and `requestTranslationRestore` are the Gecko engine session functions. This corresponding actions for these functions are `TranslateAction`, and `TranslateRestoreAction`. The success and failure correspond to the actions `TranslateSuccessAction` and `TranslateExceptionAction`. Sample usage is provided on reference browser. The sample is currently hardcoded to support Spanish to English page translations until the next API is introduced.
Android Components > Browser > Engine-Gecko
Engine implementation based on GeckoView.
Usage
Setting up the dependency
Use Gradle to download the library from maven.mozilla.org (Setup repository):
implementation "org.mozilla.components:browser-engine-gecko:{latest-version}"
Integration with the Glean SDK
Before using this component
Products sending telemetry and using this component must request a data-review following this process.
The Glean SDK can be used to collect Gecko Telemetry. Applications using both this component and the Glean SDK should setup the Gecko Telemetry delegate as shown below:
val builder = GeckoRuntimeSettings.Builder()
val runtimeSettings = builder
.telemetryDelegate(GeckoGleanAdapter()) // Sets up the delegate!
.build()
// Create the Gecko runtime.
GeckoRuntime.create(context, runtimeSettings)
Adding new metrics
New Gecko metrics can be added as described in the Firefox Telemetry docs.
License
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/