mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-18 07:45:30 +00:00
Bug 1649094 - [geckodriver] Update of release documentation for 0.28.0. r=webdriver-reviewers,jgraham
Differential Revision: https://phabricator.services.mozilla.com/D95073
This commit is contained in:
parent
9bcfe67ea4
commit
ae095ec86d
@ -1,8 +1,43 @@
|
||||
Change log
|
||||
==========
|
||||
|
||||
All notable changes to this program is documented in this file.
|
||||
All notable changes to this program are documented in this file.
|
||||
|
||||
0.28.0 (2020-11-02)
|
||||
--------------------
|
||||
|
||||
### Known problems
|
||||
|
||||
- _macOS 10.15 (Catalina):_
|
||||
|
||||
Due to the requirement from Apple that all programs must be
|
||||
notarized, geckodriver will not work on Catalina if you manually
|
||||
download it through another notarized program, such as Firefox.
|
||||
|
||||
Whilst we are working on a repackaging fix for this problem, you can
|
||||
find more details on how to work around this issue in the [macOS
|
||||
notarization] section of the documentation.
|
||||
|
||||
### Added
|
||||
|
||||
- The command line flag `--android-storage` has been added, to allow geckodriver
|
||||
to also control Firefox on root-less Android devices. See the [documentation][Flags]
|
||||
for available values.
|
||||
|
||||
### Fixed
|
||||
|
||||
- Firefox can be started again via a shell script that is located outside of the
|
||||
Firefox directory on Linux.
|
||||
|
||||
- If Firefox cannot be started by geckodriver the real underlying error message is
|
||||
now being reported.
|
||||
|
||||
- Version numbers for minor and extended support releases of Firefox are now parsed correctly.
|
||||
|
||||
### Removed
|
||||
|
||||
- Since Firefox 72 extension commands for finding an element’s anonymous children
|
||||
and querying its attributes are no longer needed, and have been removed.
|
||||
|
||||
0.27.0 (2020-07-27, `7b8c4f32cdde`)
|
||||
--------------------
|
||||
@ -1338,6 +1373,7 @@ and greater.
|
||||
[Firefox Preview]: https://play.google.com/store/apps/details?id=org.mozilla.fenix
|
||||
[Firefox Reality]: https://play.google.com/store/apps/details?id=org.mozilla.vrbrowser
|
||||
[Capabilities]: https://firefox-source-docs.mozilla.org/testing/geckodriver/Capabilities.html
|
||||
[Flags]: https://firefox-source-docs.mozilla.org/testing/geckodriver/Flags.html
|
||||
[enable remote debugging on the Android device]: https://developers.google.com/web/tools/chrome-devtools/remote-debugging
|
||||
[macOS notarization]: https://firefox-source-docs.mozilla.org/testing/geckodriver/Notarization.html
|
||||
|
||||
|
@ -1,7 +1,53 @@
|
||||
Flags
|
||||
=====
|
||||
|
||||
#### <code>-b <var>BINARY</var></code>/<code>--binary <var>BINARY</var></code>
|
||||
#### <code>--android-storage <var>ANDROID_STORAGE</var></code>
|
||||
|
||||
Selects the test data location on the Android device, eg. the Firefox profile.
|
||||
By default `auto` is used.
|
||||
|
||||
<style type="text/css">
|
||||
table { width: 100%; margin-bottom: 2em; }
|
||||
table, th, td { border: solid gray 1px; }
|
||||
td, th { padding: 10px; text-align: left; vertical-align: middle; }
|
||||
td:nth-child(1), th:nth-child(1) { width: 10em; text-align: center; }
|
||||
</style>
|
||||
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Value
|
||||
<th>Description
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tr>
|
||||
<td>auto
|
||||
<td>Best suitable location based on whether the device is rooted.<br/>
|
||||
If the device is rooted <code>internal</code> is used, otherwise <code>app</code>.
|
||||
<tr>
|
||||
<td>app
|
||||
<td><p>Location: <code>/data/data/%androidPackage%/test_root</code></p>
|
||||
Based on the <code>androidPackage</code> capability that is passed as part of
|
||||
<code>moz:firefoxOptions</code> when creating a new session. Commands that
|
||||
change data in the app's directory are executed using run-as. This requires
|
||||
that the installed app is debuggable.
|
||||
<tr>
|
||||
<td>internal
|
||||
<td><p>Location: <code>/data/local/tmp/test_root</code></p>
|
||||
The device must be rooted since when the app runs, files that are created
|
||||
in the profile, which is owned by the app user, cannot be changed by the
|
||||
shell user. Commands will be executed via <code>su</code>.
|
||||
<tr>
|
||||
<td>sdcard
|
||||
<td><p>Location: <code>/mnt/sdcard/test_root</code></p>
|
||||
This location is not supported on Android 11+ due to the
|
||||
<a href="https://developer.android.com/about/versions/11/privacy/storage">
|
||||
changes related to scoped storage</a>.
|
||||
</table>
|
||||
|
||||
|
||||
#### <code>-b <var>BINARY</var></code> / <code>--binary <var>BINARY</var></code>
|
||||
|
||||
Path to the Firefox binary to use. By default geckodriver tries to
|
||||
find and use the system installation of Firefox, but that behaviour
|
||||
@ -28,7 +74,7 @@ scanning the Windows registry.
|
||||
[whereis(1)]: http://www.manpagez.com/man/1/whereis/
|
||||
|
||||
|
||||
#### `--connect-existing`
|
||||
#### <code>--connect-existing</code>
|
||||
|
||||
Connect geckodriver to an existing Firefox instance. This means
|
||||
geckodriver will abstain from the default of starting a new Firefox
|
||||
@ -55,6 +101,12 @@ Set the Gecko and geckodriver log level. Possible values are `fatal`,
|
||||
`error`, `warn`, `info`, `config`, `debug`, and `trace`.
|
||||
|
||||
|
||||
#### <code>--marionette-host <var>HOST</var></code>
|
||||
|
||||
Selects the host for geckodriver’s connection to the [Marionette]
|
||||
remote protocol. Defaults to 127.0.0.1.
|
||||
|
||||
|
||||
#### <code>--marionette-port <var>PORT</var></code>
|
||||
|
||||
Selects the port for geckodriver’s connection to the [Marionette]
|
||||
@ -70,7 +122,7 @@ under geckodriver’s control, it will simply connect to <var>PORT</var>.
|
||||
[`--connect-existing`]: #connect-existing
|
||||
|
||||
|
||||
#### <code>-p <var>PORT</var></code>/<code>--port <var>PORT</var></code>
|
||||
#### <code>-p <var>PORT</var></code> / <code>--port <var>PORT</var></code>
|
||||
|
||||
Port to use for the WebDriver server. Defaults to 4444.
|
||||
|
||||
|
@ -326,6 +326,7 @@ fn make_app<'a, 'b>() -> App<'a, 'b> {
|
||||
.long("android-storage")
|
||||
.possible_values(&["auto", "app", "internal", "sdcard"])
|
||||
.default_value("auto")
|
||||
.value_name("ANDROID_STORAGE")
|
||||
.help("Selects storage location to be used for test data."),
|
||||
)
|
||||
}
|
||||
|
Loading…
Reference in New Issue
Block a user