You are viewing a plain text version of this content. The canonical link for it is here.

Posted to dev@cordova.apache.org by omefire <gi...@git.apache.org> on 2016/02/17 20:23:26 UTC

[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 Mefire <om...@gmail.com>
Date:   2016-02-03T23:27:29Z

    Remove invalid reference & Fix spelling mistakes

commit 41119ddadf6ba82036b79edd59852908c57b18bd
Author: Omar Mefire <om...@gmail.com>
Date:   2016-02-03T23:27:29Z

    Remove invalid reference & Fix spelling mistakes

commit 6ee2eadc6595b460e6833c7dd5a04bca663b084b
Author: Omar Mefire <om...@gmail.com>
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 <om...@gmail.com>
Date:   2016-02-15T00:12:51Z

    Minor fixes

commit 55bbd55f5567d5ea685ef6861b2356769f624104
Author: Omar Mefire <om...@gmail.com>
Date:   2016-02-17T03:54:25Z

    App Signing & Debugging sections

commit 8cfae21f2793bfa4cf42ae0dab6f2cef6077507c
Author: Omar Mefire <om...@gmail.com>
Date:   2016-02-17T05:40:31Z

    Platform Centered Workflow

commit 83428e6af6c652634d09200ef8378d44ab70cad3
Author: Omar Mefire <om...@gmail.com>
Date:   2016-02-17T07:47:32Z

    Removing config, tools & upgrade pages

commit 67b7ac49b0cf5a644354ece697a130a01362400e
Author: Omar Mefire <om...@gmail.com>
Date:   2016-02-17T09:23:47Z

    redirects

commit 0c6eb3f8b02773b121f0eed16a182e6dd255d8fd
Author: Omar Mefire <om...@gmail.com>
Date:   2016-02-17T09:24:34Z

    redirects

commit f22529a3af698602c614bfa48ee4a21d934a9132
Author: Omar Mefire <om...@gmail.com>
Date:   2016-02-17T09:25:17Z

    App Signing: better params description

commit 69b307087f2f535e4c0a6f5097de037bed55d58b
Author: Omar Mefire <om...@gmail.com>
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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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

https://github.com/apache/cordova-docs/pull/505#discussion_r53500008

--- 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": {
+ "codeSignIdentity": "iPhone Development",
+ "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954"
+ },
+ "release": {
+ "codeSignIdentity": "iPhone Distribution"
+ "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306"
+ }
+ }
+ }
+
+### Using xcrun

- ![]({{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png)
+You can also sign from the command line using the following command:

- 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
- and run a different target within Xcode.
+```
+ xcrun -sdk iphoneos PackageApplication -v /home/user/app/build/device/MyApp.app -o /home/user/app/build/device/MyApp.ipa --sign "iPhone Development" --embed "7151ab45-6085-4ea1-9bcd-022b5cebe44b"
+```

-Xcode comes bundled with emulators for the latest versions of iPhone
-and iPad. Older versions may be available from the __Xcode &rarr;
-Preferences &rarr; Downloads &rarr; Components__ panel.
+## Debugging

-## Deploy to Device
+For details on the debugging tools that come with Xcode, see this [article](https://developer.apple.com/support/debugging)
+and this [video](https://developer.apple.com/videos/play/wwdc2014-413/).

-For details about various requirements to deploy to a device, refer
-to the _Launch Your App On Devices_ section of
-Apple's
-[About App Distribution Workflows](https://developer.apple.com/library/prerelease/ios/documentation/IDEs/Conceptual/AppDistributionGuide/Introduction/Introduction.html).
-Briefly, you need to do the following before deploying:
+### Open a Project within Xcode

-1. Join the Apple iOS Developer Program.
+Cordova for iOS projects can be opened in Xcode. This can be useful if
+you wish to use Xcode built in debugging/profiling tools or if you are
+developing iOS plugins. Please note that when opening your project in Xcode,
+it is recommended that you do NOT edit your code in the IDE. This will edit the code
+in the ```platforms``` folder of your project (not ```www```), and changes are liable to be overwritten.
+Instead, edit the ```www``` folder and copy over your changes by running ```cordova build```.

-2. Create a _Provisioning Profile_ within the
- [iOS Provisioning Portal](https://developer.apple.com/ios/manage/overview/index.action).
- You can use its _Development Provisioning Assistant_ to create and
- install the profile and certificate Xcode requires.
+Plugin developers wishing to edit their native code in the IDE should use the ```--link``` flag when adding their
+plugin to the project via cordova plugin add. This will link the files so that changes to the plugin files in the
+platforms folder are reflected in your plugin's source folder (and vice versa).

-3. Verify that the _Code Signing_ section's _Code Signing Identity_
- within the project settings is set to your provisioning profile
- name.
-
-To deploy to the device:
-
-1. Use the USB cable to plug the device into your Mac.
-
-2. Select the name of the project in the Xcode window's __Scheme__
- drop-down list.
-
-3. Select your device from the __Device__ drop-down list. If it is
- plugged in via USB but still does not appear, press the
- __Organizer__ button to resolve any errors.
-
-4. Press the __Run__ button to build, deploy and run the application
- on your device.
-
-## Common Problems
-
-__Deprecation Warnings__: When an application programming interface
-(API) is changed or replaced by another API, it is marked as
-_deprecated_. The API still works in the near term, but is eventually
-removed. Some of these deprecated interfaces are reflected in Apache
-Cordova, and Xcode issues warnings about them when you build and
-deploy an application.
-
-Xcode's warning about the `invokeString` method concerns functionality
-that launches an app from a custom URL. While the mechanism to load
-from a custom URL has changed, this code is still present to provide
-backwards functionality for apps created with older versions of
-Cordova. The sample app does not use this functionality, so these
-warnings can be ignored. To prevent these warnings from appearing,
-remove the code that references the deprecated invokeString API:
-
-* Edit the _Classes/MainViewController.m_ file, surround the following
- block of code with `/*` and `*/` comments as shown below, then type
- __Command-s__ to save the file:
-
- (void)webViewDidFinishLoad:(UIWebView*)theWebView
- {
- // only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
- /*
- if (self.invokeString) {
- // this is passed before the deviceready event is fired, so you can access it in js when you receive deviceready
- NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url.");
- NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString];
- [theWebView stringByEvaluatingJavaScriptFromString:jsString];
- }
- */
- // Black base color for background matches the native apps
- theWebView.backgroundColor = [UIColor blackColor];
-
- return [super webViewDidFinishLoad:theWebView];
- }
-
-* Edit the _Classes/AppViewDelegate.m_ file, comment out the following
- line by inserting a double slash as shown below, then type
- __Command-s__ to save the file:
-
- //self.viewController.invokeString = invokeString;
-
-* Press __Command-b__ to rebuild the project and eliminate the warnings.
-
-
-
-__Missing Headers__: Compilation errors relating to missing headers
-result from problems with the build location, and can be fixed
-via Xcode preferences:
-
-1. Select __Xcode &rarr; Preferences &rarr; Locations__.
+Once the ios platform is added to your project and built using ```cordova build```, you can open it from
+within Xcode. Double-click to open the `${PROJECT_NAME}/platforms/ios/${PROJECT_NAME}.xcodeproj`
+file. The screen should look like this:

-2. In the __Derived Data__ section, press the __Advanced__ button and
- select __Unique__ as the __Build Location__ as shown here:
+![]({{ site.baseurl }}/static/img/guide/platforms/ios/helloworld_project.png)

- ![]({{ site.baseurl }}/static/img/guide/platforms/ios/xcode_build_location.png)
+## Platform Centered Workflow

-This is the default setting for a new Xcode install, but it may be set
-differently following an upgrade from an older version of Xcode.
+cordova-ios includes a number of scripts that allow the platform to be used
+without the full Cordova CLI. This development path may offer you a greater
+range of development options in certain situations than the cross-platform CLI
+tool described in [The Command-Line Interface](../../cli/index.html).
+For example, you need to use shell tools when deploying a custom
+Cordova WebView alongside native components. Before using this
+development path, you must still configure the SDK environment
+as described in [Requirements and Support](#link-requirements-and-support)
+above.

-For further information, consult Apple's documentation:
+For each of the scripts discussed below, refer to
+[The Command-Line Interface](../../cli/index.html) for more information on their
+arguments and usage. Each script has a name that matches the corresponding CLI
+command. For example, `cordova-ios/bin/create` is equivalent to
+`cordova create`.

-* [Start Developing iOS Apps Today](http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343) provides a quick overview of steps for developing iOS Apps.
+To get started, either download the cordova-ios package from
+[npm](https://www.npmjs.com/package/cordova-ios) or
+[Github](https://github.com/apache/cordova-ios).

-* [Member Center home page](https://developer.apple.com/membercenter/index.action)
- provides links to several iOS technical resources including
- technical resources, the provisioning portal, distribution guides
- and community forums.
+To create a project using this package, run the `create` script in the `bin`
+folder:

-* [Tools Workflow Guide for iOS](http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959)
+ $ cordova-ios/bin/create ...

-* [Xcode User Guide](http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215)
+The created project will have a folder named `cordova` inside that contains
+scripts for the project-specific Cordova commands (e.g. `run`, `build`, etc.).
+Additionally, The project will feature a structure different from that of a
+normal Cordova project. Notably, `/www` is moved to `/assets/www`.
--- End diff --

Consider giving an example for running either run/build.

---
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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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.

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-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/HelloWorldStandard.png)
+You can also sign from the command line using the following command:

-1. Join the Apple iOS Developer Program.
+Cordova for iOS projects can be opened in Xcode. This can be useful if
--- End diff --

Moved to sections of their own.

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by dblotsky <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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.

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-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/HelloWorldStandard.png)
+You can also sign from the command line using the following command:

- ![]({{ site.baseurl }}/static/img/guide/platforms/ios/xcode_build_location.png)
+## Platform Centered Workflow

-* [Session Videos](https://developer.apple.com/videos/wwdc/2012/) from
- the Apple World Wide Developer Conference 2012 (WWDC2012)
+To install plugins in this project, use the [Cordova Plugman Utility](../../../plugin_ref/plugman.html).

-* The [xcode-select command](http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html),
- which helps specify the correct version of Xcode if more than one is installed.

(Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® and Finder® are Trademarks of Apple Inc.)
--- End diff --

Added back

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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.

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-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/HelloWorldStandard.png)
+You can also sign from the command line using the following command:

- ![]({{ site.baseurl }}/static/img/guide/platforms/ios/xcode_build_location.png)
+## Platform Centered Workflow

(Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® and Finder® are Trademarks of Apple Inc.)
--- End diff --

As discussed, we should add an 'Upgrading' section here with reference to the upgrade article. The upgrade article shouldn't be deleted.

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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.

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-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/HelloWorldStandard.png)
+You can also sign from the command line using the following command:

-3. Verify that the _Code Signing_ section's _Code Signing Identity_
--- End diff --

Why are we getting rid of this section?

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by jcesarmobile <gi...@git.apache.org>.

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": {
    			"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


---
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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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.

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

Path should be in inline quotes.

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by jcesarmobile <gi...@git.apache.org>.

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

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-3. Select the intended device from the toolbar's __Scheme__ menu, such
- as the iPhone 6.0 Simulator as highlighted here:
+### Using build.json

-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",
+ "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954",
+ },
+ "release": {
+ "codeSignIdentitiy": "iPhone Distribution"
+ "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306",
+ }
+ }
+ }
+
+### Using xcrun

- ![]({{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png)
+You can also sign from the command line using the following command:

You can edit the root www folder from Xcode. But doing this makes o effect when you run the app. You have to do a 'cordova prepare ios' to copy the changes. I use a xcode build script that run 'cordova prepare ios' before running. The files you should change are the ones on "Staging" folder, those are the ```platforms``` ones

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by jcesarmobile <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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

https://github.com/apache/cordova-docs/pull/505#discussion_r53246246

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-3. Select the intended device from the toolbar's __Scheme__ menu, such
- as the iPhone 6.0 Simulator as highlighted here:
+### Using build.json

-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",
+ "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954",
+ },
+ "release": {
+ "codeSignIdentitiy": "iPhone Distribution"
+ "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306",
+ }
+ }
+ }
+
+### Using xcrun

- ![]({{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png)
+You can also sign from the command line using the following command:

Thanks for the feedback. I believe we are saying the same thing. I can try to rephrase things to make them easier to parse, though.

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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

https://github.com/apache/cordova-docs/pull/505#discussion_r53229214

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-3. Select the intended device from the toolbar's __Scheme__ menu, such
- as the iPhone 6.0 Simulator as highlighted here:
+### Using build.json

Thanks, handled!

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by dblotsky <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by dblotsky <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by asfgit <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by jcesarmobile <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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.

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-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/HelloWorldStandard.png)
+You can also sign from the command line using the following command:

-3. Verify that the _Code Signing_ section's _Code Signing Identity_
--- End diff --

reinstated

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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": {
    +                 "codeSignIdentity": "iPhone Development",
    +                 "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954"
    +             },
    +             "release": {
    +                 "codeSignIdentity": "iPhone Distribution"
    +                 "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306"
    +             }
    +         }
    +    }
    +    
    +### Using xcrun
     
    -   ![]({{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png)
    +You can also sign from the command line using the following command:
     
    -   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
    -   and run a different target within Xcode.
    +```
    +    xcrun -sdk iphoneos PackageApplication -v /home/user/app/build/device/MyApp.app -o /home/user/app/build/device/MyApp.ipa --sign "iPhone Development" --embed "7151ab45-6085-4ea1-9bcd-022b5cebe44b"
    +```
     
    -Xcode comes bundled with emulators for the latest versions of iPhone
    -and iPad. Older versions may be available from the __Xcode &rarr;
    -Preferences &rarr; Downloads &rarr; Components__ panel.
    +## Debugging
     
    -## Deploy to Device
    +For details on the debugging tools that come with Xcode, see this [article](https://developer.apple.com/support/debugging)
    +and this [video](https://developer.apple.com/videos/play/wwdc2014-413/).
     
    -For details about various requirements to deploy to a device, refer
    -to the _Launch Your App On Devices_ section of
    -Apple's
    -[About App Distribution Workflows](https://developer.apple.com/library/prerelease/ios/documentation/IDEs/Conceptual/AppDistributionGuide/Introduction/Introduction.html).
    -Briefly, you need to do the following before deploying:
    +### Open a Project within Xcode
     
    -1. Join the Apple iOS Developer Program.
    +Cordova for iOS projects can be opened in Xcode. This can be useful if 
    --- End diff --
    
    Shouldn't this be a part of 'Project Configuration'?


---
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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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 &rarr;
Preferences &rarr; Downloads &rarr; 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'.

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by omefire <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by jcesarmobile <gi...@git.apache.org>.

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

https://github.com/apache/cordova-docs/pull/505#discussion_r53283872

-## Install Deploy Tools
+### Deployment Tools

$ npm install -g ios-sim
$ npm install -g ios-deploy

-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:

-3. Select the intended device from the toolbar's __Scheme__ menu, such
- as the iPhone 6.0 Simulator as highlighted here:
+### Using build.json

I think it's still missing a `,` after "iPhone Distribution"

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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by rakatyal <gi...@git.apache.org>.

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 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

[GitHub] cordova-docs pull request: CB-10526: iOS Guide Improvements

Posted by dblotsky <gi...@git.apache.org>.

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 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