[signing] windows

configuring/preferences.md

@@ -47,7 +47,7 @@ This fragment will make the iOS app be available in landscape orientation while
   <tr>
     <td><code>phonegap-version</code></td>
     <td>
-      Currently supported versions are <b>3.0.0</b>, <b>3.0.0</b>, <b>3.1.0</b>, <b>3.2.0</b>, <b>3.3.0</b>, <b>3.4.0</b>, <b>3.5.0</b>, <b>3.6.3</b>, <b>3.7.0</b>, <b>cli-5.1.1</b>, and <b>cli-5.2.0</b>  (default) 
+      You can find [currently supported versions here](https://build.phonegap.com/current-support).
       If you don't specify a version in your config, it will be set
       to the current default version. Your app will not build if you specify
       an unsupported version number.
@@ -258,3 +258,32 @@ This fragment will make the iOS app be available in landscape orientation while
   </tr>
 
 </table>
+
+
+## Windows 10 Only
+
+<table class="table">
+
+  <tr>
+    <td><code>windows-arch</code><br/>(windows only)</td>
+    <td>
+       Select the architecture that your build targets. Valid values are `anycpu`, `arm`, `x86`, and `x64`
+      <br/><br/>
+      Example:
+      <br/>
+      <code>&lt;preference name="windows-arch" value="x86" /&gt;</code>
+    </td>
+  </tr>
+
+  <tr>
+    <td><code>windows-identity-name</code><br/>(windows only)</td>
+    <td>
+       Set the App Idenity Name in your App Manifest, necessary for publishing to the App Store. This preference must match the App Identity Name from your *Windows Dev Center Account -> App Management -> App Identity*.
+      <br/><br/>
+      Example:
+      <br/>
+      <code>&lt;preference name="windows-identity-name" value="PhonegapBuild.PhoneGapBuild" /&gt;</code>
+    </td>
+  </tr>
+
+</table>

index.md

@@ -111,6 +111,12 @@ license: Licensed to the Apache Software Foundation (ASF) under one
               Learn how to sign your Android application on Build.
             </span>
         </li>
+        <li>
+            <h2>[Windows Signing]</h2>
+            <span>
+              Learn how to sign your Windows 10 and Windows Phone application on Build.
+            </span>
+        </li>
     </ul>
     <h1>Debugging</h1>
     <ul>

signing/signing-windows.md

@@ -0,0 +1,32 @@
+# Windows Signing
+
+- [Windows 10 (Universal) Signing](#windows): `phonegap-version cli-6.1.0` and greater
+- [Windows Phone 8.0/8.1 Signing](#winphone8): `phonegap-version cli-6.0.0` and below
+
+<a id="windows"></a>
+## Windows 10 (Universal) Signing
+
+
+Windows builds have a slightly more involved signing process than the previous Windows Phone Publisher ID method, which was a simple GUID setting. A .pfx certificate file is now required to sign your app and distribute it to the App Store. [This article on MSDN](https://msdn.microsoft.com/en-us/library/windows/desktop/jj835832(v=vs.85).aspx) explains how to create a PFX store file. Ensure the Subject Name of your signing certificate matches the Windows Publisher ID from your [Microsoft Developer Account](https://developer.microsoft.com/en-us/dashboard/account/management).
+
+Go to your [PhoneGap Build Account Settings](https://buildstage.phonegap.com/people/edit), select the **Signing Keys** tab, upload your **Windows 10** pfx key and unlock it, and select it when building your application.
+
+**In addition:**
+
+1. The `author` field in your config.xml must match the Publisher Display Name from *Windows Dev Center -> Account Settings*, i.e:
+
+    ```&gt;author&lt;Adobe Systems Canada Inc</author>```
+
+2. A new config.xml preference `windows-identity-name` has been introduced to set the App Idenity Name in your App Manifest. This preference must match the App Identity Name from your *Windows Dev Center Account -> App Management -> App Identity*:
+
+	```<preference name="windows-identity-name" value="PhonegapBuild.PGBDeveloper" />```
+
+<a id="winphone8"></a>
+## Windows Phone 8.0/8.1 Signing
+
+1. Log into the [Windows Dev Center](http://dev.windows.com), and click **Dashboard** in the top right.
+2. Click **Account Settings**.
+3. Copy the **Windows Publisher ID** field.
+4. Add the Publisher ID to your Signing Keys in your [PhoneGap Build Account Settings](https://build.phonegap.com/people/edit).
+5. Build your app using the newly added Windows Publisher ID, selected in a dropdown in your App details.
+6. Upload the resulting xap/appx file to the Windows Dev Center.