Appium Driver for Codeception

Appium driver for codeception for writing mobile tests.

---

Requirement

1. PHP >= 7.0
2. Appium
3. Setup Android SDK on Mac
4. Inspect App with Appium Desktop

Table of Contents

• Install
• Tests
  • Writing tests for Android
  • Generating Actor classes
  • Your First Android Test
  • Running tests

Install

Just add me-io/appium-driver-codeception to your project's composer.json file:

{
    "require": {
        "me-io/appium-driver-codeception": "~1"
    }
}

and then run composer install. This will install codeception appium driver and all it's dependencies. Or run the following command

composer require me-io/appium-driver-codeception

Tests

Now lets run the following command at the root directory of your project:

codecept bootstrap

This command will creates a configuration file for codeception and tests directory and default test suites.

Writing tests for Android

Now, lets create a new configuration file android.suite.yml inside tests directory and put the following contents inside of it.

class_name: AndroidGuy
modules:
  enabled:
    # Enable appium driver
    - \Appium\AppiumDriver 
    -  Asserts
  config:
    # Configuration for appium driver
    \Appium\AppiumDriver:
      host: 0.0.0.0
      port: 4723
      dummyRemote: false
      resetAfterSuite: true
      resetAfterCest: false
      resetAfterTest: false
      resetAfterStep: false
      capabilities:
        platformName: 'Android'
        deviceName: 'Android device'
        automationName: 'Appium'
        appPackage: io.selendroid.testapp
        fullReset: false
        noReset: false
        newCommandTimeout: 7200
        nativeInstrumentsLib: true
        connection_timeout: 500
        request_timeout: 500
        autoAcceptAlerts: true
        appActivity: io.selendroid.testapp.HomeScreenActivity
        skipUnlock: true

Generating Actor classes

Now we need to generate actor class for the AndroidGuy that we defined in android.suite.yml. To generate the actor class for AndroidGuy run the following command inside your terminal:

codecept build

Your First Android Test

To create your first android test create a new directory android inside tests folder. After creating the android folder create a new file FirstAndroidCest.php and put the following contents inside of it:

class FirstAndroidCest
{
    public function changeLanguage(AndroidGuy $I)
    {
        $I->implicitWait([
            'ms' => 3500,
        ]);
        $text = $I->byId('id_of_button')->getText();
        $I->assertEquals('Hello, World!', $text);
    }
}

Running tests

Run the appium server by running the following command:

appium

After running the appium server now you need to start android emulator and install the application that you want to test. If you don't know how to start the emulator you can follow the following guide Setup Genymotion Android Emulators on Mac OS

Now run the following command inside your terminal to run the tests:

codecept run --steps

Note: While following the steps that are mentioned here if you get codecept command not found error try to run codecept command like this ./vendor/bin/codecept.

Contributors

A huge thanks to all of our contributors:

Mohamed Meabed 💻 📢	Zeeshan Ahmad 💻 🐛 ⚠️ 📖

License

The code is available under the MIT license.