cordova-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <>
Subject [jira] [Commented] (CB-10526) Improve 'iOS Guide' documentation
Date Wed, 17 Feb 2016 20:28:18 GMT


ASF GitHub Bot commented on CB-10526:

Github user jcesarmobile commented on a diff in the pull request:
    --- Diff: www/docs/en/dev/guide/platforms/ios/ ---
    @@ -74,190 +67,123 @@ There are two ways to download Xcode:
     Once Xcode is installed, several command-line tools need to be enabled
     for Cordova to run. From the __Xcode__ menu, select __Preferences__,
     then the __Downloads__ tab. From the __Components__ panel, press the
    -__Install__ button next to the __Command Line Tools__ listing.
    +__Install__ button next to the __Command Line Tools__ listing. 
    -## Install Deploy Tools
    +### Deployment Tools
    -Run from comman-line terminal:
    +The [ios-sim]( and 
    +[ios-deploy]( tools - allows you
    +to launch iOS apps into the iOS Simulator and iOS Device from the command-line.
    +To install them, run the following from command-line terminal:
             $ npm install -g ios-sim
             $ npm install -g ios-deploy
    -## Create a New Project
    -Use the `cordova` utility to set up a new project, as described in The
    -Cordova [The Command-Line Interface](../../cli/index.html). For example, in a source-code
    +## Project Configuration
    -        $ cordova create hello com.example.hello "HelloWorld"
    -        $ cd hello
    -        $ cordova platform add ios
    -        $ cordova prepare              # or "cordova build"
    +Installing Xcode will mostly set everything needed to get started.
    -## Deploy the app
    -To deploy the app on a connected iOS device:
    -        $ cordova run ios --device
    -To deploy the app on a default iOS emulator:
    -        $ cordova emulate ios
    -You can use __cordova run ios --list__ to see all available targets and 
    -__cordova run ios --target=target_name__ to run application on a specific 
    -device or emulator (for example,  `cordova run ios --target="iPhone-6"`).
    -You can also use __cordova run --help__ to see additional build and run
    -## Open a Project in the SDK
    -Once ios platform is added to your project, you can open it from 
    -within Xcode. Double-click to open the `hello/platforms/ios/hello.xcodeproj`
    -file. The screen should look like this:
    -![]({{ site.baseurl }}/static/img/guide/platforms/ios/helloworld_project.png)
    +## Signing an App
    -## Deploy to Emulator
    +First, you should read through the [Code Signing Support Page](

    +and the [App Distribution Workflows](
    -To preview the app in the iOS emulator:
    +### Using Flags
    -1. Make sure the _.xcodeproj_ file is selected in the left panel.
    +To sign an app, you need the following parameters:
    -2. Select the __hello__ app in the panel immediately to the right.
    +| Parameter                | Flag                     | Description
    +| Code Sign Identity       | `--codeSignIdentity`     | Code signing identity to use
for signing. It can be created with Xcode and added to your keychain.
    +| Provisioning Profile     | `--provisioningProfile`  | GUID of the provisioning profile
to be used for signing. It is copied here on your Mac: ~/Library/MobileDevice/Provisioning\
Profiles/. Opening it in a text editor, you can find the GUID which needs to be specified
    +| Code Sign Resource Rules | `--codesignResourceRules`| (Optional) Used to control which
files in a bundle should be sealed by a code signature. For more details, read [The OS X Code
Signing In Depth article](

    -3. Select the intended device from the toolbar's __Scheme__ menu, such
    -   as the iPhone 6.0 Simulator as highlighted here:
    +### Using build.json
    -   ![]({{ site.baseurl }}/static/img/guide/platforms/ios/select_xcode_scheme.png)
    +Alternatively, you could specify them in a build configuration file (`build.json`)
    +using the `--buildConfig` argument to the same commands. Here's a sample of a
    +build configuration file:
    -4. Press the __Run__ button that appears in the same toolbar to the
    -   left of the __Scheme__. That builds, deploys and runs the
    -   application in the emulator. A separate emulator application opens
    -   to display the app:
    +    {
    --- End diff --
    this JSON is not well formated, it should be `{
    	"ios": {
    		"debug": {
    			"codeSignIdentitiy": "iPhone Development",
    			"provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954"
    		"release": {
    			"codeSignIdentitiy": "iPhone Distribution",
    			"provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306"

> Improve 'iOS Guide' documentation
> ---------------------------------
>                 Key: CB-10526
>                 URL:
>             Project: Apache Cordova
>          Issue Type: Improvement
>          Components: Docs, iOS
>            Reporter: Omar Mefire
>            Assignee: Omar Mefire

This message was sent by Atlassian JIRA

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message