ionic/lib/ionic/run.js

A tool for creating and developing Ionic Framework mobile apps.

'use strict';

var chalk = require('chalk');
var extend = require('../utils/extend');
var npmScripts = require('../utils/npmScripts');
var os = require('os');
var Q = require('q');
var IonicAppLib = require('ionic-app-lib');
var ConfigXml = IonicAppLib.configXml;
var log = IonicAppLib.logging.logger;
var cordovaUtils = require('../utils/cordova');

var cordovaRunEmulateOptions = {
  '--livereload|-l': 'Live reload app dev files from the device' + chalk.yellow(' (beta)'),
  '--address': 'Use specific address (livereload req.)',
  '--port|-p': 'Dev server HTTP port (8100 default, livereload req.)',
  '--livereload-port|-r': 'Live Reload port (35729 default, livereload req.)',
  '--consolelogs|-c': {
    title: 'Print app console logs to Ionic CLI (livereload req.)',
    boolean: true
  },
  '--serverlogs|-s': {
    title: 'Print dev server logs to Ionic CLI (livereload req.)',
    boolean: true
  },
  '--debug|--release': {
    title: '',
    boolean: true
  },
  '--device|--emulator|--target=FOO': ''
};

var settings = {
  title: 'run',
  name: 'run',
  summary: 'Run an Ionic project on a connected device',
  args: {
    '<PLATFORM>': '',
    '[options]': ''
  },
  options: cordovaRunEmulateOptions,
  isProjectTask: true
};

function run(ionic, argv, rawCliArguments) {
  var appDirectory = process.cwd();
  var rawArgs = rawCliArguments.slice(0);
  var cmdName = argv._[0].toLowerCase();
  var hasBuildCommand = false;
  var hasServeCommand = false;

  var isLiveReload = argv.livereload || argv['live-reload'] || argv.l || false;

  // If platform was not passed then add it to the rawArgs
  var runPlatform = argv._[1];
  if (!runPlatform) {
    runPlatform = 'ios';
    rawArgs.splice(1, 0, runPlatform);
  }

  if (runPlatform === 'ios' && os.platform() !== 'darwin') {
    log.error('✗ You cannot run iOS unless you are on Mac OSX.');
    return Q();
  }

  var promiseList = []
    .concat(!cordovaUtils.isPlatformInstalled(runPlatform, appDirectory) ?
      cordovaUtils.installPlatform(runPlatform) :
      Q())
    .concat(!cordovaUtils.arePluginsInstalled(appDirectory) ?
      cordovaUtils.installPlugins() :
      Q())
    .concat(npmScripts.hasIonicScript('build'))
    .concat(npmScripts.hasIonicScript('serve'));

  return Q.all(promiseList).then(function(results) {
    hasBuildCommand = results[2];
    hasServeCommand = results[3];

    if (hasBuildCommand && !(isLiveReload && hasServeCommand)) {
      return npmScripts.runIonicScript('build', rawArgs.slice(2));
    }
    return Q();
  })
  .then(function() {

    // If we are running livereload and are using "ionic:serve" app-script
    // then configure devServer manually
    if (isLiveReload && hasServeCommand) {

      // using app-scripts and livereload is requested
      // Also remove commandName from the rawArgs passed
      return cordovaUtils.startAppScriptsServer(argv);
    } else if (isLiveReload) {

      // not an app-scripts project but the user wants livereload
      return cordovaUtils.setupLiveReload(argv, appDirectory);
    }

    // ensure the content node was set back to its original
    return ConfigXml.setConfigXml(appDirectory, {
      resetContent: true,
      errorWhenNotFound: false
    });
  })
  .then(function(serveOptions) {
    var optionList = cordovaUtils.filterArgumentsForCordova(cmdName, argv, rawArgs);
    return cordovaUtils.execCordovaCommand(optionList, isLiveReload, serveOptions);
  })
  .catch(function(ex) {
    if (ex instanceof Error) {
      log.error(ex);
    }
  });
}

module.exports = extend(settings, {
  run: run
});