Add MacDriver (#8046)

* Add MacDriver

* Add MacDriver to version map

* Add some notes about Mac

* Update README.md

* Add section about mac apps.

* Move information to running on OS X page

README.md

@@ -10,7 +10,7 @@
 
 [![Build Status](https://team-appium.ci.cloudbees.com/job/Appium/badge/icon)](https://team-appium.ci.cloudbees.com/job/Appium/)
 
-Appium is an open source, cross-platform test automation tool for native, hybrid and mobile web apps, tested on simulators (iOS), emulators (Android), and real devices (iOS, Android, Windows).
+Appium is an open source, cross-platform test automation tool for native, hybrid and mobile web and desktop apps, tested on simulators (iOS), emulators (Android), and real devices (iOS, Android, Windows, Mac).
 
 
 ### Supported Platforms
@@ -18,6 +18,7 @@ Appium is an open source, cross-platform test automation tool for native, hybrid
 * iOS
 * Android
 * Windows
+* Mac
 
 See the [platform support doc](/docs/en/appium-setup/platform-support.md) for more detailed information.
 
@@ -82,6 +83,11 @@ You also need to download the Appium client for your language so you can write t
 * Windows 10
 * [Documentation](/docs/en/appium-setup/running-on-windows.md)
 
+#### Mac Requirements
+
+* Mac OS X 10.7 +
+* [Documentation](https://github.com/penguinho/appium/blob/mac-driver/docs/en/appium-setup/running-on-osx.md#testing-mac-apps)
+
 ### Quick Start
 
 Kick up an Appium server, and then run a test written in your favorite [WebDriver](https://w3c.github.io/webdriver/webdriver-spec.html)-compatible language!

docs/en/appium-setup/running-on-osx.md

@@ -66,8 +66,15 @@ manager:
 brew install carthage
 ```
 
+### Testing Mac apps
 
+Currently, the Mac app driver for appium does not ship with the AppiumForMac binary, which means, in order to automate Mac apps you must manually install the AppiumForMac application and grant it the appropriate OS X Accessibility permissions.
 
+To Install Appium for Mac:
+1. [Download a release](https://github.com/appium/appium-for-mac/releases/tag/0.2.0) and unzip the application into your `/Applications` folder
+2. Follow the [brief supplemental installation instructions](https://github.com/appium/appium-for-mac#installation) to enable appium to have access to OS X's Accessibility APIs
+
+For more information on using Appium for mac, checkout the [docs](https://github.com/appium/appium-for-mac#appium-for-mac).
 
 ### System setup (Android)
 

lib/appium.js

@@ -11,6 +11,7 @@ import { SelendroidDriver } from 'appium-selendroid-driver';
 import { XCUITestDriver } from 'appium-xcuitest-driver';
 import { YouiEngineDriver } from 'appium-youiengine-driver';
 import { WindowsDriver } from 'appium-windows-driver';
+import { MacDriver } from 'appium-mac-driver';
 import B from 'bluebird';
 import util from 'util';
 
@@ -86,6 +87,10 @@ class AppiumDriver extends BaseDriver {
       return WindowsDriver;
     }
 
+    if (caps.platformName.toLowerCase() === 'mac') {
+      return MacDriver;
+    }
+
     let msg;
     if (caps.automationName) {
       msg = `Could not find a driver for automationName '${caps.automationName}' and platformName ` +
@@ -106,6 +111,7 @@ class AppiumDriver extends BaseDriver {
       AndroidDriver: 'appium-android-driver',
       IosDriver: 'appium-ios-driver',
       WindowsDriver: 'appium-windows-driver',
+      MacDriver: 'appium-mac-driver',
     };
     if (!NAME_DRIVER_MAP[driver.name]) {
       log.warn(`Unable to get version of driver '${driver.name}'`);

package.json

@@ -38,6 +38,7 @@
     "appium-base-driver": "2.x",
     "appium-fake-driver": "0.x",
     "appium-ios-driver": "1.x",
+    "appium-mac-driver": "1.x",
     "appium-selendroid-driver": "1.x",
     "appium-support": "2.x",
     "appium-uiautomator2-driver": "0.x",