# ywinappdriver Service

> wdio-ywinappdriver-service is a 3rd party package, for more information please see [GitHub](https://github.com/licanhua/wdio-ywinappdriver-service) | [npm](https://www.npmjs.com/package/wdio-ywinappdriver-service)

This service helps you to run the ywinappdriver server seamlessly when running tests with the [WDIO testrunner](https://webdriver.io/guide/testrunner/gettingstarted.html). It starts the [ywinappdriver](https://github.com/licanhua/YWinAppDriver) in a child process.

## Installation[​](#installation "Direct link to Installation")

```
npm install wdio-ywinappdriver-service --save-dev
```

Instructions on how to install `WebdriverIO` can be found [here.](https://webdriver.io/docs/gettingstarted.html)

## Configuration[​](#configuration "Direct link to Configuration")

In order to use the service you need to add `ywinappdriver` to your service array:

```
// wdio.conf.js
export.config = {
    // ...
    services: ['ywinappdriver'],
    // ...
};
```

## Options[​](#options "Direct link to Options")

The following options can be added to the wdio.conf.js file. To define options for the service you need to add the service to the `services` list in the following way:

```
// wdio.conf.js
export.config = {
    // ...
    services: [
        ['ywinappdriver', {
            // ywinappdriver service options here
            // ...
        }]
    ],
    // ...
};
```

### logPath[​](#logpath "Direct link to logPath")

Path where all logs from the ywinappdriver server should be stored.

Type: `String`

Example:

```
export.config = {
    // ...
    services: [
        ['ywinappdriver', {
            logPath : './'
        }]
    ],
    // ...
}
```

### command[​](#command "Direct link to command")

To use your own installation of winappdriver, e.g. globally installed, specify the command which should be started.

Type: `String`

Example:

```
export.config = {
    // ...
    services: [
        ['ywinappdriver', {
            command : 'c:\\xx\\ywinappdriver.exe'
        }]
    ],
    // ...
}
```

### args[​](#args "Direct link to args")

List of arguments passed directly to `ywinappdriver`.

See [the documentation](https://github.com/licanhua/ywinappdriver) for possible arguments.

Type: `Array`

Default: `[]`

Example:

```
export.config = {
    // ...
    services: [
        ['ywinappdriver', {
            args: ['--urls' 'http://127.0.0.1:4723' '--basepath' '/wd/hub']
        }]
    ],
    // ...
}
```