Author: steven
Date: Wed Mar 23 19:14:10 2016
New Revision: 1736375
URL: http://svn.apache.org/viewvc?rev=1736375&view=rev
Log:
CB-10902 added release blog post
Added:
cordova/site/public/announcements/2016/03/22/
cordova/site/public/announcements/2016/03/22/new-plugin-fetching.html
cordova/site/public/docs/en/dev/gen/
cordova/site/public/docs/en/dev/gen/cordova-cli/
cordova/site/public/docs/en/dev/gen/cordova-cli/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-battery-status/
cordova/site/public/docs/en/dev/gen/cordova-plugin-battery-status/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-camera/
cordova/site/public/docs/en/dev/gen/cordova-plugin-camera/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-console/
cordova/site/public/docs/en/dev/gen/cordova-plugin-console/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-contacts/
cordova/site/public/docs/en/dev/gen/cordova-plugin-contacts/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-device/
cordova/site/public/docs/en/dev/gen/cordova-plugin-device-motion/
cordova/site/public/docs/en/dev/gen/cordova-plugin-device-motion/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-device-orientation/
cordova/site/public/docs/en/dev/gen/cordova-plugin-device-orientation/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-device/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-dialogs/
cordova/site/public/docs/en/dev/gen/cordova-plugin-dialogs/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-file/
cordova/site/public/docs/en/dev/gen/cordova-plugin-file-transfer/
cordova/site/public/docs/en/dev/gen/cordova-plugin-file-transfer/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-file/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-geolocation/
cordova/site/public/docs/en/dev/gen/cordova-plugin-geolocation/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-globalization/
cordova/site/public/docs/en/dev/gen/cordova-plugin-globalization/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-inappbrowser/
cordova/site/public/docs/en/dev/gen/cordova-plugin-inappbrowser/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-legacy-whitelist/
cordova/site/public/docs/en/dev/gen/cordova-plugin-legacy-whitelist/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-media/
cordova/site/public/docs/en/dev/gen/cordova-plugin-media-capture/
cordova/site/public/docs/en/dev/gen/cordova-plugin-media-capture/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-media/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-network-information/
cordova/site/public/docs/en/dev/gen/cordova-plugin-network-information/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-splashscreen/
cordova/site/public/docs/en/dev/gen/cordova-plugin-splashscreen/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-statusbar/
cordova/site/public/docs/en/dev/gen/cordova-plugin-statusbar/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-vibration/
cordova/site/public/docs/en/dev/gen/cordova-plugin-vibration/index.html
cordova/site/public/docs/en/dev/gen/cordova-plugin-whitelist/
cordova/site/public/docs/en/dev/gen/cordova-plugin-whitelist/index.html
cordova/site/public/news/2016/03/23/
cordova/site/public/news/2016/03/23/tools-release.html
Modified:
cordova/site/public/blog/index.html
cordova/site/public/docs/en/6.x/guide/cli/index.html
cordova/site/public/docs/en/6.x/guide/hybrid/plugins/index.html
cordova/site/public/docs/en/6.x/reference/cordova-cli/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html
cordova/site/public/docs/en/dev/cordova-cli/index.html
cordova/site/public/docs/en/dev/cordova-plugin-battery-status/index.html
cordova/site/public/docs/en/dev/cordova-plugin-camera/index.html
cordova/site/public/docs/en/dev/cordova-plugin-console/index.html
cordova/site/public/docs/en/dev/cordova-plugin-contacts/index.html
cordova/site/public/docs/en/dev/cordova-plugin-device-motion/index.html
cordova/site/public/docs/en/dev/cordova-plugin-device-orientation/index.html
cordova/site/public/docs/en/dev/cordova-plugin-device/index.html
cordova/site/public/docs/en/dev/cordova-plugin-dialogs/index.html
cordova/site/public/docs/en/dev/cordova-plugin-file-transfer/index.html
cordova/site/public/docs/en/dev/cordova-plugin-file/index.html
cordova/site/public/docs/en/dev/cordova-plugin-geolocation/index.html
cordova/site/public/docs/en/dev/cordova-plugin-globalization/index.html
cordova/site/public/docs/en/dev/cordova-plugin-inappbrowser/index.html
cordova/site/public/docs/en/dev/cordova-plugin-legacy-whitelist/index.html
cordova/site/public/docs/en/dev/cordova-plugin-media-capture/index.html
cordova/site/public/docs/en/dev/cordova-plugin-media/index.html
cordova/site/public/docs/en/dev/cordova-plugin-network-information/index.html
cordova/site/public/docs/en/dev/cordova-plugin-splashscreen/index.html
cordova/site/public/docs/en/dev/cordova-plugin-statusbar/index.html
cordova/site/public/docs/en/dev/cordova-plugin-vibration/index.html
cordova/site/public/docs/en/dev/cordova-plugin-whitelist/index.html
cordova/site/public/docs/en/dev/guide/cli/index.html
cordova/site/public/docs/en/dev/guide/hybrid/plugins/index.html
cordova/site/public/docs/en/dev/reference/cordova-cli/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
cordova/site/public/feed.xml
cordova/site/public/news/2016/03/12/plugin-release.html
cordova/site/public/sitemap.xml
cordova/site/public/static/css/main.css
cordova/site/public/static/js/index.js
cordova/site/public/static/js/plugins.js
Added: cordova/site/public/announcements/2016/03/22/new-plugin-fetching.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/announcements/2016/03/22/new-plugin-fetching.html?rev=1736375&view=auto
==============================================================================
--- cordova/site/public/announcements/2016/03/22/new-plugin-fetching.html
(added)
+++ cordova/site/public/announcements/2016/03/22/new-plugin-fetching.html Wed
Mar 23 19:14:10 2016
@@ -0,0 +1,298 @@
+<!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="The Cordova 6.0.0 release introduced the
pinning of core pluginversions in cordova-lib.We are happy to announce that one
of the new features in the upcomingC...">
+
+ <title>
+
+
+ Upcoming Changes to Plugin Fetching - Apache Cordova
+
+
+ </title>
+
+ <link rel="SHORTCUT ICON" href="/favicon.ico"/>
+ <link rel="canonical"
href="https://cordova.apache.org/announcements/2016/03/22/new-plugin-fetching.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">
+
+
+ <!-- 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>
+</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/guide/overview/">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>
+ </ul>
+ <form action="https://www.google.com/search"; method="GET"
class="navbar-form navbar-right" id="header-search-form" role="search">
+ <div class="input-group">
+ <input type="text" name="q" class="form-control
hidden-sm" placeholder="Site-wide Search">
+ <span class="input-group-btn">
+ <button type="submit" class="btn
search-button">
+ <span class="glyphicon glyphicon-search"
aria-hidden="true"></span>
+ </button>
+ </span>
+ </div>
+ <input type="hidden" name="q"
value="site:cordova.apache.org">
+ </form>
+ </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">Upcoming Changes to Plugin Fetching</div>
+ <div class="author">By:
+
+ <a href="https://github.com/riknoll";>Richard Knoll</a>
+
+ </div>
+ <div class="date">22 Mar 2016</div>
+ </header>
+ <section>
+ <div>
+ <p>The Cordova 6.0.0 release introduced the pinning of core plugin
+versions in cordova-lib.</p>
+
+<p>We are happy to announce that one of the new features in the upcoming
+Cordova 6.1.0 release is a general API that allows any plugin to guide
+the CLI in choosing a compatible plugin release to fetch for a given project.
+This moves the plugin dependency information out of cordova-lib so that it
+can update independently of the Cordova tools and support third-party plugins
+outside of core. Our hope is that this feature will improve Cordova's
plugin
+ecosystem and reduce some of the frustration that Cordova developers face when
+adding a new plugin to a project.</p>
+
+<!--more-->
+
+<p>The new API allows for plugin developers to give a mapping of plugin
+releases to project requirements in their <code>package.json</code>. When an
app developer
+adds a plugin to their Cordova project, cordova-lib will examine their
+installed plugins, platforms, and cordova-lib version and decide which
+version of the plugin to fetch based on the provided mapping.
+If the project does not fulfill the requirements for the latest release of the
+plugin, the CLI will print warnings indicating the problems and fetch the
+latest release of the plugin that is compatible.</p>
+
+<p>This API will eventually replace the <a
href="http://cordova.apache.org/docs/en/latest/plugin_ref/spec.html#engines-and-engine";>engines
element</a> in <code>plugin.xml</code>.
+It extends that element's capabilities by allowing the CLI to intelligently
+select a compatible plugin release rather than failing abruptly. Printed
warnings
+still clearly tell the app developer that the version they are using
+is not latest and show what they must update to fulfill the latest
release's
+requirements. Implementing this API helps you prevent your plugin from causing
+unexpected build errors when added to a project.</p>
+
+<p>See the <a
href="http://cordova.apache.org/docs/en/latest/guide/hybrid/plugins/index.html#specifying-cordova-dependencies";>documentation</a>
+for more information about how to use this API in your plugin.</p>
+
+<p>If you have feedback or questions about this feature, please leave
+a comment on this post.</p>
+
+ </div>
+ </section>
+ <footer>
+ <div class="row">
+ <div class="col-sm-6">
+
+ <a href="/news/2016/03/12/plugin-release.html">Previous</a>
+ <br>
+ <br>
+ <a class="title"
href="/news/2016/03/12/plugin-release.html">Plugins Release</a>
+ <div class="date"> 12 Mar 2016 - By Carlos Santana </div>
+ <p class="content">
+ The following plugins were updated today:
cordova-plugin-camera@2.1.1 cordova-plugin-statusbar@2.1.2
cordova-plugin-globalization@1.0.3 cordova-plugin-splashscreen@3.2.1 You can...
+ </p>
+
+ </div>
+ <div class="col-sm-6">
+
+ <a href="/news/2016/03/23/tools-release.html">Next</a>
+ <br>
+ <br>
+ <a class="title"
href="/news/2016/03/23/tools-release.html">Cordova 6.1.0 Released!</a>
+ <div class="date"> 23 Mar 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
+ -->
+ New versions of cordova tools are now live!
cordova-lib@6.1.0 cordova@6.1.0 plugman@1.2.0 cordova-js@4.1.4...
+ </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" id="footer">
+ <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>
+ </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.
+ </p>
+ <a class="closing" href="#top"></a>
+ </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>
+
(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>
+
+</body>
+</html>
Modified: cordova/site/public/blog/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/blog/index.html?rev=1736375&r1=1736374&r2=1736375&view=diff
==============================================================================
--- cordova/site/public/blog/index.html (original)
+++ cordova/site/public/blog/index.html Wed Mar 23 19:14:10 2016
@@ -104,6 +104,90 @@
<li>
<header>
+ <div class="adorner" blogTime="Wed, 23 Mar 2016 00:00:00
-0700"></div>
+ <h2 class="title">
+ <a href="/news/2016/03/23/tools-release.html">Cordova
6.1.0 Released!</a>
+ </h2>
+ <div class="details">
+ <span class="date">23 Mar 2016</span>
+ - by
+ <span class="author">
+
+ <a href="https://twitter.com/stevesgill";>Steve
Gill</a>
+
+ </span>
+ <a class="comment"
href="/news/2016/03/23/tools-release.html#disqus_thread"></a>
+ </div>
+ </header>
+ <section class="post-excerpt">
+ <p><p>New versions of cordova tools are now live!</p>
+
+<ul>
+<li><a
href="https://www.npmjs.org/package/cordova-lib";>cordova-lib@6.1.0</a></li>
+<li><a href="https://www.npmjs.org/package/cordova";>cordova@6.1.0</a></li>
+<li><a href="https://www.npmjs.org/package/plugman";>plugman@1.2.0</a></li>
+<li><a
href="https://www.npmjs.org/package/cordova-js";>cordova-js@4.1.4</a></li>
+<li><a
href="https://www.npmjs.com/package/cordova-common";>cordova-common@1.1.1</a></li>
+</ul>
+
+<p>Release Highlights include:</p>
+
+<ul>
+<li><a href="https://issues.apache.org/jira/browse/CB-10679";>CB-10679</a>
implemented new plugin fetching logic. We now allow community plugins to define
cordova engine restrictions. Read about it in our <a
href="http://cordova.apache.org/announcements/2016/03/22/new-plugin-fetching.html";>new
plugin fetching blog post</a>.</li>
+<li><a href="https://issues.apache.org/jira/browse/CB-10880";>CB-10880</a>
Removed plugin pinning. Replaced by new plugin fetching logic. </li>
+</ul>
+
+<p>To update your tools:</p>
+
+<ul>
+<li><p>If you have <code>cordova</code> installed:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">npm install
-g cordova@latest
+</code></pre></div></li>
+<li><p>If you have <code>plugman</code> installed:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">npm install
-g plugman@latest
+</code></pre></div></li>
+</ul>
+</p>
+ <div><a
href="/news/2016/03/23/tools-release.html">More...</a></div>
+ </section>
+ </li>
+
+ <li>
+ <header>
+ <div class="adorner" blogTime="Tue, 22 Mar 2016 00:00:00
-0700"></div>
+ <h2 class="title">
+ <a
href="/announcements/2016/03/22/new-plugin-fetching.html">Upcoming Changes to
Plugin Fetching</a>
+ </h2>
+ <div class="details">
+ <span class="date">22 Mar 2016</span>
+ - by
+ <span class="author">
+
+ <a href="https://github.com/riknoll";>Richard
Knoll</a>
+
+ </span>
+ <a class="comment"
href="/announcements/2016/03/22/new-plugin-fetching.html#disqus_thread"></a>
+ </div>
+ </header>
+ <section class="post-excerpt">
+ <p><p>The Cordova 6.0.0 release introduced the pinning of
core plugin
+versions in cordova-lib.</p>
+
+<p>We are happy to announce that one of the new features in the upcoming
+Cordova 6.1.0 release is a general API that allows any plugin to guide
+the CLI in choosing a compatible plugin release to fetch for a given project.
+This moves the plugin dependency information out of cordova-lib so that it
+can update independently of the Cordova tools and support third-party plugins
+outside of core. Our hope is that this feature will improve Cordova's
plugin
+ecosystem and reduce some of the frustration that Cordova developers face when
+adding a new plugin to a project.</p>
+</p>
+ <div><a
href="/announcements/2016/03/22/new-plugin-fetching.html">More...</a></div>
+ </section>
+ </li>
+
+ <li>
+ <header>
<div class="adorner" blogTime="Sat, 12 Mar 2016 00:00:00
-0800"></div>
<h2 class="title">
<a href="/news/2016/03/12/plugin-release.html">Plugins
Release</a>
@@ -4009,7 +4093,7 @@ window.twttr = (function(d, s, id) {
<script>
window.onload = function(){
setTimeout(function(){
- var lastPostTime = new Date("Sat, 12 Mar 2016 00:00:00
-0800").getTime();
+ var lastPostTime = new Date("Wed, 23 Mar 2016 00:00:00
-0700").getTime();
setCookie("visitTime", lastPostTime, 365);
}, 2000);
};
Modified: cordova/site/public/docs/en/6.x/guide/cli/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/docs/en/6.x/guide/cli/index.html?rev=1736375&r1=1736374&r2=1736375&view=diff
==============================================================================
--- cordova/site/public/docs/en/6.x/guide/cli/index.html (original)
+++ cordova/site/public/docs/en/6.x/guide/cli/index.html Wed Mar 23 19:14:10
2016
@@ -2899,7 +2899,7 @@ applications for building, or when plugi
<li><a
href="../../reference/cordova-cli/index.html#cordova-platform-command">Cordova
platform command reference documentation</a></li>
</ul>
-<h2>Install pre-requrisites for building</h2>
+<h2>Install pre-requisites for building</h2>
<p>To build and run apps, you need to install SDKs for each platform you wish
to target. Alternatively, if you are using browser for development you can use
<code>browser</code> platform which does not require any platform SDKs.</p>
Modified: cordova/site/public/docs/en/6.x/guide/hybrid/plugins/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/docs/en/6.x/guide/hybrid/plugins/index.html?rev=1736375&r1=1736374&r2=1736375&view=diff
==============================================================================
--- cordova/site/public/docs/en/6.x/guide/hybrid/plugins/index.html (original)
+++ cordova/site/public/docs/en/6.x/guide/hybrid/plugins/index.html Wed Mar 23
19:14:10 2016
@@ -3003,6 +3003,100 @@ Plugman's <code>createpackagejson</c
</span></code></pre></div>
<p>For more detailed example of a package.json, review the <a
href="https://github.com/apache/cordova-plugin-device/blob/master/package.json";>package.json
file of cordova-plugin-device</a>.</p>
+<h3>Specifying Cordova Dependencies</h3>
+
+<p><strong>Cordova 6.1.0</strong> added support for specifying the
Cordova-related dependencies of a plugin
+as part of the plugin's <code>package.json</code> file. Plugins may list
the dependencies for multiple
+releases so as to provide guidance to the Cordova CLI when it is selecting the
version of a
+plugin to fetch from npm. The CLI will choose the latest release of a plugin
that is
+compatible with the local project's installed platforms and plugins as
well as the
+the local Cordova CLI version. If no releases of the plugin are compatible,
the CLI will warn
+the user about the failed requirements and fall back to the old behavior of
fetching the
+latest release.</p>
+
+<p>This feature is intended to eventually replace the <a
href="../../../plugin_ref/spec.html#engines-and-engine">engines element</a> in
plugin.xml.
+Listing dependencies is a good way to ensure that your plugin will not appear
broken or cause
+build errors when fetched from npm. If the latest release of the plugin is not
compatible with
+a project, the CLI will give the app developer a list of unmet project
requirements so that
+they are aware of incompatibilites and can update their project to support
your plugin. This
+allows your plugin to respond to breaking changes without fear of confusing
devlopers who
+are building against old platforms and plugins.</p>
+
+<p>To specify Cordova-related dependencies for a plugin, alter the
<code>engines</code> element in
+<code>package.json</code> to include a <code>cordovaDependencies</code> object
using the following
+structure:</p>
+<div class="highlight"><pre><code class="language-javascript"
data-lang="javascript"><span class="nx">engines</span><span
class="err">:</span> <span class="p">{</span>
+ <span class="nl">cordovaDependencies</span><span class="p">:</span> <span
class="p">{</span>
+ <span class="nl">PLUGIN_VERSION</span><span class="p">:</span> <span
class="p">{</span>
+ <span class="nl">DEPENDENCY</span><span class="p">:</span> <span
class="nx">SEMVER_RANGE</span><span class="p">,</span>
+ <span class="nx">DEPENDENCY</span><span class="err">:</span> <span
class="nx">SEMVER_RANGE</span><span class="p">,</span>
+ <span class="p">...</span>
+ <span class="p">},</span>
+ <span class="p">...</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+</code></pre></div>
+<ul>
+<li><code>PLUGIN_VERSION</code> specifies a version of your plugin. It should
adhere the syntax for a single version as defined by <a
href="https://www.npmjs.com/package/semver";>npm's semver package</a> or an
upper bound (see <a href="#upper-bounds">below</a>)</li>
+<li><code>DEPENDENCY</code> may be one of the following:
+
+<ul>
+<li>The Cordova CLI, <code>"cordova"</code></li>
+<li>A Cordova platform (e.g. <code>"cordova-android"</code>,
<code>"cordova-ios"</code>, <code>"cordova-windows"</code>,
etc.)</li>
+<li>Another Cordova plugin (e.g.
<code>"cordova-plugin-camera"</code>, etc.)</li>
+</ul></li>
+<li><code>SEMVER_RANGE</code> should adhere to the syntax for a range as
defined by <a href="https://www.npmjs.com/package/semver";>npm's semver
package</a></li>
+</ul>
+
+<p><strong>NOTE:</strong> A Cordova platform <code>DEPENDENCY</code> refers to
the Cordova platform and not
+the OS (i.e. <code>cordova-android</code> rather than the Android OS)</p>
+
+<p>Your <code>cordovaDependencies</code> may list any number of
<code>PLUGIN_VERSION</code> requirements
+and any number of <code>DEPENDENCY</code> constraints within them. Versions of
your plugin
+that do not have their dependencies listed will be assumed to have the same
+dependency information as the highest <code>PLUGIN_VERSION</code> listed below
them. For
+example, consider the following entry:</p>
+<div class="highlight"><pre><code class="language-javascript"
data-lang="javascript"><span class="nx">engines</span><span
class="err">:</span> <span class="p">{</span>
+ <span class="nl">cordovaDependencies</span><span class="p">:</span> <span
class="p">{</span>
+ <span class="s2">"1.0.0"</span><span class="err">:</span> <span
class="p">{</span> <span class="s2">"cordova-android"</span><span
class="err">:</span> <span class="s2">"<3.0.0"</span><span
class="p">},</span>
+ <span class="s2">"2.1.0"</span><span class="err">:</span> <span
class="p">{</span> <span class="s2">"cordova-android"</span><span
class="err">:</span> <span class="s2">">4.0.0"</span><span class="p">}</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+</code></pre></div>
+<p>All plugin versions below the lowest entry (1.0.0 in this example) are
assumed
+to have no dependencies. Any version of the plugin between 1.0.0 and 2.1.0 is
+assumed to have the same dependencies as version 1.0.0 (a cordova-android
+version less than 3.0.0). This lets you only update your
<code>cordovaDependencies</code>
+information when there are breaking changes.</p>
+
+<h4>Upper Bounds</h4>
+
+<p>In addition to a single version, a <code>PLUGIN_VERSION</code> in
<code>cordovaDependencies</code>
+may also specify an upper bound to amend entries for older releases
+of your plugin. This is useful when a breaking change occurs in a
<code>DEPENDENCY</code>
+and a new constraint must be added for all older versions of a plugin that do
+not support it. These bounds should be written as, a <code><</code>
followed by a single
+<a href="https://www.npmjs.com/package/semver";>semver</a> version (<strong>Not
an arbitrary range!</strong>). This will apply
+whatever <code>DEPENDENCY</code> values are given to all versions of the
plugin below the
+specified version. For example, consider the following entry:</p>
+<div class="highlight"><pre><code class="language-javascript"
data-lang="javascript"><span class="nx">engines</span><span
class="err">:</span> <span class="p">{</span>
+ <span class="nl">cordovaDependencies</span><span class="p">:</span> <span
class="p">{</span>
+ <span class="s2">"0.0.1"</span><span class="err">:</span> <span
class="p">{</span> <span class="s2">"cordova-ios"</span><span
class="err">:</span> <span class="s2">">1.0.0"</span> <span
class="p">},</span>
+ <span class="s2">"<1.0.0"</span><span class="err">:</span> <span
class="p">{</span> <span class="s2">"cordova-ios"</span><span
class="err">:</span> <span class="s2">"<2.0.0"</span> <span
class="p">},</span>
+ <span class="s2">"<2.0.0"</span><span class="err">:</span> <span
class="p">{</span> <span class="s2">"cordova-ios"</span><span
class="err">:</span> <span class="s2">"<5.0.0"</span> <span
class="p">}</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+</code></pre></div>
+<p>Here we specify one plugin version (0.0.1) and two upper bounds (<1.0.0
and <2.0.0)
+that constrain cordova-ios. The two upper bounds do not override the constraint
+of 0.0.1, they are combined via AND at evaluation time. When the CLI checks the
+cordova-ios version of the project, the constraint that will be evaluated for
+plugin version 0.0.1 will be the combination of these three:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">
cordova-ios >1.0.0 AND cordova-ios <2.0.0 AND cordova-ios <5.0.0
+</code></pre></div>
+<p>Please note that the only <code>PLUGIN_VERSION</code> values allowed are
single versions or
+upper bounds; no other semver ranges are supported.</p>
+
</div>
</div>
Modified: cordova/site/public/docs/en/6.x/reference/cordova-cli/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/docs/en/6.x/reference/cordova-cli/index.html?rev=1736375&r1=1736374&r2=1736375&view=diff
==============================================================================
--- cordova/site/public/docs/en/6.x/reference/cordova-cli/index.html (original)
+++ cordova/site/public/docs/en/6.x/reference/cordova-cli/index.html Wed Mar 23
19:14:10 2016
@@ -2916,7 +2916,7 @@
<h2>Platform-specific options</h2>
-<p>Certain commands have options (<code>platformOpts</code>) that are specific
to a particular platform. They can be provided to the cordova-cli with a
'--' separator that stops the command parsing within the cordova-lib
module and passes through rest of the options for platforms to parse. </p>
+<p>Certain commands have options (<code>platformOpts</code>) that are specific
to a particular platform. They can be provided to the cordova-cli with a
'--' separator that stops the command parsing within the cordova-lib
module and passes through rest of the options for platforms to parse.</p>
<h2>Examples</h2>
@@ -3343,6 +3343,18 @@ www/
</tr>
</tbody></table>
+<h3>Algorithm for resolving plugins</h3>
+
+<p>When adding a plugin to a project, the CLI will resolve the plugin
+based on the following criteria (listed in order of precedence):</p>
+
+<ol>
+<li>The <code>plugin-spec</code> given in the command (e.g. <code>cordova
plugin add pluginID@version</code>)</li>
+<li>The <code>plugin-spec</code> saved in <code>config.xml</code> (i.e. if the
plugin was previously added with <code>--save</code>)</li>
+<li>As of Cordova version 6.1, the latest plugin version published to npm that
the current project can support (only applies to plugins that list their <a
href="http://cordova.apache.org/docs/en/latest/guide/hybrid/plugins/index.html#specifying-project-requirements";>Cordova
dependencies</a> in their <code>package.json</code>)</li>
+<li>The latest plugin version published to npm</li>
+</ol>
+
<h3>Examples</h3>
<ul>
Modified:
cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html?rev=1736375&r1=1736374&r2=1736375&view=diff
==============================================================================
---
cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html
(original)
+++
cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html
Wed Mar 23 19:14:10 2016
@@ -2826,7 +2826,7 @@
<h1>cordova-plugin-splashscreen</h1>
-<p>This plugin displays and hides a splash screen during application
launch.</p>
+<p>This plugin is required to work with splash screens. This plugin displays
and hides a splash screen during application launch.</p>
<p>Report issues with this plugin 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%20Splashscreen%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC";>Apache
Cordova issue tracker</a>.</p>
@@ -2850,32 +2850,74 @@ cordova plugin add https://github.com/ap
<li>Browser</li>
</ul>
+<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>
+
+<p>Please notice that the value of the "src" attribute is relative
to the project directory and not to the www directory. You can name the source
image whatever you like. The internal name in the app is determined by
Cordova.</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><platform</span> <span class="na">name=</span><span
class="s">"android"</span><span class="nt">></span>
+ <span class="c"><!-- you can use any density that exists in the Android
project --></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/android/splash-land-hdpi.png"</span> <span
class="na">density=</span><span class="s">"land-hdpi"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/android/splash-land-ldpi.png"</span> <span
class="na">density=</span><span class="s">"land-ldpi"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/android/splash-land-mdpi.png"</span> <span
class="na">density=</span><span class="s">"land-mdpi"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/android/splash-land-xhdpi.png"</span> <span
class="na">density=</span><span class="s">"land-xhdpi"</span><span
class="nt">/></span>
+
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/android/splash-port-hdpi.png"</span> <span
class="na">density=</span><span class="s">"port-hdpi"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/android/splash-port-ldpi.png"</span> <span
class="na">density=</span><span class="s">"port-ldpi"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/android/splash-port-mdpi.png"</span> <span
class="na">density=</span><span class="s">"port-mdpi"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/android/splash-port-xhdpi.png"</span> <span
class="na">density=</span><span class="s">"port-xhdpi"</span><span
class="nt">/></span>
+<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="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>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-Portrait@2x~ipad.png"</span> <span
class="na">width=</span><span class="s">"1536"</span> <span
class="na">height=</span><span class="s">"2048"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-Landscape~ipad.png"</span> <span
class="na">width=</span><span class="s">"1024"</span> <span
class="na">height=</span><span class="s">"768"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-Landscape@2x~ipad.png"</span> <span
class="na">width=</span><span class="s">"2048"</span> <span
class="na">height=</span><span class="s">"1536"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-568h@2x~iphone.png"</span> <span
class="na">width=</span><span class="s">"640"</span> <span
class="na">height=</span><span class="s">"1136"</span><span
class="nt">/></span>
+ <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="nt"></platform></span>
+
+<span class="nt"><platform</span> <span class="na">name=</span><span
class="s">"windows"</span><span class="nt">></span>
+ <span class="c"><!-- 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/windows/splashscreen.png"</span> <span
class="na">width=</span><span class="s">"620"</span> <span
class="na">height=</span><span class="s">"300"</span><span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/windows/splashscreenphone.png"</span> <span
class="na">width=</span><span class="s">"1152"</span> <span
class="na">height=</span><span class="s">"1920"</span><span
class="nt">/></span>
+<span class="nt"></platform></span>
+
+<span class="nt"><platform</span> <span class="na">name=</span><span
class="s">"blackberry10"</span><span class="nt">></span>
+ <span class="c"><!-- Add a rim:splash element for each resolution and
locale you wish --></span>
+ <span class="c"><!--
http://developer.blackberry.com/html5/documentation/rim_splash_element.html
--></span>
+ <span class="nt"><rim:splash</span> <span class="na">src=</span><span
class="s">"res/screen/blackberry/splashscreen.png"</span><span
class="nt">/></span>
+<span class="nt"></platform></span>
+
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span
class="s">"10000"</span> <span class="nt">/></span>
+</code></pre></div>
<h2>Preferences</h2>
<h4>config.xml</h4>
<ul>
-<li><p><strong>SplashScreen</strong> (string). The resource name which is used
for the displaying splash screen. Different platforms use values for this.</p>
-<div class="highlight"><pre><code class="language-"
data-lang=""><preference name="SplashScreen" value="resourcename" />
-</code></pre></div></li>
-<li><p><strong>AutoHideSplashScreen</strong> (boolean, default to
<code>true</code>). Indicates wherether hide splash screen automatically or
not. Splash screen hidden after amount of time specified in the
<code>SplashScreenDelay</code> preference.</p>
-<div class="highlight"><pre><code class="language-"
data-lang=""><preference name="AutoHideSplashScreen" value="true" />
-</code></pre></div></li>
-<li><p><strong>SplashScreenDelay</strong> (number, default to 3000). Amount of
time in milliseconds to wait before automatically hide splash screen.</p>
-<div class="highlight"><pre><code class="language-"
data-lang=""><preference name="SplashScreenDelay" value="3000" />
-</code></pre></div></li>
+<li> <strong>AutoHideSplashScreen</strong> (boolean, default to
<code>true</code>). Indicates wherether hide splash screen automatically or
not. Splash screen hidden after amount of time specified in the
<code>SplashScreenDelay</code> preference.</li>
</ul>
-
+<div class="highlight"><pre><code class="language-xml" data-lang="xml">
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"AutoHideSplashScreen"</span> <span class="na">value=</span><span
class="s">"true"</span> <span class="nt">/></span>
+</code></pre></div>
+<ul>
+<li> <strong>SplashScreenDelay</strong> (number, default to 3000). Amount of
time in milliseconds to wait before automatically hide splash screen.</li>
+</ul>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml">
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span
class="s">"3000"</span> <span class="nt">/></span>
+</code></pre></div>
<h3>Android Quirks</h3>
<p>In your <code>config.xml</code>, you need to add the following
preferences:</p>
-<div class="highlight"><pre><code class="language-"
data-lang=""><preference name="SplashScreen" value="foo" />
-<preference name="SplashScreenDelay" value="3000" />
-<preference name="SplashMaintainAspectRatio" value="true|false" />
-<preference name="SplashShowOnlyFirstTime" value="true|false" />
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span
class="s">"3000"</span> <span class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashMaintainAspectRatio"</span> <span
class="na">value=</span><span class="s">"true|false"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashShowOnlyFirstTime"</span> <span class="na">value=</span><span
class="s">"true|false"</span> <span class="nt">/></span>
</code></pre></div>
-<p>Where foo is the name of the splashscreen file, preferably a 9 patch file.
Make sure to add your splashcreen files to your res/xml directory under the
appropriate folders. The second parameter represents how long the splashscreen
will appear in milliseconds. It defaults to 3000 ms. See <a
href="http://cordova.apache.org/docs/en/edge/config_ref_images.md.html";>Icons
and Splash Screens</a>
-for more information.</p>
+<p>The first parameter represents how long the splashscreen will appear in
milliseconds. It defaults to 3000 ms.</p>
<p>"SplashMaintainAspectRatio" preference is optional. If set to
true, splash screen drawable is not stretched to fit screen, but instead simply
"covers" the screen, like CSS "background-size:cover". This
is very useful when splash screen images cannot be distorted in any way, for
example when they contain scenery or text. This setting works best with images
that have large margins (safe areas) that can be safely cropped on screens with
different aspect ratios.</p>
@@ -2886,31 +2928,33 @@ for more information.</p>
<h3>Browser Quirks</h3>
<p>You can use the following preferences in your <code>config.xml</code>:</p>
-<div class="highlight"><pre><code class="language-" data-lang=""><platform
name="browser">
- <preference name="SplashScreen"
value="/images/browser/splashscreen.jpg" /> <!-- defaults to
"/img/logo.png" -->
- <preference name="SplashScreenDelay" value="3000" /> <!--
defaults to "3000" -->
- <preference name="SplashScreenBackgroundColor" value="green" />
<!-- defaults to "#464646" -->
- <preference name="ShowSplashScreen" value="false" /> <!--
defaults to "true" -->
- <preference name="SplashScreenWidth" value="600" /> <!-- defaults
to "170" -->
- <preference name="SplashScreenHeight" value="300" /> <!--
defaults to "200" -->
-</platform>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><platform</span> <span class="na">name=</span><span
class="s">"browser"</span><span class="nt">></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashScreen"</span> <span class="na">value=</span><span
class="s">"/images/browser/splashscreen.jpg"</span> <span
class="nt">/></span> <span class="c"><!-- defaults to "/img/logo.png"
--></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span
class="s">"3000"</span> <span class="nt">/></span> <span class="c"><!--
defaults to "3000" --></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashScreenBackgroundColor"</span> <span
class="na">value=</span><span class="s">"green"</span> <span
class="nt">/></span> <span class="c"><!-- defaults to "#464646"
--></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"ShowSplashScreen"</span> <span class="na">value=</span><span
class="s">"false"</span> <span class="nt">/></span> <span class="c"><!--
defaults to "true" --></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashScreenWidth"</span> <span class="na">value=</span><span
class="s">"600"</span> <span class="nt">/></span> <span class="c"><!--
defaults to "170" --></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"SplashScreenHeight"</span> <span class="na">value=</span><span
class="s">"300"</span> <span class="nt">/></span> <span class="c"><!--
defaults to "200" --></span>
+<span class="nt"></platform></span>
</code></pre></div>
-<p><strong>Note</strong>: <code>SplashScreen</code> value should be absolute
in order to work in a sub-page.</p>
+<p><strong>Note</strong>: <code>SplashScreen</code> value should be absolute
in order to work in a sub-page. The <code>SplashScreen</code> value is used
only for the browser platform. The value will be ignored for other
platforms.</p>
<h3>Android and iOS Quirks</h3>
<ul>
+<li><p>In iOS, the splashscreen images are called launch images. These images
are mandatory on iOS.</p></li>
<li><p><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>):
Set to <code>false</code> to
prevent the splash screen from fading in and out when its display
-state changes.</p>
-<div class="highlight"><pre><code class="language-"
data-lang=""><preference name="FadeSplashScreen" value="false"/>
-</code></pre></div></li>
-<li><p><code>FadeSplashScreenDuration</code> (float, defaults to
<code>3000</code>): Specifies the
-number of milliseconds for the splash screen fade effect to execute.</p>
-<div class="highlight"><pre><code class="language-"
data-lang=""><preference name="FadeSplashScreenDuration" value="3000"/>
-</code></pre></div></li>
+state changes.</p></li>
</ul>
-
+<div class="highlight"><pre><code class="language-xml" data-lang="xml">
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"FadeSplashScreen"</span> <span class="na">value=</span><span
class="s">"false"</span><span class="nt">/></span>
+</code></pre></div>
+<ul>
+<li><code>FadeSplashScreenDuration</code> (float, defaults to
<code>3000</code>): Specifies the
+number of milliseconds for the splash screen fade effect to execute.</li>
+</ul>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml">
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"FadeSplashScreenDuration"</span> <span class="na">value=</span><span
class="s">"3000"</span><span class="nt">/></span>
+</code></pre></div>
<p>Note also that this value used to be seconds, and not milliseconds, so
values less than 30 will still be treated as seconds. ( Consider this a
deprecated patch that will disapear in some future version. )</p>
<p><em>Note</em>: <code>FadeSplashScreenDuration</code> is included into
<code>SplashScreenDelay</code>, for example if you have <code><preference
name="SplashScreenDelay" value="3000" /></code> and
<code><preference name="FadeSplashScreenDuration"
value="1000"/></code> defined in <code>config.xml</code>:</p>
@@ -2930,12 +2974,11 @@ number of milliseconds for the splash sc
<span class="p">},</span> <span class="nx">splashDuration</span> <span
class="o">-</span> <span class="nx">fadeDuration</span><span class="p">);</span>
</code></pre></div>
<ul>
-<li><p><code>ShowSplashScreenSpinner</code> (boolean, defaults to
<code>true</code>): Set to <code>false</code>
-to hide the splash-screen spinner.</p>
-<div class="highlight"><pre><code class="language-"
data-lang=""><preference name="ShowSplashScreenSpinner" value="false"/>
-</code></pre></div></li>
+<li><code>ShowSplashScreenSpinner</code> (boolean, defaults to
<code>true</code>): Set to <code>false</code>
+to hide the splash-screen spinner.</li>
</ul>
-
+<div class="highlight"><pre><code class="language-xml" data-lang="xml">
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"ShowSplashScreenSpinner"</span> <span class="na">value=</span><span
class="s">"false"</span><span class="nt">/></span>
+</code></pre></div>
<h2>Methods</h2>
<ul>
@@ -2946,21 +2989,21 @@ to hide the splash-screen spinner.</p>
<h2>splashscreen.hide</h2>
<p>Dismiss the splash screen.</p>
-<div class="highlight"><pre><code class="language-"
data-lang="">navigator.splashscreen.hide();
+<div class="highlight"><pre><code class="language-js" data-lang="js"><span
class="nx">navigator</span><span class="p">.</span><span
class="nx">splashscreen</span><span class="p">.</span><span
class="nx">hide</span><span class="p">();</span>
</code></pre></div>
<h3>BlackBerry 10, WP8, iOS Quirk</h3>
<p>The <code>config.xml</code> file's <code>AutoHideSplashScreen</code>
setting must be
<code>false</code>. To delay hiding the splash screen for two seconds, add a
timer such as the following in the <code>deviceready</code> event handler:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">
setTimeout(function() {
- navigator.splashscreen.hide();
- }, 2000);
+<div class="highlight"><pre><code class="language-js" data-lang="js"><span
class="nx">setTimeout</span><span class="p">(</span><span
class="kd">function</span><span class="p">()</span> <span class="p">{</span>
+ <span class="nx">navigator</span><span class="p">.</span><span
class="nx">splashscreen</span><span class="p">.</span><span
class="nx">hide</span><span class="p">();</span>
+<span class="p">},</span> <span class="mi">2000</span><span class="p">);</span>
</code></pre></div>
<h2>splashscreen.show</h2>
<p>Displays the splash screen.</p>
-<div class="highlight"><pre><code class="language-"
data-lang="">navigator.splashscreen.show();
+<div class="highlight"><pre><code class="language-js" data-lang="js"><span
class="nx">navigator</span><span class="p">.</span><span
class="nx">splashscreen</span><span class="p">.</span><span
class="nx">show</span><span class="p">();</span>
</code></pre></div>
<p>Your application cannot call <code>navigator.splashscreen.show()</code>
until the app has
started and the <code>deviceready</code> event has fired. But since typically
the splash
@@ -2968,9 +3011,7 @@ screen is meant to be visible before you
defeat the purpose of the splash screen. Providing some configuration in
<code>config.xml</code> will automatically <code>show</code> the splash screen
immediately after your
app launch and before it has fully started and received the
<code>deviceready</code>
-event. See <a
href="http://cordova.apache.org/docs/en/edge/config_ref_images.md.html";>Icons
and Splash Screens</a>
-for more information on doing this configuration. For this reason, it is
-unlikely you need to call <code>navigator.splashscreen.show()</code> to make
the splash
+event. For this reason, it is unlikely you need to call
<code>navigator.splashscreen.show()</code> to make the splash
screen visible for app startup.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org
