[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user asfgit closed the pull request at: https://github.com/apache/cordova-docs/pull/505 --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on the pull request: https://github.com/apache/cordova-docs/pull/505#issuecomment-186778586 LGTM! --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53539872 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -132,20 +203,20 @@ To preview the app in the iOS emulator: 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 + application in the simulator. A separate simulator application opens to display the app: ![]({{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png) - Only one emulator may run at a time, so if you want to test the app - in a different emulator, you need to quit the emulator application + Only one simulator may run at a time, so if you want to test the app + in a different simulator, you need to quit the simulator application and run a different target within Xcode. -Xcode comes bundled with emulators for the latest versions of iPhone +Xcode comes bundled with simulators for the latest versions of iPhone and iPad. Older versions may be available from the __Xcode Preferences Downloads Components__ panel. -## Deploy to Device +## Deploying to Device --- End diff -- These sections should be moved under 'Project Configuration' above. We should not be speaking of deployment after having a section on 'Signing the app'. --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on the pull request: https://github.com/apache/cordova-docs/pull/505#issuecomment-186469445 - Rebased on top of master --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53532560 --- Diff: www/docs/en/dev/guide/platforms/index.md --- @@ -61,11 +61,8 @@ a lower-level alternative to the `cordova` command-line utility. ## iOS * [iOS Platform Guide](ios/index.html) -* [iOS Shell Tool Guide](ios/tools.html) -* [iOS Configuration](ios/config.html) * [iOS Plugins](ios/plugin.html) * [iOS WebViews](ios/webview.html) -* [Upgrading iOS](ios/upgrade.html) --- End diff -- deleted. --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53531598 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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: +{ + "ios": { + "debug": { +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53531200 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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: +{ + "ios": { + "debug": { +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53531054 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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: +{ + "ios": { + "debug": { +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53500398 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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: +{ + "ios": { + "debug": { +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r5358 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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: +{ + "ios": { + "debug": { +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53499455 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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: +{ + "ios": { + "debug": { +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53499272 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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: +{ + "ios": { + "debug": { +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53498542 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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. --- End diff -- Path should be in inline quotes. --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53498288 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -72,192 +60,124 @@ There are two ways to download Xcode: which requires registration as an Apple Developer. 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. +for Cordova to run. From the command line, run: +``` xcode-select --install``` -## 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. --- End diff -- We can also give a link here to the CLI, something like 'You should be able to create a cordova project now. For more details refer to the CLI" --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53497631 --- Diff: www/docs/en/dev/guide/platforms/index.md --- @@ -61,11 +61,8 @@ a lower-level alternative to the `cordova` command-line utility. ## iOS * [iOS Platform Guide](ios/index.html) -* [iOS Shell Tool Guide](ios/tools.html) -* [iOS Configuration](ios/config.html) * [iOS Plugins](ios/plugin.html) * [iOS WebViews](ios/webview.html) -* [Upgrading iOS](ios/upgrade.html) --- End diff -- We can actually get rid of this file all together. --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user dblotsky commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53392433 --- Diff: www/_data/redirects.yml --- @@ -6,6 +6,8 @@ general: # redirects paths relative to /docs/XX/ docs: +- {old: "dev/guide/platforms/ios/tools.html", new: "dev/guide/platforms/ios/index.html"} +- {old: "dev/guide/platforms/ios/config.html", new: "dev/config_ref/index.html"} --- End diff -- Please also add redirects for `/latest/`. --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user dblotsky commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53392250 --- Diff: www/_data/redirects.yml --- @@ -166,3 +166,5 @@ docs-global: - {old: "guide_plugin-development_blackberry10_index.md.html", new: "guide/plugin-development/blackberry10/index.html"} - {old: "guide_privacy_index.md.html", new: "guide/privacy/index.html"} - {old: "guide_upgrading_windows-8_index.md.html", new: "guide/upgrading/windows-8/index.html"} +- {old: "dev/guide/platforms/ios/tools.html", new: "dev/guide/platforms/ios/index.html"} +- {old: "dev/guide/platforms/ios/config.html", new: "dev/config_ref/index.html"} --- End diff -- @omefire By "version-specific", I mean redirects that hold across all languages but not across all versions (e.g. pages that are removed after a given version). The alternative is "global", which applies to redirects that hold across all languages and versions (e.g. renaming `index.html` to `index.htm` in all versions). --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user dblotsky commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53391759 --- Diff: www/_data/redirects.yml --- @@ -6,6 +6,8 @@ general: # redirects paths relative to /docs/XX/ docs: +- {old: "dev/guide/platforms/ios/tools.html", new: "dev/guide/platforms/ios/index.html"} +- {old: "dev/guide/platforms/ios/config.html", new: "dev/config_ref/index.html"} --- End diff -- Should there also be a redirect for the upgrade page? --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53368735 --- Diff: www/_data/redirects.yml --- @@ -166,3 +166,5 @@ docs-global: - {old: "guide_plugin-development_blackberry10_index.md.html", new: "guide/plugin-development/blackberry10/index.html"} - {old: "guide_privacy_index.md.html", new: "guide/privacy/index.html"} - {old: "guide_upgrading_windows-8_index.md.html", new: "guide/upgrading/windows-8/index.html"} +- {old: "dev/guide/platforms/ios/tools.html", new: "dev/guide/platforms/ios/index.html"} +- {old: "dev/guide/platforms/ios/config.html", new: "dev/config_ref/index.html"} --- End diff -- 2. The redirects are necessary. For Example, The config.html file is not platform-specific anymore and has been turned into a reference doc. We need to redirect old urls to the new file. --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53367760 --- Diff: www/_data/redirects.yml --- @@ -166,3 +166,5 @@ docs-global: - {old: "guide_plugin-development_blackberry10_index.md.html", new: "guide/plugin-development/blackberry10/index.html"} - {old: "guide_privacy_index.md.html", new: "guide/privacy/index.html"} - {old: "guide_upgrading_windows-8_index.md.html", new: "guide/upgrading/windows-8/index.html"} +- {old: "dev/guide/platforms/ios/tools.html", new: "dev/guide/platforms/ios/index.html"} +- {old: "dev/guide/platforms/ios/config.html", new: "dev/config_ref/index.html"} --- End diff -- 1. Thanks for pointing this out, Moving to ```docs``` section. By being version-specific, you mean the redirects will only apply in the case of the dev/latest version ? (Just making sure). --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user jcesarmobile commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53283872 --- 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 -- I think it's still missing a `,` after "iPhone Distribution" --- If your project is set up for it, you can
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user dblotsky commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53255568 --- Diff: www/_data/redirects.yml --- @@ -166,3 +166,5 @@ docs-global: - {old: "guide_plugin-development_blackberry10_index.md.html", new: "guide/plugin-development/blackberry10/index.html"} - {old: "guide_privacy_index.md.html", new: "guide/privacy/index.html"} - {old: "guide_upgrading_windows-8_index.md.html", new: "guide/upgrading/windows-8/index.html"} +- {old: "dev/guide/platforms/ios/tools.html", new: "dev/guide/platforms/ios/index.html"} +- {old: "dev/guide/platforms/ios/config.html", new: "dev/config_ref/index.html"} --- End diff -- Two things: 1. These are version-specific, not global: please place them in the `docs` section in this file; the difference is described [here][redirects] 2. Are these redirects necessary, or could the files stay where they are? [redirects]: https://github.com/apache/cordova-docs#redirects --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53246246 --- 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: +{ + "ios": { + "debug": { + "codeSignIdentitiy": "iPhone Development", +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user jcesarmobile commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53238166 --- 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: +{ + "ios": { + "debug": { + "codeSignIdentitiy": "iPhone Development", +
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on the pull request: https://github.com/apache/cordova-docs/pull/505#issuecomment-185405382 @devgeeks , please take a look as well --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
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] cordova-docs pull request: CB-10526: iOS Guide Improvements
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: - -![]({{ 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 -- this JSON is not well formated, it should be `{ "ios": { "debug": {
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user jcesarmobile commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53225665 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -53,15 +48,13 @@ include all iPad® models, iPhone® 3GS and above, and iPod® Touch 3rd Generation or later. To install apps onto a device, you must also be a member of Apple's [iOS Developer Program](https://developer.apple.com/programs/ios/), -which costs $99 per year. This guide shows how to deploy apps to the +which costs [$99](https://developer.apple.com/support/purchase-activation/) per year. This guide shows how to deploy apps to the iOS emulator, for which you don't need to register with the developer --- End diff -- It's simulator, not emulator --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user jcesarmobile commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/505#discussion_r53225642 --- Diff: www/docs/en/dev/guide/platforms/ios/index.md --- @@ -53,15 +48,13 @@ include all iPad® models, iPhone® 3GS and above, and iPod® Touch 3rd Generation or later. To install apps onto a device, you must also be a --- End diff -- You no longer need a paid account to install apps on real devices, you need xcode 7 --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
Github user omefire commented on the pull request: https://github.com/apache/cordova-docs/pull/505#issuecomment-185371859 @shazron could you please take a look ? --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org
[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements
GitHub user omefire opened a pull request: https://github.com/apache/cordova-docs/pull/505 CB-10526: iOS Guide Improvements You can merge this pull request into a Git repository by running: $ git pull https://github.com/omefire/cordova-docs CB-10526 Alternatively you can review and apply these changes as the patch at: https://github.com/apache/cordova-docs/pull/505.patch To close this pull request, make a commit to your master/trunk branch with (at least) the following in the commit message: This closes #505 commit 35ccd05af2f7dd7eebf7bf00b9abd2c7cfbb9ec2 Author: Omar MefireDate: 2016-02-03T23:27:29Z Remove invalid reference & Fix spelling mistakes commit 41119ddadf6ba82036b79edd59852908c57b18bd Author: Omar Mefire Date: 2016-02-03T23:27:29Z Remove invalid reference & Fix spelling mistakes commit 6ee2eadc6595b460e6833c7dd5a04bca663b084b Author: Omar Mefire Date: 2016-02-12T19:51:29Z Merge branch 'CB-10526' of https://github.com/omefire/cordova-docs into CB-10526 commit 986d79caf0b607c979698706cb7b834752032d40 Author: Omar Mefire Date: 2016-02-15T00:12:51Z Minor fixes commit 55bbd55f5567d5ea685ef6861b2356769f624104 Author: Omar Mefire Date: 2016-02-17T03:54:25Z App Signing & Debugging sections commit 8cfae21f2793bfa4cf42ae0dab6f2cef6077507c Author: Omar Mefire Date: 2016-02-17T05:40:31Z Platform Centered Workflow commit 83428e6af6c652634d09200ef8378d44ab70cad3 Author: Omar Mefire Date: 2016-02-17T07:47:32Z Removing config, tools & upgrade pages commit 67b7ac49b0cf5a644354ece697a130a01362400e Author: Omar Mefire Date: 2016-02-17T09:23:47Z redirects commit 0c6eb3f8b02773b121f0eed16a182e6dd255d8fd Author: Omar Mefire Date: 2016-02-17T09:24:34Z redirects commit f22529a3af698602c614bfa48ee4a21d934a9132 Author: Omar Mefire Date: 2016-02-17T09:25:17Z App Signing: better params description commit 69b307087f2f535e4c0a6f5097de037bed55d58b Author: Omar Mefire Date: 2016-02-17T19:20:30Z Handling plugins --- 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 infrastruct...@apache.org or file a JIRA ticket with INFRA. --- - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org For additional commands, e-mail: dev-h...@cordova.apache.org