Binaries for ChromeDriver can be found packaged as zip files for various host platforms on the downloads page.
The standard selenium project remote driver language bindings need to be installed for your language of choice for writing your tests. This driver is available from your friendly local package manager or the selenium project (http://docs.seleniumhq.org/download/). For example, the language bindings for Python can be installed with pip.
$ pip install selenium
The SDK can be downloaded from developer.android.com: http://developer.android.com/sdk/index.html
As of Chrome version 33, a rooted device is no longer required. If running tests on older versions of Chrome, devices needed to be rooted as ChromeDriver required write access to the /data/local directory to set Chrome's command line arguments.
1. Start the Android SDK's Android Debug Bridge (adb) server:
$ adb start-server
2. If testing on Chrome app prior to version 33, ensure adb shell has read/write access to /data/local directory on the device:
$ adb shell su -c chmod 777 /data/local
3. Start the ChromeDriver server. It will print the port it is listening on:
The following capabilities are applicable to both Chrome and WebView apps:
The following capabilities are only applicable to WebView apps.
Tests should pass the app’s package name to the server when creating the driver through the capabilitychromeOptions.androidPackage. For example, a minimal Python test looks like this:
from selenium import webdriver
To use a particular device for a session, specify androidDeviceSerial as a desired capability.
If the serial number is not specified, the server will select an unused device at random to associate with each session. An error will be returned if all devices already have active sessions, so tests should make sure to call quit when finished.
If your tests expect to connect to wd/hub, you can add --url-base=wd/hub when launching the server:
$ ./chromedriver --url-base=wd/hub
Getting started >