1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
# Android WebView
To run WPT on WebView on an Android device, some additional set-up is required.
Currently, Android WebView support is experimental.
## Prerequisites
Please check [Chrome for Android](chrome_android.md) for the common instructions for Android support first.
Ensure you have a userdebug or eng Android build installed on the device.
Install an up-to-date version of system webview shell:
1. Go to [chromium-browser-snapshots](https://commondatastorage.googleapis.com/chromium-browser-snapshots/index.html?prefix=Android/)
2. Find the subdirectory with the highest number and click it, this number can be found
in the "Commit Position" column of row "LAST_CHANGE" (at bottom of page).
3. Download `chrome-android.zip` file and unzip it.
4. Install `SystemWebViewShell.apk`.
5. On emulator, system webview shell may already be installed by default. Then you may need to remove the existing apk:
* Choose a userdebug build.
* Run an emulator with
[writable system partition from command line](https://chromium.googlesource.com/chromium/src/+/HEAD/docs/android_emulator.md/)
If you have an issue with ChromeDriver version mismatch, try one of the following:
* Try removing `_venv/bin/chromedriver` such that wpt runner can install a matching version
automatically. Failing that, please check your environment path and make
sure that no other ChromeDriver is used.
* Download the [ChromeDriver binary](https://chromedriver.chromium.org/) matching your WebView's major version and specify it on the command line
```
./wpt run --webdriver-binary <binary path> ...
```
Configure host remap rules in the [webview commandline file](https://cs.chromium.org/chromium/src/android_webview/docs/commandline-flags.md?l=57):
```
adb shell "echo '_ --host-resolver-rules=\"MAP nonexistent.*.test ^NOTFOUND, MAP *.test 127.0.0.1\"' > /data/local/tmp/webview-command-line"
```
Ensure that `adb` can be found on your system's PATH.
## Running Tests
Example command line:
```bash
./wpt run --test-type=testharness android_webview <TESTS>
```
* Note that there is no support for channel or automatic installation. The test
will be run against the current WebView version installed on the device.
* Reftests are not supported at the moment.
|
