Skip to content

Commit

Permalink
Merge remote-tracking branch 'private/master'
Browse files Browse the repository at this point in the history 
Conflicts:
	Readme.md
	tutorial-gulp/gulp-task-runner-explorer.md
  • Loading branch information
@cpsloal
cpsloal committed Jul 20, 2015
2 parents f82f2a9 + ae7d8a8 commit d90828c
Show file tree
Hide file tree
Showing 59 changed files with 1,358 additions and 341 deletions.
21 changes: 16 additions & 5 deletions Readme.md
View file
Original file line number Diff line number Diff line change
@@ -1,14 +1,26 @@
# Visual Studio Tools for Apache Cordova
This repository contains a set of documents and tutorials for the **Visual Studio 2015 RC** release of **[Tools for Apache Cordova](http://aka.ms/cordova).**
This repository contains a set of documents and tutorials for the **Visual Studio 2015** release of **[Tools for Apache Cordova](http://aka.ms/cordova).**

**Note that this documentation does not apply to Visual Studio 2013 CTPs.**
**Note that, with the exception of known issues, this documentation does not apply to Visual Studio 2013 CTPs.**

<a name="tutorials"></a>
## Tutorials
1. [Using Apache Cordova 5](./tutorial-cordova-5)
1. [An Introduction to Cordova 5 Security](./tutorial-cordova-5/cordova-5-security.md)
1. [Using Gulp with your Cordova projects](./tutorial-gulp)
1. [Building Cordova Apps in a Team / Continuous Integration Environment](./tutorial-team-build)
1. [Using Gulp to Build Cordova Projects](./tutorial-gulp/gulp-ci.md)
1. [Invoking Gulp Tasks During a Cordova Build and the VS Task Runner Explorer](./tutorial-gulp/gulp-task-runner-explorer.md)
1. [Compiling TypeScript with Gulp](./tutorial-gulp/gulp-typescript.md)
1. [Building Cordova Apps in a Team / Continuous Integration (CI) Environment](./tutorial-team-build)
1. [Getting Started with Cordova & TFS 2015 or Visual Studio Online](./tutorial-team-build/TFS2015.md)
1. [Getting Started with Cordova & TFS 2013](./tutorial-team-build/TFS2013.md)
1. [Getting Started with Cordova & Jenkins CI](./tutorial-team-build/Jenkins.md)
1. [Package & Publish your Cordova Applications](./tutorial-package-publish)
1. [Using TypeScript with your Cordova projects](./getting-started/tutorial-typescript.md)
1. [Build and Simulate iOS in the Cloud](http://go.microsoft.com/fwlink/?LinkID=618476) (MSDN)
1. [Build a Cordova app for iOS using Parallels](http://go.microsoft.com/fwlink/?LinkID=618477) (MSDN)
1. [Run the Android Emulator on OSX when using Windows in Parallels](http://go.microsoft.com/fwlink/?LinkID=618478) (MSDN)
1. [Convert a Cordova Project to a PhoneGap Project](http://go.microsoft.com/fwlink/?LinkID=618479) (MSDN)

<a name="tips"></a>
## Tips & Workarounds
Expand All @@ -33,7 +45,6 @@ This repository contains a set of documents and tutorials for the **Visual Studi
1. [Visual Studio 2015](./known-issues/known-issues-vs2015.md)
1. [CTP 3.1 / Visual Studio 2013](./known-issues/known-issues-vs2013.md)


## Help us improve our documentation
Help us improve out docuementaiton by sending us a pull-request or opening a [GitHub Issue](https://github.com/Microsoft/cordova-docs/issues/new)

Expand All @@ -42,7 +53,7 @@ Help us improve out docuementaiton by sending us a pull-request or opening a [Gi
* [Download samples from our Cordova Samples repository](http://github.com/Microsoft/cordova-samples)
* [Follow us on Twitter](https://twitter.com/VSCordovaTools)
* [Visit our site http://aka.ms/cordova](http://aka.ms/cordova)
* [Read MSDN docs on using Visual Studo Tools for Apache Cordova](http://go.microsoft.com/fwlink/?LinkID=533794)
* [Read MSDN docs on using Visual Studio Tools for Apache Cordova](http://go.microsoft.com/fwlink/?LinkID=533794)
* [Ask for help on StackOverflow](http://stackoverflow.com/questions/tagged/visual-studio-cordova)
* [Email us your questions](mailto:/[email protected])

Expand Down
1 change: 1 addition & 0 deletions cordova-docs-private
Submodule cordova-docs-private added at faf243
2 changes: 1 addition & 1 deletion known-issues/known-issues-android.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,6 @@ If this does not resolve the issue, you can upgrade to a 64-bit version of the J
* [Download samples from our Cordova Samples repository](http://github.com/Microsoft/cordova-samples)
* [Follow us on Twitter](https://twitter.com/VSCordovaTools)
* [Visit our site http://aka.ms/cordova](http://aka.ms/cordova)
* [Read MSDN docs on using Visual Studo Tools for Apache Cordova](http://go.microsoft.com/fwlink/?LinkID=533794)
* [Read MSDN docs on using Visual Studio Tools for Apache Cordova](http://go.microsoft.com/fwlink/?LinkID=533794)
* [Ask for help on StackOverflow](http://stackoverflow.com/questions/tagged/visual-studio-cordova)
* [Email us your questions](mailto://[email protected])
23 changes: 14 additions & 9 deletions known-issues/known-issues-cordova5.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,13 @@ This article covers [known issues](../Readme.md#knownissues) related to Visual S
In general we recommend **using Cordova 5.1.1 or above** instead of 5.0.0 as there are a number of issues including a security hole with Cordova 5.0.0.

##Apache Cordova 5.x.x General Issues
----------
**Old versions of Cordova plugins due to Cordova plugin ID changes:** A significant change occurred with Cordova 5.0.0+ that also altered the IDs of many core Cordova plugins. The Visual Studio 2015 config.xml designer uses the old IDs (ex: org.apache.cordova.camera not cordova-plugin-camera) because Cordova 4.3.1 and below cannot access plugins using these new IDs and the default template uses 4.3.1.

To install updated plugins, follow [this proceedure to install a npm sourced plugin](../tips-and-workarounds/general/README.md#plugin-npm).

*Note that these updated plugins were tested on Cordova 5.0.0 or later and therefore may or may not work on earlier versions of Cordova.* We advise against updating your plugins when using older versions of Cordova unless you are attempting to solve a specific problem.

----------
**Cannot access any network resources from Android app:** The Android platform contained within Cordova 5.0.0+ does not have a "whitelist" plugin installed by default and therefore blocks network access by default. There are now two whitelist plugins that can be installed:

Expand All @@ -22,19 +29,17 @@ line or by adding this XML element to config.xml (see [this article for more det
~~~~~~~~~~~~~~~~~
----------
**Ripple throws error when starting up Cordova:** Ripple does not function properly in Cordova 5.0.0 due to a newly introduced validation check. This problem was fixed in Cordova 5.1.1.
**Error when adding plugin using Git URI with Cordova 5.1.1:** Cordova 5.1.1 has a bug that can cause plugins installed from a Git repo to fail with the error **Error: EXDEV, cross-device link not permitted** if the project is on a different drive than your temp folder.
----------
**Missing Android SDK 22:** The Android platform in Cordova 5.0.0 requires Android SDK API Level 22 which is not pre-installed by Visual Studio. Install the SDK using the Android SDK manager.
See [tips and workarounds](../tips-and-workarounds/general/README.md#plugin-xml) for information on adding plugins not in the config designer from either the Cordova plugin repository or npm. If you must add a Git version of the plugin, either move your project to the same drive as your temp folder when installing or you can instead download a copy, unzip it, and add the plugin from the filesystem.
##Apache Cordova 5.x.x and Visual Studio 2015 RC
----------
**Old versions of Cordova plugins due to Cordova plugin ID changes:** A significant change occurred with Cordova 5.0.0+ that also altered the IDs of many core Cordova plugins. The Visual Studio 2015 RC config.xml designer uses the old IDs (ex: org.apache.cordova.camera not cordova-plugin-camera) because Cordova 4.3.1 and below cannot access plugins using these new IDs and the default template uses 4.3.0.
**Missing Android SDK 22:** The Android platform in Cordova 5.0.0 requires Android SDK API Level 22 which may not be installed on your system. Install the SDK using the Android SDK manager.
To install updated plugins, follow [this proceedure to install a npm sourced plugin](../tips-and-workarounds/general/README.md#plugin-npm).
----------
**Ripple throws error when starting up Cordova 5.0.0:** Ripple does not function properly in Cordova 5.0.0 due to a newly introduced validation check. This problem was fixed in Cordova 5.1.1.
*Note that these updated plugins were tested on Cordova 5.0.0 or later and therefore may or may not work on earlier versions of Cordova.* We advise against updating your plugins when using older versions of Cordova unless you are attempting to solve a specific problem.
##Apache Cordova 5.x.x and Visual Studio 2015 RC
----------
**Visual Studio 2015 RC uses Ant to build Android with Cordova 5.x.x:** Visual Studio 2015 RC uses Ant to build Android while the command line has switched to Gradle by default in version 5.0.0 of the CLI. When switching between Visual Studio and the command line with the version of Android in Cordova 5.0.0, you may want to specify that the platform should be built with Ant instead if you are running into unexpected issues.
Expand Down Expand Up @@ -74,7 +79,7 @@ Finally, if you are still build errors, you may want to opt to remove and re-add
* [Download samples from our Cordova Samples repository](http://github.com/Microsoft/cordova-samples)
* [Follow us on Twitter](https://twitter.com/VSCordovaTools)
* [Visit our site http://aka.ms/cordova](http://aka.ms/cordova)
* [Read MSDN docs on using Visual Studo Tools for Apache Cordova](http://go.microsoft.com/fwlink/?LinkID=533794)
* [Read MSDN docs on using Visual Studio Tools for Apache Cordova](http://go.microsoft.com/fwlink/?LinkID=533794)
* [Ask for help on StackOverflow](http://stackoverflow.com/questions/tagged/visual-studio-cordova)
* [Email us your questions](mailto://[email protected])
2 changes: 1 addition & 1 deletion known-issues/known-issues-debugger.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,6 @@ This article covers [known issues and limitations](../Readme.md#knownissues) rel
* [Download samples from our Cordova Samples repository](http://github.com/Microsoft/cordova-samples)
* [Follow us on Twitter](https://twitter.com/VSCordovaTools)
* [Visit our site http://aka.ms/cordova](http://aka.ms/cordova)
* [Read MSDN docs on using Visual Studo Tools for Apache Cordova](http://go.microsoft.com/fwlink/?LinkID=533794)
* [Read MSDN docs on using Visual Studio Tools for Apache Cordova](http://go.microsoft.com/fwlink/?LinkID=533794)
* [Ask for help on StackOverflow](http://stackoverflow.com/questions/tagged/visual-studio-cordova)
* [Email us your questions](mailto://[email protected])
Loading

0 comments on commit d90828c

Please sign in to comment.