Moodle Mobile 2 (Ionic 1) End To End Testing

Protractor is an end-to-end test framework for AngularJS applications. Protractor runs tests against your application running in a real browser, interacting with it as a user would.

Setting-up testing environment

This currently only covers testing on Android 4.4 onwards and Chrome. iOS testing is a work in progress.

Head to the root directory of your MM instance.

• Install the packages required for testing

npm install (do not use the -g option)

• Install the Chrome webdriver

./node_modules/protractor/bin/webdriver-manager update

• Make sure your checkout is up to date, all the cordova plugins are installed and the android platform is set-up. The following should be enough.

gulp
ionic state restore
ionic build android

Once this is done, you will need to generate a protactor configuration file for the platform you intend to test the app on.

Generating Protractor config file

Protractor config file contains all the information for running the tests, as well as to provide the tests with information about the site being tested.

• For Android
  • gulp e2e-build --target android --device abcdefg --version 4.4
• For Chrome (browser)
  • gulp e2e-build --target browser

By default the configuration file is saved at e2e/build/protractor.conf.js, should you wish to save the configuration file to re-use it later, you can use the argument --output <filename>.

Other arguments are available, you can find more about them using:

   gulp e2e-build -h
   gulp e2e-build --target android -h
   gulp e2e-build --target browser -h

Running the suite

• Run the ionic first
  • ionic serve -b -a
• Start the web driver
  • For Android: ./node_modules/appium/bin/appium.js
  • For Chrome : ./node_modules/protractor/bin/webdriver-manager start
• Wait for the driver to be fully started
• Run Protractor
  • ./node_modules/protractor/bin/protractor e2e/build/protractor.conf.js