https://github.com/moatazeldebsy/appium-server-github-action

Running Appium Server with GitHub Action to be able to run Appium mobile test automation scripts
https://github.com/moatazeldebsy/appium-server-github-action

appium appium-android appium-automation appium-ios appium-server appium-tests

Last synced: 8 days ago
JSON representation

Running Appium Server with GitHub Action to be able to run Appium mobile test automation scripts

• Host: GitHub
• URL: https://github.com/moatazeldebsy/appium-server-github-action
• Owner: moatazeldebsy
• License: gpl-3.0
• Created: 2020-03-20T11:50:47.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-10-22T08:45:31.000Z (2 months ago)
• Last Synced: 2024-10-30T14:17:47.674Z (about 2 months ago)
• Topics: appium, appium-android, appium-automation, appium-ios, appium-server, appium-tests
• Language: Dockerfile
• Size: 200 KB
• Stars: 43
• Watchers: 5
• Forks: 14
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Appium Server GitHub Action

[![Release](https://img.shields.io/github/release/moatazeldebsy/Appium-Server-GitHub-Action.svg)](https://github.com/moatazeldebsy/Appium-Server-GitHub-Action/releases)

[![Marketplace](https://img.shields.io/badge/GitHub-Marketplace-blue.svg)](https://github.com/marketplace/actions/appium-server-action)

Running `Appium` Server with `GitHub Action` to be able to run `Appium` mobile test automation scripts (`Android`)

Inspired by the 2020 [GitHub Actions Hackathon.](https://githubhackathon.com/)

### Note

> This action is expected to be run within a ubuntu virtual machine and Android apps



### What is Appium?

Appium is an open-source test automation framework for use with native, hybrid and mobile web apps. 

It drives iOS, Android, and Windows apps using the WebDriver protocol.



### What is the problem ?

The problem now that, how can we run an Appium server on GitHub Actions?

Because we are using a GUI tool like Appium Desktop on our local machines, So we need to run the Appium server from the command line and in the background to be able to run the rest of the commands.

### The Solution

I created  this GitHub action to install the Appium server using nodeJS and npm then running it in the background.

## Usage

workflow/main.yml:

```yaml

name: Appium CI

on: [push]

jobs:

  Sauce Labs App Automate:

    runs-on: ubuntu-latest

    name: Appium Test

    steps:

      - name: Checkout

        uses: actions/checkout@v2

       - name: Install and Run Appium Server

         uses: moatazeldebsy/[email protected]

```




## Usage in in the code

```java

@BeforeClass

    public void setUp() throws MalformedURLException {

        DesiredCapabilities caps = new DesiredCapabilities();

        caps.setCapability("automationName" , "UiAutomator1");

        caps.setCapability("platformName" , "Android");

        caps.setCapability("platformVersion" , "7.1.1");

        caps.setCapability("deviceName" , "Android Emulator");

        caps.setCapability("app" , System.getProperty("user.dir")+"/apps/selendroid-test-app-0.17.0.apk");

        driver = new AndroidDriver<>(new URL("http://localhost:4723/wd/hub"), caps);

    }

```

## Contributing

Are you facing an issue? Have some questions? Would like to implement a new feature? Learn more about our [contributing guidelines](CONTRIBUTING.md).




## Licence

The project is released under the [MIT License](LICENSE).