| /** |
| 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. |
| */ |
| |
| var server = require('./server'), |
| fs = require('fs'), |
| Q = require('q'), |
| 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) { |
| return Q().then(function () { |
| if (!platform) { |
| throw new Error('A platform must be specified'); |
| } |
| |
| opts = opts || {}; |
| var projectRoot = findProjectRoot(opts.root); |
| var platformRoot = opts.root = util.getPlatformWwwRoot(projectRoot, platform); |
| if (!fs.existsSync(opts.root)) { |
| throw new Error('Project does not include the specified platform: ' + platform); |
| } |
| |
| return server(opts).then(function (serverInfo) { |
| serverInfo.projectRoot = projectRoot; |
| serverInfo.platformRoot = platformRoot; |
| return serverInfo; |
| }); |
| }); |
| }; |
| |
| function findProjectRoot(path) { |
| var 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; |
| } |