Command "emulate" and options "--emulator/--device/--avd" are a bit confusing to use

[pkoleva]

emulate command is used to run an app on an emulator but we already have options to specify on what device to run the app.
The different options that one can use to define deployment target are behaving differently
--device - can be used to specify which device to be targeted and accepts device id and device name for some commands -> related issue 2345

run --emulator = emulate, but the option does not accept any parameters - related 2329

If emulate command is removed, to specify which device you'll use, you'll have to type the below command
tns run android/ios --emulator --device {DeviceName/Id}

I think we should agree on some kind of flow that covers the most common use cases.

For me the way I use these options is something like that ->
Option 1 - no emulate command
tns run/debug/deploy/livesync --emulator - starts emulator and ignores all connected real devices
tns run/debug/deploy/livesync --emulator {EmulatorName/Id} - starts/connects to specified emulator or if it doesn't exist give a meaningful error message
'tns run/debug/deploy/livesync --device {EmulatorName/Id}' - starts/connects to specified emulator or if it doesn't exist give a meaningful error message
Option 2 - no --emulator option
tns emulate - starts emulator and runs app on it, ignores all connected real devices
tns emulate --device {DeviceName/Id} - starts emulator with specified name and runs the app on it
'tns run/debug/deploy/livesync --device {EmulatorName/Id}' - starts/connects to specified emulator or if it doesn't exist give a meaningful error message

[enchev]

I like Option 2.

[tzraikov]

The --avd option is depricated and it is not supported for some time now.
We plan to remove the emulate command (as discussed with @valentinstoychev):
#2329

[pkoleva]

the option may be deprecated but it is available, as well as --geny option, as @rosen-vladimirov reminded me recently. Also I am not sure removing the command helps a lot - it will still be confusing to use tns run android/ios --emulator --device {DeviceName/Id} for me.

[tzraikov]

It is not necessary to use the --emulator option when using --device.
Currently we fail with an error message when the --avd option is used. I would opt for removing this option.
I was not aware that we have a --geny option. Maybe we should remove it?

[enchev]

I also believe that we should remove --geny & --avd.

[Plamen5kov]

@pkoleva @rosen-vladimirov I vote for removing the emulate command and replace it with
tns run/debug --device "emulator/device name" Which will search for a connected device(emulator or real device) with that name and run on it, or try to start emulator with that name if no such connected device is found.

[toddanglin]

Before we deprecate the emulate command, we need to make sure the run command works reliably for the emulators.

In 2.5.1, I am still unable to specify a specific iOS device when using the run command. This does not work currently (it reports that the device with that name cannot be found):

$ tns run ios --device "iPad Air 2"

But this command DOES work:

$ tns emulate ios --device "iPad Air 2"

I would expect the first command to behave identically to the second, launching the iOS emulator with the specified device. Further, if we deprecate the emulate command, how would someone launch the emulator with just the default device?

[Plamen5kov]

@toddanglin I was thinking something along the lines of:

Check for --device option:

• If there isn’t a device option
  • Search for connected devices and run app on all of them or
  • Start default emulator or
  • Throw error unable to connect/start a device
• If there is a device option
  • Search for device with name specified in --device or
  • Throw error unable to connect to the specified device

[toddanglin]

There are scenarios where I only want to run my app on the emulators, even if I have a device connected. So if we take this path, I have to explicitly know the name of my emulators...or I have to disconnect all of my devices. There is no direct equivalent for tns emulate to just run on all available emulators. Correct?

Is there a harm in keeping the tns emulate command? Even if not widely promoted?

Meanwhile, for cases where the device name is known, your proposal is fine so long as tns run [platform] --device "[emulator name]" works.

[Plamen5kov]

I have to explicitly know the name of my emulators...

@toddanglin you're right, that's why if you run tns device you'd get all the names of devices and emulators that are currently connected. Of course that doesn't mean we can't keep the emulate command, but IMO we don't need it.

---

Is there a harm in keeping the tns emulate command? Even if not widely promoted?

There's no harm in keeping the command per se, but the fact is it has caused us trouble in the past. If we have duplicate functionality I see no reason in keeping both ways to do the same thing.

[pkoleva]

IMO if I have to chose to remove one of "--emulator" or "emulate", I'll choose to remove the first one. I think "--device" option is sufficient to cover the need to run an app on a specific device/emulator/simulator. About "emulate", before removing it we should first define who uses it and how and then find a way to provide the users a way to continue working like they did before.

[toddanglin]

@pkoleva I agree. I think the tns emulate command is still more intuitive than tns run --emulator

@Plamen5kov My concern is that tns run would require two different behaviors to run the emulator depending on whether you want to explicitly specify the device or not:

tns run [platform] --emulator // Use the default emulator
tns run [platform] --device "Emulator Name" // Use a named emulator

Compared to the consistency of today's command:

tns emulate [platform] // Use the default emulator
tns emulate [platform] --device "Emulator Name" // Use a named emulator

Further, if use I tns run ios (let's say), and I have a device connected, should it fire-up both the emulator and deploy to the device? Are we trying to make tns run do too much?