| /** |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| */ |
| |
| /* globals Promise: true */ |
| |
| const fs = require('fs'); |
| const util = require('./util'); |
| |
| /** |
| * Launches a server where the root points to the specified platform in a Cordova project. |
| * @param {string} platform - Cordova platform to serve. |
| * @param {{root: ?string, port: ?number, urlPathProcessor: ?function, streamHandler: ?function, serverExtender: ?function}} opts |
| * root - cordova project directory, or any directory within it. If not specified, cwd is used. This will be modified to point to the platform's www_dir. |
| * All other values are passed unaltered to launchServer(). |
| * @returns {*|promise} |
| */ |
| module.exports = function (platform, opts) { |
| // note: `this` is actually an instance of main.js CordovaServe |
| // this module is a mixin |
| const that = this; |
| const retPromise = new Promise((resolve, reject) => { |
| if (!platform) { |
| reject(new Error('Error: A platform must be specified')); |
| } else { |
| opts = opts || {}; |
| const projectRoot = findProjectRoot(opts.root); |
| that.projectRoot = projectRoot; |
| opts.root = util.getPlatformWwwRoot(projectRoot, platform); |
| |
| if (!fs.existsSync(opts.root)) { |
| reject(new Error(`Error: Project does not include the specified platform: ${platform}`)); |
| } else { |
| return resolve(that.launchServer(opts)); |
| } |
| } |
| }); |
| return retPromise; |
| }; |
| |
| function findProjectRoot (path) { |
| const projectRoot = util.cordovaProjectRoot(path); |
| if (!projectRoot) { |
| if (!path) { |
| throw new Error('Current directory does not appear to be in a Cordova project.'); |
| } else { |
| throw new Error(`Directory "${path}" does not appear to be in a Cordova project.`); |
| } |
| } |
| return projectRoot; |
| } |