add setUrl command

calls adb startUri under the hood so users can deep
link to a dynamic place in their AUT

README.md

@@ -115,6 +115,7 @@ console.log(await driver.getOrientation()); // -> 'LANDSCAPE'
 | `setNetworkConnection`     |
 | `setOrientation`           |
 | `setValue`                 |
+| `setUrl`                   |
 | `startActivity`            |
 | `startChromedriverProxy`   |
 | `stopChromedriverProxies`  |

lib/commands/general.js

@@ -158,6 +158,12 @@ commands.reset = async function () {
   return await this.startAUT();
 };
 
+// we override setUrl to take an android URI which can be used for deep-linking
+// inside an app, similar to starting an intent
+commands.setUrl = async function (uri) {
+  await this.adb.startUri(uri, this.opts.appPackage);
+};
+
 Object.assign(extensions, commands, helpers);
 export { commands, helpers };
 export default extensions;

package.json

@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "adm-zip": "^0.4.7",
-    "appium-adb": "^2.0.1",
+    "appium-adb": "^2.2.0",
     "appium-android-bootstrap": "^2.2.3",
     "appium-android-ime": "^2.0.0",
     "appium-base-driver": "^1.0.2",

test/functional/commands/url-e2e-specs.js

@@ -0,0 +1,29 @@
+import chai from 'chai';
+import chaiAsPromised from 'chai-as-promised';
+import { AndroidDriver } from '../../../..';
+
+chai.should();
+chai.use(chaiAsPromised);
+
+let driver;
+let defaultCaps = {
+  appPackage: 'com.android.browser',
+  appActivity: '.BrowserActivity',
+  deviceName: 'Android',
+  platformName: 'Android'
+};
+
+describe('setUrl', function(){
+  before(async () => {
+    driver = new AndroidDriver();
+    await driver.createSession(defaultCaps);
+  });
+  after(async () => {
+    await driver.deleteSession();
+  });
+  it('should be able to start a data uri via setUrl', async () => {
+    await driver.setUrl('http://saucelabs.com');
+    let el = await driver.findElOrEls('id', 'com.android.browser:id/url', false);
+    await driver.getText(el.ELEMENT).should.eventually.include('saucelabs.com');
+  });
+});