bumping beta

.gitignore

@@ -31,3 +31,4 @@ lib/devices/ios/uiauto/lib/status.js
 lib/devices/ios/uiauto/appium/xpath.js
 *DerivedData
 __pycache__
+npm-shrinkwrap.json

.gitmodules

@@ -16,9 +16,6 @@
 [submodule "submodules/unlock_apk"]
 	path = submodules/unlock_apk
 	url = https://github.com/appium/unlock_apk.git
-[submodule "submodules/SafariLauncher"]
-	path = submodules/SafariLauncher
-	url = https://github.com/snevesbarros/SafariLauncher.git
 [submodule "submodules/libimobiledevice-macosx"]
 	path = submodules/libimobiledevice-macosx
 	url = https://github.com/benvium/libimobiledevice-macosx.git

CHANGELOG.md

@@ -1,4 +1,56 @@
-CHANGES IN VERSION 1.4
+CHANGES IN VERSION 1.5 (from 1.4.?)
+======================================
+
+*IN DEVELOPMENT*
+
+- add Tapster support for some more touch methods
+
+CHANGES IN VERSION 1.4.5 (from 1.4.4)
+===================================
+
+#### General
+- fix problem with npm shrinkwrap that caused Appium not to start
+
+
+CHANGES IN VERSION 1.4.4 (from 1.4.3)
+===================================
+
+#### Chromedriver / Android hybrid
+- fix a problem in downstream appium-chromedriver; no longer rely on async
+  methods returning objects of the Promise type. This was causing undefined
+  errors when running Chromedriver/hybrid tests.
+
+
+CHANGES IN VERSION 1.4.3 (from 1.4.2)
+===================================
+
+#### iOS
+- update the appium-instruments dependency with working subdeps
+
+
+CHANGES IN VERSION 1.4.2 (from 1.4.1)
+===================================
+
+#### General
+- update ES6-based dependencies which got bit by a breaking Regenerator
+  change
+
+#### iOS
+- keep track of the correct app ID for Safari webviews (fixes problems in
+  finding the webview for iOS)
+
+#### Android
+- fix sendKeys and clear for Samsung devices
+
+
+CHANGES IN VERSION 1.4.1 (from 1.4)
+===================================
+
+#### Chromedriver
+- have the appium-chromedriver manage the chromedriver binary download/install
+
+
+CHANGES IN VERSION 1.4 (from 1.3.7)
 ======================================
 
 #### General
@@ -7,10 +59,15 @@ CHANGES IN VERSION 1.4
 - updated sample code
 - updated documentation
 - updated test suite
+- deprecate node 0.10
 
 #### iOS
-- Support for iOS 8.3
-- fix for issues relating to finding xcode folder
+- support for iOS 8.3
+- deprecate iOS 6.1 and iOS 7.0 (support will be removed soon, probably 1.5)
+- deprecate Xcodes less than 6.3 (moving to support of latest versions only,
+  and Xcode 6.3+ together allows automation of all supported iOS versions). The
+  only exception to this is the combination of Xcode 6.0.1 + iOS 8.0.
+- fix for issues relating to finding xcode folder and Info.plist
 - new sever flag `--instruments <path>` to specify custom path to instruments commandLine tool
 - fix for getOrientation
 - fix for iOS crash log retrieval
@@ -24,6 +81,9 @@ CHANGES IN VERSION 1.4
 - new capability `disableAndroidWatchers`
 - deprecated capability `stopAppOnReset`
 - new capability `dontStopAppOnReset`
+- fix a crash possibly encountered during extracting app strings
+- new server argument `suppress-adb-kill-server`
+- fix issue with `keys()`; now it correctly targets currently-focused element
 
 #### Selendroid
 - Support for installApp, isAppInstalled and removeApp
@@ -31,10 +91,14 @@ CHANGES IN VERSION 1.4
 #### Android+Chrome
 - Chormedriver version updated to 2.15
 - fix for driver.quit()
+- use the correct ADB path already identified by Appium
 
 #### iOS+Safari
 - fix for handling real device object
 - fix for safariAllowPopups for iOS 8.x
+- reduce logging in remote debugger for real devices, and don't use console.log
+- fix issues with SafariLauncher on real devices
+- fix execute_async so that it now works at all
 
 CHANGES IN VERSION 1.3.7
 ======================================

README.md

@@ -88,7 +88,7 @@ You can run an Appium server using node.js or using the application, see below.
 
 #### Using Node.js
 
-```center
+```
 $ npm install -g appium
 $ appium &
 ```

bin/publish.sh

@@ -7,18 +7,9 @@ else
     branch="$1"
 fi
 
-XCODE_PATH=$(xcode-select -print-path)
-if test -d $XCODE_PATH/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator7.1.sdk ||
-   [ -e /Library/Developer/CoreSimulator/Profiles/Runtimes/iOS\ 7.1.simruntime ]; then
-    echo "Confirmed iOS7.1 SDK available"
-else
-    echo "You don't have iOS 7.1 SDK available. Switch to Xcode 5?"
-    exit 1
-fi
-
-node --version | grep "v0.10" >/dev/null
+node --version | grep "v0.12" >/dev/null
 if [ $? -gt 0 ]; then
-    echo "You need to publish Appium using Node 0.10.x, not $(node --version)"
+    echo "You need to publish Appium using Node 0.12.x, not $(node --version)"
     exit 1;
 else
     echo "Node version OK"
@@ -50,7 +41,9 @@ set -e
 echo "Getting latest from upstream:$branch"
 git pull upstream $branch
 echo "Resetting"
-./reset.sh --hardcore --real-safari --chromedriver-install-all --chromedriver-version 2.15
+./reset.sh --no-npmlink --hardcore --chromedriver-install-all --chromedriver-version 2.15
+rm -rf node_modules npm-shrinkwrap.json
+npm install --production && npm shrinkwrap
 version=$(cat package.json | $(npm bin)/underscore extract version | sed 's/\"//g')
 echo "Clearing npm cache"
 npm cache clear appium

docs/cn/about-appium/intro.cn.md

@@ -21,7 +21,7 @@ Appium 是一个自动化测试开源工具，支持 iOS 平台和 Android 平
 
 那么 Appium 架构是如何实现这个哲学呢？为了满足第一条，Appium 真正的工作引擎其实是第三方自动化框架。这样，我们就不需在你的应用里植入 Appium 相关或者第三方的代码。这意味着你测试使用的应用与最终发布的应用并无二致。我们使用以下的第三方框架：
 
-* iOS: 苹果的 [UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html)
+* iOS: 苹果的 [UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef)
 * Android 4.2+: Google's [UiAutomator](http://developer.android.com/tools/help/uiautomator/index.html)
 * Android 2.3+: Google's [Instrumentation](http://developer.android.com/reference/android/app/Instrumentation.html). (Instrumentation由单独的项目[Selendroid](http://selendroid.io)提供支持 )
 

docs/cn/appium-setup/platform-support.cn.md

@@ -9,7 +9,7 @@ Appimu的时候支持的平台版本和上述测试方式的必备条件。
 
 * 版本号：6.1，7.0，以及7.1。
 * 支持设备：iPhone模拟器，iPad模拟器以及iPhones和iPads真机。
-* 是否支持原生应用：支持。同时支持模拟器中调试应用版本和正确签名的真机ipa。其他相关支持由苹果的[UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html)框架提供。
+* 是否支持原生应用：支持。同时支持模拟器中调试应用版本和正确签名的真机ipa。其他相关支持由苹果的[UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/)框架提供。
 * 是否支持内置移动浏览器：支持。Safari浏览器已经通过测试。对于真机，则需要安装调试工具ios-webkit-remote-debugger。很遗憾，对于Safari的原生界面的自动化是不支持的。更多信息请移步至[mobile web doc](/docs/cn/writing-running-appium/mobile-web.cn.md) 。
 * 是否支持混合应用：支持。同样对于真机需要安装调试工具ios-webkit-remote-debugger，更多详情请移步至[hybrid doc](/docs/cn/advanced-concepts/hybrid.cn.md) 查看详情。
 * 是否支持在同一个session中执行多个应用的自动化：不支持。

docs/cn/writing-running-appium/ios_predicate.cn.md

@@ -1,6 +1,6 @@
 ## iOS 谓词(Predicate)
 
-在查看 *'-ios uiautomation'* 搜索策略时了解 **谓词(Predicate)** 十分必要。 [UIAutomation JavaScript API](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html)有下列几种非常有用的方法:
+在查看 *'-ios uiautomation'* 搜索策略时了解 **谓词(Predicate)** 十分必要。 [UIAutomation JavaScript API](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/)有下列几种非常有用的方法:
 
 ```center
 (UIAElement) UIAElementArray.firstWithPredicate(PredicateString predicateString)
@@ -243,4 +243,4 @@ predicate = "name contains[c] '#{text}' || label contains[c] '#{text}' || value
 element = execute_script(%Q(au.mainApp().getFirstWithPredicate("#{predicate}");))
 
 puts element.name # Buttons, Various uses of UIButton
-```
+```

docs/en/about-appium/intro.md

@@ -31,7 +31,7 @@ meet requirement #1 by using vendor-provided automation frameworks under the
 hood. That way, we don't need to compile in any Appium-specific or
 third-party code or frameworks to your app. This means **you're testing the same app you're shipping**. The vendor-provided frameworks we use are:
 
-* iOS: Apple's [UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html)
+* iOS: Apple's [UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/)
 * Android 4.2+: Google's [UiAutomator](http://developer.android.com/tools/help/uiautomator/index.html)
 * Android 2.3+: Google's [Instrumentation](http://developer.android.com/reference/android/app/Instrumentation.html). (Instrumentation support is provided by bundling a separate project, [Selendroid](http://selendroid.io))
 

docs/en/appium-setup/platform-support.md

@@ -13,7 +13,7 @@ instructions.
 * Devices: iPhone Simulator, iPad Simulator, and real iPhones and iPads
 * Native app support: Yes, with debug version of .app (simulator),
   or correctly-signed .ipa (real devices). Underlying support is provided by
-  Apple's [UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html)
+  Apple's [UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/)
   framework.
 * Mobile web support: Yes, via automation of mobile Safari. For real devices,
   ios-webkit-remote-debugger is required, and automation of native aspects of

docs/en/appium-setup/troubleshooting.md

@@ -67,6 +67,14 @@ own items in the SDK manager. Make sure you install the build-tools and platform
   a new version of Xcode, as well.
 * If you see `iOS Simulator failed to install the application.` and the
   paths are correct, try restarting the computer.
+* If you have custom elements in your app, they will not be automatable by
+  UIAutomation (and therefore Appium) by default. You need to set the
+  accessibility status to 'enabled' on them. The way to do this in code is:
+
+  ```center
+  [myCustomView setAccessibilityEnabled:YES];
+  ```
+
 * Tests on iOS may exhibit symptoms similar to a memory leak including sluggish
   performance or hangs. If you experience this problem, it's likely due to a
   known issue with NSLog. One option is to remove NSLog from your code.

docs/en/contributing-to-appium/credits.md

@@ -2,7 +2,7 @@
 
 ###  These are the projects that inspired us, or are depended upon to make Appium awesome.
 
-* [Apple UIAutomation](http://developer.apple.com/library/ios/#documentation/DeveloperTools/Reference/UIAutomationRef/_index.html)
+* [Apple UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/)
 * [GhostDriver](https://github.com/detro/ghostdriver)
 * [IOS Auto](https://github.com/penguinho/applecart)
 * [IOS Driver](https://github.com/ios-driver/ios-driver)

docs/en/writing-running-appium/caps.md

@@ -56,6 +56,7 @@
 |`noSign`| Skip checking and signing of app with debug keys, will work only with UiAutomator and not with selendroid, default `false`| `true` or `false`|
 |`ignoreUnimportantViews`| Calls the `setCompressedLayoutHierarchy()` uiautomator function. This capability can speed up test execution, since Accessibility commands will run faster ignoring some elements. The ignored elements will not be findable, which is why this capability has also been implemented as a toggle-able *setting* as well as a capability. Defaults to `false` | `true` or `false`
 |`disableAndroidWatchers`| Disables android watchers that watch for application not responding and application crash, this will reduce cpu usage on android device/emulator. This capability will work only with UiAutomator and not with selendroid, default `false`| `true` or `false`|
+|`chromeOptions`| Allows passing chromeOptions capability for chrome driver. For more information see [chromeOptions](https://sites.google.com/a/chromium.org/chromedriver/capabilities) | `chromeOptions: {args: ['--disable-popup-blocking']}` |
 
 ### iOS Only
 

docs/en/writing-running-appium/ios_predicate.md

@@ -1,7 +1,7 @@
 ## iOS Predicate
 
 It is worth looking at *'-ios uiautomation'* search strategy with **Predicates**.
-[UIAutomation JavaScript API](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html) has following methods which can are very useful.
+[UIAutomation JavaScript API](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/) has following methods which can are very useful.
 
 ```center
 (UIAElement) UIAElementArray.firstWithPredicate(PredicateString predicateString)

docs/en/writing-running-appium/server-args.md

@@ -1,8 +1,8 @@
-# Appium server arguments
+## Appium server arguments
 
 Usage: `node . [flags]`
 
-## Server flags
+### Server flags
 All flags are optional, but some are required in conjunction with certain others.
 
 

docs/old/cn/intro.cn.md

@@ -27,7 +27,7 @@ Appium 是一个自动化测试开源工具，支持 iOS 平台和 Android 平
 这样，我们就不需在你的应用里植入 Appium 特定或者第三方的代码。这就意味着你在测试你将发布的应用。我们
 使用以下的第三方框架：
 
-* iOS: 苹果的 [UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html)
+* iOS: 苹果的 [UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/)
 * Android 4.2+: Google's [UiAutomator](http://developer.android.com/tools/help/uiautomator/index.html)
 * Android 2.3+: Google's [Instrumentation](http://developer.android.com/reference/android/app/Instrumentation.html). (Instrumentation support is provided by bundling a separate project, [Selendroid](http://selendroid.io))
 

docs/old/cn/ios_predicate.cn.md

@@ -1,6 +1,6 @@
 # iOS Predicate
 
-I'd like to share my experience in using *'-ios uiautomation'* search strategy with **Predicates**. After using Instruments/UIAutomation tool for a long time I paid attention on the following methods in [UIAutomation JavaScript API](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html):
+I'd like to share my experience in using *'-ios uiautomation'* search strategy with **Predicates**. After using Instruments/UIAutomation tool for a long time I paid attention on the following methods in [UIAutomation JavaScript API](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/):
 
 ```java
 (UIAElement) UIAElementArray.firstWithPredicate(PredicateString predicateString)

docs/old/cn/platform-support.cn.md

@@ -11,7 +11,7 @@ Appimu时候支持的平台版本和上述测试方式的必备条件。
 * 版本号：6.1 , 7.0 , and 7.1
 * 支持设备： iPhone 模拟器, iPad 模拟器以及iPhones 和 iPads真机
 * 是否支持原生应用：支持 。同时支持模拟器中调试应用版本和正确签名的真机ipa。
-  其他相关支持由苹果的[UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/_index.html)
+  其他相关支持由苹果的[UIAutomation](https://developer.apple.com/library/ios/documentation/DeveloperTools/Reference/UIAutomationRef/)
   框架提供。
 * 是否支持内嵌浏览器：支持, Safari浏览器已经通过测试。对于
   真机,则需要安装调试工具 ios-webkit-remote-debugger，很遗憾

grunt-helpers.js

@@ -355,7 +355,7 @@ module.exports.signApp = function (appName, certName, cb) {
 };
 
 module.exports.buildSafariLauncherApp = function (cb, sdk, xcconfig) {
-  var appRoot = path.resolve(__dirname, "submodules", "SafariLauncher");
+  var appRoot = path.resolve(require.resolve('safari-launcher'), '..');
   module.exports.build(appRoot, function (err) {
     if (err !== null) {
       console.log(err);

lib/devices/android/android-common.js

@@ -819,6 +819,7 @@ androidCommon.extractStringsFromApk = function (makeStrings, language, cb) {
 };
 
 androidCommon.extractStrings = function (cb, language) {
+  logger.debug("Extracting strings for language: " + (language || "default"));
   var outputPath = path.resolve(this.args.tmpDir, this.args.appPackage);
   var stringsJson = 'strings.json';
   if (!fs.existsSync(this.args.app)) {
@@ -835,8 +836,21 @@ androidCommon.extractStrings = function (cb, language) {
         this.language = null;
         return cb(err);
       }
-      var file = fs.readFileSync(path.join(outputPath, stringsJson), 'utf8');
-      this.apkStrings = JSON.parse(file);
+      var file;
+      try {
+        logger.debug("Reading strings from converted strings.json");
+        file = fs.readFileSync(path.join(outputPath, stringsJson)).toString('utf8');
+        this.apkStrings = JSON.parse(file);
+      } catch (e) {
+        var msg = "Could not parse strings from strings.json. Original " +
+                  "error: " + e.message;
+        logger.debug(msg);
+        if (file) {
+          logger.debug("Content started with: " + file.slice(0, 300));
+        }
+        return cb(new Error(msg));
+      }
+      logger.debug("Setting language to " + (language || "default"));
       this.language = language;
       cb();
     }.bind(this));

lib/devices/android/android-controller.js

@@ -202,15 +202,15 @@ androidController.getPageIndex = function (elementId, cb) {
   cb(new NotYetImplementedError(), null);
 };
 
-androidController.keys = function (elementId, keys, cb) {
+androidController.keys = function (keys, cb) {
   var params = {
-    elementId: elementId,
-    text: keys
+    text: keys,
+    replace: false
   };
   if (this.args.unicodeKeyboard) {
     params.unicodeKeyboard = true;
   }
-  this.proxy(["element:setText", params], cb);
+  this.proxy(['setText', params], cb);
 };
 
 androidController.frame = function (frame, cb) {
@@ -1026,7 +1026,7 @@ androidController.performTouch = function (gestures, cb) {
 };
 
 androidController.parseTouch = function (gestures, multi, cb) {
-  if (_.last(gestures).action === 'release') {
+  if (multi && _.last(gestures).action === 'release') {
     gestures.pop();
   }
 

lib/devices/android/android-hybrid.js

@@ -3,11 +3,6 @@
 var logger = require('../../server/logger.js').get('appium')
   , _ = require('underscore')
   , errors = require('../../server/errors.js')
-  , path = require('path')
-  , system = require('appium-support').system
-  , isWindows = system.isWindows()
-  , isLinux = system.isLinux()
-  , exec = require('child_process').exec
   , UnknownError = errors.UnknownError
   , async = require('async')
   , Chromedriver = require('appium-chromedriver')
@@ -173,12 +168,11 @@ androidHybrid.setupNewChromedriver = function (context, cb) {
       this.onChromedriverStop(context);
     }
   }.bind(this));
-  this.chromedriver.start(caps).nodeify(function (err) {
-    if (err) return cb(err);
+  this.chromedriver.start(caps).then(function () {
     // save the chromedriver object under the context
     this.sessionChromedrivers[context] = this.chromedriver;
     cb();
-  }.bind(this));
+  }.bind(this), cb);
 };
 
 
@@ -192,18 +186,16 @@ androidHybrid.setupExistingChromedriver = function (context, cb) {
 
   // check the status by sending a simple window-based command to ChromeDriver
   // if there is an error, we want to recreate the ChromeDriver session
-  this.chromedriver.hasWorkingWebview().nodeify(function (err, works) {
-    if (err) return cb(err);
+  this.chromedriver.hasWorkingWebview().then(function (works) {
     if (works) return cb();
     logger.debug("ChromeDriver is not associated with a window. " +
                  "Re-initializing the session.");
     this.chromedriverRestartingContext = context;
-    this.chromedriver.restart().nodeify(function (err) {
-      if (err) return cb(err);
+    this.chromedriver.restart().then(function () {
       this.chromedriverRestartingContext = null;
       cb();
-    }.bind(this));
-  }.bind(this));
+    }.bind(this), cb);
+  }.bind(this), cb);
 };
 
 androidHybrid.onChromedriverStop = function (context) {
@@ -242,12 +234,15 @@ androidHybrid.stopChromedriverProxies = function (ocb) {
     logger.debug("Stopping chromedriver for context " + context);
     // stop listening for the stopped state event
     this.sessionChromedrivers[context].removeAllListeners(Chromedriver.EVENT_CHANGED);
-    this.sessionChromedrivers[context].stop().nodeify(function (err) {
+    var onStop = function (err) {
       if (err) logger.warn("Error stopping Chromedriver: " + err.message);
       // chromedriver isn't valid anymore, so remove it from context list
       delete this.sessionChromedrivers[context];
       cb();
-    }.bind(this));
+    }.bind(this);
+    this.sessionChromedrivers[context].stop().then(function () {
+      onStop();
+    }, onStop);
   }.bind(this), function (err) {
     // if one of these fails, go back to last proxy state and error out
     this.restoreProxyState();
@@ -277,38 +272,4 @@ androidHybrid.initAutoWebview = function (cb) {
   }
 };
 
-// get the correct chromedriver executable path based on our system
-// TODO: don't download/build chromedriver in reset.sh, instead let this be
-// something that the appium-chromedriver package manages
-androidHybrid.initChromedriverPath = function (cb) {
-  if (this.args.chromedriverExecutable) {
-    cb();
-  } else {
-    var setPath = function (platform, executable) {
-      this.args.chromedriverExecutable = path.resolve(__dirname, "..", "..",
-          "..", "build", "chromedriver", platform, executable);
-      logger.debug("Set chromedriver binary as: " + this.args.chromedriverExecutable);
-    }.bind(this);
-    if (isLinux) {
-      logger.debug("Determining linux architecture");
-      exec("uname -m", function (err, stdout) {
-        var executable;
-        if (err) return cb(err);
-        if (stdout.trim() === "i686") {
-          executable = "chromedriver32";
-        } else {
-          executable = "chromedriver64";
-        }
-        setPath("linux", executable);
-        cb();
-      });
-    } else {
-      var executable = isWindows ? "chromedriver.exe" : "chromedriver";
-      var platform = isWindows ? "windows" : "mac";
-      setPath(platform, executable);
-      cb();
-    }
-  }
-};
-
 module.exports = androidHybrid;

lib/devices/android/android.js

@@ -101,7 +101,6 @@ Android.prototype.start = function (cb, onDie) {
     this.initAdb.bind(this),
     this.packageAndLaunchActivityFromManifest.bind(this),
     this.initUiautomator.bind(this),
-    this.initChromedriverPath.bind(this),
     this.prepareDevice.bind(this),
     this.checkApiLevel.bind(this),
     this.pushStrings.bind(this),
@@ -330,12 +329,15 @@ Android.prototype.pushStrings = function (cb, language) {
     if (err) {
       if (!fs.existsSync(this.args.app)) {
         // apk doesn't exist locally so remove old strings.json
+        logger.debug("Could not get strings, but it looks like we had an " +
+                     "old strings file anyway, so ignoring");
         return this.adb.rimraf(remotePath + '/' + stringsJson, function (err) {
           if (err) return cb(new Error("Could not remove old strings"));
           cb();
         });
       } else {
         // if we can't get strings, just dump an empty json and continue
+        logger.warn("Could not get strings, continuing anyway");
         var remoteFile = remotePath + '/' + stringsJson;
         return this.adb.shell("echo '{}' > " + remoteFile, cb);
       }
@@ -573,8 +575,8 @@ Android.prototype.setActualCapabilities = function (cb) {
       logger.debug("Device is at release version " + version);
       this.capabilities.platformVersion = version;
     }
+    return cb();
   }.bind(this));
-  cb();
 };
 
 Android.prototype.resetTimeout = deviceCommon.resetTimeout;

lib/devices/android/bootstrap/src/io/appium/android/bootstrap/handler/SetText.java

@@ -2,7 +2,10 @@ package io.appium.android.bootstrap.handler;
 
 import com.android.uiautomator.core.UiDevice;
 import com.android.uiautomator.core.UiObjectNotFoundException;
+import com.android.uiautomator.core.UiSelector;
 import io.appium.android.bootstrap.*;
+import io.appium.android.bootstrap.exceptions.ElementNotFoundException;
+import io.appium.android.bootstrap.handler.Find;
 import org.json.JSONException;
 
 import java.util.Hashtable;
@@ -26,51 +29,60 @@ public class SetText extends CommandHandler {
   @Override
   public AndroidCommandResult execute(final AndroidCommand command)
       throws JSONException {
+
+    AndroidElement el = null;
     if (command.isElementCommand()) {
-      // Only makes sense on an element
-      try {
-        final Hashtable<String, Object> params = command.params();
-        final AndroidElement el = command.getElement();
-        boolean replace = Boolean.parseBoolean(params.get("replace").toString());
-        String text = params.get("text").toString();
-        boolean pressEnter = false;
-        if (text.endsWith("\\n")) {
-          pressEnter = true;
-          text = text.replace("\\n", "");
-          Logger.debug("Will press enter after setting text");
-        }
-        boolean unicodeKeyboard = false;
-        if (params.get("unicodeKeyboard") != null) {
-          unicodeKeyboard = Boolean.parseBoolean(params.get("unicodeKeyboard").toString());
-        }
-        String currText = el.getText();
-        new Clear().execute(command);
-        if (!el.getText().isEmpty()) {
-          // clear could have failed, or we could have a hint in the field
-          // we'll assume it is the latter
-          Logger.debug("Text not cleared. Assuming remainder is hint text.");
-          currText = "";
-        }
-        if (!replace) {
-          text = currText + text;
-        }
-        final boolean result = el.setText(text, unicodeKeyboard);
-        if (!result) {
-          return getErrorResult("el.setText() failed!");
-        }
-        if (pressEnter) {
-          final UiDevice d = UiDevice.getInstance();
-          d.pressEnter();
-        }
-        return getSuccessResult(result);
-      } catch (final UiObjectNotFoundException e) {
-        return new AndroidCommandResult(WDStatus.NO_SUCH_ELEMENT,
-            e.getMessage());
-      } catch (final Exception e) { // handle NullPointerException
-        return getErrorResult("Unknown error");
-      }
+      Logger.debug("Using element passed in.");
+      el = command.getElement();
     } else {
-      return getErrorResult("Unable to set text without an element.");
+      try {
+        Logger.debug("Using currently-focused element.");
+        AndroidElementsHash  elements = AndroidElementsHash.getInstance();
+        el = elements.getElement(new UiSelector().focused(true), "");
+      } catch (ElementNotFoundException e) {
+        Logger.debug("Error retrieving focused element: " + e);
+        return getErrorResult("Unable to set text without a focused element.");
+      }
+    }
+    try {
+      final Hashtable<String, Object> params = command.params();
+      boolean replace = Boolean.parseBoolean(params.get("replace").toString());
+      String text = params.get("text").toString();
+      boolean pressEnter = false;
+      if (text.endsWith("\\n")) {
+        pressEnter = true;
+        text = text.replace("\\n", "");
+        Logger.debug("Will press enter after setting text");
+      }
+      boolean unicodeKeyboard = false;
+      if (params.get("unicodeKeyboard") != null) {
+        unicodeKeyboard = Boolean.parseBoolean(params.get("unicodeKeyboard").toString());
+      }
+      String currText = el.getText();
+      new Clear().execute(command);
+      if (!el.getText().isEmpty()) {
+        // clear could have failed, or we could have a hint in the field
+        // we'll assume it is the latter
+        Logger.debug("Text not cleared. Assuming remainder is hint text.");
+        currText = "";
+      }
+      if (!replace) {
+        text = currText + text;
+      }
+      final boolean result = el.setText(text, unicodeKeyboard);
+      if (!result) {
+        return getErrorResult("el.setText() failed!");
+      }
+      if (pressEnter) {
+        final UiDevice d = UiDevice.getInstance();
+        d.pressEnter();
+      }
+      return getSuccessResult(result);
+    } catch (final UiObjectNotFoundException e) {
+      return new AndroidCommandResult(WDStatus.NO_SUCH_ELEMENT,
+          e.getMessage());
+    } catch (final Exception e) { // handle NullPointerException
+      return getErrorResult("Unknown error");
     }
   }
 }

lib/devices/android/bootstrap/src/io/appium/uiautomator/core/UiAutomatorBridge.java

@@ -49,7 +49,7 @@ public class UiAutomatorBridge {
   }
 
   public boolean injectInputEvent(InputEvent event, boolean sync) {
-    return (Boolean) invoke(method(CLASS_UI_AUTOMATOR_BRIDGE, METHOD_INJECT_INPUT_EVENT, InputEvent.class, Boolean.class),
+    return (Boolean) invoke(method(CLASS_UI_AUTOMATOR_BRIDGE, METHOD_INJECT_INPUT_EVENT, InputEvent.class, boolean.class),
             uiAutomatorBridge, event, sync);
   }
 

lib/devices/android/chrome.js

@@ -8,7 +8,6 @@ var Android = require('./android.js')
   , deviceCommon = require('../common.js')
   , jwpSuccess = deviceCommon.jwpSuccess
   , async = require('async')
-  , ADB = require('./adb.js')
   , UiAutomator = require('./uiautomator.js');
 
 var NATIVE_WIN = "NATIVE_APP";
@@ -81,16 +80,13 @@ ChromeAndroid.prototype.startAutomation = function (cb) {
 };
 
 ChromeAndroid.prototype.start = function (cb, onDie) {
-  this.adb = new ADB(this.args);
-  this.uiautomator = new UiAutomator(this.adb, this.args);
-  this.uiautomator.setExitHandler(this.onUiautomatorExit.bind(this));
   this.onDieCb = onDie;
 
   async.series([
     this.initAdb.bind(this),
+    this.prepareUiAutomator.bind(this),
     this.initUiautomator.bind(this),
     this.prepareDevice.bind(this),
-    this.initChromedriverPath.bind(this),
     this.prepareChromedriver.bind(this),
     this.pushAndUnlock.bind(this),
     this.forwardPort.bind(this),
@@ -116,6 +112,12 @@ ChromeAndroid.prototype.prepareChromedriver = function (cb) {
   cb();
 };
 
+ChromeAndroid.prototype.prepareUiAutomator = function (cb) {
+  this.uiautomator = new UiAutomator(this.adb, this.args);
+  this.uiautomator.setExitHandler(this.onUiautomatorExit.bind(this));
+  cb();
+};
+
 ChromeAndroid.prototype.pushAndUnlock = function (cb) {
   this.pushUnlock(function (err) {
     if (err) return cb(err);
@@ -149,17 +151,20 @@ ChromeAndroid.prototype.createSession = function (cb) {
       this.onChromedriverStop(this.onDieCb);
     }
   }.bind(this));
-  this.chromedriver.start(caps).nodeify(cb);
+  this.chromedriver.start(caps).then(function () {
+    cb(null, this.chromedriver.sessionId());
+  }.bind(this), cb);
 };
 
 ChromeAndroid.prototype.stop = function (cb) {
   // stop listening for the stopped state event
   this.chromedriver.removeAllListeners(Chromedriver.EVENT_CHANGED);
   // now we can handle the stop on our own
-  this.chromedriver.stop().nodeify(function (err) {
+  var onStop = function (err) {
     if (err) logger.warn("Error stopping Chromedriver: " + err.message);
     this.onChromedriverStop(cb);
-  }.bind(this));
+  }.bind(this);
+  this.chromedriver.stop().then(function () { onStop(); }, onStop);
 };
 
 ChromeAndroid.prototype.onChromedriverStop = function (cb) {

lib/devices/android/selendroid.js

@@ -70,6 +70,7 @@ Selendroid.prototype.init = function () {
     , ['POST', new RegExp('^/wd/hub/session/[^/]+/network_connection')]
     , ['POST', new RegExp('^/wd/hub/session/[^/]+/ime')]
     , ['GET', new RegExp('^/wd/hub/session/[^/]+/ime')]
+    , ['POST', new RegExp('^/wd/hub/session/[^/]+/keys')]
   ];
   this.curContext = this.defaultContext();
 };
@@ -525,12 +526,11 @@ Selendroid.prototype.defaultWebviewName = function () {
   return this.WEBVIEW_WIN + "_0";
 };
 
-Selendroid.prototype.setValue = function (elementId, value, cb) {
-  logger.debug('Setting text on element \'' + elementId + '\': \'' + value + '\'');
+var encodeString = function (value, unicode) {
   for (var i = 0; i < value.length; i++) {
     var c = value.charCodeAt(i);
     // if we're using the unicode keyboard, and this is unicode, maybe encode
-    if (this.args.unicodeKeyboard && (c > 127 || c === 38)) {
+    if (unicode && (c > 127 || c === 38)) {
       // this is not simple ascii, or it is an ampersand (`&`)
       if (c >= parseInt("E000", 16) && c <= parseInt("E040", 16)) {
         // Selenium uses a Unicode PUA to cover certain special characters
@@ -542,6 +542,12 @@ Selendroid.prototype.setValue = function (elementId, value, cb) {
       }
     }
   }
+  return value;
+};
+
+Selendroid.prototype.setValue = function (elementId, value, cb) {
+  logger.debug('Setting text on element \'' + elementId + '\': \'' + value + '\'');
+  value = encodeString(value, this.args.unicodeKeyboard);
   var reqUrl = this.proxyHost + ':' + this.proxyPort +
       '/wd/hub/session/' + this.proxySessionId +
       '/element/' + elementId + '/value';
@@ -554,6 +560,21 @@ Selendroid.prototype.setValue = function (elementId, value, cb) {
   });
 };
 
+Selendroid.prototype.keys = function (value, cb) {
+  logger.debug('Setting text: \'' + value + '\'');
+  value = encodeString(value, this.args.unicodeKeyboard);
+  var reqUrl = this.proxyHost + ':' + this.proxyPort +
+      '/wd/hub/session/' + this.proxySessionId +
+      '/keys';
+  doRequest(reqUrl, 'POST', { value: [value] }, null, function (err) {
+    if (err) return cb(err);
+    cb(null, {
+      status: status.codes.Success.code,
+      value: ''
+    });
+  });
+};
+
 Selendroid.prototype.back = function (cb) {
   this.keyevent(4, null, cb);
 };

lib/devices/ios/ios-controller.js

@@ -22,8 +22,11 @@ var uuid = require('uuid-js')
   , IOSPerfLog = require('./ios-perf-log')
   , errors = require('../../server/errors.js')
   , isWindows = require('appium-support').system.isWindows
+  , localIp = require('appium-support').util.localIp
   , NotImplementedError = errors.NotImplementedError
-  , NotYetImplementedError = errors.NotYetImplementedError;
+  , NotYetImplementedError = errors.NotYetImplementedError
+  , Parser = require('../../server/parser.js')
+  , url = require('url');
 
 var iOSController = {};
 var FLICK_MS = 3000;
@@ -41,6 +44,13 @@ var logTypesSupported = {
   'performance': 'Performance Logs - Debug Timelines on real devices and simulators'
 };
 
+var getDefaultCallbackAddress = function () {
+  var parser = new Parser();
+  return parser.rawArgs.filter(function (a) {
+    return a[0][1] === '--address';
+  })[0][1].defaultValue;
+};
+
 iOSController.getStatusExtensions = function () {
   var ext = {};
   ext.isShuttingDown = this.isShuttingDown; // this is for testing purposes
@@ -1887,6 +1897,21 @@ iOSController.execute = function (script, args, cb) {
 
 iOSController.executeAsync = function (script, args, responseUrl, cb) {
   if (this.isWebContext()) {
+    if (this.args.udid) {
+      var defaultHost = getDefaultCallbackAddress();
+      var urlObject = url.parse(responseUrl);
+      if (urlObject.hostname === defaultHost) {
+        logger.debug('Real device safari test and no custom ' +
+                     'callback address set, ' +
+                     'changing callback address to local ip.');
+        urlObject.hostname = localIp();
+        urlObject.host = null; // set to null, otherwise hostname is ignored
+        responseUrl = url.format(urlObject);
+      } else {
+        logger.debug('Custom callback address set, leaving as is.');
+      }
+    }
+
     logger.debug("Response url for executeAsync is " + responseUrl);
     this.convertElementForAtoms(args, function (err, res) {
       if (err) {

lib/devices/ios/ios-hybrid.js

@@ -77,9 +77,11 @@ iOSHybrid.listWebFrames = function (cb, exitCb) {
       if (this.remoteAppKey === null) {
         return cb(new Error("remote debug app key must be set"));
       }
-      this.remote.selectApp(this.remoteAppKey, function (res) {
+      this.remote.selectApp(this.remoteAppKey, function (err, perhapsModifiedAppKey, res) {
+        if (err) return onDone(err);
+        this.remoteAppKey = perhapsModifiedAppKey;
         onDone(null, res);
-      });
+      }.bind(this));
     }
   } else {
     if (this.args.udid !== null) {
@@ -107,9 +109,11 @@ iOSHybrid.listWebFrames = function (cb, exitCb) {
         }
         logger.debug("Using remote debugger app key: " + appKey);
         this.remoteAppKey = appKey;
-        this.remote.selectApp(appKey, function (res) {
+        this.remote.selectApp(appKey, function (err, perhapsModifiedAppKey, res) {
+          if (err) return onDone(err);
+          this.remoteAppKey = perhapsModifiedAppKey;
           onDone(null, res);
-        });
+        }.bind(this));
       }.bind(this), this.onPageChange.bind(this));
       var loopCloseRuns = 0;
       var loopClose = function () {

lib/devices/ios/ios.js

@@ -30,7 +30,7 @@ var path = require('path')
   , UnknownError = errors.UnknownError
   , binaryPlist = true
   , Args = require("vargs").Constructor
-  ;
+  , logCustomDeprecationWarning = require('../../helpers.js').logCustomDeprecationWarning;
 
 // XML Plist library helper
 var parseXmlPlistFile = function (plistFilename, cb) {
@@ -155,6 +155,13 @@ IOS.prototype.configure = function (args, caps, cb) {
     return cb(new Error(msg));
   }
 
+  if (parseFloat(caps.platformVersion) < 7.1) {
+    logCustomDeprecationWarning('iOS version', caps.platformVersion,
+                                'iOS ' + caps.platformVersion + ' support has ' +
+                                'been deprecated and will be removed in a ' +
+                                'future version of Appium.');
+  }
+
   return this.configureApp(cb);
 };
 
@@ -321,48 +328,30 @@ IOS.prototype.startInstruments = function (cb) {
     });
   }.bind(this);
 
-  if (this.shouldIgnoreInstrumentsExit()) {
-    // for safari on a real device, instruments is going to crash, but we
-    // expect that and ignore it
-    logger.debug("Not starting command proxy since we're expecting that " +
-                 "Instruments won't be able to talk to it anyway");
-    this.instruments.start(
-      function (err) {
-        if (err) return treatError(err, cb);
-        // instruments will never check into the command proxy, so go ahead
-        // and just call back here once instruments is started, rather than
-        // waiting for it to make the first connection to the command proxy
-        cb();
-      }
-    , function () {
-        // ignore unexpected instruments exit since that's exactly what
-        // we're expecting anyway
-    });
-  } else {
-    logger.debug("Starting command proxy.");
-    this.commandProxy.start(
-      function (err) { // on first connection
-        // first let instruments know so that it does not restart itself
-        this.instruments.launchHandler(err);
-        // then we call the callback
-        cb(err);
-      }.bind(this)
-      //
-    , function (err) { // regular cb
-        if (err) return treatError(err, cb);
-        logger.debug("Starting instruments");
-        this.instruments.start(
-          function (err) {
-            if (err) return treatError(err, cb);
-            // we don't call cb here, waiting for first connection or error
-          }.bind(this)
-        , function (code) {
+  logger.debug("Starting command proxy.");
+  this.commandProxy.start(
+    function onFirstConnection(err) {
+      // first let instruments know so that it does not restart itself
+      this.instruments.launchHandler(err);
+      // then we call the callback
+      cb(err);
+    }.bind(this)
+  , function regularCallback(err) {
+      if (err) return treatError(err, cb);
+      logger.debug("Starting instruments");
+      this.instruments.start(
+        function (err) {
+          if (err) return treatError(err, cb);
+          // we don't call cb here, waiting for first connection or error
+        }.bind(this)
+      , function (code) {
+          if (!this.shouldIgnoreInstrumentsExit()) {
             this.onUnexpectedInstrumentsExit(code);
-          }.bind(this)
-        );
-      }.bind(this)
-    );
-  }
+          }
+        }.bind(this)
+      );
+    }.bind(this)
+  );
 };
 
 IOS.prototype.makeInstruments = function (cb) {
@@ -372,7 +361,7 @@ IOS.prototype.makeInstruments = function (cb) {
   var bootstrap = prepareBootstrap({
     sock: this.sock,
     interKeyDelay: this.args.interKeyDelay,
-    justLoopInfinitely: this.shouldIgnoreInstrumentsExit(),
+    justLoopInfinitely: false,
     autoAcceptAlerts: !(!this.args.autoAcceptAlerts || this.args.autoAcceptAlerts === 'false'),
     autoDismissAlerts: !(!this.args.autoDismissAlerts || this.args.autoDismissAlerts === 'false'),
     sendKeyStrategy: this.args.sendKeyStrategy || (this.args.udid ? 'grouped' : 'oneByOne')
@@ -543,8 +532,22 @@ IOS.prototype.setXcodeVersion = function (cb) {
   xcode.getVersion(function (err, versionNumber) {
     if (err) {
       logger.error("Could not determine Xcode version:" + err.message);
+    } else {
+      var minorVersion = parseFloat(versionNumber.slice(0, 3));
+      var pv = parseFloat(this.args.platformVersion);
+      // we deprecate Xcodes < 6.3, except for iOS 8.0 in which case we
+      // support Xcode 6.0 as well
+      if (minorVersion < 6.3 && (!(minorVersion === 6.0 && pv === 8.0))) {
+        logCustomDeprecationWarning('Xcode version', versionNumber,
+                                    'Support for Xcode ' + versionNumber + ' ' +
+                                    'has been deprecated and will be removed ' +
+                                    'in a future version. Please upgrade ' +
+                                    'to version 6.3 or higher (or version ' +
+                                    '6.0.1 for iOS 8.0)');
+      }
     }
     this.xcodeVersion = versionNumber;
+    logger.debug("Xcode version set to " + versionNumber);
     cb();
   }.bind(this));
 };
@@ -707,9 +710,9 @@ IOS.prototype.instantLaunchAndQuit = function (needSafariDirs, cb) {
   var condition = function () {
     var simDirsExist = this.sim.dirsExist();
     var locServicesExist = settings.locServicesDirsExist(this.sim);
-    var safariDirsExist = this.iOSSDKVersion < 7.0 ||
+    var safariDirsExist = this.args.platformVersion < 7.0 ||
                           (this.sim.safariDirsExist() &&
-                           (this.iOSSDKVersion < 8.0 ||
+                           (this.args.platformVersion < 8.0 ||
                             this.sim.userSettingsPlistExists())
                           );
     var okToGo = simDirsExist && locServicesExist &&
@@ -808,7 +811,7 @@ IOS.prototype.detectUdid = function (cb) {
         }
 
         if (stdout && stdout.length > 2) {
-          this.args.udid = stdout.replace("\n", "");
+          this.args.udid = stdout.split("\n")[0];
           logger.debug("Detected udid as " + this.args.udid);
           cb();
         } else {
@@ -1230,7 +1233,7 @@ IOS.prototype.prelaunchSimulator = function (cb) {
       waitForSimulatorLogs(10);
     }.bind(this));
 
-  }).bind(this);
+  }.bind(this));
 };
 
 IOS.prototype.parseLocalizableStrings = function (/* language, stringFile, cb */) {
@@ -1554,12 +1557,22 @@ IOS.prototype.getLatestWebviewContextForTitle = function (titleRegex, cb) {
     if (err) return cb(err);
     var matchingCtx;
     _(contexts).each(function (ctx) {
-      if (ctx.view && ctx.view.url !== "about:blank" && (ctx.view.title || "").match(titleRegex)) {
-        matchingCtx = ctx;
+      if (ctx.view && (ctx.view.title || "").match(titleRegex)) {
+        if (ctx.view.url === "about:blank") {
+          // in the case of Xcode  < 5 (i.e., iOS SDK Version less than 7)
+          // and in the case of iOS 7.1 in a webview (not in Safari)
+          // we can have the url be `about:blank`
+          if (parseFloat(this.iOSSDKVersion) < 7 ||
+              (this.args.platformVersion === '7.1' && this.args.app && this.args.app.toLowerCase() !== 'safari')) {
+            matchingCtx = ctx;
+          }
+        } else {
+          matchingCtx = ctx;
+        }
       }
-    });
+    }.bind(this));
     cb(null, matchingCtx ? matchingCtx.id : undefined);
-  });
+  }.bind(this));
 };
 
 // Right now we don't necessarily wait for webview

lib/devices/ios/remote-debugger.js

@@ -151,7 +151,7 @@ RemoteDebugger.prototype.selectApp = function (appIdKey, cb, tries) {
     }
     if (responded) return;
     responded = true;
-    cb(this.pageArrayFromDict(pageDict));
+    cb(null, appIdKey, this.pageArrayFromDict(pageDict));
     this.specialCbs['_rpc_forwardGetListing:'] = this.onPageChange.bind(this);
   }.bind(this);
 

lib/devices/ios/safari.js

@@ -5,8 +5,7 @@ var IOS = require('./ios.js')
   , path = require('path')
   , _ = require('underscore');
 
-var NATIVE_REAL_SAFARI_MIN_VER = 7.0
-  , SAFARI_BUNDLE = 'com.apple.mobilesafari';
+var SAFARI_BUNDLE = 'com.apple.mobilesafari';
 
 var Safari = function () {
   this.init();
@@ -58,6 +57,38 @@ Safari.prototype.moveBuiltInApp = function (cb) {
   }
 };
 
+// once safariLauncher is running and instrumented, this function
+// finds the button which launches safari and clicks it.
+Safari.prototype._clickButtonToLaunchSafari = function (cb) {
+  this.findElement('accessibility id', 'launch safari',
+                   function (err, res) {
+    if (err || res.status !== 0) {
+      var msg = "Error. Could not find button to launch Safari. " +
+                "Make sure you are using the latest version of " +
+                "SafariLauncher that appium is using";
+      logger.error(msg);
+      return cb(new Error(msg));
+    }
+
+    var buttonId = res.value.ELEMENT;
+
+    this.click(buttonId, function (err, res) {
+      if (err || res.status !== 0) {
+        var msg = "Error. For whatever reason, could not click " +
+                  "the 'launch safari' button of SafariLauncher";
+        logger.error(msg);
+        return cb(new Error(msg));
+      }
+
+      logger.debug("Clicked button, safari should be launching.");
+
+      // we're done with instruments at this point, we go on to Safari
+      this.navToInitialWebview(cb);
+
+    }.bind(this));
+  }.bind(this));
+};
+
 Safari.prototype._start = IOS.prototype.start;
 Safari.prototype.start = function (cb, onDie) {
   var newOnDie = function (err) {
@@ -69,13 +100,23 @@ Safari.prototype.start = function (cb, onDie) {
 
   this._start(function (err) {
     if (err) return cb(err);
-    this.navToInitialWebview(cb);
+
+    if (this.args.udid) {
+      logger.debug("On Safari Launcher. Tapping button to launch Safari");
+
+      this._clickButtonToLaunchSafari(function (err) {
+        if (err) return cb(err);
+
+        this.navToInitialWebview(cb);
+      }.bind(this));
+    } else {
+      this.navToInitialWebview(cb);
+    }
   }.bind(this), newOnDie);
 };
 
 Safari.prototype.shouldIgnoreInstrumentsExit = function () {
-  return !!this.args.udid &&
-         this.iOSSDKVersion < NATIVE_REAL_SAFARI_MIN_VER;
+  return !!this.args.udid;
 };
 
 Safari.prototype._click = IOS.prototype.click;
@@ -103,16 +144,6 @@ Safari.prototype.setInitialOrientation = function (cb) {
   this._setInitialOrientation(cb);
 };
 
-Safari.prototype._configureBootstrap = IOS.prototype.configureBootstrap;
-Safari.prototype.configureBootstrap = function (cb) {
-  if (this.shouldIgnoreInstrumentsExit()) {
-    logger.debug("Not setting bootstrap config because we're on " +
-                 "SafariLauncher");
-    return cb();
-  }
-  this._configureBootstrap(cb);
-};
-
 Safari.prototype.installToRealDevice = function (cb) {
   if (this.args.udid) {
     try {

lib/devices/ios/settings.js

@@ -181,47 +181,25 @@ settings.updateLocationSettings = function (sim, bundleId, authorized) {
   });
   var curSettings = settings.getSettings(sim, 'locationClients');
   _.each(curSettings, function (settingSet, file) {
-    /*
-    * Support location services for 8.x platform.
-    */
-    if (parseFloat(sim.platformVer) >= 8) {
-      logger.debug("Using 8.X format locationd plist format.");
-      _.extend(newPrefs,  {
-        Authorization: 2,
-        SupportedAuthorizationMask: 3,
-      });
-      // now add our app's data
-      if (!_.has(settingSet, bundleId)) {
-        settingSet[bundleId] = {};
-      }
-      _.extend(settingSet[bundleId], newPrefs);
-      if (!_.has(settingSet[bundleId], 'Executable')) {
-        settingSet[bundleId].Executable = "";
-      }
-      if (!_.has(settingSet[bundleId], 'Registered')) {
-        settingSet[bundleId].Registered = "";
-      }
-    }  else {
-      // add this random data to the clients.plist since it always seems to be there
-      if (!_.has(settingSet, weirdLocKey)) {
-        settingSet[weirdLocKey] = {
-          BundlePath: "/System/Library/PrivateFrameworks/AOSNotification.framework",
-          Whitelisted: false,
-          Executable: "",
-          Registered: ""
-        };
-      }
-      // now add our app's data
-      if (!_.has(settingSet, bundleId)) {
-        settingSet[bundleId] = {};
-      }
-      _.extend(settingSet[bundleId], newPrefs);
-      if (!_.has(settingSet[bundleId], 'Executable')) {
-        settingSet[bundleId].Executable = "";
-      }
-      if (!_.has(settingSet[bundleId], 'Registered')) {
-        settingSet[bundleId].Registered = "";
-      }
+    // add this random data to the clients.plist since it always seems to be there
+    if (!_.has(settingSet, weirdLocKey)) {
+      settingSet[weirdLocKey] = {
+        BundlePath: "/System/Library/PrivateFrameworks/AOSNotification.framework",
+        Whitelisted: false,
+        Executable: "",
+        Registered: ""
+      };
+    }
+    // now add our app's data
+    if (!_.has(settingSet, bundleId)) {
+      settingSet[bundleId] = {};
+    }
+    _.extend(settingSet[bundleId], newPrefs);
+    if (!_.has(settingSet, 'Executable')) {
+      settingSet.Executable = "";
+    }
+    if (!_.has(settingSet, 'Registered')) {
+      settingSet.Registered = "";
     }
     prefSetPerFile[file] = settingSet;
   });

lib/devices/ios/simulator.js

@@ -450,6 +450,7 @@ Simulator.prototype.cleanSim = function (keepKeychains, tempDir, cb) {
 };
 
 Simulator.prototype.moveBuiltInApp = function (appPath, appName, newAppDir, cb) {
+  safeRimRafSync(newAppDir);
   ncp(appPath, newAppDir, function (err) {
     if (err) return cb(err);
     logger.debug("Copied " + appName + " to " + newAppDir);
@@ -496,7 +497,7 @@ Simulator.prototype.prepareBuiltInApp = function (appName, tmpDir, cb) {
       fs.stat(newAppDir, function (err, s) {
         if (err) {
           logger.warn("App is also not at " + newAppDir);
-          return cb(new Error("Couldn't find built in app in its home " +
+          return cb(new Error("Couldn't find built in app " + appName + " in its home " +
                               "or temp dir!"));
         }
         if (checkApp(s, appPath, cb)) {

lib/devices/ios/webkit-remote-debugger.js

@@ -44,10 +44,14 @@ WebKitRemoteDebugger.prototype.connect = function (pageId, cb, pageChangeCb) {
     }
   }.bind(this));
   this.socket.on('error', function (exception) {
-    console.log('Debugger web socket error %s', exception);
-  });
+    this.logger.debug('Debugger web socket error: ' + exception.message);
+  }.bind(this));
   this.socket.on('message', function (data) {
-    console.log('Debugger web socket received data :  %s', data);
+    var truncated = data || '';
+    if (truncated.length > 300) {
+      truncated = truncated.slice(0, 300) + '...';
+    }
+    this.logger.debug('Debugger web socket received data: ' + truncated);
     this.receive(data);
   }.bind(this));
 };

lib/future.js

@@ -34,15 +34,16 @@ var nodeifyFn = function (fn, bindObj) {
 
 // if we've imported es6 Promise type functions, ensure we can still use
 // Q/B-like "nodeify" on them in our transitional code
-if (typeof Promise === "function") {
-  Promise.prototype.nodeify = function (cb) {
-    this.then(function (res) {
-      cb(null, res);
-    }, function (err) {
-      cb(err);
-    });
-  };
+if (typeof Promise !== "function") {
+  require('es6-promise').polyfill();
 }
+Promise.prototype.nodeify = function (cb) {
+  this.then(function (res) {
+    cb(null, res);
+  }, function (err) {
+    cb(err);
+  });
+};
 
 module.exports = {
   simctl: nodeify(simctl),

lib/server/main.js

@@ -72,6 +72,12 @@ var http = require('http')
 
 
 var main = function (args, readyCb, doneCb) {
+
+  var nodeVer = Number(process.version.match(/^v(\d+\.\d+)/)[1]);
+  if (nodeVer < 0.10) {
+    logger.error("Appium requires Node >= 0.10");
+    process.exit(1);
+  }
   if (args.asyncTrace) {
     require('longjohn').async_trace_limit = -1;
   }
@@ -85,6 +91,12 @@ var main = function (args, readyCb, doneCb) {
     process.exit(0);
   }
 
+  if (nodeVer < 0.12) {
+    logger.warn("Appium support for versions of node < 0.12 has been " +
+                "deprecated and will be removed in a future version. Please " +
+                "upgrade!");
+  }
+
   checkArgs(parser, args);
   if (typeof doneCb === "undefined") {
     doneCb = function () {};

lib/server/parser.js

@@ -61,7 +61,7 @@ var args = [
   , dest: 'callbackAddress'
   , defaultValue: null
   , example: "127.0.0.1"
-  , help: 'callback IP Address (default: same as address)'
+  , help: 'callback IP Address (default: same as --address)'
   }],
 
   [['-cp', '--callback-port'], {

package.json

@@ -11,7 +11,7 @@
     "firefoxos",
     "testing"
   ],
-  "version": "1.4.0-beta",
+  "version": "1.4.6-beta2",
   "author": "https://github.com/appium",
   "licenses": [
     {
@@ -43,11 +43,11 @@
     "adm-zip": "~0.4.7",
     "appium-adb": "=1.7.5",
     "appium-atoms": "=0.0.5",
-    "appium-chromedriver": "^1.0.1",
-    "appium-instruments": "=2.0.0",
-    "appium-support": "=1.0.4",
+    "appium-chromedriver": "^2.1.3",
+    "appium-instruments": "^2.0.4",
+    "appium-support": "=1.0.5",
     "appium-uiauto": "=1.10.8",
-    "appium-xcode": "=2.0.0",
+    "appium-xcode": "^2.0.5",
     "argparse": "~1.0.1",
     "async": "~0.9.0",
     "binary-cookies": "~0.1.1",
@@ -60,6 +60,7 @@
     "colors": "~1.0.3",
     "date-utils": "~1.2.16",
     "difflib": "~0.2.4",
+    "es6-promise": "^2.1.1",
     "express": "~4.11.2",
     "glob": "~4.4.0",
     "grunt": "~0.4.5",
@@ -74,7 +75,7 @@
     "namp": "0.2.25",
     "ncp": "~2.0.0",
     "node-idevice": "~0.1.5",
-    "node-simctl": "=2.0.0",
+    "node-simctl": "^2.0.1",
     "node-uuid": "~1.4.2",
     "npmlog": "~1.1.0",
     "path": "~0.11.14",
@@ -83,9 +84,11 @@
     "q": "~1.1.2",
     "request": "~2.53.0",
     "rimraf": "~2.2.8",
+    "safari-launcher": "=2.0.5",
     "sandboxed-module": "~2.0.0",
     "serve-favicon": "~2.2.0",
     "socket.io": "~1.3.4",
+    "stack-trace": "0.0.9",
     "swig": "~1.4.2",
     "temp": "~0.8.1",
     "through": "~2.3.6",
@@ -138,7 +141,6 @@
     "socks": "~0.0.1",
     "spawn-mocha-parallel": "~1.3.1",
     "split": "^0.3.3",
-    "stack-trace": "0.0.9",
     "uncolor": "~0.3.0",
     "underscore-cli": "~0.2.18",
     "unorm": "~1.3.3",

reset.sh

@@ -206,23 +206,20 @@ reset_ios() {
         run_cmd "$grunt" buildApp:WebViewApp:iphonesimulator$sdk_ver
     fi
     if $should_reset_realsafari; then
-        echo "* Cloning/updating SafariLauncher"
-        run_cmd git submodule update --init submodules/SafariLauncher
         echo "* Building SafariLauncher for real devices"
         run_cmd rm -rf build/SafariLauncher
         run_cmd mkdir -p build/SafariLauncher
-        run_cmd rm -f submodules/SafariLauncher/target.xcconfig
-        touch submodules/SafariLauncher/target.xcconfig
-        echo "BUNDLE_ID = com.bytearc.SafariLauncher" >> submodules/SafariLauncher/target.xcconfig
+        touch build/SafariLauncher/target.xcconfig
+        echo "BUNDLE_ID = com.bytearc.SafariLauncher" >> build/SafariLauncher/target.xcconfig
         if [[ ! -z $code_sign_identity ]]; then
-          echo "IDENTITY_NAME = " $code_sign_identity >> submodules/SafariLauncher/target.xcconfig
+          echo "IDENTITY_NAME = " $code_sign_identity >> build/SafariLauncher/target.xcconfig
         else
-          echo "IDENTITY_NAME = iPhone Developer" >> submodules/SafariLauncher/target.xcconfig
+          echo "IDENTITY_NAME = iPhone Developer" >> build/SafariLauncher/target.xcconfig
         fi
-        echo "IDENTITY_CODE = " $provisioning_profile >> submodules/SafariLauncher/target.xcconfig
-        run_cmd "$grunt" buildSafariLauncherApp:iphoneos:"target.xcconfig"
+        echo "IDENTITY_CODE = " $provisioning_profile >> build/SafariLauncher/target.xcconfig
+        run_cmd "$grunt" buildSafariLauncherApp:iphoneos:"$appium_home/build/SafariLauncher/target.xcconfig"
         echo "* Copying SafariLauncher for real devices to build"
-        run_cmd zip -r build/SafariLauncher/SafariLauncher submodules/SafariLauncher/build/Release-iphoneos/SafariLauncher.app
+        run_cmd zip -r build/SafariLauncher/SafariLauncher node_modules/safari-launcher/build/Release-iphoneos/SafariLauncher.app
     fi
     echo "* Cloning/updating libimobiledevice-macosx"
     run_cmd git submodule update --init submodules/libimobiledevice-macosx
@@ -481,64 +478,11 @@ reset_gappium() {
 
 reset_chromedriver() {
     echo "RESETTING CHROMEDRIVER"
-    machine=$(run_cmd_output uname -m)
-    if [ "$machine" == "i686" ]; then
-        machine="32"
-    else
-        machine="64"
+    if $chromedriver_install_all ; then
+        run_cmd pushd node_modules/appium-chromedriver/
+        run_cmd npm run-script chromedriver_all
+        run_cmd popd
     fi
-    if [ -d "$appium_home"/build/chromedriver ]; then
-        echo "* Clearing old ChromeDriver(s)"
-        run_cmd rm -rf "$appium_home"/build/chromedriver/*
-    else
-        run_cmd rm -rf "$appium_home"/build/chromedriver  # could have been an old binary
-        run_cmd mkdir "$appium_home"/build/chromedriver
-    fi
-    if [ "$chromedriver_version" == false ]; then
-        echo "* Finding latest version"
-        chromedriver_version=$(run_cmd_output curl -L http://chromedriver.storage.googleapis.com/LATEST_RELEASE)
-    fi
-    if ! $chromedriver_install_all ; then
-        if [ "$platform" == "mac" ]; then
-            chromedriver_file="chromedriver_mac32.zip"
-            run_cmd mkdir "$appium_home"/build/chromedriver/mac
-            install_chromedriver $platform $chromedriver_version $chromedriver_file
-        else
-            chromedriver_file="chromedriver_linux$machine.zip"
-            binary="chromedriver$machine"
-            run_cmd mkdir "$appium_home"/build/chromedriver/linux
-            install_chromedriver $platform $chromedriver_version $chromedriver_file $binary
-        fi
-    else
-        echo "* Building directory structure"
-        run_cmd mkdir "$appium_home"/build/chromedriver/mac
-        run_cmd mkdir "$appium_home"/build/chromedriver/linux
-        run_cmd mkdir "$appium_home"/build/chromedriver/windows
-
-        install_chromedriver "mac" $chromedriver_version "chromedriver_mac32.zip"
-        install_chromedriver "linux" $chromedriver_version "chromedriver_linux32.zip" "chromedriver32"
-        install_chromedriver "linux" $chromedriver_version "chromedriver_linux64.zip" "chromedriver64"
-        install_chromedriver "windows" $chromedriver_version "chromedriver_win32.zip"
-    fi
-}
-
-install_chromedriver() {
-    platform=$1
-    version=$2
-    file=$3
-    binary=$4
-
-    echo "* Downloading ChromeDriver version $version for $platform"
-    run_cmd curl -L http://chromedriver.storage.googleapis.com/$version/$file -o "$appium_home"/build/chromedriver/$platform/chromedriver.zip
-    run_cmd pushd "$appium_home"/build/chromedriver/$platform
-
-    echo "* Unzipping ChromeDriver"
-    run_cmd unzip chromedriver.zip
-    run_cmd rm chromedriver.zip
-    if [[ $binary != "" ]]; then
-        run_cmd mv chromedriver $binary
-    fi
-    run_cmd popd
 }
 
 reset_firefoxos() {

test/functional/android/apidemos/touch/press-specs.js

@@ -57,3 +57,38 @@ describe("apidemo - touch - press", function () {
     });
   });
 });
+
+describe("apidemo - touch - longpress - release", function () {
+  var driver;
+  setup(this, _.defaults({
+    appActivity: '.view.SecureView'
+  }, desired)).then(function (d) { driver= d;});
+  describe('press released after pause should call release', function () {
+    it('should open an alert dialog', function (done) {
+      driver
+        .elementByName("Don't click! It'll cost you!")
+        .then(function (el) {
+          var action = new TouchAction(driver);
+          return action.press({el: el}).wait(1000).release().perform();
+        })
+        .elementByName("Oops...").should.eventually.exist
+        .then(function (el) {
+          el.click();
+        })
+        .nodeify(done);
+    });
+  });
+
+  describe('longPress should call release', function () {
+    it('should open an alert dialog', function (done) {
+      driver
+        .elementByName("Don't click! It'll cost you!")
+        .then(function (el) {
+          var action = new TouchAction(driver);
+          return action.longPress({el: el}).release().perform();
+        })
+        .elementByName("Oh no!").should.eventually.exist
+        .nodeify(done);
+    });
+  });
+});

test/functional/common/android-keyboard-base.js

@@ -3,13 +3,11 @@
 var env = require('../../helpers/env')
   , setup = require("./setup-base")
   , _ = require('underscore')
-  , getAppPath = require('../../helpers/app').getAppPath
-  , status = require('../../../lib/server/status');
+  , getAppPath = require('../../helpers/app').getAppPath;
 
 
 var desired = {
   app: getAppPath('ApiDemos'),
-  appActivity: '.view.TextFields',
   newCommandTimeout: 90
 };
 if (env.SELENDROID) {
@@ -19,215 +17,201 @@ if (env.SELENDROID) {
 module.exports = function () {
   var driver;
 
-  var runTextEditTest = function (testText, done) {
+  var runTextEditTest = function (testText, keys, done) {
     var el;
     driver
-      .waitForElementByClassName('android.widget.EditText')
-      .then(function (_el) { el = _el; })
+      .waitForElementsByClassName('android.widget.EditText')
+      // use a text field with no hint text, so clear is faster
+      .then(function (els) {
+        el = _.last(els);
+        return el;
+      })
+      .clear()
       .then(function () {
-        if (env.SELENDROID) {
-          return el.clear();
+        if (keys) {
+          return driver.keys(testText);
+        } else {
+          return el.sendKeys(testText);
         }
       })
-      .then(function () { return el.sendKeys(testText); })
-      .then(function () { return el.text().should.become(testText); })
+      .then(function () {
+        if (env.SELENDROID) {
+          // in Selendroid mode we sometimes get the text before
+          // it is fully sent to the element
+          return driver.sleep(300);
+        }
+      })
+      .then(function () { return el.text(); })
+      .then(function (text) {
+        // For samsung samsung S5 text is appended with ". Editing."
+        text = text.replace(". Editing.", "");
+        return text.should.be.equal(testText);
+      })
       .nodeify(done);
   };
 
-  var runEditAndClearTest = function (testText, done) {
+  var runEditAndClearTest = function (testText, keys, done) {
     var el;
     driver
-      .waitForElementByClassName('android.widget.EditText')
-      .then(function (_el) { el = _el; })
+      .waitForElementsByClassName('android.widget.EditText')
+      .then(function (els) {
+        el = _.last(els);
+        return el;
+      })
+      .clear()
       .then(function () {
-        if (env.SELENDROID) {
-          return el.clear();
+        if (keys) {
+          return driver.keys(testText);
+        } else {
+          return el.sendKeys(testText);
         }
       })
-      .then(function () { return el.sendKeys(testText).text().should.become(testText); })
+      .then(function () {
+        el.text().should.become(testText);
+      })
       .then(function () {
         return el.clear().should.not.be.rejected;
       })
       .then(function () {
-        // Selendroid and uiautomator have different ways of dealing with
-        // hint text. In particular, Selendroid does not return it
-        // and uiautomator does.
-        var expectedText = "hint text";
-        if (env.SELENDROID) {
-          expectedText = "";
-        }
-        return el.text().should.become(expectedText);
+        return el.text();
+      })
+      .then(function (text) {
+        // For samsung samsung S5 text is appended with ". Editing."
+        text = text.replace("Editing.", "");
+        text.should.be.equal("");
       })
       .nodeify(done);
   };
 
-  describe('editing ascii text field', function () {
-    setup(this, desired).then(function (d) { driver = d; });
+  var runKeyboardTests = function (testText) {
+    return function () {
+      it('should work with sendKeys', function (done) {
+        runTextEditTest(testText, false, done);
+      });
+      it('should work with keys', function (done) {
+        runTextEditTest(testText, true, done);
+      });
+    };
+  };
 
-    it('should be able to edit a text field', function (done) {
-      var testText = "Life, the Universe and Everything.";
-      runTextEditTest(testText, done);
+  var runKeyEventTests = function () {
+    var editTextField = 'android.widget.TextView';
+    if (env.SELENDROID) {
+      // with Selendroid we can't find classes by their parent class
+      // and with uiautomator we can't find the subclass.
+      editTextField = 'io.appium.android.apis.text.LogTextBox';
+    }
+
+    // skip selendroid because selendroid implements keyevent with an adb
+    // call, and we are unable to send metastate that way
+    it('should be able to send combination keyevents @skip-selendroid-all', function (done) {
+      driver
+        .elementById('clear').click()
+        .pressDeviceKey(29, 193)
+        .elementsByClassName(editTextField)
+        .then(function (els) {
+          return _.last(els).text();
+        })
+        .then(function (txt) {
+          txt.should.include('keyCode=KEYCODE_A');
+          txt.should.include('metaState=META_SHIFT_ON');
+        })
+        .nodeify(done);
     });
 
-    it('should be able to edit and manually clear a text field', function (done) {
-      var testText = "The answer is 42.";
-      runEditAndClearTest(testText, done);
+    it('should be able to send keyevents', function (done) {
+      driver
+        .elementById('clear').click()
+        .pressDeviceKey(82)
+        .elementsByClassName(editTextField)
+        .then(function (els) {
+          return _.last(els).text();
+        })
+        .then(function (txt) {
+          txt.should.include('[keycode=82]');
+          txt.should.include('keyCode=KEYCODE_MENU');
+        })
+        .nodeify(done);
     });
+  };
 
-    it('should be able to send &-', function (done) {
-      var testText = '&-';
-      runTextEditTest(testText, done);
+  var runManualClearTests = function () {
+    var testText = "The answer is 42.";
+    it('should work with sendKeys', function (done) {
+      runEditAndClearTest(testText, false, done);
     });
-
-    it('should be able to send & and - in other text', function (done) {
-      var testText = 'In the mid-1990s he ate fish & chips as mayor-elect.';
-      runTextEditTest(testText, done);
+    it('should work with keys', function (done) {
+      runEditAndClearTest(testText, true, done);
     });
+  };
 
-    it('should be able to send - in text', function (done) {
-      var testText = 'Super-test.';
-      runTextEditTest(testText, done);
-    });
 
-    describe('pressing device key', function () {
-      it('should be able to send keyevents', function (done) {
-        driver
-          .waitForElementByClassName('android.widget.EditText')
-          .elementById('com.android.launcher:id/search_button')
-            .should.be.rejectedWith(status.codes.NoSuchElement.code)
-          .pressDeviceKey(3)
-          .waitForElementById('com.android.launcher:id/search_button')
-          .elementByClassName('android.widget.EditText')
-            .should.be.rejectedWith(status.codes.NoSuchElement.code)
-          .nodeify(done);
+  describe('editing a text field', function () {
+    var appActivity = '.view.TextFields';
+    var tests = [
+      { label: 'editing a text field', text: 'Life, the Universe and Everything.' },
+      { label: 'sending &-', text: '&-' },
+      { label: 'sending & and - in other text', text: 'In the mid-1990s he ate fish & chips as mayor-elect.' },
+      { label: 'sending - in text', text: 'Super-test.' },
+    ];
+
+    describe('ascii', function () {
+      setup(this, _.defaults({
+        appActivity: appActivity
+      }, desired)).then(function (d) { driver = d; });
+
+      _.each(tests, function (test) {
+        describe(test.label, runKeyboardTests(test.text));
       });
 
-      // skip selendroid because selendroid implements keyevent with an adb
-      // call, and we are unable to send metastate that way
-      it('should be able to send combination keyevents @skip-selendroid-all', function (done) {
-        driver
-          .waitForElementByClassName('android.widget.EditText')
-            .clear()
-          .pressDeviceKey(29, 193)
-          .elementByClassName('android.widget.EditText')
-            .text().should.become('A')
-          .nodeify(done);
+      describe('editing and manually clearing a text field', runManualClearTests);
+    });
+
+    describe('unicode', function () {
+      setup(this,  _.defaults({
+        appActivity: appActivity,
+        unicodeKeyboard: true,
+        resetKeyboard: true
+      }, desired)).then(function (d) { driver = d; });
+
+      var unicodeTests = _.union(tests, [
+        { label: 'should be able to send - in unicode text', text: 'परीक्षा-परीक्षण' },
+        { label: 'should be able to send & in text', text: 'Fish & chips' },
+        { label: 'should be able to send & in unicode text', text: 'Mīna & chips' },
+        { label: 'should be able to send roman characters with diacritics', text: 'Áé Œ ù ḍ' },
+        { label: 'should be able to send a u with an umlaut', text: 'ü' },
+        { label: 'should be able to send Tamil', text: 'சோதனை' },
+        { label: 'should be able to send Gujarati', text: 'પરીક્ષણ' },
+        { label: 'should be able to send Chinese', text: '测试' },
+        { label: 'should be able to send Russian', text: 'тестирование' },
+        // skip rtl languages, which don't clear correctly atm
+        // { label: 'should be able to send Arabic', 'تجريب'],
+        // { label: 'should be able to send Hebrew', 'בדיקות'],
+      ]);
+
+      _.each(unicodeTests, function (test) {
+        describe(test.label, runKeyboardTests(test.text));
       });
+
+      describe('editing and manually clearing a text field', runManualClearTests);
     });
   });
 
-  describe('editing unicode text field', function () {
-    setup(this,  _.defaults({
-      unicodeKeyboard: true,
-      resetKeyboard: true
-    }, desired)).then(function (d) { driver = d; });
-
-    it('should be able to edit a text field', function (done) {
-      var testText = "Life, the Universe and Everything.";
-      runTextEditTest(testText, done);
+  describe('key events', function () {
+    var appActivity = '.text.KeyEventText';
+    describe('ascii', function () {
+      setup(this, _.defaults({
+        appActivity: appActivity
+      }, desired)).then(function (d) { driver = d; });
+      describe('pressing device key', runKeyEventTests);
     });
-
-    it('should be able to edit and manually clear a text field', function (done) {
-      var testText = "The answer is 42.";
-      runEditAndClearTest(testText, done);
-    });
-
-    it('should be able to send &-', function (done) {
-      var testText = '&-';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send & and - in other text', function (done) {
-      var testText = 'In the mid-1990s he ate fish & chips as mayor-elect.';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send - in text', function (done) {
-      var testText = 'Super-test.';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send - in unicode text', function (done) {
-      var testText = 'परीक्षा-परीक्षण';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send & in text', function (done) {
-      var testText = 'Fish & chips';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send & in unicode text', function (done) {
-      var testText = 'Mīna & chips';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send roman characters with diacritics', function (done) {
-      var testText = 'Áé Œ ù ḍ';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send a u with an umlaut', function (done) {
-      var testText = 'ü';
-      runTextEditTest(testText, done);
-    });
-
-    // skipping because clear doesn't work reliably on RTL scripts
-    it.skip('should be able to send Arabic', function (done) {
-      var testText = 'تجريب';
-      runTextEditTest(testText, done);
-    });
-
-    // skipping because clear doesn't work reliably on RTL scripts
-    it.skip('should be able to send Hebrew', function (done) {
-      var testText = 'בדיקות';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send Tamil', function (done) {
-      var testText = 'சோதனை';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send Gujarati', function (done) {
-      var testText = 'પરીક્ષણ';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send Chinese', function (done) {
-      var testText = '测试';
-      runTextEditTest(testText, done);
-    });
-
-    it('should be able to send Russian', function (done) {
-      var testText = 'тестирование';
-      runTextEditTest(testText, done);
-    });
-
-    describe('pressing device key with unicode keyboard', function () {
-      it('should be able to send keyevents', function (done) {
-        driver
-          .waitForElementByClassName('android.widget.EditText')
-          .elementById('com.android.launcher:id/search_button')
-            .should.be.rejectedWith(status.codes.NoSuchElement.code)
-          .pressDeviceKey(3)
-          .waitForElementById('com.android.launcher:id/search_button')
-          .elementByClassName('android.widget.EditText')
-            .should.be.rejectedWith(status.codes.NoSuchElement.code)
-          .nodeify(done);
-      });
-
-      // skip selendroid because selendroid implements keyevent with an adb
-      // call, and we are unable to send metastate that way
-      it('should be able to send combination keyevents @skip-selendroid-all', function (done) {
-        driver
-          .waitForElementByClassName('android.widget.EditText')
-            .clear()
-          .pressDeviceKey(29, 193)
-          .elementByClassName('android.widget.EditText')
-            .text().should.become('A')
-          .nodeify(done);
-      });
+    describe('unicode', function () {
+      setup(this, _.defaults({
+        appActivity: appActivity,
+        unicodeKeyboard: true,
+        resetKeyboard: true
+      }, desired)).then(function (d) { driver = d; });
+      describe('pressing device key', runKeyEventTests);
     });
   });
 };

test/helpers/env.js

@@ -1,8 +1,7 @@
 "use strict";
 
 var path = require('path')
-  , _ = require('underscore')
-  , os = require('os');
+  , localIp = require('appium-support').util.localIp;
 
 var env = {};
 
@@ -251,24 +250,11 @@ if (env.SAUCE && env.TARBALL) {
   env.CAPS.tags = [env.DEVICE];
 }
 
-// rest enf points
-env.localIP = function () {
-  var ip = _.chain(os.networkInterfaces())
-    .values()
-    .flatten()
-    .filter(function (val) {
-      return (val.family === 'IPv4' && val.internal === false);
-    })
-    .pluck('address')
-    .first().value();
-  return ip;
-};
-
 env.LOCAL_APPIUM_PORT = env.SAUCE ? 4443 : env.APPIUM_PORT;
 env.TEST_END_POINT = 'http://localhost:' + env.LOCAL_APPIUM_PORT + '/test/';
 env.GUINEA_TEST_END_POINT = env.TEST_END_POINT + 'guinea-pig';
 if (env.REAL_DEVICE) {
-  env.CHROME_TEST_END_POINT = 'http://' + env.localIP() + ':' + env.LOCAL_APPIUM_PORT + '/test/';
+  env.CHROME_TEST_END_POINT = 'http://' + localIp() + ':' + env.LOCAL_APPIUM_PORT + '/test/';
 } else {
   env.CHROME_TEST_END_POINT = 'http://10.0.2.2:' + env.LOCAL_APPIUM_PORT + '/test/';
 }

test/unit/android-controller-specs.js

@@ -17,16 +17,19 @@ describe('android-controller', function () {
                         { action: 'moveTo', options: { x: -40, y: -41 } },
                         { action: 'release', options: {} } ];
         controller.parseTouch(actions, false, function (err, touchStates) {
-          touchStates.length.should.equal(4);
+          touchStates.length.should.equal(5);
 
           var actions = [{action: 'press', x: 100, y: 101},
                          {action: 'moveTo', x: 150, y: 152},
                          {action: 'wait', x: 150, y: 152},
-                         {action: 'moveTo', x: 110, y: 111}];
+                         {action: 'moveTo', x: 110, y: 111},
+                         {action: 'release'}];
           _.each(touchStates, function (state, index) {
             state.action.should.equal(actions[index].action);
-            state.options.x.should.equal(actions[index].x);
-            state.options.y.should.equal(actions[index].y);
+            if (actions[index].action !== 'release') {
+              state.options.x.should.equal(actions[index].x);
+              state.options.y.should.equal(actions[index].y);
+            }
           });
 
           done();