You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by st...@apache.org on 2018/03/02 14:29:11 UTC
svn commit: r1825729 [2/5] - in /cordova/site/public: ./ docs/en/dev/
docs/en/dev/config_ref/ docs/en/dev/cordova/events/
docs/en/dev/cordova/storage/ docs/en/dev/guide/appdev/hooks/
docs/en/dev/guide/appdev/privacy/ docs/en/dev/guide/appdev/security/ ...
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">×</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'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>
+
+<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 "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>
+
+<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"><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>
+</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 "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
+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 "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>
+<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 '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><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'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
+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 '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>
+
+<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"><widget</span> <span class="na">windows-packageVersion=</span><span class="s">"2.0.0"</span> <span class="err">...</span><span class="nt">></span> <span class="c"><!-- windows-packageVersion overrides version --></span>
+<span class="nt"><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">/></span> <span class="c"><!-- WindowsStoreIdentityName overrides widget.id --></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"><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>
+
+<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: "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>
+
+<p>Where:</p>
+
+<ul>
+<li>user : Specifies "current user" 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've associated with the certificate:</p>
+<div class="highlight"><pre><code class="language-powershell" data-lang="powershell">powershell -Command <span class="s2">" & {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'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'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's own:</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">"WindowsToastCapable"</span> <span class="na">value=</span><span class="s">"true"</span> <span class="nt">/></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 "Remote mode" for HTML applications. Prior to it, Windows 8.1 apps
+worked on what is now termed as "Local Mode" 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'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'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&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 © 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-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org