You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ja...@apache.org on 2019/05/08 13:21:48 UTC
svn commit: r1858924 [4/7] - in /cordova/site/public: ./
announcements/2019/04/ announcements/2019/04/22/ blog/ blog/2013/07/11/
blog/2013/08/12/ blog/releases/2013/07/23/ docs/en/6.x/reference/cordova-cli/
docs/en/6.x/reference/cordova-plugin-battery-...
Modified: cordova/site/public/docs/en/dev/guide/platforms/windows/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/guide/platforms/windows/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/guide/platforms/windows/index.html (original)
+++ cordova/site/public/docs/en/dev/guide/platforms/windows/index.html Wed May 8 13:21:47 2019
@@ -2532,84 +2532,82 @@
<div id="page-toc-source">
<h1>Windows Platform Guide</h1>
-<p>This guide shows how to set up your SDK development environment to build
-and deploy Cordova apps for Windows 8.1, Windows Phone 8.1, and
-Windows 10 Universal App Platform. It shows how to use either shell tools
-to generate and build apps, or the cross-platform Cordova CLI. (See the <a href="../../overview/index.html#development-paths">Overview</a> for a comparison of these
-development options.) This section also shows how to modify Cordova apps
-within Visual Studio. Regardless of <a href="../../overview/index.html#development-paths">which</a> approach you take, you need to
-install the Visual Studio SDK, as described below.</p>
-
-<p>Developers wishing to target Windows Phone 8 should use the wp8 platform,
-see <a href="../wp8/index.html">Windows Phone 8 Platform Guide</a> for details (Warning, the wp8 platform is deprecated).</p>
-
-<p>Cordova WebViews running on Windows rely on Internet Explorer 11 (Windows 8.1 and Windows Phone 8.1) as
-their rendering engine, so as a practical matter you can use IE's
-powerful debugger to test any web content that doesn't invoke Cordova
-APIs. The Windows Phone Developer Blog provides
-<a href="http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx">helpful guidance</a>
-on how to support IE along with comparable WebKit browsers.</p>
+<p>This guide shows how to set up your SDK development environment to build and deploy Cordova apps Windows 10 (Universal Windows Platform [= UWP], formerly known as Universal App Platform [= UAP]), Windows 8.1 and Windows Phone 8.1. It shows how to use either shell tools to generate and build apps, or the cross-platform Cordova CLI. (See the <a href="../../overview/index.html#development-paths">Overview</a> for a comparison of these development options.) This section also shows how to modify Cordova apps within Visual Studio. Regardless of <a href="../../overview/index.html#development-paths">which approach</a> you take, you need to install the Visual Studio SDK, as described below.</p>
+
+<p>Cordova Windows on Windows 8.1 and Windows Phone 8.1 rely on Internet Explorer 11 as their rendering engine, so as a practical matter you can use IE's powerful debugger to test any web content that doesn't invoke Cordova APIs. The Windows Phone Developer Blog provides <a href="https://blogs.windows.com/buildingapps/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10/#qYPwLJDbYKToOveG.97">helpful guidance</a> on how to support IE along with comparable WebKit browsers.</p>
<h2>Requirements and Support</h2>
-<p>To develop apps for Windows platform you need:</p>
+<p>To develop apps for Windows 10 you need:</p>
<ul>
-<li><p>A Windows 8.1, 32 or 64-bit machine (<em>Home</em>, <em>Pro</em>, or <em>Enterprise</em> editions)
-with minimum 4 GB of RAM along with <a href="http://www.visualstudio.com/downloads">Visual Studio 2015</a>
-or Visual Studio 2013. An evaluation version of Windows 8.1 Enterprise is
-available from the
-<a href="https://technet.microsoft.com/evalcenter/hh699156.aspx">Microsoft Developer Network</a>.</p></li>
-<li><p>For the Windows Phone emulators, Windows 8.1 (x64) Professional edition or higher,
-and a processor that supports <a href='https://msdn.microsoft.com/en-us/library/windows/apps/ff626524(v=vs.105).aspx#hyperv'>Client Hyper-V and Second Level Address Translation (SLAT)</a>.</p></li>
+<li>Windows 10 (or Windows 8.1), 32- or 64-bit, along with <a href="http://www.visualstudio.com/downloads">Visual Studio</a> 2015 or Visual Studio 2017. (Cordova Windows is not supported by Visual Studio 2019.)</li>
</ul>
-<p>To develop apps for Windows 10:</p>
+<p>To develop apps for Windows 8.1:</p>
<ul>
-<li>Windows 8.1 or Windows 10, 32- or 64-bit, along with
-<a href="http://www.visualstudio.com/downloads">Visual Studio 2015</a> or higher.</li>
+<li>Windows 8.1, 32 or 64-bit, along with <a href="http://www.visualstudio.com/downloads">Visual Studio</a> 2015 or Visual Studio 2013.</li>
+<li>For the Windows Phone emulators, Windows 8.1 (x64) Professional edition or higher, and a processor that supports <a href="https://msdn.microsoft.com/en-us/library/windows/apps/ff626524(v=vs.105).aspx#hyperv">Client Hyper-V and Second Level Address Translation (SLAT)</a></li>
</ul>
-<p>App compatibility is determined by the OS that the app targeted. Apps are forwardly-compatible
-but not backwardly-compatible, so an app targeting Windows 10 cannot run on 8.1, but
-an app built for 8.1 can run on 10.</p>
-
<p>Cordova apps targeting Windows can be developed on a Mac, either by running a
virtual machine environment or by using Boot Camp to dual-boot a
-Windows 8.1 partition. Consult these resources to set up the required
+Windows partition. Consult these resources to set up the required
Windows development environment on a Mac:</p>
<ul>
-<li><p><a href="http://msdn.microsoft.com/en-US/library/windows/apps/jj945426">VMWare Fusion</a></p></li>
-<li><p><a href="http://msdn.microsoft.com/en-US/library/windows/apps/jj945424">Parallels Desktop</a></p></li>
-<li><p><a href="http://msdn.microsoft.com/en-US/library/windows/apps/jj945423">Boot Camp</a></p></li>
+<li><a href="http://msdn.microsoft.com/en-US/library/windows/apps/jj945426">VMWare Fusion</a></li>
+<li><a href="http://msdn.microsoft.com/en-US/library/windows/apps/jj945424">Parallels Desktop</a></li>
+<li><a href="http://msdn.microsoft.com/en-US/library/windows/apps/jj945423">Boot Camp</a></li>
</ul>
<h2>Installing the Requirements</h2>
-<p>Install any edition of
-<a href="http://www.visualstudio.com/downloads">Visual Studio</a> matching the version
+<p>Install any edition of <a href="http://www.visualstudio.com/downloads">Visual Studio</a> matching the version
requirements listed above.</p>
+<h3>Visual Studio 2017</h3>
+
+<p>You also need to install the Workload "Universal Windows Platform development" and the "Windows 10 SDK (10.0.10240.0)" as individual component.</p>
+
+<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/vs17_workload.png" /></p><br/></p>
+
+<p>See <a href="#user-content-visual-studio-2017-and-msbuild-v40-is-not-supported-aborting">here if you get error messages regarding <code>MSBuild v4.0</code></a>. </p>
+
+<h3>Visual Studio 2015</h3>
+
<p>The tools and SDKs for the target Windows platforms (UWP, 8.1, etc.) must also be selected in the installer. They can be found under the "Windows and Web Development" heading.</p>
<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/win8_installTools.png" /></p><br/></p>
<h2>Project Configuration</h2>
+<p>After installation, you should be ready to develop apps targetting Windows platform. Refer to <a href="../../cli/index.html">Create your first app</a> guide for details.</p>
+
<h3>Target Windows version</h3>
-<p>After installation, you should be ready to develop apps targetting Windows platform. Refer to <a href="../../cli/index.html">Create your first app</a> guide for details.</p>
+<p>By default the <code>cordova build</code> command produces one package for Windows 10.</p>
+
+<p>App compatibility is determined by the OS that the app targeted. Apps are forwardly-compatible but not backwardly-compatible, so an app targeting Windows 10 cannot run on 8.1, but an app built for 8.1 can run on 10.</p>
+
+<h4>Target version configuration</h4>
+
+<p>If you want to build Windows 8.1 and Windows Phone 8.1 packages by default, you have to target <code>8.1</code> and the following configuration setting must be added to configuration file (<code>config.xml</code>).</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"windows-target-version"</span> <span class="na">value=</span><span class="s">"8.1"</span> <span class="nt">/></span>
+</code></pre></div>
+<p>Once you add this setting, the <code>build</code> command will start producing Windows 8.1 and Windows Phone 8.1 packages.</p>
-<p>By default the <code>cordova build</code> command produces two packages: Windows 8.1 and Windows Phone 8.1.
-To upgrade Windows package to version 10 the following configuration setting must be
-added to configuration file (<code>config.xml</code>).</p>
-<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"windows-target-version"</span> <span class="na">value=</span><span class="s">"10.0"</span> <span class="nt">/></span>
+<h4>Overriding configuration with the --appx parameter</h4>
+
+<p>You may decide that you want to build a particular version of your application targeting a particular OS (for example, you might have set that you want to target Windows 10, but you want to build for Windows Phone 8.1). To do this, you can use the <code>--appx</code> parameter:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova build windows -- --appx=8.1-phone
</code></pre></div>
-<p>Once you add this setting <code>build</code> command will start producing Windows 10 packages.</p>
+<p>The build system will ignore the preference set in <code>config.xml</code> for the target Windows version and strictly build a package for Windows Phone 8.1.</p>
+
+<p>Valid values for the <code>--appx</code> flag are <code>8.1-win</code>, <code>8.1-phone</code>, and <code>uwp</code> or <code>uap</code> (for Windows 10 Universal Apps / Universal Windows Apps). These options also apply to the <code>cordova run</code> command.</p>
-<h3>Considerations for target Windows version</h3>
+<h4>Considerations for target Windows version</h4>
<p>Windows 10 supports a new "Remote" mode for Cordova apps (and HTML apps in general). This mode enables
apps to have much more freedom with respect to use of DOM manipulation and common web patterns such as the use
@@ -2620,24 +2618,10 @@ the <a href="#understanding-remote-mode-
<p>When using Remote Mode, developers are encouraged to apply a Content Security Policy (CSP) to their application
to prevent script injection attacks.</p>
-<h3>The --appx parameter</h3>
-
-<p>You may decide that you want to build a particular version of your application targeting a particular OS (for example, you might have set that you want to target Windows 10, but you want to build for Windows Phone 8.1). To do this, you can use the <code>--appx</code> parameter:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">cordova build windows -- --appx=8.1-phone
-</code></pre></div>
-<p>The build system will ignore the preference set in config.xml for the target Windows version and strictly build a package for Windows Phone 8.1.</p>
-
-<p>Valid values for the <code>--appx</code> flag are <code>8.1-win</code>, <code>8.1-phone</code>, and <code>uap</code> (for Windows 10 Universal Apps). These options also apply to the <code>cordova run</code> command.</p>
-
<h3>Deploy options</h3>
<p>To deploy Windows package:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">cordova run windows -- --win # explicitly specify Windows as deployment target
-cordova run windows # `run` uses Windows package by default
-</code></pre></div>
-<p>To deploy Windows Phone package:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">cordova run windows -- --phone # deploy app to Windows Phone 8.1 emulator
-cordova run windows --device -- --phone # deploy app to connected device
+<div class="highlight"><pre><code class="language-" data-lang="">cordova run windows
</code></pre></div>
<p>This command will give you the list of all available targets:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova run windows --list
@@ -2645,55 +2629,76 @@ cordova run windows --device -- --phone
<p>This allows you to run the application on a specific device or emulator, in this case "Emulator 8.1 720p 4.7 inch"</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova run windows --target="Emulator 8.1 720P 4.7 inch" -- --phone
</code></pre></div>
+<h4>Architecture option</h4>
+
+<ul>
+<li><code>--archs</code></li>
+<li>Specific chip architectures (<code>anycpu</code>, <code>arm</code>, <code>x86</code>, <code>x64</code>)</li>
+</ul>
+
+<h4>Bundle option</h4>
+
+<ul>
+<li><code>--bundle</code></li>
+<li>Generates an .appxbundle. Not valid if anycpu AND chip-specific architectures are used (at the same time)</li>
+</ul>
+
<p>You can also use <strong>cordova run --help</strong> to see additional build and run options.</p>
+<h4>Deploy options when targetting Windows (Phone) 8.1</h4>
+
+<p>With Windows (Phone) 8.1 packages you have more options for deployment.</p>
+
+<h5><code>--phone</code> and <code>--win</code></h5>
+
+<p>To deploy Windows 8.1 package:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova run windows -- --win # explicitly specify Windows as deployment target
+</code></pre></div>
+<p>To deploy Windows Phone 8.1 package:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova run windows -- --phone # deploy app to Windows Phone 8.1 emulator
+cordova run windows --device -- --phone # deploy app to connected device
+</code></pre></div>
+<h5><code>--win10tools</code></h5>
+
+<ul>
+<li><code>--win10tools</code></li>
+<li>Uses Windows 10 deployment tools (used for a Windows 8.1 app when) being deployed to a Windows 10 device</li>
+</ul>
+
<h3>Using Visual Studio to deploy the app</h3>
-<p>Once you build a Cordova app, you can open it with
-Visual Studio. The various <code>build</code> commands generate a Visual Studio
-Solution (<em>.sln</em>) file. Open the file in the File Explorer to modify
-the project within Visual Studio:</p>
+<p>Once you build a Cordova app, you can open it with Visual Studio. The various <code>build</code> commands generate a Visual Studio
+Solution (<em>.sln</em>) file. Open the file in the File Explorer to modify the project within Visual Studio:</p>
<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/win8_sdk_openSLN.png" /></p><br/></p>
-<p>The <code>CordovaApp</code> component displays within the solution, and its <code>www</code>
-directory contains the web-based source code, including the
-<code>index.html</code> home page:</p>
+<p>The <code>CordovaApp</code> component displays within the solution, and its <code>www</code> directory contains the web-based source code, including the <code>index.html</code> home page:</p>
<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/win8_sdk.png" /></p><br/></p>
-<p>The projects for different Windows versions are displayed separately in the solution explorer. You can choose the deploy target version by right clicking the 'solution' (topmost entry in the solution explorer) and then going into 'Properties'. Here you can update the 'Single start up' field. The controls below Visual Studio's main menu allow you to test or
-deploy the app:</p>
+<p>The projects for different Windows versions are displayed separately in the solution explorer. You can choose the deploy target version by right clicking the 'solution' (topmost entry in the solution explorer) and then going into 'Properties'. Here you can update the 'Single start up' field. The controls below Visual Studio's main menu allow you to test or deploy the app:</p>
<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/win8_sdk_deploy.png" /></p><br/></p>
-<p>With <strong>Local Machine</strong> selected, press the green arrow to install the
-app on the same machine running Visual Studio. Once you do so, the app
-appears in Windows' app listings:</p>
+<p>With <strong>Local Machine</strong> selected, press the green arrow to install the app on the same machine running Visual Studio. Once you do so, the app appears in Windows' app listings:</p>
<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/win8_sdk_runApp.png" /></p><br/></p>
-<p>Each time you rebuild the app, the version available in the interface
-is refreshed.</p>
+<p>Each time you rebuild the app, the version available in the interface is refreshed.</p>
-<p>Once available in the app listings, holding down the <strong>CTRL</strong> key
-while selecting the app allows you to pin it to the main screen:</p>
+<p>Once available in the app listings, holding down the <strong>CTRL</strong> key while selecting the app allows you to pin it to the main screen:</p>
<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/win8_sdk_runHome.png" /></p><br/></p>
-<p>Note that if you open the app within a virtual machine environment,
-you may need to click in the corners or along the sides of the windows
-to switch apps or access additional functionality:</p>
+<p>Note that if you open the app within a virtual machine environment, you may need to click in the corners or along the sides of the windows to switch apps or access additional functionality:</p>
<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/win8_sdk_run.png" /></p><br/></p>
-<p>Alternately, choose the <strong>Simulator</strong> deployment option to view the
-app as if it were running on a tablet device:</p>
+<p>Alternately, choose the <strong>Simulator</strong> deployment option to view the app as if it were running on a tablet device:</p>
<p><br/><p align="center"><img src="/static/img/guide/platforms/windows/win8_sdk_sim.png" /></p><br/></p>
-<p>Unlike desktop deployment, this option allows you to simulate the
-tablet's orientation, location, and vary its network settings.</p>
+<p>Unlike desktop deployment, this option allows you to simulate the tablet's orientation, location, and vary its network settings.</p>
<p><strong>NOTE</strong>: Consult the <a href="../../overview/index.html">Overview</a> for advice on how to use Cordova's
command-line tools or the SDK in your workflow. The Cordova CLI relies
@@ -2704,11 +2709,9 @@ to the CLI.</p>
<h2>Debugging</h2>
-<p>Visual Studio provides powerful tools to debug your application. You can refer to <a href="https://msdn.microsoft.com/en-us/library/7seh8d72.aspx">this</a> article to get started with it.</p>
+<p>Visual Studio provides powerful tools to debug your application. You can refer to <a href="https://msdn.microsoft.com/en-us/library/7seh8d72.aspx">this article</a> to get started with it.</p>
-<p><strong>Note:</strong> Resume and pause events are not triggered normally when debugging apps using Visual Studio. This is because Windows does not suspend your app when it is being debugged.
-The only way to change the application state is through the 'Lifecycle event' options inside Visual Studio. The events should work as expected when the app
-is run on a device/emulator without the debugger attached.</p>
+<p><strong>Note:</strong> Resume and pause events are not triggered normally when debugging apps using Visual Studio. This is because Windows does not suspend your app when it is being debugged. The only way to change the application state is through the 'Lifecycle event' options inside Visual Studio. The events should work as expected when the app is run on a device/emulator without the debugger attached.</p>
<h2>Signing an App</h2>
@@ -2721,7 +2724,7 @@ is run on a device/emulator without the
<li>Identity details matching the provided signing certificate</li>
</ul>
-<p>In Windows project, identity details are kept in a file named package.appxmanifest. This file is automatically populated every time a Cordova app is built. Identity holds 3 important fields.</p>
+<p>In Windows project, identity details are kept in a file named <code>package.appxmanifest</code>. This file is automatically populated every time a Cordova app is built. Identity holds 3 important fields.</p>
<ul>
<li>Name</li>
@@ -2729,7 +2732,7 @@ is run on a device/emulator without the
<li>Version</li>
</ul>
-<p><em>Name</em> and <em>Version</em> can be set from <strong>config.xml</strong>. <em>Publisher</em> can be provided as a build parameter or can be set on <strong>build.json</strong> file.</p>
+<p><em>Name</em> and <em>Version</em> can be set from <code>config.xml</code>. <em>Publisher</em> can be provided as a build parameter or can be set on <code>build.json</code> file.</p>
<p><img src="/static/img/guide/platforms/windows/vs2015_packaging.png" alt=""></p>
@@ -2741,7 +2744,7 @@ is run on a device/emulator without the
<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"WindowsStorePublisherName"</span> <span class="na">value=</span><span class="s">"FakeCorp"</span><span class="nt">/></span> <span class="c"><!-- WindowsStorePublisherName overrides author --></span>
<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"WindowsStoreDisplayName"</span> <span class="na">value=</span><span class="s">"CoolApp"</span><span class="nt">/></span> <span class="c"><!-- WindowsStorePublisherName overrides name --></span>
</code></pre></div>
-<p>A signing certificate can be provided from either CLI or through build.json file. The certificate related CLI flags are:</p>
+<p>A signing certificate can be provided from either CLI or through <code>build.json</code> file. The certificate related CLI flags are:</p>
<table><thead>
<tr>
@@ -2765,7 +2768,7 @@ is run on a device/emulator without the
<p>Example:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova build -- --packageCertificateKeyFile="platforms\windows\CordovaApp_TemporaryKey.pfx" --packageThumbprint="ABCABCABCABC123123123123"
</code></pre></div>
-<p>Alternatively, these values could be specified using a build configuration file (build.json) using CLI (--buildConfig). A sample build configuration file:</p>
+<p>Alternatively, these values could be specified using a build configuration file (<code>build.json</code>) using CLI (<code>--buildConfig</code>). A sample build configuration file:</p>
<div class="highlight"><pre><code class="language-json" data-lang="json"><span class="p">{</span><span class="w">
</span><span class="s2">"windows"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"debug"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -2779,13 +2782,13 @@ is run on a device/emulator without the
</span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div>
-<p>There is also support to mix and match command line arguments and parameters in build.json file. Values from the command line arguments will get precedence.</p>
+<p>There is also support to mix and match command line arguments and parameters in <code>build.json</code> file. Values from the command line arguments will get precedence.</p>
<h3>Creating a certificate key</h3>
-<p>Signing is required for distributing and installing Windows Store apps. This process is normally handled by Visual Studio when you deploy a package for release. To do this without Visual Studio we need to create our own certificates. <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/jj835832(v=vs.85).aspx">This</a> article has instructions on how to do that.</p>
+<p>Signing is required for distributing and installing Windows Store apps. This process is normally handled by Visual Studio when you deploy a package for release. To do this without Visual Studio we need to create our own certificates. <a href="https://msdn.microsoft.com/en-us/library/windows/desktop/jj835832(v=vs.85).aspx">This article</a> has instructions on how to do that.</p>
-<p>Once you have the pfx file created and provided to build.json file, you might get the following error: "The key file may be password protected. To correct this, try to import the certificate manually into the current user's personal certificate store.". In order to import it you have to use <a href="https://technet.microsoft.com/en-us/library/ee624045(v=ws.10).aspx">certutil</a> from an admin prompt:</p>
+<p>Once you have the <code>.pfx</code> file created and provided to <code>build.json</code> file, you might get the following error: "The key file may be password protected. To correct this, try to import the certificate manually into the current user's personal certificate store.". In order to import it you have to use <a href="https://technet.microsoft.com/en-us/library/ee624045(v=ws.10).aspx">certutil</a> from an admin prompt:</p>
<p><code>certutil -user -p PASSWORD -importPFX FakeCorp.com.pfx</code></p>
@@ -2794,7 +2797,7 @@ is run on a device/emulator without the
<ul>
<li>user : Specifies "current user" personal store</li>
<li>p : Password for pfx file</li>
-<li>importPfx : Name of pfx file</li>
+<li>importPFX : Name of pfx file</li>
</ul>
<p>Once installed, next step is to add packageThumbprint and packageCertificateKeyFile to build.json. In order to find the packageThumbprint, search for the CommonName you've associated with the certificate:</p>
@@ -2911,6 +2914,22 @@ prevent accessing certain functionality,
<p>While scrolling of the WebView is enabled by default in "Remote mode" and on the other platforms, in "Local Mode" this is not the case. If scrolling is required in "Local Mode", it can be enabled using the CSS <code>overflow</code> property.</p>
+<h2>Common Problems and Workarounds</h2>
+
+<h3>Visual Studio 2017 and <code>MSBuild v4.0 is not supported, aborting.</code></h3>
+
+<p>The support for Visual Studio 2017 in Cordova Windows unfortunately is not very stable and Cordova Windows sometime can not find MSBuild, Visual Studio's command line build tools. If this affects you, when trying to build a Cordova Windows project you will get an error message simlar to this:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">MSBuild v4.0 is not supported, aborting.
+</code></pre></div>
+<p>To work around this problem, we implemented two environment variables that you can set to tell Cordova Windows where to look. </p>
+
+<ul>
+<li>The first is <code>VSINSTALLDIR</code>and should be set to the installation directory of your Visual Studio (e.g. <code>C:\Program Files (x86)\Microsoft Visual Studio\2017\Community</code>). </li>
+<li>If this doesn't work, the second one is called <code>MSBUILDDIR</code> and describes the path of your MSBuild <code>bin</code> directory (which is most often found at <code>C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\MSBuild\15.0\Bin</code>).</li>
+</ul>
+
+<p>You can either set the environment variable on demand manually by executing <code>set KEY=VALUE</code> (e.g. <code>set MSBUILDDIR=C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\MSBuild\15.0\Bin</code>) or <a href="https://www.computerhope.com/issues/ch000549.htm">set it permanently via the "System Properties"</a>.</p>
+
</div>
</div>
Modified: cordova/site/public/docs/en/dev/reference/cordova-cli/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-cli/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-cli/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-cli/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-cli/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
@@ -2916,18 +2918,8 @@ www/
<li>Android</li>
<li>iOS</li>
<li>Windows (8.1, Phone 8.1, UWP - Windows 10)</li>
-<li>Blackberry10</li>
-<li>Ubuntu</li>
<li>Browser</li>
-</ul>
-
-<h3>Deprecated Platforms</h3>
-
-<ul>
-<li>Amazon-fireos (use Android platform instead)</li>
-<li>WP8 (use Windows platform instead)</li>
-<li>Windows 8.0 (use older versions of cordova)</li>
-<li>Firefox OS (use older versions of cordova)</li>
+<li>Electron</li>
</ul>
<h3>Examples</h3>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-battery-status/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-battery-status/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-battery-status/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-battery-status/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-battery-status/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
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=1858924&r1=1858923&r2=1858924&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 May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-camera/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-device/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-device/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-device/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-device/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-device/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-dialogs/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-dialogs/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-dialogs/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-dialogs/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-dialogs/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-file/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-file/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-file/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-file/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-file/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-geolocation/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-geolocation/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-geolocation/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-geolocation/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-geolocation/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-inappbrowser/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-inappbrowser/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-inappbrowser/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-inappbrowser/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-inappbrowser/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
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=1858924&r1=1858923&r2=1858924&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 May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-media-capture/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-media/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-media/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-media/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-media/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-media/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-network-information/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-network-information/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-network-information/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-network-information/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-network-information/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-screen-orientation/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-screen-orientation/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-screen-orientation/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-screen-orientation/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-screen-orientation/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
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=1858924&r1=1858923&r2=1858924&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 May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-splashscreen/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
@@ -2557,7 +2559,35 @@
<h1>cordova-plugin-splashscreen</h1>
-<p>This plugin is required to work with splash screens. This plugin displays and hides a splash screen during application launch.</p>
+<p>This plugin displays and hides a splash screen while your web application is launching. Using its methods you can also show and hide the splash screen manually.</p>
+
+<ul>
+<li><a href="#installation">Installation</a></li>
+<li><a href="#supported-platforms">Supported Platforms</a></li>
+<li><a href="#platform-splash-screen-image-configuration">Platform Splash Screen Image Configuration</a>
+
+<ul>
+<li><a href="#example-configuration">Example Configuration</a></li>
+<li><a href="#ios-specific-information">iOS-specific Information</a></li>
+<li><a href="#windows-specific-information">Windows-specific Information</a></li>
+</ul></li>
+<li><a href="#preferences">Preferences</a>
+
+<ul>
+<li><a href="#configxml">config.xml</a></li>
+<li><a href="#quirks">Quirks</a></li>
+<li><a href="#android-quirks">Android Quirks</a></li>
+<li><a href="#browser-quirks">Browser Quirks</a></li>
+<li><a href="#ios-quirks">iOS Quirks</a></li>
+<li><a href="#windows-quirks">Windows Quirks</a></li>
+</ul></li>
+<li><a href="#methods">Methods</a>
+
+<ul>
+<li><a href="#splashscreenhide">splashscreen.hide</a></li>
+<li><a href="#splashscreenshow">splashscreen.show</a></li>
+</ul></li>
+</ul>
<h2>Installation</h2>
<div class="highlight"><pre><code class="language-" data-lang="">// npm hosted (new) id
@@ -2571,13 +2601,91 @@ cordova plugin add https://github.com/ap
<ul>
<li>Android</li>
<li>iOS</li>
-<li>Windows (<code>cordova-windows</code> version >= 4.4.0 is required)</li>
+<li>Windows (<code>cordova-windows</code> version >= 4.4.0 is required)<br>
+<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.</li>
<li>Browser</li>
</ul>
-<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>
+<h2>Platform Splash Screen Image Configuration</h2>
+
+<h3>Example Configuration</h3>
+
+<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>The value of the "src" attribute is relative to the project root directory and NOT to the <code>www</code> directory (see <code>Directory structure</code> below). You can name the source image file whatever you like. The internal name in the application is automatically determined by Cordova.</p>
+
+<p>Directory structure:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">projectRoot
+ hooks
+ platforms
+ plugins
+ www
+ css
+ img
+ js
+ res
+ screen
+ android
+ ios
+ windows
+</code></pre></div><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-land-xxhdpi.png"</span> <span class="na">density=</span><span class="s">"land-xxhdpi"</span><span class="nt">/></span>
-<h3>iOS-specific information</h3>
+ <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"><splash</span> <span class="na">src=</span><span class="s">"res/screen/android/splash-port-xxhdpi.png"</span> <span class="na">density=</span><span class="s">"port-xxhdpi"</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"><!-- 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>
+ <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="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="c"><!-- Configuration using MRT concept (Recommended, see "Windows-specific information" section for details): --></span>
+<span class="nt"><platform</span> <span class="na">name=</span><span class="s">"windows"</span><span class="nt">></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/windows/splashscreen.png"</span> <span class="na">target=</span><span class="s">"SplashScreen"</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">target=</span><span class="s">"SplashScreenPhone"</span><span class="nt">/></span>
+<span class="nt"></platform></span>
+
+<span class="c"><!-- Configuration using image size: --></span>
+<span class="c"><!--<platform name="windows">
+ <splash src="res/screen/windows/splashscreen.png" width="620" height="300"/>
+ <splash src="res/screen/windows/splashscreenphone.png" width="1152" height="1920"/>
+</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>
+<h3>iOS-specific Information</h3>
<p>There are two mechanisms for displaying a launch screen on iOS:</p>
@@ -2984,12 +3092,13 @@ When Xcode deploys to a specific simulat
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>Windows-specific information</h2>
+<h3>Windows-specific Information</h3>
<p>Splash screen images can be defined using the <a href="https://cordova.apache.org/docs/en/dev/config_ref/images.html#windows">MRT</a> concept.<br>
-If you specify src="res/windows/splashscreen.png" the following files will be copied into the application's images folder:<br>
-<code>res/windows/splashscreen.png</code> | <code>res/windows/splashscreen.scale-100.png</code>, <code>res/windows/splashscreen.scale-125.png</code>, etc.<br>
-The following are supported:</p>
+If you specify <code>src="res/windows/splashscreen.png"</code> the following files will be copied into the application's images folder:<br>
+<code>res/windows/splashscreen.png</code> | <code>res/windows/splashscreen.scale-100.png</code>, <code>res/windows/splashscreen.scale-125.png</code>, etc. </p>
+
+<p>The following are supported:</p>
<table><thead>
<tr>
@@ -3076,96 +3185,18 @@ The following are supported:</p>
<strong>Note</strong>: Supported formats are <code>.png</code>, <code>.jpg</code>, <code>.jpeg</code>. Mixing of the extensions within a target is not supported. I.e. you can have <code>splashscreen.jpg</code> and <code>splashscreenphone.png</code> but not <code>splashscreen.scale-100.png</code>, <code>splashscreen.scale-400.jpg</code>.<br>
<strong>Note</strong>: You may need to reopen Visual Studio solution after changing the images and doing a <code>cordova prepare</code> for the changes to take effect.</p>
-<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 root directory and not to the www directory (see <code>Directory structure</code> below). You can name the source image whatever you like. The internal name in the app is determined by Cordova.</p>
-
-<p>Directory structure:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">projectRoot
- hooks
- platforms
- plugins
- www
- css
- img
- js
- res
- screen
- android
- ios
- windows
-</code></pre></div><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"><!-- 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>
- <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="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="c"><!-- Configuration using MRT concept (Recommended, see "Windows-specific information" section for details): --></span>
-<span class="nt"><platform</span> <span class="na">name=</span><span class="s">"windows"</span><span class="nt">></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span class="s">"res/screen/windows/splashscreen.png"</span> <span class="na">target=</span><span class="s">"SplashScreen"</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">target=</span><span class="s">"SplashScreenPhone"</span><span class="nt">/></span>
-<span class="nt"></platform></span>
-
-<span class="c"><!-- Configuration using image size: --></span>
-<span class="c"><!--<platform name="windows">
- <splash src="res/screen/windows/splashscreen.png" width="620" height="300"/>
- <splash src="res/screen/windows/splashscreenphone.png" width="1152" height="1920"/>
-</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>
+<h3>config.xml</h3>
<ul>
-<li><code>AutoHideSplashScreen</code> (boolean, default to <code>true</code>). Indicates whether to 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><code>SplashScreenDelay</code> (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>
+<li><p><code>AutoHideSplashScreen</code> (boolean, default to <code>true</code>). Indicates whether to hide splash screen automatically or not. The splash screen is hidden after the amount of time specified in the <code>SplashScreenDelay</code> preference.</p>
+<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></li>
+<li><p><code>SplashScreenDelay</code> (number, default to 3000). Amount of time in milliseconds to wait before automatically hide splash screen.</p>
+<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>
-<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>This value used to be in seconds (but is now milliseconds) so values less than 30 will continue to be treated as seconds. (Consider this a deprecated patch that will disapear in some future version.)</p>
<p>To disable the splashscreen add the following preference to <code>config.xml</code>:</p>
<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">"0"</span><span class="nt">/></span>
@@ -3173,20 +3204,15 @@ The following are supported:</p>
<p><strong>Windows Quirk</strong>: You should disable the splashscreen in case you are updating the entire document body dynamically (f.e. with a SPA router) to avoid affecting UI/controls.<br>
Note that you should also directly reference <code>WinJS/base.js</code> in the page HTML in this case to avoid the issues with activation context (<a href="https://issues.apache.org/jira/browse/CB-11658">CB-11658</a>).</p>
-<p><strong>iOS Quirk</strong>: to disable the splashscreen on <code>ios</code> platform you should also add <code><preference name="FadeSplashScreenDuration" value="0"/></code> to <code>config.xml</code>.</p>
-
-<ul>
-<li><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>): Set to <code>false</code> to
+<p><strong>iOS Quirk</strong>: to disable the splashscreen on <code>ios</code> platform you should also add <code><preference name="FadeSplashScreenDuration" value="0"/></code> to <code>config.xml</code>.</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.</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>500</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">"750"</span><span class="nt">/></span>
+state changes.</p>
+<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></li>
+<li><p><code>FadeSplashScreenDuration</code> (float, defaults to <code>500</code>): Specifies the
+number of milliseconds for the splash screen fade effect to execute.</p>
+<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">"750"</span><span class="nt">/></span>
</code></pre></div>
<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>
@@ -3196,36 +3222,39 @@ number of milliseconds for the splash sc
<li>00:03 - splashscreen is hidden</li>
</ul>
-<p>Turning the fading off via <code><preference name="FadeSplashScreen" value="false"/></code> technically means fading duration to be <code>0</code> so that in this example the overall splash delay will still be 3 seconds.</p>
+<p>Turning the fading off via <code><preference name="FadeSplashScreen" value="false"/></code> technically means fading duration to be <code>0</code> so that in this example the overall splash screen delay will still be 3 seconds.</p>
-<p><em>Note</em>: This only applies to the app startup - you need to take the fading timeout into account when manually showing/hiding the splashscreen in the code:</p>
+<p><em>Note</em>: This only applies to the application startup - you need to take the fading timeout into account when manually showing/hiding the splash screen in your application's code:</p>
<div class="highlight"><pre><code class="language-javascript" data-lang="javascript"><span class="nb">navigator</span><span class="p">.</span><span class="nx">splashscreen</span><span class="p">.</span><span class="nx">show</span><span class="p">();</span>
<span class="nb">window</span><span class="p">.</span><span class="nx">setTimeout</span><span class="p">(</span><span class="kd">function</span> <span class="p">()</span> <span class="p">{</span>
<span class="nb">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="nx">splashDuration</span> <span class="o">-</span> <span class="nx">fadeDuration</span><span class="p">);</span>
+</code></pre></div></li>
+<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-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>
-<ul>
-<li><code>ShowSplashScreenSpinner</code> (boolean, defaults to <code>true</code>): Set to <code>false</code>
-to hide the splash-screen spinner.</li>
+<p><em>Note</em>: Does not work on Browser or Windows platforms.</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">"ShowSplashScreenSpinner"</span> <span class="na">value=</span><span class="s">"false"</span><span class="nt">/></span>
-</code></pre></div>
-<h3>Android Quirks</h3>
+
+<h3>Quirks</h3>
+
+<h4>Android Quirks</h4>
<p>In your <code>config.xml</code>, you can add the following preferences:</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"><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>
<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"white"</span> <span class="nt">/></span>
</code></pre></div>
-<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>
+<p><code>SplashMaintainAspectRatio</code> preference is optional. If set to <code>true</code>, the splash screen drawable is not stretched to fit the full 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>
-<p>The plugin reloads splash drawable whenever orientation changes, so you can specify different drawables for portrait and landscape orientations.</p>
+<p>The splash screen plugin reloads the splash screen whenever the orientation changes so that you can specify different splash screen images for portrait and landscape orientations.</p>
-<p>"SplashShowOnlyFirstTime" preference is also optional and defaults to <code>true</code>. When set to <code>true</code> splash screen will only appear on application launch. However, if you plan to use <code>navigator.app.exitApp()</code> to close application and force splash screen appear on next launch, you should set this property to <code>false</code> (this also applies to closing the App with Back button).</p>
+<p><code>SplashShowOnlyFirstTime</code> preference is optional and defaults to <code>true</code>. When set to <code>true</code> the splash screen will only appear on application launch. However, if you plan to use <code>navigator.app.exitApp()</code> to close the application and force the splash screen appear on the application's next launch, you should set this property to <code>false</code> (this also applies to closing the application with the Back button).</p>
-<p>"SplashScreenSpinnerColor" preference is also optional and is ignored when not set. Setting it to a valid color name or HEX color code will change the color of the spinner on Android 5.0+ devices.</p>
+<p><code>SplashScreenSpinnerColor</code> preference is also optional and is ignored when not set. Setting it to a valid color name or HEX color code will change the color of the spinner on Android 5.0+ devices.</p>
-<h3>Browser Quirks</h3>
+<h4>Browser Quirks</h4>
<p>You can use the following preferences in your <code>config.xml</code>:</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">"browser"</span><span class="nt">></span>
@@ -3240,26 +3269,25 @@ to hide the splash-screen spinner.</li>
</code></pre></div>
<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>iOS Quirks</h3>
+<h4>iOS Quirks</h4>
<ul>
-<li>In iOS, the splashscreen images are called launch images. These images are mandatory on iOS.</li>
+<li>In iOS, the splash screen images are called launch images. These images are mandatory on iOS.</li>
</ul>
-<h3>Windows Quirks</h3>
+<h4>Windows Quirks</h4>
<ul>
-<li><code>SplashScreenSpinnerColor</code> (string, defaults to system accent color): hash, rgb notation or CSS color name.</li>
-</ul>
+<li><p><code>SplashScreenSpinnerColor</code> (string, defaults to system accent color): hash, rgb notation or CSS color name.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"#242424"</span><span class="nt">/></span>
<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"DarkRed"</span><span class="nt">/></span>
<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"rgb(50,128,128)"</span><span class="nt">/></span>
-</code></pre></div>
-<ul>
-<li><code>SplashScreenBackgroundColor</code> (string, defaults to #464646): hex notation.</li>
-</ul>
+</code></pre></div></li>
+<li><p><code>SplashScreenBackgroundColor</code> (string, defaults to #464646): hex notation.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenBackgroundColor"</span> <span class="na">value=</span><span class="s">"0xFFFFFFFF"</span><span class="nt">/></span>
-</code></pre></div>
+</code></pre></div></li>
+</ul>
+
<h2>Methods</h2>
<ul>
@@ -3267,12 +3295,12 @@ to hide the splash-screen spinner.</li>
<li>splashscreen.hide</li>
</ul>
-<h2>splashscreen.hide</h2>
+<h3>splashscreen.hide</h3>
<p>Dismiss the splash screen.</p>
<div class="highlight"><pre><code class="language-js" data-lang="js"><span class="nb">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>iOS Quirk</h3>
+<h4>iOS Quirk</h4>
<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
@@ -3281,19 +3309,19 @@ timer such as the following in the <code
<span class="nb">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>
+<h3>splashscreen.show</h3>
<p>Displays the splash screen.</p>
<div class="highlight"><pre><code class="language-js" data-lang="js"><span class="nb">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
+<p>Your application cannot call <code>navigator.splashscreen.show()</code> until the application has
started and the <code>deviceready</code> event has fired. But since typically the splash
-screen is meant to be visible before your app has started, that would seem to
-defeat the purpose of the splash screen. Providing some configuration in
+screen is meant to be visible before your application has started, that would seem to
+defeat the purpose of the splash screen. Providing any parameters 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. 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>
+application is launched and before it has fully started and received the <code>deviceready</code>
+event. For this reason, it is unlikely you will need to call <code>navigator.splashscreen.show()</code> to make the splash
+screen visible for application startup.</p>
</div>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-statusbar/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-vibration/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-vibration/index.html?rev=1858924&r1=1858923&r2=1858924&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-vibration/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-vibration/index.html Wed May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-vibration/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
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=1858924&r1=1858923&r2=1858924&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 May 8 13:21:47 2019
@@ -1641,8 +1641,10 @@
+
+
- <a href="/docs/en/dev/reference/cordova-plugin-whitelist/index.html" class="">
+ <a href="/docs/en/dev/" class="missing-page">
<span class="selected">
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org