GitHub - athena-oss/plugin-appium: Plugin to handle mobile automation using Appium.
Skip to content

athena-oss/plugin-appium

Repository files navigation

Appium Plugin Build Status

Athena Appium Plugin is a plugin for Athena, that provides an out of the box integration with Appium and Virtual Mobile devices.

You can easily use this plugin in your local development machine, or in a CI/CD pipeline.

How to Install ?

On Linux

  • Using apt-get :
$ sudo add-apt-repository ppa:athena-oss/athena
$ sudo apt-get update
$ sudo apt-get install athena-plugin-appium

On MAC OSX

$ brew tap athena-oss/tap
$ brew install plugin-appium

Alternative

$ athena plugins install appium https://github.com/athena-oss/plugin-appium.git

Read the Documentation on using Athena.

How to Use ?

This plugin provides the following commands :

start - Start a Appium server

$ athena appium start [<options>...] [<appium_options>...]

$ # e.g. start Appium server and link with device from Athena AVD plugin
$ athena appium start --with-avd=athena-plugin-avd-wxga720-api-24-0

$ # e.g. start Appium server and export ABD for devices to connect automatically
$ athena appium start --adb-port=5037

$ # e.g. start Appium server and link with Genymotion device
$ athena appium start --with-avd=192.168.57.101:5555

$ # e.g. start Appium server at port 9001
$ athena appium start --port=9001

stop - Stop the Appium server

$ athena appium stop [--help|<options>...]

$ # e.g. stop Appium server
$ athena appium stop

logs - Show Appium server logs

$ athena appium logs [--help|<options>...]

$ # e.g. get Appium server logs
$ athena appium logs

$ # e.g. get Appium server on port 9001 logs
$ athena appium logs --port=9001

terminal - Starts a shell inside device/server container

$ athena appium terminal [--help|<options>...]

$ # e.g. simple shell
$ athena appium terminal

$ # e.g. open a terminal on Appium server at port 9001
$ athena appium terminal --port=9001

Contributing

Checkout our guidelines on how to contribute in CONTRIBUTING.md.

Versioning

Releases are managed using github's release feature. We use Semantic Versioning for all the releases. Every change made to the code base will be referred to in the release notes (except for cleanups and refactorings).

License

Licensed under the Apache License Version 2.0 (APLv2).