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 2015/05/13 00:53:06 UTC
[11/15] docs commit: CB-8486 docs for windows packaging
CB-8486 docs for windows packaging
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/9a4c7ecc
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/9a4c7ecc
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/9a4c7ecc
Branch: refs/heads/master
Commit: 9a4c7eccfb404e2875835a15b21bd68db2cbf878
Parents: da177f8
Author: Murat Sutunc <su...@gmail.com>
Authored: Mon May 11 11:52:19 2015 -0700
Committer: Murat Sutunc <su...@gmail.com>
Committed: Mon May 11 11:54:04 2015 -0700
----------------------------------------------------------------------
docs/en/edge/guide/platforms/index.md | 1 +
docs/en/edge/guide/platforms/win8/packaging.md | 59 +++++++++++++++++++
.../img/guide/platforms/win8/packaging.png | Bin 0 -> 59718 bytes
3 files changed, 60 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/9a4c7ecc/docs/en/edge/guide/platforms/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/index.md b/docs/en/edge/guide/platforms/index.md
index 4c3dc05..96eb6af 100644
--- a/docs/en/edge/guide/platforms/index.md
+++ b/docs/en/edge/guide/platforms/index.md
@@ -88,6 +88,7 @@ a lower-level alternative to the `cordova` command-line utility.
* Windows Platform Guide
* Windows Plugins
+* Windows Packaging
* Upgrading Windows 8
## Tizen
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/9a4c7ecc/docs/en/edge/guide/platforms/win8/packaging.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/win8/packaging.md b/docs/en/edge/guide/platforms/win8/packaging.md
new file mode 100644
index 0000000..d6494d4
--- /dev/null
+++ b/docs/en/edge/guide/platforms/win8/packaging.md
@@ -0,0 +1,59 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Packaging of Windows Store Apps
+
+You can learn more about signing and packaging of Windows Store Apps on [MSDN](https://msdn.microsoft.com/en-us/library/hh446593(v=vs.85).aspx).
+
+To be able to correctly package and sign Windows apps there are few things required:
+
+- A signing certificate
+- Identity details matching the provided signing certificate
+
+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.
+
+- Name
+- Publisher
+- Version
+
+*Name* and *Version* can be set from **config.xml**. *Publisher* can be provided as a build parameter or can be set on **build.json** file.
+
+![](img/guide/platforms/win8/packaging.png)
+
+A signing certificate can be provided from either CLI or through build.json file. The certificate related CLI flags are:
+
+- `--packageCertificateKeyFile` : Once a package signing certificate is created, this parameter can be used to associate the certificate with the app. This flag takes a file path as an argument. Eg. `> cordova build -- --packageCertificateKeyFile="platforms\windows\CordovaApp_TemporaryKey.pfx"`
+- `--packageThumbprint` : Package thumbprint is 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. Eg. `> cordova build -- --packageCertificateKeyFile="platforms\windows\CordovaApp_TemporaryKey.pfx" --packageThumbprint="ABCABCABCABC123123123123"`
+
+Alternatively, these values could be specified using a build configuration file (build.json) using CLI (--buildConfig). A sample build configuration file:
+
+ {
+ "windows": {
+ "debug": {
+ "packageCertificateKeyFile": "platforms\\windows\\CordovaApp_TemporaryKey.pfx"
+ },
+ "release": {
+ "packageCertificateKeyFile": "c:\\path-to-key\\keycert.pfx",
+ "packageThumbprint": "ABCABCABCABC123123123123",
+ "publisherId": "CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"
+ }
+ }
+ }
+
+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.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/9a4c7ecc/template/docs/default/img/guide/platforms/win8/packaging.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/platforms/win8/packaging.png b/template/docs/default/img/guide/platforms/win8/packaging.png
new file mode 100644
index 0000000..4b5a320
Binary files /dev/null and b/template/docs/default/img/guide/platforms/win8/packaging.png differ
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org