diff --git a/known-issues/known-issues-ios.md b/known-issues/known-issues-ios.md index 47369635..1f1782e0 100644 --- a/known-issues/known-issues-ios.md +++ b/known-issues/known-issues-ios.md @@ -27,6 +27,9 @@ This article covers [known issues](../Readme.md#knownissues) related to Visual S ---------- **Deploying to iOS 8.3 device fails from OSX Mavericks or below:** If deploying to iOS 8.3 device fails because vs-mda-remote cannot find DeveloperDiskImage.dmg, ensure you are running OSX Yosemite and Xcode 6.3. Xcode 6.3 is required to deploy to an 8.3 device and only runs on Yosemite. +---------- +**"Could not find module 'Q'" error when building iOS:** If your OSX machine has case a case sensitive filesystem you can hit with certain versions of Cordova like Cordova 5.1.1. (Most people do not turn on case sensitivity.) A fix is in the works and will be in the next version of the Cordova iOS platform along with an updated version of Cordova itself. Watch the [Cordova homepage](http://cordova.apache.org) for release announcements. Once the Cordova iOS platform is released you can follow [these directions](../tips-and-workarounds/general/README.md#cordova-platform-ver) to use it at release or you may wait until a full Cordova "tools" release also occurs and update the Cordova version via the config.xml designer. + ---------- **Incremental builds not faster than initial build when using VS 2015 RC or RTM:** Unfortunately this is a known issue with the iOS incremental build feature. We are actively working on a fix that will be resolved in a point release update. diff --git a/tips-and-workarounds/general/README.md b/tips-and-workarounds/general/README.md index 2072e79b..b47d87ce 100644 --- a/tips-and-workarounds/general/README.md +++ b/tips-and-workarounds/general/README.md @@ -10,6 +10,7 @@ It covers the following issues and tips: 1. [Using a npm sourced plugins not listed in the config.xml designer or with Cordova < 5.0.0](#plugin-npm) 1. [Tips for troubleshooting 3rd party Cordova plugins](#plugin-troubleshoot) 1. [Build errors caused by long path and file names](#build-errors-long-path) +1. [Using a different version of a Cordova platform](#cordova-platform-ver) ##Building a Cordova project from source control results in a successful build, but with Cordova plugin APIs not returning results when the app is run @@ -243,6 +244,55 @@ If your project is located inside a deeply nested directory in your file system ...replacing "c:\npm\cache" with your desired folder. + +##Using a Different Version of a Cordova Platform +Typically when you want get a fix or feature for Cordova itself you will simply use the Platforms tab of the config.xml designer to update the Cordova version for your project. However, under [certain circumstances](../android/security-05-26-2015) you may want to update a "platform" independent of the entire Cordova release. See [this article](../../tutorial-cordova-5) for a discussion of what a "platform" is in the Cordova context and how it is versioned. + +Updating a platform version for your project is easy with Cordova 4.3.0 and up. First we need to update config.xml. + +1. In Visual Studio, right click on config.xml and select “View Code” +2. When using Cordova 4.3.0 or 4.3.1, add the following under the root <widget> element in config.xml: + + ~~~~~~~~~~~~~~~~~~~~~~~ + + ~~~~~~~~~~~~~~~~~~~~~~~ + + ...or if you opted to update to Cordova 5.0.0+: + + ~~~~~~~~~~~~~~~~~~~~~~~~ + + ~~~~~~~~~~~~~~~~~~~~~~~~ + + ...replacing "android" with the platform you want to update in all lower case. + +Next, for projects where you have **already executed a build for the platform on your system**, you’ll also need to remove the old version of the Cordova platform. + +For iOS, all you need to do is execute a "clean" for your project and the new platform will take effect on next build. + +For Android, Windows, and Windows Phone, follow these steps: + +1. Open a command prompt and go to your Cordova project root (not the solution root). + +2. Type the following commands: + + ~~~~~~~~~~~~~~~~~~~~~~~~ + npm install -g cordova + cordova platform remove + cordova platform add + ~~~~~~~~~~~~~~~~~~~~~~~~ + + ...replacing <platform> with the platform you are trying to update in all lower case (Ex: android). + +The next time you build you will now be on the updated version of the platform. + +You can also use a platform from Git using the following syntax: + +~~~~~~~~~~~~~~~~~~~~~~~~ + +~~~~~~~~~~~~~~~~~~~~~~~~ + +Be aware that platform versions in Git are typically dev releases so you will likely encounter bugs. + ## More Information * [Read tutorials and learn about tips, tricks, and known issues](../../Readme.md) * [Download samples from our Cordova Samples repository](http://github.com/Microsoft/cordova-samples)