UNPKG

appium

Version:

Automation for Apps.

github.com/appium/appium

appium/appium

113 lines (95 loc) • 7.72 kB
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
## Chromedriver Appium supports automating Android web pages (in Chrome and the built-in Browser) and hybrid apps that are Chrome-backed, by managing a [Chromedriver](https://sites.google.com/a/chromium.org/chromedriver/) instance and proxying commands to it when necessary. It comes bundled with the [latest version of Chromedriver](https://chromedriver.storage.googleapis.com/LATEST_RELEASE), installed through the npm package [appium-chromedriver](https://www.npmjs.com/package/appium-chromedriver) (Github: [appium-chromedriver](https://github.com/appium/appium-chromedriver)). Unfortunately, with each update to Chromedriver there is an increase in the minimum supported version of Chrome, such that older devices are often unable to be automated with the bundled version. In the Appium server logs there will be an error like: ``` An unknown server-side error occurred while processing the command. Original error: unknown error: Chrome version must be >= 55.0.2883.0 ``` To get around this, Appium can be configured to use a particular Chromedriver version, either at install time, by either passing the `--chromedriver_version` config property, e.g., ``` npm install appium --chromedriver_version="2.16" ``` Or specifying the version in the `CHROMEDRIVER_VERSION` environment variable, e.g, ``` CHROMEDRIVER_VERSION=2.20 npm install appium ``` This can also be set to `LATEST` to get the most recent version. Finally, a version can be specified at runtime, by specifying the `--chromedriver-executable` server flag, along with the full path to the Chromedriver executable which was manually downloaded, e.g., ``` appium --chromedriver-executable /path/to/my/chromedriver ``` ### Chromedriver/Chrome compatibility The following is a list of Chromedriver versions and their corresponding minimum Chrome version that is automatable: | Version | Minimum Chrome Version | Link to Chromedriver | |---------|------------------------|-----------------------------------------------------------------------------------| | 2.33 | 60.0.3112.0 | [v2.33 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.33/) | | 2.32 | 59.0.3071.0 | [v2.32 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.32/) | | 2.31 | 58.0.3029.0 | [v2.31 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.31/) | | 2.30 | 58.0.3029.0 | [v2.30 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.30/) | | 2.29 | 57.0.2987.0 | [v2.29 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.29/) | | 2.28 | 55.0.2883.0 | [v2.28 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.28/) | | 2.27 | 54.0.2840.0 | [v2.27 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.27/) | | 2.26 | 53.0.2785.0 | [v2.26 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.26/) | | 2.25 | 53.0.2785.0 | [v2.25 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.25/) | | 2.24 | 52.0.2743.0 | [v2.24 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.24/) | | 2.23 | 51.0.2704.0 | [v2.23 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.23/) | | 2.22 | 49.0.2623.0 | [v2.22 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.22/) | | 2.21 | 46.0.2490.0 | [v2.21 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.21/) | | 2.20 | 43.0.2357.0 | [v2.20 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.20/) | | 2.19 | 43.0.2357.0 | [v2.19 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.19/) | | 2.18 | 43.0.2357.0 | [v2.18 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.18/) | | 2.17 | 42.0.2311.0 | [v2.17 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.17/) | | 2.16 | 42.0.2311.0 | [v2.16 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.16/) | | 2.15 | 40.0.2214.0 | [v2.15 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.15/) | | 2.14 | 39.0.2171.0 | [v2.14 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.14/) | | 2.13 | 38.0.2125.0 | [v2.13 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.13/) | | 2.12 | 36.0.1985.0 | [v2.12 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.12/) | | 2.11 | 36.0.1985.0 | [v2.11 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.11/) | | 2.10 | 33.0.1751.0 | [v2.10 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.10/) | | 2.9 | 31.0.1650.59 | [v2.9 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.9/) | | 2.8 | 30.0.1573.2 | [v2.8 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.8/) | | 2.7 | 30.0.1573.2 | [v2.7 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.7/) | | 2.6 | | [v2.6 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.6/) | | 2.5 | | [v2.5 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.5/) | | 2.4 | 29.0.1545.0 | [v2.4 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.4/) | | 2.3 | 28.0.1500.0 | [v2.3 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.3/) | | 2.2 | 27.0.1453.0 | [v2.2 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.2/) | | 2.1 | 27.0.1453.0 | [v2.1 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.1/) | | 2.0 | 27.0.1453.0 | [v2.0 (link)](https://chromedriver.storage.googleapis.com/index.html?path=2.0/) | The complete list of available Chromedriver releases is [here](https://chromedriver.storage.googleapis.com/index.html). To find the minimum supported version for any particular version, get the [Chromium](https://www.chromium.org/Home) [source code](https://chromium.googlesource.com/chromium/src/+/master/docs/get_the_code.md), check out the release commit, and check the variable `kMinimumSupportedChromeVersion` in the file `src/chrome/test/chromedriver/chrome/version.cc`. (To find the release commits, you can use `git log --pretty=format:'%h | %s%d' | grep -i "Release Chromedriver version"`.) ### Installing an network issues When Appium is installed it needs to download Chromedriver, so there is the possibility that there could be network problems that make the install fail. By default Chromedriver is retrieved from `https://chromedriver.storage.googleapis.com/`. To use a mirror of the ChromeDriver binaries use npm config property `chromedriver_cdnurl`. ```bash npm install appium-chromedriver --chromedriver_cdnurl=http://npm.taobao.org/mirrors/chromedriver ``` Or add the property into your [`.npmrc`](https://docs.npmjs.com/files/npmrc) file. ```bash chromedriver_cdnurl=http://npm.taobao.org/mirrors/chromedriver ``` Another option is to use PATH variable `CHROMEDRIVER_CDNURL`. ```bash CHROMEDRIVER_CDNURL=http://npm.taobao.org/mirrors/chromedriver npm install appium-chromedriver ``` It may also be necessary to adjust network proxy and firewall settings to allow the download to occur.