Running on windows support (#628)

* Update package scripts to use node for cross-plattform.

* Fix detox test / run-server using paths that don't work on windows.

* Replace CRLFs in exec.js, fixes running the emulator on windows.

* Should fix build.js on mac.

* Remove some paranoia.

* Make eslint pass on JS scripts.

* Ignore exec hack in coverage to get CI passing.

* Walk back detox test change so it works with detox-cli.

* Don't try to start emulator if it's already running.

* Remove unneeded comments, only refresh ADB devices if needed.

* Update detox unit tests to pass on windows.

Use path module in tests to normalize paths.
Use process.platform to test with actual absolute paths on windows.

* Add windows support to detox-cli.

* Some basic documentation in roadmap.

* docs: 'detox' -> 'Detox'

* More docs fixes.

* Oops, missed building Detox-ios-src.tbz

* Lint complained about hashbangs in detox scripts.

detox-cli/cli.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+const cp = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const detoxPath = path.join(process.cwd(), 'node_modules/detox');
+const detoxPackageJsonPath = path.join(detoxPath, 'package.json');
+
+if (fs.existsSync(detoxPackageJsonPath)) {
+  // { shell: true } option seems to break quoting on windows? Otherwise this would be much simpler.
+  if (process.platform === 'win32') {
+    const result = cp.spawnSync(
+      'cmd',
+      ['/c', path.join(process.cwd(), 'node_modules/.bin/detox.cmd')].concat(process.argv.slice(2)),
+      { stdio: 'inherit' });
+    process.exit(result.status);
+  } else {
+    const result = cp.spawnSync(
+      path.join(process.cwd(), 'node_modules/.bin/detox'),
+      process.argv.slice(2),
+      { stdio: 'inherit' });
+    process.exit(result.status);
+  }
+} else {
+  console.log(detoxPackageJsonPath);
+  console.log("detox is not installed in this directory");
+  process.exit(1);
+}

detox-cli/package.json

@@ -7,7 +7,7 @@
     "test": ":"
   },
   "bin": {
-    "detox": "./cli.sh"
+    "detox": "./cli.js"
   },
   "repository": {
     "type": "git",

detox/local-cli/detox-run-server.js

@@ -2,14 +2,11 @@
 
 const program = require('commander');
 const cp = require('child_process');
-const fs = require('fs');
 const path = require('path');
 
 program.parse(process.argv);
 
-if (fs.existsSync(path.join(process.cwd(), 'node_modules/.bin/detox-server'))) {
-  cp.execSync('node_modules/.bin/detox-server', {stdio: 'inherit'});
-} else {
-  cp.execSync('node_modules/detox/node_modules/.bin/detox-server', {stdio: 'inherit'});
-}
-
+const serverPackagePath = require.resolve('detox-server/package.json');
+const cli = require(serverPackagePath).bin['detox-server'];
+const binPath = path.join(path.dirname(serverPackagePath), cli);
+cp.execFileSync('node', [binPath], {stdio: 'inherit'});

detox/local-cli/detox-test.js

@@ -99,16 +99,19 @@ function runMocha() {
   const headless = program.headless ? `--headless` : '';
 
   const debugSynchronization = program.debugSynchronization ? `--debug-synchronization ${program.debugSynchronization}` : '';
-  const command = `node_modules/.bin/mocha ${testFolder} ${configFile} ${configuration} ${loglevel} ${cleanup} ${reuse} ${debugSynchronization} ${platformString} ${artifactsLocation} ${headless}`;
+  const binPath = path.join('node_modules', '.bin', 'mocha');
+  const command = `${binPath} ${testFolder} ${configFile} ${configuration} ${loglevel} ${cleanup} ${reuse} ${debugSynchronization} ${platformString} ${artifactsLocation} ${headless}`;
 
   console.log(command);
   cp.execSync(command, {stdio: 'inherit'});
 }
 
 function runJest() {
   const configFile = runnerConfig ? `--config=${runnerConfig}` : '';
+  const platform = program.platform ? `--testNamePattern='^((?!${getPlatformSpecificString(program.platform)}).)*$'` : '';
+  const binPath = path.join('node_modules', '.bin', 'jest');
   const platformString = platform ? `--testNamePattern='^((?!${getPlatformSpecificString(platform)}).)*$'` : '';
-  const command = `node_modules/.bin/jest ${testFolder} ${configFile} --runInBand ${platformString}`;
+  const command = `${binPath} ${testFolder} ${configFile} --runInBand ${platformString}`;
   console.log(command);
   cp.execSync(command, {
     stdio: 'inherit',

detox/package.json

@@ -21,14 +21,14 @@
   "author": "Tal Kol <talkol@gmail.com>",
   "license": "MIT",
   "scripts": {
-    "build": "scripts/build.sh",
-    "lint": "eslint src",
+    "build": "node scripts/build.js",
+    "lint": "eslint src scripts",
     "unit": "jest --coverage --verbose",
     "pretest": "npm run lint",
     "test": "npm run unit",
     "unit:watch": "jest --watch",
     "prepublish": "npm run build",
-    "postinstall": "scripts/postinstall.sh"
+    "postinstall": "node scripts/postinstall.js"
   },
   "devDependencies": {
     "eslint": "^4.11.0",

detox/scripts/build.js

@@ -0,0 +1,43 @@
+const childProcess = require('child_process');
+const fs = require('fs-extra');
+
+// Just make the usage a little prettier
+function sh(cmdline, opts) {
+  const args = cmdline.split(' ');
+  const cmd = args.shift();
+  return childProcess.execFileSync(cmd, args, opts);
+}
+
+if (process.platform === 'darwin') {
+  console.log("\nPackaging Detox iOS sources");
+
+  fs.removeSync('Detox-ios-src.tbz');
+  // Prepare Earl Grey without building
+  sh("ios/EarlGrey/Scripts/setup-earlgrey.sh");
+  sh("find ./ios -name Build -type d -exec rm -rf {} ;");
+
+  sh("tar -cjf ../Detox-ios-src.tbz .", { cwd: "ios" });
+}
+
+if (process.argv[2] === "android" || process.argv[3] === "android") {
+	console.log("\nBuilding Detox aars");
+	const aars = [
+		"detox-minReactNative44-debug.aar",
+		"detox-minReactNative46-debug.aar",
+		"detox-minReactNative44-release.aar",
+		"detox-minReactNative46-release.aar"
+	];
+	aars.forEach(aar => {
+		fs.removeSync(aar);
+	});
+
+	sh("./gradlew assembleDebug assembleRelease", {
+		cwd: "android",
+		stdio: "inherit",
+		shell: true
+	});
+
+	aars.forEach(aar => {
+		fs.copySync(`android/detox/build/outputs/aar/${aar}`, aar);
+	});
+}

detox/scripts/postinstall.js

@@ -0,0 +1,5 @@
+if (process.platform === "darwin") {
+	require("child_process").execSync(`${__dirname}/build_framework.ios.sh`, {
+		stdio: "inherit"
+	});
+}

detox/src/configurations.mock.js

@@ -85,7 +85,7 @@ const pathsTests = {
   },
   "configurations": {
     "absolutePath": {
-      "binaryPath": "/tmp/abcdef/123",
+      "binaryPath": process.platform === "win32" ? "C:\\Temp\\abcdef\\123" : "/tmp/abcdef/123",
       "type": "ios.simulator",
       "name": "iPhone 7 Plus, iOS 10.2"
     },

detox/src/devices/Device.test.js

@@ -1,6 +1,7 @@
-const _ = require('lodash');
 const configurationsMock = require('../configurations.mock');
 
+const path = require('path');
+
 const validScheme = configurationsMock.validOneDeviceAndSession;
 const invalidDeviceNoBinary = configurationsMock.invalidDeviceNoBinary;
 const invalidDeviceNoDeviceName = configurationsMock.invalidDeviceNoDeviceName;
@@ -547,11 +548,11 @@ describe('Device', () => {
 
   it(`should accept absolute path for binary`, async () => {
     const actualPath = await launchAndTestBinaryPath('absolutePath');
-    expect(actualPath).toEqual('/tmp/abcdef/123');
+    expect(actualPath).toEqual(process.platform === 'win32' ? 'C:\\Temp\\abcdef\\123' : '/tmp/abcdef/123');
   });
 
   it(`should accept relative path for binary`, async () => {
     const actualPath = await launchAndTestBinaryPath('relativePath');
-    expect(actualPath).toEqual(`${process.cwd()}/abcdef/123`);
+    expect(actualPath).toEqual(path.join(process.cwd(), 'abcdef/123'));
   });
 });

detox/src/devices/EmulatorDriver.js

@@ -52,10 +52,18 @@ class EmulatorDriver extends AndroidDriver {
     }
 
     await this._fixEmulatorConfigIniSkinName(name);
-    await this.emulator.boot(name);
 
-    const adbDevices = await this.adb.devices();
-    const filteredDevices = _.filter(adbDevices, {type: 'emulator', name: name});
+    let adbDevices = await this.adb.devices();
+    let filteredDevices = _.filter(adbDevices, {type: 'emulator', name: name});
+
+    // If it's not already running, start it now.
+    if (!filteredDevices.length) {
+      await this.emulator.boot(name);
+
+      // Refresh devices after boot completes.
+      adbDevices = await this.adb.devices();
+      filteredDevices = _.filter(adbDevices, {type: 'emulator', name: name});
+    }
 
     let adbName;
     switch (filteredDevices.length) {

detox/src/devices/android/APKPath.test.js

@@ -1,3 +1,7 @@
+// Using path methods will normalize slashes to backslashes on win32, so tests must match.
+const path = require('path');
+const rootPath = process.platform === 'win32' ? 'C:\\Users\\SomeUser' : '~/somePath';
+
 describe('APKPath', () => {
   let APKPath;
 
@@ -6,20 +10,20 @@ describe('APKPath', () => {
   });
 
   it(`simple path`, async () => {
-    const inputApkPath = '~/somePath/build/outputs/apk/debug/app-debug.apk';
-    const expectedTestApkPath = '~/somePath/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk';
+    const inputApkPath = path.join(rootPath, 'build/outputs/apk/debug/app-debug.apk');
+    const expectedTestApkPath = path.join(rootPath, 'build/outputs/apk/androidTest/debug/app-debug-androidTest.apk');
     expect(APKPath.getTestApkPath(inputApkPath)).toEqual(expectedTestApkPath);
   });
 
   it(`path for a gradle build flavor`, async () => {
-    const inputApkPath = '~/somePath/build/outputs/apk/development/debug/app-development-debug.apk';
-    const expectedTestApkPath = '~/somePath/build/outputs/apk/androidTest/development/debug/app-development-debug-androidTest.apk';
+    const inputApkPath = path.join(rootPath, 'build/outputs/apk/development/debug/app-development-debug.apk');
+    const expectedTestApkPath = path.join(rootPath, 'build/outputs/apk/androidTest/development/debug/app-development-debug-androidTest.apk');
     expect(APKPath.getTestApkPath(inputApkPath)).toEqual(expectedTestApkPath);
   });
 
   it(`path for a gradle build with multiple flavors`, async () => {
-    const inputApkPath = '~/android/app/build/outputs/apk/pocPlayStore/debug/app-poc-playStore-debug.apk';
-    const expectedTestApkPath = '~/android/app/build/outputs/apk/androidTest/pocPlayStore/debug/app-poc-playStore-debug-androidTest.apk';
+    const inputApkPath = path.join(rootPath, 'build/outputs/apk/pocPlayStore/debug/app-poc-playStore-debug.apk');
+    const expectedTestApkPath = path.join(rootPath, 'build/outputs/apk/androidTest/pocPlayStore/debug/app-poc-playStore-debug-androidTest.apk');
     expect(APKPath.getTestApkPath(inputApkPath)).toEqual(expectedTestApkPath);
   });
 

detox/src/utils/exec.js

@@ -47,6 +47,16 @@ async function execWithRetriesAndLogs(bin, options, statusLogs, retries = 10, in
   //  log.error(`${_operationCounter}: stderr:`, result.stderr);
   //}
 
+  /* istanbul ignore next */
+  if (process.platform === 'win32') {
+    if (result.stdout) {
+      result.stdout = result.stdout.replace(/\r\n/g, '\n');
+    }
+    if (result.stderr) {
+      result.stderr = result.stderr.replace(/\r\n/g, '\n');
+    }
+  }
+
   return result;
 }
 

docs/More.Roadmap.md

@@ -11,6 +11,13 @@ The current API supports addition of multiple platforms, Android is next. This i
 ### iOS physical device support
 Currently Detox only supports running on iOS simulators, we plan on adding support for running on devices as well.
 
+### Windows support
+There is some work done for running Detox on Windows, but it's still fairly untested. Please open issues for anything you run into, but be aware of these limitations:
+
+- Apple doesn't support iOS apps on Windows, so you're limited to the in-progress Android support.
+- `binaryPath` can be left as a relative path with `/`, or use `\\` if you don't need cross-platform support.
+- `build` should not use `./gradlew ...`, but simply `gradlew ...` - you may prefer scripting the build outside of Detox if you want to maintain cross-platform support - or simply have two configurations!
+
 ### Expectations on device logs
 One of our most wanted features, being able to assert log outputs.