forked from github/cordova-android
fb36e03aeb
* refactor(run)!: get rid of emit-and-throw & throw-literal antipatterns * refactor(run)!: convert run method to async/await * refactor(run): require build module in advance * refactor(run): minor cleanup * refactor(run): drop always-undefined option arch `parseBuildOptions` only sets `arch` if something truthy is passed for parameter `resolvedTarget` to which we pass `null`. * refactor(run): destructure buildOptions
77 lines
2.7 KiB
JavaScript
77 lines
2.7 KiB
JavaScript
/*
|
|
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 emulator = require('./emulator');
|
|
const target = require('./target');
|
|
const build = require('./build');
|
|
const PackageType = require('./PackageType');
|
|
const { CordovaError, events } = require('cordova-common');
|
|
|
|
/**
|
|
* Builds a target spec from a runOptions object
|
|
*
|
|
* @param {{target?: string, device?: boolean, emulator?: boolean}} runOptions
|
|
* @return {target.TargetSpec}
|
|
*/
|
|
function buildTargetSpec (runOptions) {
|
|
const spec = {};
|
|
if (runOptions.target) {
|
|
spec.id = runOptions.target;
|
|
} else if (runOptions.device) {
|
|
spec.type = 'device';
|
|
} else if (runOptions.emulator) {
|
|
spec.type = 'emulator';
|
|
}
|
|
return spec;
|
|
}
|
|
|
|
function formatResolvedTarget ({ id, type }) {
|
|
return `${type} ${id}`;
|
|
}
|
|
|
|
/**
|
|
* Runs the application on a device if available. If no device is found, it will
|
|
* use a started emulator. If no started emulators are found it will attempt
|
|
* to start an avd. If no avds are found it will error out.
|
|
*
|
|
* @param {Object} runOptions various run/build options. See Api.js build/run
|
|
* methods for reference.
|
|
*
|
|
* @return {Promise}
|
|
*/
|
|
module.exports.run = async function (runOptions = {}) {
|
|
const spec = buildTargetSpec(runOptions);
|
|
const resolvedTarget = await target.resolve(spec);
|
|
events.emit('log', `Deploying to ${formatResolvedTarget(resolvedTarget)}`);
|
|
|
|
const { packageType, buildType } = build.parseBuildOptions(runOptions, null, this.root);
|
|
|
|
// Android app bundles cannot be deployed directly to the device
|
|
if (packageType === PackageType.BUNDLE) {
|
|
throw new CordovaError('Package type "bundle" is not supported during cordova run.');
|
|
}
|
|
|
|
const buildResults = this._builder.fetchBuildResults(buildType);
|
|
|
|
if (resolvedTarget.type === 'emulator') {
|
|
await emulator.wait_for_boot(resolvedTarget.id);
|
|
}
|
|
return target.install(resolvedTarget, buildResults);
|
|
};
|