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 Tue, 13 Dec 2016 10:52:55 GMT
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 <kotikov.vladimir@gmail.com>
Authored: Tue Dec 6 17:58:31 2016 +0300
Committer: Vladimir Kotikov <kotikov.vladimir@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


Mime
View raw message