Appium driver for codeception for writing mobile tests.
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
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.
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
Note:
deviceName
should be set asAndroid device
only for real device. For Android Emulator use the name of the virtual device.
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
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);
}
}
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 android FirstAndroidCest.php--steps
Note: While following the steps that are mentioned here if you get
codecept command not found
error try to runcodecept
command like this./vendor/bin/codecept
.
A huge thanks to all of our contributors:
Mohamed Meabed ๐ป ๐ข |
Zeeshan Ahmad ๐ป ๐ |
---|
The code is available under the MIT license.