You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by an...@apache.org on 2016/12/13 10:52:55 UTC
docs commit: CB-12239 Add documentation about build flags for Windows
Repository: cordova-docs
Updated Branches:
refs/heads/CB-12239 [created] 9fc8b3aaf
CB-12239 Add documentation about build flags for Windows
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/9fc8b3aa
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/9fc8b3aa
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/9fc8b3aa
Branch: refs/heads/CB-12239
Commit: 9fc8b3aafaf75091ce03aa68d474f7bd7943d517
Parents: d0ea3e5
Author: Vladimir Kotikov <ko...@gmail.com>
Authored: Tue Dec 6 17:58:31 2016 +0300
Committer: Vladimir Kotikov <ko...@gmail.com>
Committed: Tue Dec 13 13:52:32 2016 +0300
----------------------------------------------------------------------
www/docs/en/6.x/guide/platforms/win8/index.md | 3 +-
www/docs/en/dev/guide/platforms/win8/index.md | 33 +++++++++++++++++++++-
2 files changed, 34 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/9fc8b3aa/www/docs/en/6.x/guide/platforms/win8/index.md
----------------------------------------------------------------------
diff --git a/www/docs/en/6.x/guide/platforms/win8/index.md b/www/docs/en/6.x/guide/platforms/win8/index.md
index d227445..f2cf45f 100644
--- a/www/docs/en/6.x/guide/platforms/win8/index.md
+++ b/www/docs/en/6.x/guide/platforms/win8/index.md
@@ -370,4 +370,5 @@ The network-related restrictions must be worked around by either using an API th
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.
[1]: https://msdn.microsoft.com/en-us/library/hh446593(v=vs.85).aspx
-[2]: https://technet.microsoft.com/en-us/library/ee624045(v=ws.10).aspx
\ No newline at end of file
+[2]: https://technet.microsoft.com/en-us/library/ee624045(v=ws.10).aspx
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/9fc8b3aa/www/docs/en/dev/guide/platforms/win8/index.md
----------------------------------------------------------------------
diff --git a/www/docs/en/dev/guide/platforms/win8/index.md b/www/docs/en/dev/guide/platforms/win8/index.md
index d227445..030749c 100644
--- a/www/docs/en/dev/guide/platforms/win8/index.md
+++ b/www/docs/en/dev/guide/platforms/win8/index.md
@@ -287,6 +287,37 @@ powershell -Command " & {dir -path cert:\LocalMachine\My | where { $_.Subject -l
Once these final values are provided. Cordova should successfully package and sign the app.
+## MSBuild build flags
+
+Similar to other platforms ([`--gradleArg` on Android](../android/index.html#setting-gradle-properties), [`--buildFlag` on iOS](../ios/index.html#xcode-build-flags)) you can pass custom flags to MSBuild. To do this you have two options:
+
+- add one or more `--buildFlag` options to `cordova build windows` or `cordova run windows` commands:
+
+ ```
+ cordova build windows -- --buildFlag /clp:Verbosity=normal --buildFlag /p:myCustomProperty=Value
+ cordova run windows -- --buildFlag /clp:Verbosity=minimal
+ ```
+
+- add `buildFlag` option to `build.json` file:
+
+ ```json
+ {
+ "windows": {
+ "debug": {
+ "buildFlag": [
+ "/clp:Verbosity=normal",
+ "/p:myCustomProperty=Value"
+ ]
+ }
+ }
+ }
+ ```
+
+
+Note that `cordova-windows` appends build flags from `build.json` and CLI arguments in specific order. In particular, flags from `build.json` are being appended _before_ build flags from CLI, which basically means that CLI flags _override_ ones from `build.json` in case of any conflicts.
+
+For the list of MSBuild's available command-line options please refer to [official MSBuild command-line reference](https://msdn.microsoft.com/library/ms164311.aspx).
+
## Platform Centered Workflow
If you want to use Cordova's Windows-centered shell tools in conjunction with the SDK, you have two basic options:
@@ -370,4 +401,4 @@ The network-related restrictions must be worked around by either using an API th
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.
[1]: https://msdn.microsoft.com/en-us/library/hh446593(v=vs.85).aspx
-[2]: https://technet.microsoft.com/en-us/library/ee624045(v=ws.10).aspx
\ No newline at end of file
+[2]: https://technet.microsoft.com/en-us/library/ee624045(v=ws.10).aspx
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org