docs: add external dependencies to setup

Author: vchimev

README.md

@@ -5,7 +5,7 @@ A package to help with writing and executing e2e [Appium](http://appium.io) test
 <!-- TOC depthFrom:2 -->
 
 - [Requirеments](#requirеments)
-- [Set Up](#set-up)
+- [Setup](#setup)
     - [Structure](#structure)
     - [Files Preview](#files-preview)
 - [Usage](#usage)
@@ -24,24 +24,44 @@ A package to help with writing and executing e2e [Appium](http://appium.io) test
 
 The `nativescript-dev-appium` plugin requires:
 * latest version of [Appium](https://github.com/appium/appium/releases)
+    * for correct functioning of the [XCUITest](https://github.com/appium/appium/blob/master/docs/en/drivers/ios-xcuitest.md) driver for iOS, additional libraries are required (see the [Setup](#setup) section)
 * latest version of [Xcode](https://developer.apple.com/library/content/releasenotes/DeveloperTools/RN-Xcode/Chapters/Introduction.html)
 * [Android SDK Tools](https://developer.android.com/studio/releases/sdk-tools.html) version greater than 25.3.0
 
-## Set Up
+## Setup
 
-Add the plugin as a `devDependency` to your project:
+Add the plugin as a *devDependency* to your project:
 
 ```shell
 $ npm install -D nativescript-dev-appium
 ```
 
+> After completion of the installation, if your project has a dependency to *TypeScript*, the plugin should have added an `e2e` folder containing predefined configs and samples.
+
 Then install [Appium](https://www.npmjs.com/package/appium) - we recommend a global installation to avoid adding it to every project you would like to test:
 
 ```shell
 $ npm install -g appium
 ```
 
-After completion of the installation, if your project has a dependency to *TypeScript*, the plugin should have added an `e2e` folder containing predefined configs and samples.
+Install external dependencies of [XCUITest](https://github.com/appium/appium-xcuitest-driver/blob/master/README.md#external-dependencies) driver for iOS via:
+
+* [Homebrew](https://brew.sh):
+
+```shell
+$ brew install carthage
+$ brew install libimobiledevice --HEAD
+$ brew install ideviceinstaller
+$ brew install ios-webkit-debug-proxy
+```
+
+* [NPM](https://www.npmjs.com/):
+
+```shell
+$ npm install -g ios-deploy
+```
+
+> For detailed information on external dependencies, please, refer to the [XCUITest](https://github.com/appium/appium-xcuitest-driver/blob/master/README.md#external-dependencies) repository.
 
 ### Structure
 
@@ -58,37 +78,37 @@ After completion of the installation, if your project has a dependency to *TypeS
         ├── package.json
         ├── tsconfig.json
 
-> Note - To avoid any incompatibilities between the source of `e2e` tests (ES6) and the source of the application (ES5), we recommend to exclude the `e2e` folder from the application's `tsconfig.json` file: `exclude": [ "e2e" ]`.
+> To avoid any incompatibilities between the source of *e2e* tests (ES6) and the source of the application (ES5), we recommend to exclude the *e2e* folder from the application's *tsconfig.json* file: `exclude": [ "e2e" ]`.
 
 ### Files Preview
 
 |File                |Purpose|
-|:-------------------------------:|:-------------------:|
-|`config/appium.capabilities.json`|Contains predefined configurations for test execution.|
-|`config/mocha.opts`              |A default mocha configuration file.                   |
-|`sample.e2e-test.ts`             |Contains a predefined ready-to-execute sample tests of the default [*hello-world*](https://github.com/NativeScript/template-hello-world-ts) template.|
-|`setup.ts`                       |Defines the `before` and `after` test execution hooks responsible to start and stop the [Appium](http://appium.io/) server.|
-|`tsconfig.json`                  |TypeScript compiler configuration file for the `e2e` tests.|
-
-> Note - The folders below are related to the image comparison feature:
+|:-----------------------------:|:-------------------:|
+|config/appium.capabilities.json|Contains predefined configurations for test execution.|
+|config/mocha.opts              |A default mocha configuration file.                   |
+|sample.e2e-test.ts             |Contains a predefined ready-to-execute sample tests of the default [hello-world-ts](https://github.com/NativeScript/template-hello-world-ts) template.|
+|setup.ts                       |Defines the `before` and `after` test execution hooks responsible to start and stop the [Appium](http://appium.io/) server.|
+|tsconfig.json                  |TypeScript compiler configuration file for the `e2e` tests.|
+
+> Note - the folders below are related to the image comparison feature:
 > * `e2e/reports` - this folder is created during test execution and stores the actual images from comparison
 > * `e2e/resources` - this folder aims to store the expected images for comparison
 
 ## Usage
 
 Before running the tests you will have to build your app for the platform on test or both. Navigate to your demo app folder from where you will execute the commands that follow.
 
-```
+```shell
 $ tns build android
 ```
 
 or
 
-```
+```shell
 $ tns build ios
 ```
 
-The command that will run the tests should specify the targeted platform using the `runType` option as shown below. This way a capabilities will be selected from the [capabilities config file](#customCapabilities).
+The command that will run the tests should specify the targeted platform using the `runType` option as shown below. This way a capabilities will be selected from the [capabilities](#custom-appium-capabilities) configuration file.
 
 ```
 $ npm run e2e -- --runType android25