[jira] [Comment Edited] (CB-3778) clarify "run" command requirements

["Filip Maj (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/CB-3778?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13685741#comment-13685741 ] 

Filip Maj edited comment on CB-3778 at 6/17/13 5:34 PM:
--------------------------------------------------------

I'm not sure that we want to document every single step in this. The per-platform documentation for deploying to a device is.. hefty. WE don't need to add on top of it, as soon as underlying platform instructions would change, we would have to, as well.

I think a better approach would be to link to relevant documentation per-platform:

- [iOS: provisioning your device(s) for development|http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/YourFirstAppStoreSubmission/ProvisionYourDevicesforDevelopment/ProvisionYourDevicesforDevelopment.html#//apple_ref/doc/uid/TP40011375-CH4-SW1]. This one is by far the hardest and most involved to set up.
- The [BlackBerry instructions|https://developer.blackberry.com/html5/documentation/running_your_bb10_app_2008471_11.html] are available but cordova actually takes a lot of the documented pain away. For the CLI, when you add BlackBerry to your project, it will interactively prompt you for some properties of your device. All of this information can be garnered from the Hardware and Network sub-sections under Settings -> About.
- For Android, you need to follow steps 2 and 3 of the [Using Hardware Devices guide|http://developer.android.com/tools/device.html] to be able to deploy to Android devices with cordova-cli.
                
      was (Author: filmaj):
    I'm not sure that we want to document every single step in this. The per-platform documentation for deploying to a device is.. hefty. WE don't need to add on top of it, as soon as underlying platform instructions would change, we would have to, as well.

I think a better approach would be to link to relevant documentation per-platform:

- [iOS: provisioning your device(s) for development|http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/YourFirstAppStoreSubmission/ProvisionYourDevicesforDevelopment/ProvisionYourDevicesforDevelopment.html#//apple_ref/doc/uid/TP40011375-CH4-SW1
- The [BlackBerry instructions|https://developer.blackberry.com/html5/documentation/running_your_bb10_app_2008471_11.html] are available but cordova actually takes a lot of the documented pain away. For the CLI, when you add BlackBerry to your project, it will interactively prompt you for some properties of your device. All of this information can be garnered from the Hardware and Network sub-sections under Settings -> About.
- For Android, you need to follow steps 2 and 3 of the [Using Hardware Devices guide|http://developer.android.com/tools/device.html] to be able to deploy to Android devices with cordova-cli.
                  
> clarify "run" command requirements
> ----------------------------------
>
>                 Key: CB-3778
>                 URL: https://issues.apache.org/jira/browse/CB-3778
>             Project: Apache Cordova
>          Issue Type: Task
>          Components: Android, BlackBerry, CLI, Docs, iOS, Windows 8
>            Reporter: Mike Sierra
>            Assignee: Michael Brooks
>            Priority: Critical
>
> Current CLI --help doc says run "deploys the application to the specified (or all) platform devices, which must be connected and configured for running via your machine". Need to clarify for each platform to make this work. Which devices are supported, e.g. both iPhone & iPad?  How are they connected, via USB?  Do you have to do anything to pair the device with the SDK?  Etc.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira