Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cordova.apache.org
From: omefire <git@git.apache.org>
To: dev@cordova.apache.org
Reply-To: dev@cordova.apache.org
References: <git-pr-505-cordova-docs@git.apache.org>
In-Reply-To: <git-pr-505-cordova-docs@git.apache.org>
Subject: [GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Content-Type: text/plain
Message-Id: <20160217205056.8F973E020D@git1-us-west.apache.org>
Date: Wed, 17 Feb 2016 20:50:56 +0000 (UTC)

Github user omefire commented on a diff in the pull request:

    https://github.com/apache/cordova-docs/pull/505#discussion_r53229214
  
    --- Diff: www/docs/en/dev/guide/platforms/ios/index.md ---
    @@ -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](https://www.npmjs.org/package/ios-sim) and 
    +[ios-deploy](https://www.npmjs.org/package/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 directory:
    +## 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
    -options.
    -
    -## 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](https://developer.apple.com/support/code-signing/) 
    +and the [App Distribution Workflows](https://developer.apple.com/library/prerelease/ios/documentation/IDEs/Conceptual/AppDistributionGuide/Introduction/Introduction.html).
     
    -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 here.
    +| 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](https://developer.apple.com/library/mac/technotes/tn2206/_index.html#//apple_ref/doc/uid/DTS40007919-CH1-TNTAG206) 
     
    -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 --
    
    Thanks, handled!


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org