android native app acceptance tests
Please read the Wiki to get started.
- Confirm location and password/username combination of debug.keystore calabash_settings
- Confirm endpoint and project configurations in project_settings
Four settings files in config/
cucumber.yml -> cucumber profiles
test_data.yml -> test data
project_settings.yml -> controls the resource location
test_settings.yml -> controls test specific settings e.g. URL endpoints
Within test_settings.yml the environment will select which APK to install and use. There must be the appropriate authentication path to match chose configuration
test:
environment: "production-debug"
environment:
"production-debug":
url:
auth: https://auth.blinkboxbooks.com
qa:
host: https://api.blinkboxbooks.com/service
Typical usage
bundle install
rake
rake calabash:run
Custom features
bundle install
rake
rake calabash:run feature=features/login.feature
Custom profiles
bundle install
rake
rake calabash:run profile=smoke
config/
test_settings.yml
project_settings.yml
test_data.yml
cucumber.yml
features/
step_definitions/
support/
modules/
pages/
model/
Rakefile #rake -T for options
README.md
Gemfile
rake -T
rake android:get_latest_apk # Get latest android APK
rake android:install_apk[apk_file] # Installs the apk and test server (will reinstall if in...
rake android:resign[apk_file] # builds and resigns the apk
rake calabash:environment_install # Checks development environment and install essentials
rake calabash:run_config # Prints out details about current configuration
rake calabash:console[apk_file] # Run calabash-android console with included Calabash::A...
rake calabash:run[apk_file] # Runs calabash android
There're a few environment variables built into the calabash source code or introduced by us, which are used to control the calabash behaviour during execution. Please refer to Calabash documentation
Note: Calabash will always re-install the app once for every feature file - we can change it in the app_installation_hooks.rb
- REINSTALL_BETWEEN_SCENARIOS (custom var) - if set to "1", Calabash will re-install the app between scenarios
- SCREENSHOT_VIA_USB - if set to "true", Calabash will take screenshots from a connected device via USB. Reliable option if you connect device with a cable.
Please refer to common convention in confluence
- @clear_app_data - clear_app_data before the tagged scenario NOTE: right now we do clear_app_data before every scenario
2015 blinkbox books Ltd. See LICENCE for details.