Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cordova.apache.org
Received-SPF: pass (athena.apache.org: domain of muratsu@microsoft.com
 designates 157.56.110.107 as permitted sender)
From: Murat Sutunc <muratsu@microsoft.com>
To: "dev@cordova.apache.org" <dev@cordova.apache.org>
Subject: --list argument for CLI
Thread-Topic: --list argument for CLI
Thread-Index: AdAYvT352rcY1tsESKmvdzxiicQP0A==
Date: Mon, 15 Dec 2014 23:22:48 +0000
Message-ID: 
 <SN2PR03MB032196ABA4556E6DAD98744B86F0@SN2PR03MB032.namprd03.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
Content-Type: multipart/alternative;
	boundary="_000_SN2PR03MB032196ABA4556E6DAD98744B86F0SN2PR03MB032namprd_"
MIME-Version: 1.0

--_000_SN2PR03MB032196ABA4556E6DAD98744B86F0SN2PR03MB032namprd_
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable

Hi all,
My name is Murat Sutunc, I'm part of the Visual Studio team @ Microsoft and=
 new to Cordova.

I was looking at the Cordova Tooling Wiki at (https://wiki.apache.org/cordo=
va/CommandLineToolingDesign) and thought it would be interesting to make so=
me additions to the list-devices feature. Currently we have list-devices an=
d list-emulator-images scripts for a lot of different platforms. However th=
ese scripts are not easily accessible from the Cordova CLI. By introducing =
an additional argument to the run or emulate command, we could show a list =
of available emulators or connected devices. (I would like to deemphasize t=
he fact that the command is called --list). After invoking the command, a u=
ser can decide which target to use and run the app on the desired target by=
 using cordova run -device devicename

Here's how it looks for an Android only project:
C:\dev\cordova-projects\hello>cordova run --list
Running command: C:\dev\cordova-projects\hello\platforms\android\cordova\ru=
n.bat --list
Available Android Virtual Devices:
        AVD_GalaxyNexus_ToolsForApacheCordova
Available Android Devices:

(Internally what happens here is, through run.js we will call android list =
and adb devices and pipe that list to the user. Similar process with iOS to=
o.)

Note that in case a platform doesn't support --list flag, it'll ignore the =
flag and run as if the flag is not provided. This is due to current args pa=
rsing logic in platforms. Is this ok for the short term? I would hope that =
more platforms would support this option in the future.

Below are the pull requests for cordova-cli and cordova-android/cordova-ios=
 that have this functionality implemented. I would like to hear your though=
ts on this design, choice of the flag and if you think this feature would b=
e a valuable addition to the CLI.

cordova-cli: https://github.com/apache/cordova-cli/pull/199
cordova-android: https://github.com/apache/cordova-android/pull/139
cordova-ios: https://github.com/apache/cordova-ios/pull/122

PS: My ICLA just got approved. You can also ping me anytime on #cordova, my=
 name on irc is muratsu.

Thanks!
-Murat

--_000_SN2PR03MB032196ABA4556E6DAD98744B86F0SN2PR03MB032namprd_--