[CB-2980] Add a ./cordova/lib/install-emulator project-level helper script

• Type: New Feature
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 3.2.0
• Component/s: cordova-cli
• Assignee: Lorin Beer
• Reporter: Filip Maj
• Created: 09/Apr/13 13:04
• Updated: 23/Aug/18 07:28
• Resolved: 05/Nov/13 22:27

Description

install-emulator [--target=id]

Installs a build of the app to an available emulator.

If --target is specified, attempts to install the app to the emulator identified by id. If the attempt fails, the script will error out with an appropriate error message and exit with code 2.

If no --target is specified, follows this multi-device flow:

1. Are there any actual emulators available, i.e. started/running? (use list-started-emulators CB-2964 to determine this). If so, target the first one, otherwise continue.
2. Are there any emulator images available to start? (use list-emulator-images CB-2947 to determine this). If so, call start-emulator <id> [TODO: issue ref] of the first available image, wait for it to become ready, then target it. If no, continue.
3. Print an error message and exit with code 2.

If the application is not compiled/built yet, the script will error out with an appropriate error message and exit with code 2.

Issue Links

• is depended upon by: CB-2914 The Great Platform-Level CLI script migration

Sub-Tasks

• Add a ./cordova/lib/install-emulator project-level helper script to Android: Closed
• Add a ./cordova/lib/install-emulator project-level helper script to iOS: Closed
• Add a ./cordova/lib/install-emulator project-level helper script to BlackBerry: Closed
• Add a ./cordova/lib/install-emulator project-level helper script to WP7: Closed
• Add a ./cordova/lib/install-emulator project-level helper script to WP8: Closed