You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by st...@apache.org on 2016/10/05 18:42:49 UTC
svn commit: r1763475 [1/2] - in /cordova/site/public: ./ blog/ contribute/
docs/en/dev/config_ref/ docs/en/dev/guide/platforms/ios/
docs/en/dev/plugin_ref/ docs/en/dev/reference/cordova-plugin-camera/
docs/en/dev/reference/cordova-plugin-console/ docs/...
Author: steven
Date: Wed Oct 5 18:42:49 2016
New Revision: 1763475
URL: http://svn.apache.org/viewvc?rev=1763475&view=rev
Log:
updated site with new blog posts
Added:
cordova/site/public/news/2016/10/
cordova/site/public/news/2016/10/01/
cordova/site/public/news/2016/10/01/0.x-4.x-deprecation-timeline.html
cordova/site/public/news/2016/10/04/
cordova/site/public/news/2016/10/04/small-releases.html
cordova/site/public/static/img/cordova-node-timeline.svg
Modified:
cordova/site/public/blog/index.html
cordova/site/public/contribute/contribute_guidelines.html
cordova/site/public/contribute/nightly_builds.html
cordova/site/public/docs/en/dev/config_ref/index.html
cordova/site/public/docs/en/dev/guide/platforms/ios/webview.html
cordova/site/public/docs/en/dev/plugin_ref/plugman.html
cordova/site/public/docs/en/dev/plugin_ref/spec.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-camera/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-console/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-contacts/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-whitelist/index.html
cordova/site/public/feed.xml
cordova/site/public/news/2016/09/14/plugins-release.html
cordova/site/public/sitemap.xml
cordova/site/public/static/js/index.js
cordova/site/public/static/js/plugins.js
Modified: cordova/site/public/blog/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/blog/index.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/blog/index.html (original)
+++ cordova/site/public/blog/index.html Wed Oct 5 18:42:49 2016
@@ -124,6 +124,86 @@
<li>
<header>
+ <div class="adorner" blogTime="Tue, 04 Oct 2016 00:00:00 -0700"></div>
+ <h2 class="title">
+ <a href="/news/2016/10/04/small-releases.html">Minor Releases</a>
+ </h2>
+ <div class="details">
+ <span class="date">04 Oct 2016</span>
+ - by
+ <span class="author">
+
+ <a href="https://twitter.com/stevesgill">Steve Gill</a>
+
+ </span>
+ <a class="comment" href="/news/2016/10/04/small-releases.html#disqus_thread"></a>
+ </div>
+ </header>
+ <section class="post-excerpt">
+ <p><p>The following were recently released:</p>
+
+<ul>
+<li>cordova-plugin-geolocation: 2.4.0</li>
+<li>cordova-create: 1.0.1</li>
+<li>cordova-app-hello-world: 3.11.0</li>
+</ul>
+
+<p><strong>Google</strong> recently sent out warnings to everyone who uses <code>cordova-plugin-geolocation</code> about having to include <code>android.hardware.location.gps</code> to their <code>AndroidManifest.xml</code>. We updated <code>cordova-plugin-geolocation</code> plugin to auto add this setting to your project's <code>AndroidManifest.xml</code> when installing the plugin. This means that the geolocation plugin will only work on <strong>android</strong> devices that have a <code>GPS</code>. Let us know if this restriction affects you negatively. </p>
+
+<p>Release Highlights:</p>
+
+<ul>
+<li><code>cordova-app-hello-world</code>: Updated default <code>CSP</code> to include <code>img-src</code> and add <code>content:</code> to it for <a href="https://issues.apache.org/jira/browse/CB-4078">CB-4078</a></li>
+</ul>
+
+<hr>
+
+<p>You can update any plugin by removing it, and then re-adding it.</p>
+
+<p>E.g. To update your geolocation plugin:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin rm cordova-plugin-geolocation --save
+cordova plugin add cordova-plugin-geolocation@latest --save
+</code></pre></div>
+<p>Changes include:</p>
+</p>
+ <div><a href="/news/2016/10/04/small-releases.html">More...</a></div>
+ </section>
+ </li>
+
+ <li>
+ <header>
+ <div class="adorner" blogTime="Sat, 01 Oct 2016 00:00:00 -0700"></div>
+ <h2 class="title">
+ <a href="/news/2016/10/01/0.x-4.x-deprecation-timeline.html">Node 0.x and 4.x Deprecation Timeline for Apache Cordova</a>
+ </h2>
+ <div class="details">
+ <span class="date">01 Oct 2016</span>
+ - by
+ <span class="author">
+
+ <a href="https://twitter.com/shazron">Shazron Abdullah</a>
+
+ </span>
+ <a class="comment" href="/news/2016/10/01/0.x-4.x-deprecation-timeline.html#disqus_thread"></a>
+ </div>
+ </header>
+ <section class="post-excerpt">
+ <p><p>Currently, all the platforms and plugins require a minimum of <code>node 0.10</code> to be installed. <code>node 0.10</code> has been out of <a href="https://github.com/nodejs/LTS" title="Node.js Long-term Support Working Group">LTS</a> for a while now, and its maintenance period (security bug fixes) <strong>stops on Oct 31st 2016</strong>. <code>node 0.12</code> will be out of maintenance <strong>Jan 1st 2017</strong>.</p>
+
+<p>There will be two distinct deprecation periods, one for <code>node 0.x</code>, and one for <code>node 4.x</code>.</p>
+
+<p><code>node 6.x</code> will be on active LTS <strong>Oct 18th 2016</strong> (thus the default and recommended version to download on <a href="http://nodejs.org">nodejs.org</a>) and will be the version we recommend users upgrade to, during both deprecation periods.</p>
+
+<p>What does <code>node 6.x</code> give us? <a href="http://node.green/#ES2015" title="Node ES6 Support">99% ES2015 (ES6)</a> support, and <a href="http://node.green/#ES2016" title="Node ES7 Support">100% ES2016 (ES7)</a> support.</p>
+
+<p>JavaScript files in plugins themselves are unaffected, since the JavaScript support for them is dependent on platform browser support. For example, ES6 is supported in iOS 10, while on older iOS platforms only ES5 is supported. </p>
+</p>
+ <div><a href="/news/2016/10/01/0.x-4.x-deprecation-timeline.html">More...</a></div>
+ </section>
+ </li>
+
+ <li>
+ <header>
<div class="adorner" blogTime="Wed, 14 Sep 2016 00:00:00 -0700"></div>
<h2 class="title">
<a href="/news/2016/09/14/plugins-release.html">Plugins Release</a>
@@ -4909,7 +4989,7 @@ window.twttr = (function(d, s, id) {
<script>
window.onload = function(){
setTimeout(function(){
- var lastPostTime = new Date("Wed, 14 Sep 2016 00:00:00 -0700").getTime();
+ var lastPostTime = new Date("Tue, 04 Oct 2016 00:00:00 -0700").getTime();
setCookie("visitTime", lastPostTime, 365);
}, 2000);
};
Modified: cordova/site/public/contribute/contribute_guidelines.html
URL: http://svn.apache.org/viewvc/cordova/site/public/contribute/contribute_guidelines.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/contribute/contribute_guidelines.html (original)
+++ cordova/site/public/contribute/contribute_guidelines.html Wed Oct 5 18:42:49 2016
@@ -118,16 +118,10 @@
<h2>Prerequisites</h2>
-<p>Before contributing to Apache Cordova, please complete the following steps:</p>
+<p>Before contributing to Apache Cordova, it is recommended that you complete the following steps:</p>
<ol>
-<li>Sign the <a href="http://www.apache.org/licenses/#clas">Individual Contributor License Agreement (ICLA)</a> and <a href="http://www.apache.org/licenses/#submitting">submit it to the ASF</a>.
-
-<ul>
-<li>You should receive an email confirming you submission within a day or so and your name will appear in the <a href="https://people.apache.org/unlistedclas.html">list of contributors</a></li>
-<li>If you are submitting on behalf of a company, you may need to submit a CCLA as well</li>
-</ul></li>
-<li>Join the <a href="http://cordova.apache.org/contact/">mailing list</a> and send a brief introduction of yourself</li>
+<li>Join the <a href="http://cordova.apache.org/contact/">mailing list</a> and send a brief introduction of yourself (optional)</li>
<li>Create an <a href="https://issues.apache.org/jira/secure/Signup!default.jspa">Apache JIRA</a> account</li>
</ol>
@@ -137,7 +131,7 @@
<h4>Claiming Issues</h4>
-<p>If you find a JIRA issue that you would like to work on, you can ask to claim it; please leave a comment indicating your intention and a committer will assign it to you. Some issues in JIRA are auto-assigned to certain contributors. If it is clear that an issue is not being worked on, feel free to work on it yourself (but please comment first to let the asignee know). If you are looking for a place to start, try searching the <a href="https://issues.apache.org/jira/issues?jql=project%20%3D%20CB%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20%22easyfix%22%20ORDER%20BY%20createdDate%20DESC">issues labelled easyfix</a>.</p>
+<p>If you find a JIRA issue that you would like to work on, you can ask to claim it; please leave a comment indicating your intention and a committer will assign it to you. Some issues in JIRA are auto-assigned to certain contributors. If it is clear that an issue is not being worked on, feel free to work on it yourself (but please comment first to let the assignee know). If you are looking for a place to start, try searching the <a href="https://issues.apache.org/jira/issues?jql=project%20%3D%20CB%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20%22easyfix%22%20ORDER%20BY%20createdDate%20DESC">issues labelled easyfix</a>.</p>
<h2>Submitting Code</h2>
@@ -182,8 +176,8 @@
<li>Any platform-specific unit tests
<ul>
-<li><code>cordova-android/test</code></li>
-<li><code>cordova-ios/CordovaLibTests</code></li>
+<li><code>cordova-android: npm run test-build</code></li>
+<li><code>cordova-ios: npm test</code></li>
<li><code>cordova-js: jake test</code></li>
<li><code>cordova-plugman: npm test</code></li>
</ul></li>
Modified: cordova/site/public/contribute/nightly_builds.html
URL: http://svn.apache.org/viewvc/cordova/site/public/contribute/nightly_builds.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/contribute/nightly_builds.html (original)
+++ cordova/site/public/contribute/nightly_builds.html Wed Oct 5 18:42:49 2016
@@ -114,7 +114,9 @@
<div class="contribute-help">
<h1>Nightly builds</h1>
-<p>Cordova community provides Cordova nightly builds as a way to test new features and bugfixes not yet included into the latest official release. Nightly builds are performed by <a href="https://builds.apache.org/view/A-D/view/Cordova/job/cordova-nightly/">Apache Jenkins</a> every day approximately at 3PM UTC and are being published to NPM under <code>@nightly</code> dist tag.</p>
+<p><strong>These are not official releases.</strong></p>
+
+<p>Cordova community provides Cordova nightly builds as a way to test new features and bug-fixes not yet included into the latest official release. Nightly builds are performed by <a href="https://builds.apache.org/view/A-D/view/Cordova/job/cordova-nightly/">Apache Jenkins</a> every day approximately at 3PM UTC and are being published to NPM under the <code>@nightly</code> dist tag.</p>
<p>The following NPM packages are being released as a part of the nightly builds:</p>
@@ -128,7 +130,7 @@
<h2>Notice</h2>
-<p>The nightly builds are untested and may contain known and unknown defects, undeclared features and any other issues. They are intended to be used for testing purposes by developers, early adopters, and others who want to help with resolving bugs.</p>
+<p>The nightly builds are untested and may contain known and unknown defects, undeclared features, and perhaps other issues. They are intended to be used for testing purposes by developers, and others who want to help with resolving bugs.</p>
<h2>Installation</h2>
Modified: cordova/site/public/docs/en/dev/config_ref/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/config_ref/index.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/config_ref/index.html (original)
+++ cordova/site/public/docs/en/dev/config_ref/index.html Wed Oct 5 18:42:49 2016
@@ -3076,6 +3076,10 @@ and will be indicated as such.</p>
<td>If set, will display the referenced local page upon an error in the application.</td>
</tr>
<tr>
+<td>ForegroundText(string) <br/> <mark>Windows</mark></td>
+<td><em>Default: "light"</em> <br/> Works for Windows 8.1 projects only. Allowed values: "light", "dark". Set to "dark" if you use the <code>BackgroundColor="white"</code> or another light color to avoid Windows Store submissions errors.</td>
+</tr>
+<tr>
<td>FullScreen(boolean) <br/> <mark>Android</mark></td>
<td><em>Default: false</em> <br/> Allows you to hide the status bar at the top of the screen. <br/> <strong>Note</strong>: Recommended platform-agnostic way to achieve this is to use the <a href="../reference/cordova-plugin-statusbar/">StatusBar plugin</a>.</td>
</tr>
Modified: cordova/site/public/docs/en/dev/guide/platforms/ios/webview.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/guide/platforms/ios/webview.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/guide/platforms/ios/webview.html (original)
+++ cordova/site/public/docs/en/dev/guide/platforms/ios/webview.html Wed Oct 5 18:42:49 2016
@@ -2714,7 +2714,7 @@ Inspector</strong>.</p></li>
drop-down menu for <strong>Location</strong>.</p></li>
<li><p>Select the <strong>project icon</strong> in the <strong>Project Navigator</strong>, select
the <strong>Target</strong>, then select the <strong>Build Settings</strong> tab.</p></li>
-<li><p>Add <code>-force_load</code> and <code>-Obj-C</code> for the <strong>Other Linker Flags</strong> value.</p></li>
+<li><p>Add <code>-force_load</code> and <code>-ObjC</code> for the <strong>Other Linker Flags</strong> value.</p></li>
<li><p>Click on the <strong>project icon</strong> in the Project Navigator, select the
<strong>Target</strong>, then select the <strong>Build Phases</strong> tab.</p></li>
<li><p>Expand <strong>Link Binaries with Libraries</strong>.</p></li>
Modified: cordova/site/public/docs/en/dev/plugin_ref/plugman.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/plugin_ref/plugman.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/plugin_ref/plugman.html (original)
+++ cordova/site/public/docs/en/dev/plugin_ref/plugman.html Wed Oct 5 18:42:49 2016
@@ -2741,7 +2741,7 @@ listed on the Platform guides page.</p>
<ul>
<li><code>--plugins_dir</code> defaults to <code><project>/cordova/plugins</code>, but can be any directory containing a subdirectory for each fetched plugin.</li>
<li><code>--www</code> defaults to the project's <code>www</code> folder location, but can be any directory that is to be used as cordova project application web assets.</li>
-<li><code>--variable</code> allows to specify certain variables at install time, necessary for certain plugins requiring API keys or other custom, user-defined parameters. Please see the <a href="plugin_ref_spec.md.html#Plugin%20Specification">plugin specification</a> for more information.</li>
+<li><code>--variable</code> allows to specify certain variables at install time, necessary for certain plugins requiring API keys or other custom, user-defined parameters. Please see the <a href="spec.md.html#Plugin%20Specification">plugin specification</a> for more information.</li>
</ul>
<h2>Remove a Plugin</h2>
Modified: cordova/site/public/docs/en/dev/plugin_ref/spec.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/plugin_ref/spec.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/plugin_ref/spec.html (original)
+++ cordova/site/public/docs/en/dev/plugin_ref/spec.html Wed Oct 5 18:42:49 2016
@@ -3022,8 +3022,8 @@ like. Any object not available on <code>
<td><em>Required</em> <br/> Location of the file relative to <code>plugin.xml</code>. If the src file can't be found, the CLI stops and reverses the installation, issues a notification about the problem, and exits with a non-zero code.</td>
</tr>
<tr>
-<td>target(string)</td>
-<td>Path to where the file will be copied in your directory.</td>
+<td>target-dir(string)</td>
+<td>A directory into which the files should be copied, relative to the root of the Cordova project.</td>
</tr>
</tbody></table>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-camera/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-camera/index.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-camera/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-camera/index.html Wed Oct 5 18:42:49 2016
@@ -2774,6 +2774,30 @@ function onDeviceReady() {
<a href="https://www.npmjs.com/package/jsdoc-to-markdown">jsdoc-to-markdown</a> is used to generate the docs.<br>
Documentation consists of template and API docs produced from the plugin JS code and should be regenerated before each commit (done automatically via <a href="https://github.com/typicode/husky">husky</a>, running <code>npm run gen-docs</code> script as a <code>precommit</code> hook - see <code>package.json</code> for details).</p>
+<h3>iOS Quirks</h3>
+
+<p>Since iOS 10 it's mandatory to add a <code>NSCameraUsageDescription</code> and <code>NSPhotoLibraryUsageDescriptionentry</code> in the info.plist.</p>
+
+<ul>
+<li><code>NSCameraUsageDescription</code> describes the reason that the app accesses the user’s camera.</li>
+<li><code>NSPhotoLibraryUsageDescriptionentry</code> describes the reason the app accesses the user's photo library. </li>
+</ul>
+
+<p>When the system prompts the user to allow access, this string is displayed as part of the dialog box. </p>
+
+<p>To add this entry you can pass the following variables on plugin install.</p>
+
+<ul>
+<li><code>CAMERA_USAGE_DESCRIPTION</code> for <code>NSCameraUsageDescription</code></li>
+</ul>
+
+<h2>- <code>PHOTOLIBRARY_USAGE_DESCRIPTION</code> for <code>NSPhotoLibraryUsageDescriptionentry</code></h2>
+
+<p>Example:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin add cordova-plugin-camera --variable CAMERA_USAGE_DESCRIPTION="your usage message"
+</code></pre></div>
+<p>If you don't pass the variable, the plugin will add an empty string as value.</p>
+
<hr>
<h1>API Reference <a name="reference"></a></h1>
@@ -2798,12 +2822,8 @@ Documentation consists of template and A
<li><a href="#module_Camera.PopoverArrowDirection">.PopoverArrowDirection</a> : <code>enum</code></li>
<li><a href="#module_Camera.Direction">.Direction</a> : <code>enum</code></li>
</ul></li>
+<li><p><a href="#module_CameraPopoverHandle">CameraPopoverHandle</a></p></li>
<li><p><a href="#module_CameraPopoverOptions">CameraPopoverOptions</a></p></li>
-<li><p><a href="#module_CameraPopoverHandle">CameraPopoverHandle</a></p>
-
-<ul>
-<li><a href="#module_CameraPopoverHandle.setPosition">.setPosition(options)</a></li>
-</ul></li>
</ul>
<hr>
@@ -3355,27 +3375,7 @@ location.</p>
<h2>CameraPopoverHandle</h2>
-<p>A handle to the image picker popover.</p>
-
-<p><a name="module_CameraPopoverHandle.setPosition"></a></p>
-
-<h3>CameraPopoverHandle.setPosition(options)</h3>
-
-<p>Can be used to reposition the image selection dialog, for example, when the device orientation changes.</p>
-
-<table><thead>
-<tr>
-<th>Param</th>
-<th>Type</th>
-<th>Description</th>
-</tr>
-</thead><tbody>
-<tr>
-<td>options</td>
-<td><code><a href="#module_CameraPopoverOptions">CameraPopoverOptions</a></code></td>
-<td>CameraPopoverOptions</td>
-</tr>
-</tbody></table>
+<p>A handle to an image picker popover.</p>
<p><strong>Supported Platforms</strong></p>
@@ -3485,6 +3485,16 @@ displays:</p>
<p>Invoking the native camera application while the device is connected
via Zune does not work, and triggers an error callback.</p>
+<h4>Windows quirks</h4>
+
+<p>On Windows Phone 8.1 using <code>SAVEDPHOTOALBUM</code> or <code>PHOTOLIBRARY</code> as a source type causes application to suspend until file picker returns the selected image and
+then restore with start page as defined in app's <code>config.xml</code>. In case when <code>camera.getPicture</code> was called from different page, this will lead to reloading
+start page from scratch and success and error callbacks will never be called.</p>
+
+<p>To avoid this we suggest using SPA pattern or call <code>camera.getPicture</code> only from your app's start page.</p>
+
+<p>More information about Windows Phone 8.1 picker APIs is here: <a href="https://msdn.microsoft.com/en-us/library/windows/apps/dn720490.aspx">How to continue your Windows Phone app after calling a file picker</a></p>
+
<h4>Tizen Quirks</h4>
<p>Tizen only supports a <code>destinationType</code> of
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-console/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-console/index.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-console/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-console/index.html Wed Oct 5 18:42:49 2016
@@ -2748,6 +2748,8 @@ function onDeviceReady() {
console.log("console.log works well");
}
</code></pre></div>
+<p>:warning: Report issues on the <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20Console%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC">Apache Cordova issue tracker</a></p>
+
<h2>Installation</h2>
<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin add cordova-plugin-console
</code></pre></div>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-contacts/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-contacts/index.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-contacts/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-contacts/index.html Wed Oct 5 18:42:49 2016
@@ -2772,6 +2772,17 @@ contact data. For more information, ple
<p>It is also possible to install via repo url directly ( unstable )</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
</code></pre></div>
+<h3>iOS Quirks</h3>
+
+<p>Since iOS 10 it's mandatory to add a <code>NSContactsUsageDescription</code> entry in the info.plist.</p>
+
+<p><code>NSContactsUsageDescription</code> describes the reason that the app accesses the user’s contacts. When the system prompts the user to allow access, this string is displayed as part of the dialog box. To add this entry you can pass the variable <code>CONTACTS_USAGE_DESCRIPTION</code> on plugin install.</p>
+
+<p>Example:
+<code>cordova plugin add cordova-plugin-contacts --variable CONTACTS_USAGE_DESCRIPTION="your usage message"</code></p>
+
+<p>If you don't pass the variable, the plugin will add an empty string as value.</p>
+
<h3>Firefox OS Quirks</h3>
<p>Create <strong>www/manifest.webapp</strong> as described in
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html Wed Oct 5 18:42:49 2016
@@ -2918,6 +2918,33 @@ object featuring a <code>CaptureError.CA
<li>Windows</li>
</ul>
+<h3>iOS Quirks</h3>
+
+<p>Since iOS 10 it's mandatory to add a <code>NSCameraUsageDescription</code>, <code>NSMicrophoneUsageDescription</code> and <code>NSPhotoLibraryUsageDescriptionentry</code> in the info.plist.</p>
+
+<ul>
+<li><code>NSCameraUsageDescription</code> describes the reason that the app accesses the user’s camera.</li>
+<li><code>NSMicrophoneUsageDescription</code> describes the reason that the app accesses the user’s microphone.</li>
+<li><code>NSPhotoLibraryUsageDescriptionentry</code> describes the reason the app accesses the user's photo library.</li>
+</ul>
+
+<p>When the system prompts the user to allow access, this string is displayed as part of the dialog box.</p>
+
+<p>To add this entry you can pass the following variables on plugin install.</p>
+
+<ul>
+<li><code>CAMERA_USAGE_DESCRIPTION</code> for <code>NSCameraUsageDescription</code></li>
+<li><code>MICROPHONE_USAGE_DESCRIPTION</code> for <code>NSMicrophoneUsageDescription</code></li>
+<li><code>PHOTOLIBRARY_USAGE_DESCRIPTION</code> for <code>NSPhotoLibraryUsageDescriptionentry</code></li>
+</ul>
+
+<p>-
+Example:</p>
+
+<p><code>cordova plugin add cordova-plugin-media-capture --variable CAMERA_USAGE_DESCRIPTION="your usage message"</code></p>
+
+<p>If you don't pass the variable, the plugin will add an empty string as value.</p>
+
<h3>Windows Phone 7 Quirks</h3>
<p>Invoking the native camera application while your device is connected
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html Wed Oct 5 18:42:49 2016
@@ -2759,6 +2759,408 @@ cordova plugin add https://github.com/ap
<p><strong>Note</strong>: Extended splashscreen does not require the plugin on Windows (as opposed to Android and iOS) in case you don't use the plugin API, i.e. programmatic hide/show.</p>
+<h3>iOS-specific information</h3>
+
+<p>There are two mechanisms for displaying a launch screen on iOS:</p>
+
+<ol>
+<li><p>Legacy launch images: images are sized exactly for the device's screen size. Does not support the iPad Pro 12.9's native resolution or split-screen/slide-over multitasking.</p></li>
+<li><p>Launch storyboard images: Images are sized based on scale, idiom, and size classes. Supports all devices, and can be used with split-screen/slide-over multitasking.</p></li>
+</ol>
+
+<p>Apple is moving away from legacy launch images. There is no official support for providing a native-resolution launch image for the iPad Pro 12.9 or for providing launch images that work with split-screen multitasking or slide-over. If your app doesn't need to support these contexts, then you can continue to use legacy launch images for as long as you like. </p>
+
+<p>The preferred method of providing launch images is to use a launch storyboard. For native app developers, the ideal launch storyboard is an unpopulated version of the app's user interface at launch. For non-native app developers who don't wish to learn Interface Builder, however, this plugin simulates the legacy launch image method as much as is feasible.</p>
+
+<h4>Legacy launch images</h4>
+
+<p>If you choose to use legacy launch images, you will use the following syntax in <code>config.xml</code>:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""> <splash src="res/screen/ios/Default~iphone.png" width="320" height="480"/>
+ <splash src="res/screen/ios/Default@2x~iphone.png" width="640" height="960"/>
+ <splash src="res/screen/ios/Default-Portrait~ipad.png" width="768" height="1024"/>
+ <splash src="res/screen/ios/Default-Portrait@2x~ipad.png" width="1536" height="2048"/>
+ <splash src="res/screen/ios/Default-Landscape~ipad.png" width="1024" height="768"/>
+ <splash src="res/screen/ios/Default-Landscape@2x~ipad.png" width="2048" height="1536"/>
+ <splash src="res/screen/ios/Default-568h@2x~iphone.png" width="640" height="1136"/>
+ <splash src="res/screen/ios/Default-667h.png" width="750" height="1334"/>
+ <splash src="res/screen/ios/Default-736h.png" width="1242" height="2208"/>
+</code></pre></div>
+<p>Technically the filename for the <code>src</code> attribute can be anything you want; the filenames are used because they match what will be used when your project is compiled. The width and height attributes determine which launch images are displayed on which devices as follows:</p>
+
+<table><thead>
+<tr>
+<th style="text-align: center">width</th>
+<th style="text-align: center">height</th>
+<th style="text-align: center">device (orientation)</th>
+</tr>
+</thead><tbody>
+<tr>
+<td style="text-align: center">320</td>
+<td style="text-align: center">480</td>
+<td style="text-align: center">All non-retina iPhones and iPods</td>
+</tr>
+<tr>
+<td style="text-align: center">640</td>
+<td style="text-align: center">960</td>
+<td style="text-align: center">iPhone 4/4s/5/5s (portrait)</td>
+</tr>
+<tr>
+<td style="text-align: center">750</td>
+<td style="text-align: center">1334</td>
+<td style="text-align: center">iPhone 6/6s/7 (portrait)</td>
+</tr>
+<tr>
+<td style="text-align: center">1242</td>
+<td style="text-align: center">2208</td>
+<td style="text-align: center">iPhone 6+/6s+/7+ (portrait)</td>
+</tr>
+<tr>
+<td style="text-align: center">2208</td>
+<td style="text-align: center">1242</td>
+<td style="text-align: center">iPhone 6+/6s+/7+ (landscape)</td>
+</tr>
+<tr>
+<td style="text-align: center">768</td>
+<td style="text-align: center">1024</td>
+<td style="text-align: center">All non-retina iPads (portrait)</td>
+</tr>
+<tr>
+<td style="text-align: center">1024</td>
+<td style="text-align: center">768</td>
+<td style="text-align: center">All non-retina iPads (landscape)</td>
+</tr>
+<tr>
+<td style="text-align: center">1536</td>
+<td style="text-align: center">2048</td>
+<td style="text-align: center">All retina iPads (portrait)</td>
+</tr>
+<tr>
+<td style="text-align: center">2048</td>
+<td style="text-align: center">1536</td>
+<td style="text-align: center">All retina iPads (landscape)</td>
+</tr>
+</tbody></table>
+
+<p>Note: It is vitally important that the source image actually matches the size specified in the <code>width</code> and <code>height</code> attributes. If it does not, the device may fail to render it properly, if at all.</p>
+
+<h4>Launch storyboard images</h4>
+
+<p>In order to support newer form factors and split-screen/slide-over multitasking, you should use launch storyboard images. These are similar to the legacy launch images above, but there are crucial differences:</p>
+
+<ul>
+<li><p>images are not specific to a given device.</p></li>
+<li><p>images are scaled to fill the available viewport (while maintaining the aspect ratio).</p></li>
+<li><p>the outer edges of the images will be cropped, and the amount will vary based on device an viewport.</p></li>
+<li><p>there is no need to provide an image for each possible device, viewport, and orientation; iOS will choose the best image for the situation automatically.</p></li>
+</ul>
+
+<h5>Designing launch storyboard images</h5>
+
+<p>The key to designing a launch storyboard image is understanding that the edges of the image will almost certainly be cropped. Therefore, one should not place any important information near the edges of any images provided to the launch storyboard. Only the center is a safe area, and this all but guarantees that following Apple's advice of presenting an unpopulated user interface will not work well.</p>
+
+<p>Instead, the following tips should enable you to create a launch image that works across a multitude of form factors, viewports, and orientations:</p>
+
+<ul>
+<li><p>Important graphics (logos, icons, titles) should be centered. The safe bounding region will vary, so you will need to test to ensure that the important graphics are never cropped. Better yet, don't supply any important graphics in the first place.</p>
+
+<ul>
+<li>You <em>can</em> fine-tune the placement and size of these graphics, but you don't have the same fine-grained control as you did with legacy launch images.</li>
+</ul></li>
+<li><p>Use a simple color wash. If you use two colors, you'll want one color to fill the top half of the image, and the second to fill the bottom half. If you use a gradient, you'll probably want to ensure that the middle of the gradient lines up with the center of the image. </p></li>
+<li><p>Don't worry about pixel perfection -- because the images are scaled, there's almost no chance the images will be perfectly fit to the pixel grid. Since all supported iOS devices use retina screens, users will be hard pressed to notice it anyway.</p></li>
+</ul>
+
+<p>It is important to understand the concept of scale, idiom, and size class traits in order to use launch storyboard images effectively. Of the images supplied to the launch storyboard, iOS will choose the image that best matches the device and viewport and render that image. It is possible to supply only one launch image if so desired, but it is also possible to fine-tune the displayed launch image based on traits. When fine-tuning, one can ignore traits that aren't targeted or supported by the app.</p>
+
+<blockquote>
+<p>Note: If you are using launch storyboard images, there is no need to include legacy images. If you do, the legacy images will be copied, but not used.</p>
+</blockquote>
+
+<h5>Scale</h5>
+
+<table><thead>
+<tr>
+<th style="text-align: center">scale</th>
+<th style="text-align: center">devices</th>
+</tr>
+</thead><tbody>
+<tr>
+<td style="text-align: center">1x</td>
+<td style="text-align: center">All non-retina devices</td>
+</tr>
+<tr>
+<td style="text-align: center">2x</td>
+<td style="text-align: center">Most retina devices</td>
+</tr>
+<tr>
+<td style="text-align: center">3x</td>
+<td style="text-align: center">iPhone 6+/6s+,7s+</td>
+</tr>
+</tbody></table>
+
+<p>In general, you'll want to supply 2x and 3x images. Cordova only supports retina devices now, so there's no point in supplying 1x images.</p>
+
+<h5>Idioms</h5>
+
+<table><thead>
+<tr>
+<th style="text-align: center">idiom</th>
+<th style="text-align: center">devices</th>
+</tr>
+</thead><tbody>
+<tr>
+<td style="text-align: center">ipad</td>
+<td style="text-align: center">All iPads</td>
+</tr>
+<tr>
+<td style="text-align: center">iphone</td>
+<td style="text-align: center">All iPhones and iPod Touches</td>
+</tr>
+<tr>
+<td style="text-align: center">universal</td>
+<td style="text-align: center">All devices</td>
+</tr>
+</tbody></table>
+
+<p>You only need to provide universal images unless you need to fine-tune for a specific device idiom.</p>
+
+<h5>Size classes</h5>
+
+<p>There are two size classes applies to both screen axes. Narrow viewports are considered to be the "compact" size class, and remaining viewports are considered "regular". When supplying images to Xcode, however, one must choose between "any & compact" and "any & regular". To stay consistent with the native terminology, this feature will match based on "any" and "compact". <code>any</code> will match regular-sized viewports. </p>
+
+<p>Note: this feature uses <code>com</code> as an abbreviation for "compact" classes.</p>
+
+<p>The following classes are supported by this feature:</p>
+
+<table><thead>
+<tr>
+<th style="text-align: center">width</th>
+<th style="text-align: center">height</th>
+<th style="text-align: center">orientation</th>
+</tr>
+</thead><tbody>
+<tr>
+<td style="text-align: center">any</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">any</td>
+</tr>
+<tr>
+<td style="text-align: center">com</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">portrait</td>
+</tr>
+<tr>
+<td style="text-align: center">any</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">landscape (wide)</td>
+</tr>
+<tr>
+<td style="text-align: center">com</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">landscape (narrow)</td>
+</tr>
+</tbody></table>
+
+<p>To see the complete list of size classes associated with devices and viewports, see <a href="http://www.sizeclasses.com">http://www.sizeclasses.com</a>.</p>
+
+<h5>Single-image launch screen</h5>
+
+<p>If your launch image is simple, you may be able to avoid creating a lot of different launch images and supply only one. The launch image needs to meet the following requirements:</p>
+
+<ul>
+<li><p>the image should be square</p></li>
+<li><p>the image should be large enough to fit on an iPad Pro 12.9": 2732x2732</p></li>
+<li><p>anything important should fit within the center</p></li>
+</ul>
+
+<p>Keep in mind that the image will be cropped, possibly quite severely, depending upon the viewport. </p>
+
+<p>Once the image is created, you can include it in your project by adding the following to <code>config.xml</code>:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""> <splash src="res/screen/ios/Default@2x~universal~anyany.png" />
+</code></pre></div>
+<p>Because only one image is provided, iOS will utilize it in every context.</p>
+
+<h5>Multi-image launch screen</h5>
+
+<p>If a single launch image won't meet your needs, you will probably need to supply at least six images, if not more. Furthermore, keep in mind that it will not be possible to fine tune the image to a specific device, but only to a device class, display factor, and viewport size.</p>
+
+<p>If you don't need to target images to a specific idiom, you should create six images, as follows:</p>
+
+<table><thead>
+<tr>
+<th style="text-align: center">scale</th>
+<th style="text-align: center">idiom</th>
+<th style="text-align: center">width</th>
+<th style="text-align: center">height</th>
+<th style="text-align: center">size</th>
+<th style="text-align: center">filename</th>
+</tr>
+</thead><tbody>
+<tr>
+<td style="text-align: center">2x*</td>
+<td style="text-align: center">universal</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">2732x2732</td>
+<td style="text-align: center"><code>Default@2x~universal~anyany.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">2x</td>
+<td style="text-align: center">universal</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">1278x2732</td>
+<td style="text-align: center"><code>Default@2x~universal~comany.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">2x</td>
+<td style="text-align: center">universal</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">1334x750</td>
+<td style="text-align: center"><code>Default@2x~universal~comcom.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">3x*</td>
+<td style="text-align: center">universal</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">2208x2208</td>
+<td style="text-align: center"><code>Default@3x~universal~anyany.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">3x</td>
+<td style="text-align: center">universal</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">2208x1242</td>
+<td style="text-align: center"><code>Default@3x~universal~anycom.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">3x</td>
+<td style="text-align: center">universal</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">1242x2208</td>
+<td style="text-align: center"><code>Default@3x~universal~comany.png</code></td>
+</tr>
+</tbody></table>
+
+<p>* this image is required in order for iOS utilize the other images within this scale and idiom.</p>
+
+<blockquote>
+<p>Note: If the 3x sizes look small too you, that's because there's only one device class that currently has a 3x density: the iPhone 6+/6s+/7+.</p>
+</blockquote>
+
+<p>The above looks like the following snippet when present in <code>config.xml</code>:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""> <splash src="res/screen/ios/Default@2x~universal~anyany.png" />
+ <splash src="res/screen/ios/Default@2x~universal~comany.png" />
+ <splash src="res/screen/ios/Default@2x~universal~comcom.png" />
+ <splash src="res/screen/ios/Default@3x~universal~anyany.png" />
+ <splash src="res/screen/ios/Default@3x~universal~anycom.png" />
+ <splash src="res/screen/ios/Default@3x~universal~comany.png" />
+</code></pre></div>
+<p>Should one need to further fine tune based upon device idiom, one can do so. This might look like so:</p>
+
+<table><thead>
+<tr>
+<th style="text-align: center">scale</th>
+<th style="text-align: center">idiom</th>
+<th style="text-align: center">width</th>
+<th style="text-align: center">height</th>
+<th style="text-align: center">size</th>
+<th style="text-align: center">filename</th>
+</tr>
+</thead><tbody>
+<tr>
+<td style="text-align: center">2x*</td>
+<td style="text-align: center">iphone</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">1334x1334</td>
+<td style="text-align: center"><code>Default@2x~iphone~anyany.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">2x</td>
+<td style="text-align: center">iphone</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">750x1334</td>
+<td style="text-align: center"><code>Default@2x~iphone~comany.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">2x</td>
+<td style="text-align: center">iphone</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">1334x750</td>
+<td style="text-align: center"><code>Default@2x~iphone~comcom.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">3x*</td>
+<td style="text-align: center">iphone</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">2208x2208</td>
+<td style="text-align: center"><code>Default@3x~iphone~anyany.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">3x</td>
+<td style="text-align: center">iphone</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">2208x1242</td>
+<td style="text-align: center"><code>Default@3x~iphone~anycom.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">3x</td>
+<td style="text-align: center">iphone</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">1242x2208</td>
+<td style="text-align: center"><code>Default@3x~iphone~comany.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">2x*</td>
+<td style="text-align: center">ipad</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">2732x2732</td>
+<td style="text-align: center"><code>Default@2x~ipad~anyany.png</code></td>
+</tr>
+<tr>
+<td style="text-align: center">2x</td>
+<td style="text-align: center">ipad</td>
+<td style="text-align: center">com</td>
+<td style="text-align: center">any</td>
+<td style="text-align: center">1278x2732</td>
+<td style="text-align: center"><code>Default@2x~ipad~comany.png</code></td>
+</tr>
+</tbody></table>
+
+<p>* this image is required in order for iOS utilize the other images within this scale and idiom.</p>
+
+<p>The above looks like the following in <code>config.xml</code>:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""> <splash src="res/screen/ios/Default@2x~iphone~anyany.png" />
+ <splash src="res/screen/ios/Default@2x~iphone~comany.png" />
+ <splash src="res/screen/ios/Default@2x~iphone~comcom.png" />
+ <splash src="res/screen/ios/Default@3x~iphone~anyany.png" />
+ <splash src="res/screen/ios/Default@3x~iphone~anycom.png" />
+ <splash src="res/screen/ios/Default@3x~iphone~comany.png" />
+ <splash src="res/screen/ios/Default@2x~ipad~anyany.png" />
+ <splash src="res/screen/ios/Default@2x~ipad~comany.png" />
+</code></pre></div>
+<h5>Quirks and Known Issues</h5>
+
+<ol>
+<li><p><strong>App on target may not reflect changes to images</strong>
+Once you run the app on a target, iOS caches the launch image. Unfortunately, when you chance the images, iOS does <em>not</em> invalidate the cache, which means you'll still see the old launch image. You should either: delete the app, or reset content & settings (simulator).</p></li>
+<li><p><strong>Simulator may not show expected images when launched from CLI</strong>
+When Xcode deploys to a specific simulator, it only copies the assets that match the simulator's characteristics. For example, if you try to run an app on the iPhone 6s Plus simulator, only @3x launch images are copied. When compiling from the CLI, however, the default is to assume an iPhone 5s, which means only @2x launch images are copied. Unless your launch images are markedly different, chances are good the difference would go unnoticed, but this does mean that the only accurate method of testing is to test on a physical device.</p></li>
+<li><p><strong><code>anyany</code> must be provided for other variations to be used</strong>
+If you don't provide an <code>anyany</code> version of the launch image for a specific scale and idiom, the other variations (like <code>anycom</code>, <code>comany</code>, and <code>comcom</code>) will ignored. </p></li>
+</ol>
+
<h2>Example Configuration</h2>
<p>In the top-level <code>config.xml</code> file (not the one in <code>platforms</code>), add configuration elements like those specified here.</p>
@@ -2793,7 +3195,9 @@ cordova plugin add https://github.com/ap
<span class="nt"></platform></span>
<span class="nt"><platform</span> <span class="na">name=</span><span class="s">"ios"</span><span class="nt">></span>
- <span class="c"><!-- images are determined by width and height. The following are supported --></span>
+ <span class="c"><!-- There are two mechanisms for showing launch images.
+ -- Legacy method (supports all devices except iPad Pro 12.9):
+ -- Note: Images are determined by width and height. The following are supported --></span>
<span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default~iphone.png"</span> <span class="na">width=</span><span class="s">"320"</span> <span class="na">height=</span><span class="s">"480"</span><span class="nt">/></span>
<span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default@2x~iphone.png"</span> <span class="na">width=</span><span class="s">"640"</span> <span class="na">height=</span><span class="s">"960"</span><span class="nt">/></span>
<span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default-Portrait~ipad.png"</span> <span class="na">width=</span><span class="s">"768"</span> <span class="na">height=</span><span class="s">"1024"</span><span class="nt">/></span>
@@ -2804,6 +3208,18 @@ cordova plugin add https://github.com/ap
<span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default-667h.png"</span> <span class="na">width=</span><span class="s">"750"</span> <span class="na">height=</span><span class="s">"1334"</span><span class="nt">/></span>
<span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default-736h.png"</span> <span class="na">width=</span><span class="s">"1242"</span> <span class="na">height=</span><span class="s">"2208"</span><span class="nt">/></span>
<span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default-Landscape-736h.png"</span> <span class="na">width=</span><span class="s">"2208"</span> <span class="na">height=</span><span class="s">"1242"</span><span class="nt">/></span>
+ <span class="c"><!-- Storyboard method (supports all devices):
+ -- Important: If you use the storyboard method, legacy images are
+ -- copied but ignored.
+ -- Note: images are determined by scale, idiom, and size traits. The following
+ -- are suggested based on current device form factors --></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default@2x~universal~anyany.png"</span> <span class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default@2x~universal~comany.png"</span> <span class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default@2x~universal~comcom.png"</span> <span class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default@3x~universal~anyany.png"</span> <span class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default@3x~universal~anycom.png"</span> <span class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/ios/Default@3x~universal~comany.png"</span> <span class="nt">/></span>
+
<span class="nt"></platform></span>
<span class="nt"><platform</span> <span class="na">name=</span><span class="s">"windows"</span><span class="nt">></span>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-whitelist/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-whitelist/index.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-whitelist/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-whitelist/index.html Wed Oct 5 18:42:49 2016
@@ -2718,6 +2718,12 @@
<p>:warning: Report issues on the <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20Whitelist%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC">Apache Cordova issue tracker</a></p>
+<h2>Installation</h2>
+
+<p>You can install whitelist plugin with Cordova CLI, from npm:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">$ cordova plugin add cordova-plugin-whitelist
+$ cordova prepare
+</code></pre></div>
<h2>Supported Cordova Platforms</h2>
<ul>
Modified: cordova/site/public/feed.xml
URL: http://svn.apache.org/viewvc/cordova/site/public/feed.xml?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/feed.xml (original)
+++ cordova/site/public/feed.xml Wed Oct 5 18:42:49 2016
@@ -6,11 +6,144 @@
</description>
<link>https://cordova.apache.org/</link>
<atom:link href="https://cordova.apache.org/feed.xml" rel="self" type="application/rss+xml"/>
- <pubDate>Wed, 14 Sep 2016 17:29:36 -0700</pubDate>
- <lastBuildDate>Wed, 14 Sep 2016 17:29:36 -0700</lastBuildDate>
+ <pubDate>Wed, 05 Oct 2016 10:54:08 -0700</pubDate>
+ <lastBuildDate>Wed, 05 Oct 2016 10:54:08 -0700</lastBuildDate>
<generator>Jekyll v2.5.3</generator>
<item>
+ <title>Minor Releases</title>
+ <description><p>The following were recently released:</p>
+
+<ul>
+<li>cordova-plugin-geolocation: 2.4.0</li>
+<li>cordova-create: 1.0.1</li>
+<li>cordova-app-hello-world: 3.11.0</li>
+</ul>
+
+<p><strong>Google</strong> recently sent out warnings to everyone who uses <code>cordova-plugin-geolocation</code> about having to include <code>android.hardware.location.gps</code> to their <code>AndroidManifest.xml</code>. We updated <code>cordova-plugin-geolocation</code> plugin to auto add this setting to your project&#39;s <code>AndroidManifest.xml</code> when installing the plugin. This means that the geolocation plugin will only work on <strong>android</strong> devices that have a <code>GPS</code>. Let us know if this restriction affects you negatively. </p>
+
+<p>Release Highlights:</p>
+
+<ul>
+<li><code>cordova-app-hello-world</code>: Updated default <code>CSP</code> to include <code>img-src</code> and add <code>content:</code> to it for <a href="https://issues.apache.org/jira/browse/CB-4078">CB-4078</a></li>
+</ul>
+
+<hr>
+
+<p>You can update any plugin by removing it, and then re-adding it.</p>
+
+<p>E.g. To update your geolocation plugin:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin rm cordova-plugin-geolocation --save
+cordova plugin add cordova-plugin-geolocation@latest --save
+</code></pre></div>
+<p>Changes include:</p>
+
+<!--more-->
+
+<p>cordova-plugin-geolocation@2.4.0</p>
+
+<ul>
+<li><strong>Ubuntu</strong> Fix altitude &amp; accuracies retrieval</li>
+<li><a href="https://issues.apache.org/jira/browse/CB-11875">CB-11875</a> added <code>android.hardware.location.gps</code> <code>uses-feature</code>.</li>
+</ul>
+
+<p>cordova-create@1.0.1</p>
+
+<ul>
+<li>removed stripping eventlisteners</li>
+</ul>
+
+<p>cordova-app-hello-world@3.11.0</p>
+
+<ul>
+<li><a href="https://issues.apache.org/jira/browse/CB-11938">CB-11938</a> updated <code>csp</code> to include <code>content:</code> for <code>img-src</code></li>
+<li><a href="https://issues.apache.org/jira/browse/CB-11412">CB-11412</a> Update templates to designate template source dir</li>
+<li><a href="https://issues.apache.org/jira/browse/CB-10522">CB-10522</a> Event binding in Hello World is misleading</li>
+</ul>
+</description>
+ <pubDate>Tue, 04 Oct 2016 00:00:00 -0700</pubDate>
+ <link>https://cordova.apache.org/news/2016/10/04/small-releases.html</link>
+ <guid isPermaLink="true">https://cordova.apache.org/news/2016/10/04/small-releases.html</guid>
+
+ <category>release</category>
+
+ <category>plugins</category>
+
+ <category>tools</category>
+
+
+ <category>news</category>
+
+ </item>
+
+ <item>
+ <title>Node 0.x and 4.x Deprecation Timeline for Apache Cordova</title>
+ <description><p>Currently, all the platforms and plugins require a minimum of <code>node 0.10</code> to be installed. <code>node 0.10</code> has been out of <a href="https://github.com/nodejs/LTS" title="Node.js Long-term Support Working Group">LTS</a> for a while now, and its maintenance period (security bug fixes) <strong>stops on Oct 31st 2016</strong>. <code>node 0.12</code> will be out of maintenance <strong>Jan 1st 2017</strong>.</p>
+
+<p>There will be two distinct deprecation periods, one for <code>node 0.x</code>, and one for <code>node 4.x</code>.</p>
+
+<p><code>node 6.x</code> will be on active LTS <strong>Oct 18th 2016</strong> (thus the default and recommended version to download on <a href="http://nodejs.org">nodejs.org</a>) and will be the version we recommend users upgrade to, during both deprecation periods.</p>
+
+<p>What does <code>node 6.x</code> give us? <a href="http://node.green/#ES2015" title="Node ES6 Support">99% ES2015 (ES6)</a> support, and <a href="http://node.green/#ES2016" title="Node ES7 Support">100% ES2016 (ES7)</a> support.</p>
+
+<p>JavaScript files in plugins themselves are unaffected, since the JavaScript support for them is dependent on platform browser support. For example, ES6 is supported in iOS 10, while on older iOS platforms only ES5 is supported. </p>
+
+<!--more-->
+
+<h2>Timeline</h2>
+
+<p><strong>Oct 1st, 2016</strong> - deprecate use of <code>node 0.x</code>. </p>
+
+<ul>
+<li>all AppVeyor/Travis CI builds still test using <code>node 0.x</code> as well as <code>node 4.x</code> and greater</li>
+<li>add a requirements check that will print out a deprecation notice if users are using a node &lt; 4, and tell them to upgrade to a minimum of 6.</li>
+</ul>
+
+<p>The <code>node 0.x</code> deprecation period will run for <strong>3 months</strong>, and it will end on Jan 1st 2017. </p>
+
+<p><strong>Jan 1st, 2017</strong> - stop <code>node 0.x</code> support. </p>
+
+<ul>
+<li>all AppVeyor/Travis CI builds only test for <code>node 4.x</code> and greater. </li>
+<li>safe to use some ES6 features in the Apache Cordova tools and platforms, not plugins (built in Promises, let, const, arrow functions, template strings, for/of loop syntax).</li>
+<li>tools and platforms will bump up a major version</li>
+</ul>
+
+<p><strong>Apr 1st, 2017</strong> - deprecate use of <code>node 4.x</code>. </p>
+
+<ul>
+<li>all AppVeyor/Travis CI builds still test using <code>node 4.x</code> as well as <code>node 6.x</code> and greater</li>
+<li>add a requirements check that will print out a deprecation notice if they are using a node &lt;= 4, and tell them to upgrade to a minimum of 6</li>
+</ul>
+
+<p>The <code>node 4.x</code> deprecation period will run for <strong>12 months</strong> and it will end on April 1st 2018.</p>
+
+<p><strong>Apr 1st, 2018</strong> - stop <code>node 4.x</code> support. </p>
+
+<ul>
+<li>all AppVeyor/Travis CI builds only test for <code>node 6.x</code> and greater</li>
+<li>safe to use ES6 and ES7 features in the Apache Cordova tools and platforms (not plugins)</li>
+<li>tools and platforms will bump up a major version</li>
+</ul>
+
+<p><a href="/static/img/cordova-node-timeline.svg"><img src="/static/img/cordova-node-timeline.svg" alt="cordova node deprecation timeline"></a></p>
+</description>
+ <pubDate>Sat, 01 Oct 2016 00:00:00 -0700</pubDate>
+ <link>https://cordova.apache.org/news/2016/10/01/0.x-4.x-deprecation-timeline.html</link>
+ <guid isPermaLink="true">https://cordova.apache.org/news/2016/10/01/0.x-4.x-deprecation-timeline.html</guid>
+
+ <category>deprecation</category>
+
+ <category>timeline</category>
+
+ <category>node</category>
+
+
+ <category>news</category>
+
+ </item>
+
+ <item>
<title>Plugins Release</title>
<description><p>The following plugins were updated today:</p>
@@ -850,108 +983,6 @@ cordova platform update android@5.2.0
<category>news</category>
- <category>releases</category>
-
-
- <category>announcements</category>
-
- </item>
-
- <item>
- <title>Cordova iOS 4.2.0</title>
- <description><p>We are happy to announce that <code>Cordova iOS 4.2.0</code> has been released!</p>
-
-<p>Along with some bug fixes, this release adds support for node 6 to <code>cordova-ios</code>!</p>
-
-<p>A new version of the <code>cordova-cli</code> will need to be released to pin this version of <strong>cordova-ios</strong> as the default version when creating a new project. If you want to start using this version now, make sure to specify the version when doing a <code>cordova platform add/update</code>.</p>
-
-<p><strong>Note:</strong> When updating, make sure to save your plugins as current unsaved plugins may not be reinstalled otherwise. Run the following command in your project to save your currently installed plugins into <code>config.xml</code>:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin save
-</code></pre></div>
-<p>To upgrade:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">npm install -g cordova
-cd my_project
-cordova platform update ios@4.2.0
-</code></pre></div>
-<p>To add it explicitly:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">cordova platform add ios@4.2.0
-</code></pre></div>
-<!--more-->
-
-<h2>What&#39;s new in iOS platform</h2>
-
-<ul>
-<li><code>cordova-ios</code> now supports node 6!</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11445">CB-11445</a> Updated checked-in <code>node_modules</code></li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11424">CB-11424</a> <code>AppVeyor</code> test failures (path separator) on <code>cordova-ios</code> platform</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11375">CB-11375</a> - onReset method of CDVPlugin is never called</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11366">CB-11366</a> Break out obj-c tests so they are not called from jasmine - Fix for <code>mktemp</code> variants (Linux vs Darwin)</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11117">CB-11117</a> Optimize prepare for <strong>iOS</strong> platform, clean prepared files</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11265">CB-11265</a> Remove target checking for <code>cordova-ios</code></li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11259">CB-11259</a> Improving build output</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-10695">CB-10695</a> Fix issue with unable to deploy to the <strong>iOS</strong> Simulator using <code>cordova emulate ios</code></li>
-<li><a href="https://issues.apache.org/jira/browse/CB-10695">CB-10695</a> Replacing <code>SDK/ARCH</code> parameters by new destination parameter. Fixes issues when project has targets using different <code>SDKs</code>, i.e.: <strong>watchOS</strong> vs <strong>iOS</strong></li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11069">CB-11069</a> <code>CDVViewController</code> <code>appURL</code> is <code>nil</code> if <code>wwwFolderName</code> is the path to a framework</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11200">CB-11200</a> Bump <code>node-xcode</code> version</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11235">CB-11235</a> <code>NSInternalInconsistencyException</code> when running <strong>iOS</strong> unit tests</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11161">CB-11161</a> Reuse <code>PluginManager</code> from <code>cordova-common</code> to <code>add/rm</code> plugins</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11161">CB-11161</a> Bump <code>cordova-common</code> to <code>1.3.0</code>.</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11019">CB-11019</a> Update tests to validate project name updates</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11019">CB-11019</a> Handle changes of app name gracefully</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-11022">CB-11022</a> Duplicate <code>www</code> files on plugin installtion/removal</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-6992">CB-6992</a> Fix non-working create case, add new test</li>
-<li><a href="https://issues.apache.org/jira/browse/CB-10957">CB-10957</a> Remove <code>build*.xconfig</code> from build outputs: <code>*.ipa</code>, <code>*.app</code></li>
-<li><a href="https://issues.apache.org/jira/browse/CB-10964">CB-10964</a> Handle <code>build.json</code> file starting with a <code>BOM</code></li>
-<li><a href="https://issues.apache.org/jira/browse/CB-10942">CB-10942</a> - Cannot <code>&lt;allow-navigation href=&quot;https://foo.bar&quot; /&gt;</code> for links in that site, if you have <code>&lt;allow-intent href=&quot;https://*&quot; /&gt;</code></li>
-</ul>
-</description>
- <pubDate>Thu, 23 Jun 2016 00:00:00 -0700</pubDate>
- <link>https://cordova.apache.org/announcements/2016/06/23/ios-4.2.0.html</link>
- <guid isPermaLink="true">https://cordova.apache.org/announcements/2016/06/23/ios-4.2.0.html</guid>
-
- <category>news</category>
-
- <category>releases</category>
-
-
- <category>announcements</category>
-
- </item>
-
- <item>
- <title>Cordova Ubuntu 4.3.4</title>
- <description><p><code>Cordova Ubuntu 4.3.4</code> has been released.</p>
-
-<p>This is a patch release, fixing bugs related to building and debugging Cordova apps targetting Ubuntu devices. See the changelog below for details.</p>
-
-<p>To upgrade:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">npm install -g cordova
-cd my_project
-cordova platform update ubuntu@4.3.4
-</code></pre></div>
-<p>To add it explicitly:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">cordova platform add ubuntu@4.3.4
-</code></pre></div>
-<!--more-->
-
-<h2>What&#39;s new in Cordova Ubuntu</h2>
-
-<ul>
-<li>fix build issue with function signature missing the cordova variable name; also avoid a warning</li>
-<li>use ubuntu-app-stop to stop the app more cleanly</li>
-<li>Update run devtools message</li>
-<li>tweak devtools url message</li>
-<li>Tweak debug launch</li>
-<li>Add app launch tweaks</li>
-<li>Improve debugging behavior; Add ip option</li>
-</ul>
-</description>
- <pubDate>Tue, 14 Jun 2016 00:00:00 -0700</pubDate>
- <link>https://cordova.apache.org/announcements/2016/06/14/cordova-ubuntu-4.3.4.html</link>
- <guid isPermaLink="true">https://cordova.apache.org/announcements/2016/06/14/cordova-ubuntu-4.3.4.html</guid>
-
- <category>news</category>
-
<category>releases</category>
Modified: cordova/site/public/news/2016/09/14/plugins-release.html
URL: http://svn.apache.org/viewvc/cordova/site/public/news/2016/09/14/plugins-release.html?rev=1763475&r1=1763474&r2=1763475&view=diff
==============================================================================
--- cordova/site/public/news/2016/09/14/plugins-release.html (original)
+++ cordova/site/public/news/2016/09/14/plugins-release.html Wed Oct 5 18:42:49 2016
@@ -564,6 +564,26 @@ cordova plugin add cordova-plugin-camera
</div>
<div class="col-sm-6">
+ <a href="/news/2016/10/01/0.x-4.x-deprecation-timeline.html">Next</a>
+ <br>
+ <br>
+ <a class="title" href="/news/2016/10/01/0.x-4.x-deprecation-timeline.html">Node 0.x and 4.x Deprecation Timeline for Apache Cordova</a>
+ <div class="date"> 01 Oct 2016 - By Shazron Abdullah </div>
+ <p class="content">
+ <!--
+ NOTE:
+ the markdownify filter is used here
+ because posts are rendered in sequence;
+ that is, the next post's content isn't
+ yet rendered at the time that this post
+ is being rendered, so page.next.excerpt
+ is still in Markdown and not HTML
+
+ Reference: https://github.com/jekyll/jekyll/issues/2860
+ -->
+ Currently, all the platforms and plugins require a minimum of node 0.10...
+ </p>
+
</div>
</div>
</footer>
Added: cordova/site/public/news/2016/10/01/0.x-4.x-deprecation-timeline.html
URL: http://svn.apache.org/viewvc/cordova/site/public/news/2016/10/01/0.x-4.x-deprecation-timeline.html?rev=1763475&view=auto
==============================================================================
--- cordova/site/public/news/2016/10/01/0.x-4.x-deprecation-timeline.html (added)
+++ cordova/site/public/news/2016/10/01/0.x-4.x-deprecation-timeline.html Wed Oct 5 18:42:49 2016
@@ -0,0 +1,343 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <meta name="format-detection" content="telephone=no">
+ <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width" />
+ <meta name="description" content="Currently, all the platforms and plugins require a minimum of node 0.10 to be installed. node 0.10 has been out of LTS for a while now, and its maintenance p...">
+
+ <title>
+
+
+ Node 0.x and 4.x Deprecation Timeline for Apache Cordova - Apache Cordova
+
+
+ </title>
+
+ <link rel="SHORTCUT ICON" href="/favicon.ico"/>
+
+
+
+
+
+
+ <link rel="canonical" href="https://cordova.apache.org/news/2016/10/01/0.x-4.x-deprecation-timeline.html">
+
+ <!-- CSS -->
+ <link rel="stylesheet" type="text/css" href="/static/css/main.css">
+ <link rel="stylesheet" type="text/css" href="/static/css/lib/syntax.css">
+ <!-- Algolia Search CSS -->
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css" />
+
+ <!-- Fonts -->
+ <!-- For attribution information, see www/attributions.html -->
+ <link href='https://fonts.googleapis.com/css?family=Raleway:700,400,300,700italic,400italic,300italic' rel='stylesheet' type='text/css'>
+
+ <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
+ <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+ <![endif]-->
+ <script type="text/javascript">
+ var disqus_developer = 1; // this would set it to developer mode
+ </script>
+
+ <!-- JS -->
+ <script defer type="text/javascript" src="/static/js/lib/jquery-2.1.1.min.js"></script>
+ <script defer type="text/javascript" src="/static/js/lib/bootstrap.min.js"></script>
+ <script defer type="text/javascript" src="/static/js/lib/ZeroClipboard.js"></script>
+
+ <script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+ ga('create', 'UA-64283057-3', 'auto');
+ ga('send', 'pageview');
+</script>
+
+</head>
+
+<body>
+ <header>
+ <a class="scroll-point pt-top" name="top"></a>
+ <nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container-fluid">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/"><img id="logo_top" src="/static/img/cordova-logo-newbrand.svg"/></a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <div class="nav_bar_center">
+ <ul class="nav navbar-nav">
+ <li >
+ <a href="/docs/en/latest/">Documentation</a>
+ </li>
+ <li >
+ <a href="/plugins">Plugins</a>
+ </li>
+ <li class="active">
+ <a href="/blog" id="blog_button">Blog<span class="badge" id="new_blog_count"></span></a>
+ </li>
+ <li >
+ <a href="/contribute">Contribute</a>
+ </li>
+ <li>
+ <a href="/#getstarted">Get Started</a>
+ </li>
+ <li>
+ <form class="navbar-form navbar-right" id="header-search-form" role="search">
+ <div class="input-group">
+
+
+
+ <input id="header-search-field" type="text" placeholder="Search '6.x' docs..." class="form-control hidden-xs" autocomplete="off">
+ </div>
+ </form>
+ </li>
+ </ul>
+ </div>
+ </div><!--/.navbar-collapse -->
+ </div>
+ </nav>
+ <div id="_fixed_navbar_spacer" style="padding-top:50px"></div>
+</header>
+
+<div class="page container">
+ <div class="blog">
+ <h1 class="blogHeader">
+ Blog
+ <span class="rss">
+ <img src="/static/img/subscribe.png"><a href="/feed.xml">RSS Feed</a>
+ </span>
+</h1>
+
+<div class="post">
+ <header>
+ <div class="title">Node 0.x and 4.x Deprecation Timeline for Apache Cordova</div>
+ <div class="author">By:
+
+ <a href="https://twitter.com/shazron">Shazron Abdullah</a>
+
+ </div>
+ <div class="date">01 Oct 2016</div>
+ </header>
+ <section>
+ <div>
+ <p>Currently, all the platforms and plugins require a minimum of <code>node 0.10</code> to be installed. <code>node 0.10</code> has been out of <a href="https://github.com/nodejs/LTS" title="Node.js Long-term Support Working Group">LTS</a> for a while now, and its maintenance period (security bug fixes) <strong>stops on Oct 31st 2016</strong>. <code>node 0.12</code> will be out of maintenance <strong>Jan 1st 2017</strong>.</p>
+
+<p>There will be two distinct deprecation periods, one for <code>node 0.x</code>, and one for <code>node 4.x</code>.</p>
+
+<p><code>node 6.x</code> will be on active LTS <strong>Oct 18th 2016</strong> (thus the default and recommended version to download on <a href="http://nodejs.org">nodejs.org</a>) and will be the version we recommend users upgrade to, during both deprecation periods.</p>
+
+<p>What does <code>node 6.x</code> give us? <a href="http://node.green/#ES2015" title="Node ES6 Support">99% ES2015 (ES6)</a> support, and <a href="http://node.green/#ES2016" title="Node ES7 Support">100% ES2016 (ES7)</a> support.</p>
+
+<p>JavaScript files in plugins themselves are unaffected, since the JavaScript support for them is dependent on platform browser support. For example, ES6 is supported in iOS 10, while on older iOS platforms only ES5 is supported. </p>
+
+<!--more-->
+
+<h2>Timeline</h2>
+
+<p><strong>Oct 1st, 2016</strong> - deprecate use of <code>node 0.x</code>. </p>
+
+<ul>
+<li>all AppVeyor/Travis CI builds still test using <code>node 0.x</code> as well as <code>node 4.x</code> and greater</li>
+<li>add a requirements check that will print out a deprecation notice if users are using a node < 4, and tell them to upgrade to a minimum of 6.</li>
+</ul>
+
+<p>The <code>node 0.x</code> deprecation period will run for <strong>3 months</strong>, and it will end on Jan 1st 2017. </p>
+
+<p><strong>Jan 1st, 2017</strong> - stop <code>node 0.x</code> support. </p>
+
+<ul>
+<li>all AppVeyor/Travis CI builds only test for <code>node 4.x</code> and greater. </li>
+<li>safe to use some ES6 features in the Apache Cordova tools and platforms, not plugins (built in Promises, let, const, arrow functions, template strings, for/of loop syntax).</li>
+<li>tools and platforms will bump up a major version</li>
+</ul>
+
+<p><strong>Apr 1st, 2017</strong> - deprecate use of <code>node 4.x</code>. </p>
+
+<ul>
+<li>all AppVeyor/Travis CI builds still test using <code>node 4.x</code> as well as <code>node 6.x</code> and greater</li>
+<li>add a requirements check that will print out a deprecation notice if they are using a node <= 4, and tell them to upgrade to a minimum of 6</li>
+</ul>
+
+<p>The <code>node 4.x</code> deprecation period will run for <strong>12 months</strong> and it will end on April 1st 2018.</p>
+
+<p><strong>Apr 1st, 2018</strong> - stop <code>node 4.x</code> support. </p>
+
+<ul>
+<li>all AppVeyor/Travis CI builds only test for <code>node 6.x</code> and greater</li>
+<li>safe to use ES6 and ES7 features in the Apache Cordova tools and platforms (not plugins)</li>
+<li>tools and platforms will bump up a major version</li>
+</ul>
+
+<p><a href="/static/img/cordova-node-timeline.svg"><img src="/static/img/cordova-node-timeline.svg" alt="cordova node deprecation timeline"></a></p>
+
+ </div>
+ </section>
+ <footer>
+ <div class="row">
+ <div class="col-sm-6">
+
+ <a href="/news/2016/09/14/plugins-release.html">Previous</a>
+ <br>
+ <br>
+ <a class="title" href="/news/2016/09/14/plugins-release.html">Plugins Release</a>
+ <div class="date"> 14 Sep 2016 - By Steve Gill </div>
+ <p class="content">
+ The following plugins were updated today: cordova-plugin-battery-status: 1.2.0 cordova-plugin-camera: 2.3.0 cordova-plugin-console: 1.0.4...
+ </p>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="/news/2016/10/04/small-releases.html">Next</a>
+ <br>
+ <br>
+ <a class="title" href="/news/2016/10/04/small-releases.html">Minor Releases</a>
+ <div class="date"> 04 Oct 2016 - By Steve Gill </div>
+ <p class="content">
+ <!--
+ NOTE:
+ the markdownify filter is used here
+ because posts are rendered in sequence;
+ that is, the next post's content isn't
+ yet rendered at the time that this post
+ is being rendered, so page.next.excerpt
+ is still in Markdown and not HTML
+
+ Reference: https://github.com/jekyll/jekyll/issues/2860
+ -->
+ The following were recently released: cordova-plugin-geolocation: 2.4.0 cordova-create: 1.0.1 cordova-app-hello-world: 3.11.0 Google...
+ </p>
+
+ </div>
+ </div>
+ </footer>
+ <div class="disqus">
+ <div id="disqus_thread"></div>
+<script type="text/javascript">
+ /* * * CONFIGURATION VARIABLES * * */
+ var disqus_shortname = 'cordovablogs';
+
+ /* * * DON'T EDIT BELOW THIS LINE * * */
+ (function() {
+ var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+ dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
+ (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+ })();
+</script>
+<noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript" rel="nofollow">comments powered by Disqus.</a></noscript>
+
+ </div>
+</div>
+
+</div>
+
+</div>
+
+<div class="blue-divider"></div>
+<footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-sm-9">
+ <h1>More Resources</h1>
+ <div class="row">
+ <div class="col-sm-4">
+ <h2>General</h2>
+ <ul class="nav">
+ <li>
+ <a target="_blank" href="https://projects.apache.org/project.html?cordova">Apache Project Page</a>
+ </li>
+ <li>
+ <a href="https://dist.apache.org/repos/dist/release/cordova/">Source Distribution</a>
+ </li>
+ <li>
+ <a target="_blank" href="http://www.apache.org/licenses/LICENSE-2.0">License</a>
+ </li>
+ <li>
+ <a href="/artwork">Artwork</a>
+ </li>
+ </ul>
+ </div>
+ <div class="col-sm-4">
+ <h2>Development</h2>
+ <ul class="nav">
+ <li><a target="_blank" href="https://github.com/apache?utf8=%E2%9C%93&query=cordova-">Source Code</a></li>
+ <li><a target="_blank" href="https://issues.apache.org/jira/browse/CB/">Issue Tracker</a></li>
+ <li><a target="_blank" href="http://stackoverflow.com/questions/tagged/cordova">Stack Overflow</a></li>
+ <li><a href="/contact">Mailing List</a></li>
+ <li><a href="/contribute/nightly_builds.html">Nightly builds</a></li>
+ </ul>
+ </div>
+ <div class="col-sm-4">
+ <h2>Apache Software Foundation</h2>
+ <ul class="nav">
+ <li>
+ <a target="_blank" href="http://www.apache.org/">About ASF</a>
+ </li>
+ <li>
+ <a target="_blank" href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a>
+ </li>
+ <li>
+ <a target="_blank" href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+ </li>
+ <li>
+ <a target="_blank" href="http://www.apache.org/security/">Security</a>
+ </li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="col-sm-3">
+ <h1>Contribute</h1>
+ <p style="padding-top:20px"><strong>Help Cordova move forward!</strong></p>
+ <p>Report bugs, improve the docs, or contribute to the code.</p>
+ <a href="/contribute" class="btn btn-lg btn-primary">
+ Learn More
+ </a>
+ <p style="padding-top:20px"> <a href="https://twitter.com/apachecordova" class="twitter-follow-button" data-show-count="false">Follow @apachecordova</a></p>
+ <script async defer src="https://slack.cordova.io/slackin.js"></script>
+ </div>
+</div>
+<p class="copyright_text">
+ Copyright © 2012, 2013, 2015 The Apache Software Foundation, Licensed under the <a target="_blank" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>
+ Apache and the Apache feather logos are <a target="_blank" href="http://www.apache.org/foundation/marks/list/">trademarks</a> of The Apache Software Foundation.
+ <br/>
+ "Raleway" font used under license. For details see the <a href="/attributions/">attributions page</a>.
+</p>
+
+ </div>
+</footer>
+
+
+ <script defer type="text/javascript" src="/static/js/index.js"></script>
+ <script defer type="text/javascript" src="/static/js/twitter.js"></script>
+
+
+
+
+
+
+
+
+<script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js"></script>
+<script type="text/javascript">
+ docsearch({
+ apiKey: '0a916ab198bd93d031aa70611271e42e',
+ indexName: 'cordova',
+ inputSelector: '#header-search-field',
+ algoliaOptions: { 'facetFilters': ["version: 6.x", "language: en"] }
+ });
+</script>
+
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org