gulp-mu-aspx-installer
v2.0.0
Published
Packs a file stream into a single self-extracting installer ASPX script (base64 ZIP payload + manifest).
Maintainers
Readme
gulp-mu-aspx-installer
Packs a gulp file stream into a single self-extracting installer ASPX script.
All piped files are ZIP-compressed (file names are flattened to MD5 keys to avoid
Windows/UTF-8 ZIP issues, with a separate JSON manifest mapping them back), the ZIP
is base64-encoded and embedded into an ASPX template together with version, build
and configuration data. The resulting *.aspx unpacks and installs the application
on the target .NET/IIS server.
Install
npm install --save-dev gulp-mu-aspx-installerUsage
import installer from 'gulp-mu-aspx-installer';
function buildInstaller() {
return gulp.src('./package/**')
.pipe(installer({
packageName: 'MyApp.aspx',
build: BUILD, // e.g. "Production" | "Test"
builds: BUILDS, // builds[<build>].packageinstaller.aspx + configurator
releases: RELEASES // [{ main, minor, revision, beta }]
}))
.pipe(gulp.dest('./out/'));
}Options
| Option | Type | Default | Description |
| -------------- | -------- | ---------------- | ------------------------------------------------------------------------------------ |
| packageName | string | — | Output ASPX file name. |
| build | string | "Production" | Build key looked up in builds.builds[build]. |
| builds | object | — | Build/configurator definition; builds[<build>].packageinstaller.aspx is required. |
| releases | array | [{main:1,minor:0,revision:0,beta:false}] | Version info; releases[0] is used. |
| compress | boolean | undefined | Forwarded to the ZIP entry options (yazl). |
| aspxTemplate | string | bundled template | Override the ASPX template path. |
| jsTemplate | string | bundled template | Override the JS template path. |
| cssTemplate | string | bundled template | Override the CSS template path. |
The builds[<build>].packageinstaller.aspx object may define
tmpinstallsaveversion, tmpinstallsavefolders, tmpinstalldonotclearfolders,
pre_update_webservices and post_update_webservices.
License
MIT
