Added: 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=1825729&view=auto
==============================================================================
--- cordova/site/public/docs/en/dev/guide/platforms/windows/index.html (added)
+++ cordova/site/public/docs/en/dev/guide/platforms/windows/index.html Fri Mar  
2 14:29:10 2018
@@ -0,0 +1,2946 @@
+<!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=" ">
+
+    <title>
+        
+            
+                Windows Platform Guide - Apache Cordova
+            
+        
+    </title>
+
+    <link rel="SHORTCUT ICON" href="/favicon.ico"/>
+
+    
+
+    
+    
+        
+
+        
+    
+
+    <link rel="canonical" 
href="https://cordova.apache.org/docs/en/dev/guide/platforms/windows/";>
+
+    <!-- CSS -->
+    <link rel="stylesheet" type="text/css" href="/static/css/main.css">
+    <link rel="stylesheet" type="text/css" href="/static/css/lib/syntax.css">
+    <!-- Algolia Search CSS -->
+    <link rel="stylesheet" 
href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"; />
+
+    <!-- Fonts -->
+    <!-- For attribution information, see www/attributions.html -->
+    <link 
href='https://fonts.googleapis.com/css?family=Raleway:700,400,300,700italic,400italic,300italic'
 rel='stylesheet' type='text/css'>
+
+    <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media 
queries -->
+    <!--[if lt IE 9]>
+        <script 
src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js";></script>
+        <script 
src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js";></script>
+    <![endif]-->
+    <script type="text/javascript">
+        var disqus_developer = 1; // this would set it to developer mode
+    </script>
+
+    <!-- JS -->
+    <script defer type="text/javascript" 
src="/static/js/lib/jquery-2.1.1.min.js"></script>
+    <script defer type="text/javascript" 
src="/static/js/lib/bootstrap.min.js"></script>
+    <script defer type="text/javascript" 
src="/static/js/lib/ZeroClipboard.js"></script>
+
+    <script>
+    
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new 
Date();a=s.createElement(o),
+    
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+    
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+    ga('create', 'UA-64283057-3', 'auto');
+    ga('send', 'pageview');
+</script>
+
+</head>
+
+<body>
+    <header>
+    <a class="scroll-point pt-top" name="top"></a>
+    <nav class="navbar navbar-inverse navbar-fixed-top">
+        <div class="container-fluid">
+            <div class="navbar-header">
+                <button type="button" class="navbar-toggle collapsed" 
data-toggle="collapse" data-target="#navbar" aria-expanded="false" 
aria-controls="navbar">
+                    <span class="sr-only">Toggle navigation</span>
+                    <span class="icon-bar"></span>
+                    <span class="icon-bar"></span>
+                    <span class="icon-bar"></span>
+                </button>
+                <a class="navbar-brand" href="/"><img id="logo_top" 
src="/static/img/cordova-logo-newbrand.svg"/></a>
+            </div>
+            <div id="navbar" class="navbar-collapse collapse">
+                <div class="nav_bar_center">
+                    <ul class="nav navbar-nav">
+                        <li class="active">
+                            <a href="/docs/en/latest/">Documentation</a>
+                        </li>
+                        <li >
+                            <a href="/plugins">Plugins</a>
+                        </li>
+                        <li >
+                            <a href="/blog" id="blog_button">Blog<span 
class="badge" id="new_blog_count"></span></a>
+                        </li>
+                        <li >
+                            <a href="/contribute">Contribute</a>
+                        </li>
+                        <li>
+                            <a href="/#getstarted">Get Started</a>
+                        </li>
+                        <li>
+                            <form class="navbar-form navbar-right" 
id="header-search-form" role="search">
+                                <div class="input-group">
+                                    
+                                        
+                                    
+                                    <input id="header-search-field" 
type="text" placeholder="Search 'dev' docs..." class="form-control hidden-xs" 
autocomplete="off">
+                                </div>
+                            </form>
+                        </li>
+                    </ul>
+                </div>
+            </div><!--/.navbar-collapse -->
+        </div>
+    </nav>
+    <div id="_fixed_navbar_spacer" style="padding-top:50px"></div>
+</header>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="docs container">
+
+    <!-- Table of Contents -->
+    <div class="hidden-xs hidden-sm col-md-4 col-lg-3 site-toc-container">
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <span class="toc-section-heading">
+                Introduction
+            </span>
+        
+
+        
+        
+
+        
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/overview/index.html">
+                Overview
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+</ul>
+
+        
+    </li>
+    
+
+    <li>
+        
+            <span class="toc-section-heading">
+                Create apps
+            </span>
+        
+
+        
+        
+
+        
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/cli/index.html">
+                Create your first app
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/cli/template.html">
+                Templates for apps
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/support/index.html">
+                Platform support
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <span class="toc-section-heading">
+                Develop for platforms
+            </span>
+        
+
+        
+        
+
+        
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/platforms/android/index.html">
+                Android
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/platforms/ios/index.html">
+                iOS
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="this-page" 
href="../../../guide/platforms/windows/index.html">
+                Windows
+            </a>
+            
+                <span class="entry-highlight"></span>
+            
+        
+
+        
+        <div id="page-toc" class="page-toc"></div>
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/platforms/osx/index.html">
+                OS X
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+</ul>
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../platform_plugin_versioning_ref/index.html">
+                Manage versions and platforms
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../config_ref/images.html">
+                Customize icons
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../cordova/storage/storage.html">
+                Store data
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/appdev/privacy/index.html">
+                Manage privacy
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/appdev/security/index.html">
+                Manage security
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/appdev/whitelist/index.html">
+                Whitelisting
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+</ul>
+
+        
+    </li>
+    
+
+    <li>
+        
+            <span class="toc-section-heading">
+                Create plugins
+            </span>
+        
+
+        
+        
+
+        
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/hybrid/plugins/index.html">
+                Create a plugin
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <span class="toc-section-heading">
+                Develop for platforms
+            </span>
+        
+
+        
+        
+
+        
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/platforms/android/plugin.html">
+                Android
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/platforms/ios/plugin.html">
+                iOS
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/platforms/windows/plugin.html">
+                Windows
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+</ul>
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../plugin_ref/plugman.html">
+                Use Plugman
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+</ul>
+
+        
+    </li>
+    
+
+    <li>
+        
+            <span class="toc-section-heading">
+                Advanced Topics
+            </span>
+        
+
+        
+        
+
+        
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/hybrid/webviews/index.html">
+                Embed Cordova in native apps
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/next/index.html">
+                Next Steps
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+</ul>
+
+        
+    </li>
+    
+
+    <li>
+        
+            <span class="toc-section-heading">
+                Reference
+            </span>
+        
+
+        
+        
+
+        
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <a class="" href="../../../config_ref/index.html">
+                Config.xml
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../cordova/events/events.html">
+                Events
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../reference/cordova-cli/index.html">
+                CLI Reference
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../guide/appdev/hooks/index.html">
+                Hooks
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" href="../../../plugin_ref/spec.html">
+                Plugin.xml
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <span class="toc-section-heading">
+                Plugin APIs
+            </span>
+        
+
+        
+        
+
+        
+        <ul class="site-toc">
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-battery-status/index.html">
+                Battery Status
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-camera/index.html">
+                Camera
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-device/index.html">
+                Device
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-dialogs/index.html">
+                Dialogs
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-file/index.html">
+                File
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-geolocation/index.html">
+                Geolocation
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-inappbrowser/index.html">
+                Inappbrowser
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-media/index.html">
+                Media
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-media-capture/index.html">
+                Media Capture
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-network-information/index.html">
+                Network Information
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-screen-orientation/index.html">
+                Screen Orientation
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-splashscreen/index.html">
+                Splashscreen
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-statusbar/index.html">
+                Statusbar
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-vibration/index.html">
+                Vibration
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+
+    <li>
+        
+            <a class="" 
href="../../../reference/cordova-plugin-whitelist/index.html">
+                Whitelist
+            </a>
+            
+        
+
+        
+        
+
+        
+    </li>
+    
+</ul>
+
+        
+    </li>
+    
+</ul>
+
+        
+    </li>
+    
+</ul>
+
+    </div>
+
+    <!-- Page content -->
+    <div class="col-md-8 col-md-offset-4 col-lg-9 col-lg-offset-3 
page-content-container container">
+        <div class="page-content row">
+            <div class="col-md-offset-1 col-md-10">
+                <div class="content-header">
+
+                    <!-- ToC Dropdown (for XS and SM sizes only) -->
+                    <div class="toc-dropdown dropdown visible-xs-block 
visible-sm-block">
+                        <button class="btn btn-default dropdown-toggle" 
type="button" id="tocDropdown" data-toggle="dropdown" aria-haspopup="true" 
aria-expanded="true">
+                            Table of Contents
+                            <span class="caret"></span>
+                        </button>
+                        <ul class="dropdown-menu">
+                            
+
+
+
+
+<li>
+    <a class="" href="../../../guide/overview/index.html">
+        Overview
+    </a>
+</li>
+
+
+
+
+
+
+
+
+
+
+<li>
+    <a class="" href="../../../guide/cli/index.html">
+        Create your first app
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/cli/template.html">
+        Templates for apps
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/support/index.html">
+        Platform support
+    </a>
+</li>
+
+
+
+
+
+
+
+<li>
+    <a class="" href="../../../guide/platforms/android/index.html">
+        Android
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/platforms/ios/index.html">
+        iOS
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="this-page" href="../../../guide/platforms/windows/index.html">
+        Windows
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/platforms/osx/index.html">
+        OS X
+    </a>
+</li>
+
+
+
+
+
+
+
+<li>
+    <a class="" href="../../../platform_plugin_versioning_ref/index.html">
+        Manage versions and platforms
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../config_ref/images.html">
+        Customize icons
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../cordova/storage/storage.html">
+        Store data
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/appdev/privacy/index.html">
+        Manage privacy
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/appdev/security/index.html">
+        Manage security
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/appdev/whitelist/index.html">
+        Whitelisting
+    </a>
+</li>
+
+
+
+
+
+
+
+
+
+
+<li>
+    <a class="" href="../../../guide/hybrid/plugins/index.html">
+        Create a plugin
+    </a>
+</li>
+
+
+
+
+
+
+
+<li>
+    <a class="" href="../../../guide/platforms/android/plugin.html">
+        Android
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/platforms/ios/plugin.html">
+        iOS
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/platforms/windows/plugin.html">
+        Windows
+    </a>
+</li>
+
+
+
+
+
+
+
+<li>
+    <a class="" href="../../../plugin_ref/plugman.html">
+        Use Plugman
+    </a>
+</li>
+
+
+
+
+
+
+
+
+
+
+<li>
+    <a class="" href="../../../guide/hybrid/webviews/index.html">
+        Embed Cordova in native apps
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/next/index.html">
+        Next Steps
+    </a>
+</li>
+
+
+
+
+
+
+
+
+
+
+<li>
+    <a class="" href="../../../config_ref/index.html">
+        Config.xml
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../cordova/events/events.html">
+        Events
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-cli/index.html">
+        CLI Reference
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../guide/appdev/hooks/index.html">
+        Hooks
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../plugin_ref/spec.html">
+        Plugin.xml
+    </a>
+</li>
+
+
+
+
+
+
+
+<li>
+    <a class="" 
href="../../../reference/cordova-plugin-battery-status/index.html">
+        Battery Status
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-plugin-camera/index.html">
+        Camera
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-plugin-device/index.html">
+        Device
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-plugin-dialogs/index.html">
+        Dialogs
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-plugin-file/index.html">
+        File
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" 
href="../../../reference/cordova-plugin-geolocation/index.html">
+        Geolocation
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" 
href="../../../reference/cordova-plugin-inappbrowser/index.html">
+        Inappbrowser
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-plugin-media/index.html">
+        Media
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" 
href="../../../reference/cordova-plugin-media-capture/index.html">
+        Media Capture
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" 
href="../../../reference/cordova-plugin-network-information/index.html">
+        Network Information
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" 
href="../../../reference/cordova-plugin-screen-orientation/index.html">
+        Screen Orientation
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" 
href="../../../reference/cordova-plugin-splashscreen/index.html">
+        Splashscreen
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-plugin-statusbar/index.html">
+        Statusbar
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-plugin-vibration/index.html">
+        Vibration
+    </a>
+</li>
+
+
+
+
+<li>
+    <a class="" href="../../../reference/cordova-plugin-whitelist/index.html">
+        Whitelist
+    </a>
+</li>
+
+
+
+
+
+
+
+
+
+
+                        </ul>
+                    </div>
+
+                    
+                    
+
+                        
+                        
+                        
+                        
+                        
+
+                        
+                        
+
+                            
+                            
+                                
+                            
+
+                            <a class="edit" 
href="https://github.com/apache/cordova-docs/tree/master/www/docs/en/dev/guide/platforms/windows/index.md";><span
 class="glyphicon glyphicon-pencil" aria-hidden="true"></span> Edit Source on 
GitHub</a>
+                        
+                    
+
+                    <!-- Language dropdown -->
+                    <div class="dropdown">
+                        <button class="btn btn-default dropdown-toggle" 
type="button" id="languageDropdown" data-toggle="dropdown" aria-haspopup="true" 
aria-expanded="true">
+                            English
+                            <span class="caret"></span>
+                        </button>
+
+                        <!-- List all languages -->
+                        <ul class="dropdown-menu" 
aria-labelledby="languageDropdown">
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/de/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        Deutsch
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/en/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        <span class="selected">
+                                            English
+                                        </span>
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/es/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        Español
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/fr/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        Français
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/it/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        Italiano
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/ja/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        日本語
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/ko/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        한국어
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/pl/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        Polski
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/ru/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        Русский
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/sl/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        Slovene
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/zh-cn/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        简体中文
+                                    
+                                </a>
+                            </li>
+                            
+
+                            
+                            
+                            
+                            
+
+                            
+
+                            
+                            
+
+                            <li>
+                                <a 
href="/docs/zh-tw/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        繁體中文
+                                    
+                                </a>
+                            </li>
+                            
+                        </ul>
+                    </div>
+
+                    <!-- Version dropdown -->
+                    <div class="dropdown">
+                        <button class="btn btn-default dropdown-toggle" 
type="button" id="versionDropdown" data-toggle="dropdown" aria-haspopup="true" 
aria-expanded="true">
+                            dev
+                            
+                            <span class="caret"></span>
+                        </button>
+                        <ul class="dropdown-menu" 
aria-labelledby="versionDropdown">
+
+                            <!-- List versions available in this language -->
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+
+                                <a 
href="/docs/en/dev/guide/platforms/windows/index.html" class="">
+                                    
+                                        <span class="selected">
+                                            
+                                    dev
+                                    
+                                
+                                        </span>
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/latest/" 
class="missing-page">
+                                    
+                                        
+                                    7.x
+                                    
+                                        (Latest)
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/6.x/" class="missing-page">
+                                    
+                                        
+                                    6.x
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/5.4.0/" class="missing-page">
+                                    
+                                        
+                                    5.4.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/5.1.1/" class="missing-page">
+                                    
+                                        
+                                    5.1.1
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/5.0.0/" class="missing-page">
+                                    
+                                        
+                                    5.0.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/4.0.0/" class="missing-page">
+                                    
+                                        
+                                    4.0.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/3.6.0/" class="missing-page">
+                                    
+                                        
+                                    3.6.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/3.5.0/" class="missing-page">
+                                    
+                                        
+                                    3.5.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/3.4.0/" class="missing-page">
+                                    
+                                        
+                                    3.4.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/3.3.0/" class="missing-page">
+                                    
+                                        
+                                    3.3.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/3.2.0/" class="missing-page">
+                                    
+                                        
+                                    3.2.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/3.1.0/" class="missing-page">
+                                    
+                                        
+                                    3.1.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/3.0.0/" class="missing-page">
+                                    
+                                        
+                                    3.0.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.9.0/" class="missing-page">
+                                    
+                                        
+                                    2.9.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.8.0/" class="missing-page">
+                                    
+                                        
+                                    2.8.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.7.0/" class="missing-page">
+                                    
+                                        
+                                    2.7.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.6.0/" class="missing-page">
+                                    
+                                        
+                                    2.6.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.5.0/" class="missing-page">
+                                    
+                                        
+                                    2.5.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.4.0/" class="missing-page">
+                                    
+                                        
+                                    2.4.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.3.0/" class="missing-page">
+                                    
+                                        
+                                    2.3.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.2.0/" class="missing-page">
+                                    
+                                        
+                                    2.2.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.1.0/" class="missing-page">
+                                    
+                                        
+                                    2.1.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/2.0.0/" class="missing-page">
+                                    
+                                        
+                                    2.0.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/1.9.0/" class="missing-page">
+                                    
+                                        
+                                    1.9.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/1.8.1/" class="missing-page">
+                                    
+                                        
+                                    1.8.1
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/1.8.0/" class="missing-page">
+                                    
+                                        
+                                    1.8.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/1.7.0/" class="missing-page">
+                                    
+                                        
+                                    1.7.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/1.6.1/" class="missing-page">
+                                    
+                                        
+                                    1.6.1
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/1.6.0/" class="missing-page">
+                                    
+                                        
+                                    1.6.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                            <li>
+                                
+                                
+                                    
+                                
+
+                                
+
+                                
+                                
+                                
+
+                                
+                                    
+                                
+
+                                <a href="/docs/en/1.5.0/" class="missing-page">
+                                    
+                                        
+                                    1.5.0
+                                    
+                                
+                                    
+                                </a>
+                            </li>
+                            
+                        </ul>
+                    </div>
+                </div>
+
+                
+                
+                
+
+                
+                
+                    
+                
+
+                <!-- Show warnings for special versions -->
+                <!-- dev warning -->
+                
+                    <div class="alert docs-alert alert-info" role="alert">
+                        <button type="button" class="close" 
data-dismiss="alert" aria-label="Close">
+                            <span aria-hidden="true">&times;</span>
+                        </button>
+                        This version of the documentation is under development!
+                        <a href="/docs/en/latest/">
+                            Click here for the latest released version.
+                        </a>
+                    </div>
+                
+
+                <!-- outdated warning -->
+                
+
+                <!-- plugin version warning -->
+                
+
+                <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&#39;s
+powerful debugger to test any web content that doesn&#39;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>
+
+<h2>Requirements and Support</h2>
+
+<p>To develop apps for Windows platform 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>
+</ul>
+
+<p>To develop apps for Windows 10:</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>
+</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 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>
+</ul>
+
+<h2>Installing the Requirements</h2>
+
+<p>Install any edition of
+<a href="http://www.visualstudio.com/downloads";>Visual Studio</a> matching the 
version
+requirements listed above.</p>
+
+<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 &quot;Windows 
and Web Development&quot; heading.</p>
+
+<p><br/><p align="center"><img 
src="/static/img/guide/platforms/windows/win8_installTools.png" /></p><br/></p>
+
+<h2>Project Configuration</h2>
+
+<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 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">&lt;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">/&gt;</span>
+</code></pre></div>
+<p>Once you add this setting <code>build</code> command will start producing 
Windows 10 packages.</p>
+
+<h3>Considerations for target Windows version</h3>
+
+<p>Windows 10 supports a new &quot;Remote&quot; 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
+of inline script, but does so by reducing the set of capabilities your app may 
use when
+submitted to the public Windows Store. For more information about Windows 10 
and Remote Mode, look at
+the <a href="#understanding-remote-mode-vs-local-mode">Understanding Remote 
Mode vs Local Mode</a> section.</p>
+
+<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
+</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
+</code></pre></div>
+<p>This allows you to run the application on a specific device or emulator, in 
this case &quot;Emulator 8.1 720p 4.7 inch&quot;</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>
+<p>You can also use <strong>cordova run --help</strong> to see additional 
build and run options.</p>
+
+<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><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><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 &#39;solution&#39; (topmost entry in the solution explorer) and then going 
into &#39;Properties&#39;. Here you can update the &#39;Single start up&#39; 
field. The controls below Visual Studio&#39;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&#39; 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>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><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><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&#39;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&#39;s
+command-line tools or the SDK in your workflow. The Cordova CLI relies
+on cross-platform source code that routinely overwrites the
+platform-specific files used by the SDK. If you want to use the SDK to
+modify the project, use the lower-level shell tools as an alternative
+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><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 &#39;Lifecycle 
event&#39; 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>
+
+<p>You can learn more about signing and packaging of Windows Store Apps on <a 
href="https://msdn.microsoft.com/en-us/library/hh446593(v=vs.85).aspx">MSDN</a>.</p>
+
+<p>To be able to correctly package and sign Windows apps there are few things 
required:</p>
+
+<ul>
+<li>A signing certificate</li>
+<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>
+
+<ul>
+<li>Name</li>
+<li>Publisher</li>
+<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><img src="/static/img/guide/platforms/windows/packaging.png" alt=""></p>
+
+<p><em>Name</em> and <em>Version</em> can also be set as platform-specific 
preferences in <strong>config.xml</strong> in the following way:</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span 
class="nt">&lt;widget</span> <span 
class="na">windows-packageVersion=</span><span class="s">"2.0.0"</span> <span 
class="err">...</span><span class="nt">&gt;</span> <span class="c">&lt;!-- 
windows-packageVersion overrides version --&gt;</span>
+<span class="nt">&lt;preference</span> <span class="na">name=</span><span 
class="s">"WindowsStoreIdentityName"</span> <span class="na">value=</span><span 
class="s">"12345FakeCorp.CoolApp"</span><span class="nt">/&gt;</span> <span 
class="c">&lt;!-- WindowsStoreIdentityName overrides widget.id --&gt;</span>
+</code></pre></div>
+<p><em>PublisherDisplayName</em> and <em>DisplayName</em> can also be 
overriden:</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span 
class="nt">&lt;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">/&gt;</span> <span class="c">&lt;!-- WindowsStorePublisherName 
overrides author --&gt;</span>
+<span class="nt">&lt;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">/&gt;</span> <span class="c">&lt;!-- 
WindowsStorePublisherName overrides name --&gt;</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>
+
+<table><thead>
+<tr>
+<th>Parameter</th>
+<th>Flag</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>Certificate File</td>
+<td><code>--packageCertificateKeyFile</code></td>
+<td>Path to the package signing certificate to be associated with the app</td>
+</tr>
+<tr>
+<td>Thumb Print</td>
+<td><code>--packageThumbprint</code></td>
+<td>Used to validate the authenticity of package certificate key file. When 
creating a certificate key file, this value will be provided to the end 
user</td>
+</tr>
+</tbody></table>
+
+<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>
+<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">
+            </span><span class="s2">"packageCertificateKeyFile"</span><span 
class="p">:</span><span class="w"> </span><span 
class="s2">"platforms</span><span class="se">\\</span><span 
class="s2">windows</span><span class="se">\\</span><span 
class="s2">CordovaApp_TemporaryKey.pfx"</span><span class="w">
+        </span><span class="p">},</span><span class="w">
+        </span><span class="s2">"release"</span><span class="p">:</span><span 
class="w"> </span><span class="p">{</span><span class="w">
+            </span><span class="s2">"packageCertificateKeyFile"</span><span 
class="p">:</span><span class="w"> </span><span class="s2">"c:</span><span 
class="se">\\</span><span class="s2">path-to-key</span><span 
class="se">\\</span><span class="s2">keycert.pfx"</span><span 
class="p">,</span><span class="w">
+            </span><span class="s2">"packageThumbprint"</span><span 
class="p">:</span><span class="w"> </span><span 
class="s2">"ABCABCABCABC123123123123"</span><span class="p">,</span><span 
class="w">
+            </span><span class="s2">"publisherId"</span><span 
class="p">:</span><span class="w"> </span><span class="s2">"CN=FakeCorp.com, 
L=Redmond, S=Washington, C=US"</span><span class="w">
+        </span><span class="p">}</span><span class="w">
+    </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>
+
+<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>Once you have the pfx file created and provided to build.json file, you 
might get the following error: &quot;The key file may be password protected. To 
correct this, try to import the certificate manually into the current 
user&#39;s personal certificate  store.&quot;. 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>
+
+<p>Where:</p>
+
+<ul>
+<li>user : Specifies &quot;current user&quot; personal store</li>
+<li>p : Password for 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&#39;ve associated with the 
certificate:</p>
+<div class="highlight"><pre><code class="language-powershell" 
data-lang="powershell">powershell -Command <span class="s2">" &amp; {dir -path 
cert:\CurrentUser\My | where { </span><span class="nv">$_</span><span 
class="s2">.Subject -like \"</span><span class="k">*</span>FakeCorp.com<span 
class="k">*</span>\<span class="s2">" }}"</span>
+</code></pre></div>
+<p>Once these final values are provided. Cordova should successfully package 
and sign the app.</p>
+
+<h2>MSBuild build flags</h2>
+
+<p>Similar to other platforms (<a 
href="../android/index.html#setting-gradle-properties"><code>--gradleArg</code> 
on Android</a>, <a 
href="../ios/index.html#xcode-build-flags"><code>--buildFlag</code> on iOS</a>) 
you can pass custom flags to MSBuild. To do this you have two options:</p>
+
+<ul>
+<li><p>add one or more <code>--buildFlag</code> options to <code>cordova build 
windows</code> or <code>cordova run windows</code> commands:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">  cordova 
build windows -- --buildFlag /clp:Verbosity=normal --buildFlag 
/p:myCustomProperty=Value
+  cordova run windows -- --buildFlag /clp:Verbosity=minimal
+</code></pre></div></li>
+<li><p>add <code>buildFlag</code> option to <code>build.json</code> file:</p>
+<div class="highlight"><pre><code class="language-json" data-lang="json"><span 
class="w">  </span><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">
+        </span><span class="s2">"buildFlag"</span><span 
class="p">:</span><span class="w"> </span><span class="p">[</span><span 
class="w">
+            </span><span class="s2">"/clp:Verbosity=normal"</span><span 
class="p">,</span><span class="w">
+            </span><span class="s2">"/p:myCustomProperty=Value"</span><span 
class="w">
+        </span><span class="p">]</span><span class="w">
+      </span><span class="p">}</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+</span></code></pre></div></li>
+</ul>
+
+<p>Note that <code>cordova-windows</code> appends build flags from 
<code>build.json</code> and CLI arguments in specific order. In particular, 
flags from <code>build.json</code> are being appended <em>before</em> build 
flags from CLI, which basically means that CLI flags <em>override</em> ones 
from <code>build.json</code> in case of any conflicts.</p>
+
+<p>For the list of MSBuild&#39;s available command-line options please refer 
to <a href="https://msdn.microsoft.com/library/ms164311.aspx";>official MSBuild 
command-line reference</a>.</p>
+
+<h2>Platform Centered Workflow</h2>
+
+<p>If you want to use Cordova&#39;s Windows-centered shell tools in 
conjunction with the SDK, you have two basic options:</p>
+
+<ul>
+<li><p>Access them locally from project code generated by the CLI. They are
+available in the <code>platforms/windows/</code> directory after you add
+the <code>windows</code> platform as described below.</p></li>
+<li><p>Download them from a separate distribution
+<a href="https://www.apache.org/dist/cordova/platforms/";>here</a>.
+The Cordova distribution contains separate archives for each platform.
+Be sure to expand the appropriate archive, <code>cordova-windows</code> in
+this case, within an empty directory.  The relevant batch utilities
+are available in <code>package/bin</code> directory. (Consult the
+<strong>README</strong> file if necessary for more detailed 
directions.)</p></li>
+</ul>
+
+<p>These shell tools allow you to create, build, and run Windows apps. Each 
cordova command corresponds to one of these shell tool scripts.</p>
+
+<p>For example, the lower-level shell-tool approach corresponding to 
<code>cordova create HelloWorld</code> is:</p>
+<div class="highlight"><pre><code class="language-" 
data-lang="">C:\path\to\cordova-windows\package\bin\create.bat 
C:\path\to\new\hello HelloWorld
+</code></pre></div>
+<p>Similarly for <code>cordova build --debug</code>:</p>
+<div class="highlight"><pre><code class="language-" 
data-lang="">C:\path\to\project\cordova\build.bat --debug
+</code></pre></div>
+<h2>Upgrading</h2>
+
+<p>Refer to <a href="upgrade.html">this</a> article for instructions to 
upgrade your <code>cordova-windows</code> version.</p>
+
+<h2>Supporting Toasts</h2>
+
+<p>Windows requires an app manifest capability declaration in order to support
+toast notifications.  When using the 
<code>cordova-plugin-local-notifications</code>
+plugin, or any other plugin that is attempting to use toast notifications,
+add the following preference to your config.xml to enable it to publish
+toast notifications, unless the plugin makes that change on it&#39;s own:</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span 
class="nt">&lt;preference</span> <span class="na">name=</span><span 
class="s">"WindowsToastCapable"</span> <span class="na">value=</span><span 
class="s">"true"</span> <span class="nt">/&gt;</span>
+</code></pre></div>
+<p>This preference sets the corresponding flag in your app manifest. Plugins
+should do the work necessary to configure the appearance of the
+displayed notifications.</p>
+
+<h2>Understanding Remote Mode vs Local Mode</h2>
+
+<p>Windows 10 introduces a new feature called &quot;Remote mode&quot; for HTML 
applications. Prior to it, Windows 8.1 apps
+worked on what is now termed as &quot;Local Mode&quot; in Windows 10, in which 
HTML Applications have full access to the native
+Windows API surface and capabilities. Local Mode disallows inline script in 
order to prevent script injection attacks,
+which could result in leaking personally-identifiable information due to 
malicious code. It also requires developers who
+perform DOM manipulation to do so within an explicit context
+(<code>MSApp.execUnsafeLocalFunction</code>).</p>
+
+<p>Remote Mode eliminates those requirements, which makes it possible to use 
unmodified libraries like jQuery
+or AngularJS directly in your code, without any changes.  To do so, it removes 
your ability to declare certain
+capabilities when certifying your app in the Windows Store.  The removal of 
these capabilities usually doesn&#39;t
+prevent accessing certain functionality, but it might require the use of a 
different combination of APIs or tactics.</p>
+
+<h2>Effect of Remote Mode on capabilities</h2>
+
+<p>The following capabilities are unavailable when deploying your Remote Mode 
application to the Windows Store:</p>
+
+<ul>
+<li>Enterprise Authentication (<code>enterpriseAuthentication</code>)</li>
+<li>Shared User Certificates (<code>sharedUserCertificates</code>)</li>
+<li>Documents Library (<code>documentsLibrary</code>)</li>
+<li>Music Library (<code>musicLibrary</code>)</li>
+<li>Pictures Library (<code>picturesLibrary</code>)</li>
+<li>Videos Library (<code>videosLibrary</code>)</li>
+<li>Removable <a href="../../../cordova/storage/storage.html">Storage</a> 
(<code>removableStorage</code>)</li>
+<li>Internet client/server (<code>internetClientServer</code>) - note that 
<code>internetClient</code> is still permitted</li>
+<li>Private network client/server 
(<code>privateNetworkClientServer</code>)</li>
+</ul>
+
+<p>Each of the library restrictions may be worked around by requesting that 
the user interact with the file system via a <a 
href="https://msdn.microsoft.com/en-us/library/windows/apps/windows.storage.pickers.fileopenpicker.aspx";>File
 Picker</a>.  This prevents malicious injected code from arbitrarily accessing 
the file system.</p>
+
+<p>The network-related restrictions must be worked around by either using an 
API that doesn&#39;t use capability checks or by brokering communication via 
standard internet communication channels, such as <code>XMLHttpRequest</code> 
or Web Sockets.</p>
+
+<p>The Enterprise Authentication and Shared User Certificates capabilities are 
specifically targeted at Enterprise scenarios.  These capabilities are 
supported for private/enterprise-enabled App Stores, so if you are building 
apps which are going to be deployed to an internal deployment mechanism, you 
can still support these.  However, they are not supported for Remote Mode apps 
in the public Windows Store.  When you build targeting Windows 10, if one of 
these capabilities is detected in your app manifest, a warning will be 
displayed.</p>
+
+
+                </div>
+            </div>
+        </div>
+        <div class="row">
+            <div class="blue-divider"></div>
+<footer>
+    <div class="container-fluid">
+        <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="http://www.apache.org/dyn/closer.cgi/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&amp;q=cordova-";>Source 
Code</a></li>
+                    <li><a target="_blank" 
href="https://issues.apache.org/jira/browse/CB/";>Issue Tracker</a></li>
+                    <li><a target="_blank" 
href="http://stackoverflow.com/questions/tagged/cordova";>Stack Overflow</a></li>
+                    <li><a href="/contact">Mailing List</a></li>
+                    <li><a href="/contribute/nightly_builds.html">Nightly 
builds</a></li>
+                </ul>
+            </div>
+            <div class="col-sm-4">
+                <h2>Apache Software Foundation</h2>
+                <ul class="nav">
+                    <li>
+                        <a target="_blank" href="http://www.apache.org/";>About 
ASF</a>
+                    </li>
+                    <li>
+                        <a target="_blank" 
href="http://www.apache.org/foundation/sponsorship.html";>Become a Sponsor</a>
+                    </li>
+                    <li>
+                        <a target="_blank" 
href="http://www.apache.org/foundation/thanks.html";>Thanks</a>
+                    </li>
+                    <li>
+                        <a target="_blank" 
href="http://www.apache.org/security/";>Security</a>
+                    </li>
+                </ul>
+            </div>
+        </div>
+    </div>
+    <div class="col-sm-3">
+        <h1>Contribute</h1>
+        <p style="padding-top:20px"><strong>Help Cordova move 
forward!</strong></p>
+        <p>Report bugs, improve the docs, or contribute to the code.</p>
+        <a href="/contribute" class="btn btn-lg btn-primary">
+            Learn More
+        </a>
+        <p style="padding-top:20px"> <a 
href="https://twitter.com/apachecordova"; class="twitter-follow-button" 
data-show-count="false">Follow @apachecordova</a></p>
+        <script async defer 
src="https://slack-cordova-io.herokuapp.com/slackin.js";></script>
+    </div>
+</div>
+<p class="copyright_text">
+    Copyright &copy; 2012, 2013, 2015 The Apache Software Foundation, Licensed 
under the <a target="_blank" 
href="http://www.apache.org/licenses/LICENSE-2.0";>Apache License, Version 
2.0</a>.<br/>
+    Apache and the Apache feather logos are <a target="_blank" 
href="http://www.apache.org/foundation/marks/list/";>trademarks</a> of The 
Apache Software Foundation.
+    <br/>
+    "Raleway" font used under license. For details see the <a 
href="/attributions/">attributions page</a>.
+</p>
+
+    </div>
+</footer>
+
+        </div>
+    </div>
+</div>
+
+<script defer type="text/javascript" src="/static/js/lib/toc.min.js"></script>
+<script defer type="text/javascript" src="/static/js/docs.js"></script>
+
+    <script defer type="text/javascript" src="/static/js/index.js"></script>
+    <script defer type="text/javascript" src="/static/js/twitter.js"></script>
+    
+    
+
+
+
+    
+
+
+<script type="text/javascript" 
src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js";></script>
+<script type="text/javascript">
+    docsearch({
+        apiKey: '0a916ab198bd93d031aa70611271e42e',
+        indexName: 'cordova',
+        inputSelector: '#header-search-field',

[... 7 lines stripped ...]


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org

Reply via email to