Skip to content

Commit c7f8432

Browse files
committed
chore: windows help
1 parent 95cc0ed commit c7f8432

1 file changed

Lines changed: 10 additions & 2 deletions

File tree

docs/man_pages/project/testing/build-windows.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,18 @@ Builds the project for Windows and produces an MSIX package that you can deploy
1515

1616
Usage | Synopsis
1717
---|---
18-
General | `$ ns build windows [--release] [--env.*]`
18+
General | `$ ns build windows [--release [--certificate <File Path> --certificate-password <Password>] [--certificate-thumbprint <Thumbprint>] [--store-upload] [--msixbundle]] [--arch <Architecture>] [--copy-to <File Path>] [--env.*]`
1919

2020
### Options
2121

22-
* `--release` - If set, produces a release build. Otherwise, produces a debug build with DevTools support enabled.
22+
* `--release` - If set, produces a release build and packages it as an MSIX. By default this produces a sideloadable `.msix` (sign it with the `--certificate*` options); pass `--store-upload` to produce a `.msixupload` bundle for the Microsoft Store instead. Without `--release`, produces a debug build with DevTools support enabled.
23+
* `--certificate` - Specifies the file path to the code-signing certificate (`.pfx`) used to sign the release MSIX. Path is resolved relative to the project directory if not absolute. Used together with `--release`.
24+
* `--certificate-password` - Provides the password for the certificate specified with `--certificate`.
25+
* `--certificate-thumbprint` - Signs the release MSIX using an already-installed certificate identified by its thumbprint, instead of a `.pfx` file. Used together with `--release`. Takes precedence over `--certificate`.
26+
* `--store-upload` - When set with `--release`, produces an unsigned `.msixupload` bundle for submission to the Microsoft Store (the Store re-signs it). No local certificate is required.
27+
* `--msixbundle` - When set with `--release`, produces an MSIX bundle (`.msixbundle`). Implied by `--store-upload`.
28+
* `--arch` - Sets the target architecture for the build (for example `x64`, `arm64`). Defaults to `x64`.
29+
* `--copy-to` - Specifies the file path where the built package will be copied. If it points to a non-existent directory path, it will be created. If the specified value is an existing directory, the original file name will be used.
2330
* `--env.*` - Specifies additional flags that the bundler may process. Can be passed multiple times. Supported additional flags:
2431
* `--env.aot` - creates Ahead-Of-Time build (Angular only).
2532
* `--env.uglify` - provides basic obfuscation and smaller app size.
@@ -40,6 +47,7 @@ General | `$ ns build windows [--release] [--env.*]`
4047
### Command Limitations
4148

4249
* You can run `$ ns build windows` only on Windows systems.
50+
* A `--release` build without `--store-upload`, `--certificate` or `--certificate-thumbprint` produces an unsigned `.msix` that cannot be installed until it is signed.
4351

4452
### Related Commands
4553

0 commit comments

Comments
 (0)