cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From an-s...@apache.org
Subject docs commit: CB-12239 Add documentation about build flags for Windows
Date Fri, 16 Dec 2016 12:36:51 GMT
Repository: cordova-docs
Updated Branches:
  refs/heads/master d0ea3e5c7 -> bedbcc1f4


CB-12239 Add documentation about build flags for Windows

This closes #688


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/bedbcc1f
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/bedbcc1f
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/bedbcc1f

Branch: refs/heads/master
Commit: bedbcc1f42a57fd1bd5f71c4dba9010faf1aae07
Parents: d0ea3e5
Author: Vladimir Kotikov <kotikov.vladimir@gmail.com>
Authored: Tue Dec 6 17:58:31 2016 +0300
Committer: Vladimir Kotikov <kotikov.vladimir@gmail.com>
Committed: Fri Dec 16 15:36:29 2016 +0300

----------------------------------------------------------------------
 www/docs/en/dev/guide/platforms/win8/index.md | 33 +++++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bedbcc1f/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


Mime
View raw message