cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ste...@apache.org
Subject [11/15] docs commit: CB-8486 docs for windows packaging
Date Tue, 12 May 2015 22:53:06 GMT
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 <sutunc@gmail.com>
Authored: Mon May 11 11:52:19 2015 -0700
Committer: Murat Sutunc <sutunc@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


Mime
View raw message