Click here to see the minimum browser versions that we support.
If you haven't updated your dependencies in a while, run npm install from your terminal to install WebdriverIO (this is a framework that lets us test both the browser app and Cordova mobile apps with a single script).
Copy WebApp/tests/browserstack/browserstack.config-template.js into WebApp/tests/browserstack/browserstack.config.js:
(WebAppEnv) $ cd WebApp
(WebAppEnv) $ cp tests/browserstack/browserstack.config-template.js tests/browserstack/browserstack.config.js
You'll need to add your credentials to browserstack.config.js. Sign into Browserstack and navigate to the BrowserStack Automate dashboard. Press the down arrow next to where it says "Access Key" in the header. You should see your username ("YOUR-USERNAME" below) and access key ("ACCESS-KEY-HERE" below). You will need both of these values to upload the compiled App.
You will also need the URL for the android app .apk file. You can get this by asking someone else or by uploading the file with Browserstack's REST API as described here. Visit this page when you are signed into Browserstack, and they will customize the command that you need to run from your terminal window:
curl -u "YOUR-USERNAME:ACCESS-KEY-HERE" -X POST https://api-cloud.browserstack.com/app-automate/upload -F "file=@/path/to/app/file/Application-debug.apk" -F 'data={"custom_id": "MyApp"}'
You can find the latest We Vote APK (for Android) and IPA (for iOS) in this Google Drive folder. Please download it to your Download folder. For example, to find this path on a Mac:
(WebAppEnv) $ cd ~/Downloads
(WebAppEnv) $ pwd
/Users/dalemcgrew/Downloads
In this example, the Android APK downloaded file is app-debug-5-29-19.apk. The full path to this downloaded file is now:
/Users/dalemcgrew/Downloads/app-debug-5-29-19.apk
So the terminal command to upload the file would look like this:
curl -u "YOUR-USERNAME:ACCESS-KEY-HERE" -X POST https://api-cloud.browserstack.com/app-automate/upload -F "file=@/Users/dalemcgrew/Downloads/app-debug-5-29-19.apk" -F 'data={"custom_id": "MyApp"}'
It will typically take 30-60 seconds to upload (without any feedback), and then return a path like this:
{"app_url":"bs://ANOTHER-GENERATED-STRING-HERE","custom_id":"MyApp","shareable_id":"dalemcgrew1/MyApp"}
Copy the path bs://ANOTHER-GENERATED-STRING-HERE into your WebApp/tests/browserstack/browserstack.config.js file,
and put it into the BROWSERSTACK_APK_URL value field like this:
BROWSERSTACK_APK_URL: 'bs://ANOTHER-GENERATED-STRING-HERE',
With this BROWSERSTACK_APK_URL variable set now, we can run tests on the android mobile application.
There are three scripts for running tests: config.py, testscript, and wdio.config.js. testScript generates the template file named wdio.config.template which acts as a template for creating wdio.config.js as well as creates the script using the script name parameter if it does not already exist. config.py uses the wdio.config.template file to generate the wdio.config.js file, which is used for running the test. Note that testScript requires bash and config.py requires python3.
(WebAppEnv) $ ./testscript -s <script name> -n <number of tests> (run without options for help)
(WebAppEnv) $ python config.py -s <script name> -b <type of device> -n <number of tests> (-h for help)
To run the tests, run:
(WebAppEnv) $ wdio wdio.config.js
When the test finishes, you should be able to see the video of browser tests on the BrowserStack Automate dashboard and video of the mobile apps on BrowserStack App Automate.
//: <> ( (This is where we imitate a Voter interacting with our website. ) //: <> ( (In Travis we automate this with a Travis powered test with every pull request. ) //: <> ( (In Travis, we reach out to Sauce Labs, and have them run tests recorded with Selenium.)