[
https://issues.apache.org/jira/browse/CB-10526?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15151109#comment-15151109
]
ASF GitHub Bot commented on CB-10526:
-------------------------------------
Github user jcesarmobile commented on a diff in the pull request:
https://github.com/apache/cordova-docs/pull/505#discussion_r53226134
--- 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:
-
-
+## 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
- 
+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"
}
}
}`
See https://issues.apache.org/jira/browse/CB-9730
> Improve 'iOS Guide' documentation
> ---------------------------------
>
> Key: CB-10526
> URL: https://issues.apache.org/jira/browse/CB-10526
> Project: Apache Cordova
> Issue Type: Improvement
> Components: Docs, iOS
> Reporter: Omar Mefire
> Assignee: Omar Mefire
>
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
