Files
craft-launcher/packaging/windows/package.ps1
David Mann 439249d1b8 feat(packaging): ship the craft-ai-mcp gateway beside the launcher
apps/craft-ai-mcp builds the gateway from storytold/craft-ai-integrations
(crates/ai-mcp, craft_ai_mcp::cli) as craft-ai-mcp, and every package puts it
beside the launcher, where Settings › AI agents finds it:

- Windows: built with the launcher, PE-checked as a console program, signed,
  in the MSI (the launcher's component) and the portable zip; listed in the
  install policy's payloads
- macOS: lipo'd and placed in Contents/MacOS, signed with the hardened runtime
  before the main executable
- Linux: /usr/bin in the deb and rpm (nfpm), the tarball and the AppImage;
  /app/bin in both Flatpak manifests
- FreeBSD: bin/, checked like the launcher

The gateway needs only serde, serde_json and dirs. It is pinned to the head
of storytold/craft-ai-integrations#197 until that merges.
2026-11-12 18:58:42 +01:00

223 lines
12 KiB
PowerShell
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<#
.SYNOPSIS
Build, sign and package ArtCraft Launcher for Windows.
.DESCRIPTION
Produces, in $env:DIST (default: dist/release):
artcraft-launcher-<version>-windows-<arch>.msi per-user installer with a setup wizard (WiX v5)
artcraft-launcher-<version>-windows-<arch>-portable.zip artcraft-launcher.exe + portable.txt
The binary links the C runtime statically (+crt-static), so neither the MSI nor the portable
zip needs the Visual C++ redistributable. Signing is delegated to sign.ps1 (skipped with a
warning when no signing secrets are set).
Needs: Rust (MSVC toolchain + the target), the Windows SDK (rc.exe, signtool.exe),
and WiX v5: dotnet tool install --global wix --version 5.0.2
wix extension add -g WixToolset.UI.wixext/5.0.2 WixToolset.Util.wixext/5.0.2
.EXAMPLE
pwsh packaging/windows/package.ps1 -Arch x64
pwsh packaging/windows/package.ps1 -Arch x86 -SkipBuild
pwsh packaging/windows/package.ps1 -Arch arm64 # cross-compiled; needs the MSVC ARM64 build tools
#>
param(
[ValidateSet('x64', 'x86', 'arm64')] [string] $Arch = 'x64',
[switch] $SkipBuild
)
$ErrorActionPreference = 'Stop'
$Root = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
# ---- app-specific values ----------------------------------------------------------------------
$Pkg = 'artcraft-launcher' # cargo package and binary
$GatewayPkg = 'artcraft-launcher-mcp' # cargo package of the shipped craft-ai-mcp gateway
$GatewayExe = 'craft-ai-mcp.exe'
$AppName = 'ArtCraft Launcher' # display name
function Invoke-Native([string] $What, [scriptblock] $Block) {
Write-Output "==> $What"
& $Block
if ($LASTEXITCODE -ne 0) { throw "$What failed with exit code $LASTEXITCODE" }
}
# The version lives in one place: [workspace.package] version in the root Cargo.toml.
$Version = $env:ARTCRAFT_LAUNCHER_VERSION
if (-not $Version) {
$inPkg = $false
foreach ($line in Get-Content (Join-Path $Root 'Cargo.toml')) {
if ($line -match '^\s*\[') { $inPkg = ($line.Trim() -eq '[workspace.package]'); continue }
if ($inPkg -and $line -match '^\s*version\s*=\s*"([^"]+)"') { $Version = $Matches[1]; break }
}
}
if (-not $Version) { throw 'could not read [workspace.package] version from Cargo.toml' }
# MSI ProductVersion is numeric (major.minor.build); pre-release tags are dropped there.
$MsiVersion = ($Version -split '-')[0]
$Target = switch ($Arch) { 'x64' { 'x86_64-pc-windows-msvc' } 'x86' { 'i686-pc-windows-msvc' } 'arm64' { 'aarch64-pc-windows-msvc' } }
$Dist = if ($env:DIST) { $env:DIST } else { Join-Path $Root 'dist\release' }
$TargetDir = if ($env:CARGO_TARGET_DIR) { $env:CARGO_TARGET_DIR } else { Join-Path $Root 'target' }
New-Item -ItemType Directory -Force -Path $Dist | Out-Null
if (-not $env:ARTCRAFT_LAUNCHER_BUILD_SHA) { $env:ARTCRAFT_LAUNCHER_BUILD_SHA = (git -C $Root rev-parse HEAD 2>$null) }
if (-not $env:ARTCRAFT_LAUNCHER_BUILD_DATE) { $env:ARTCRAFT_LAUNCHER_BUILD_DATE = (Get-Date).ToUniversalTime().ToString('yyyy-MM-dd') }
Write-Output "$AppName $Version for Windows $Arch ($Target)"
if (-not $SkipBuild) {
# Static CRT: no VC++ redistributable needed. Scoped to the target so host build scripts and
# proc-macros are unaffected.
$flagVar = 'CARGO_TARGET_' + ($Target.ToUpper() -replace '-', '_') + '_RUSTFLAGS'
[Environment]::SetEnvironmentVariable($flagVar, '-C target-feature=+crt-static')
# Fail the build (rather than warn) if the icon/VERSIONINFO can't be embedded.
$env:ARTCRAFT_LAUNCHER_REQUIRE_WINRES = '1'
# The launcher and the craft-ai-mcp gateway it ships (Settings › AI agents).
Invoke-Native "cargo build ($Target)" { cargo build --release --locked -p $Pkg -p $GatewayPkg --target $Target }
}
$Bin = Join-Path $TargetDir "$Target\release"
$Exe = "$Pkg.exe"
# Check the PE header before packaging. Machine (COFF header) must match -Arch, so an x64 build
# can never ship labelled arm64. Subsystem (optional header) must be 2 = Windows GUI, so no
# console window opens with the launcher.
function Get-PeHeader([string] $Path) {
$bytes = [System.IO.File]::ReadAllBytes($Path)
$pe = [BitConverter]::ToInt32($bytes, 0x3C)
return @{ Machine = [BitConverter]::ToUInt16($bytes, $pe + 4); Subsystem = [BitConverter]::ToUInt16($bytes, $pe + 0x5C) }
}
$Machine = switch ($Arch) { 'x64' { 0x8664 } 'x86' { 0x14C } 'arm64' { 0xAA64 } }
$h = Get-PeHeader (Join-Path $Bin $Exe)
if ($h.Machine -ne $Machine) { throw "$Exe is for machine 0x$('{0:X}' -f $h.Machine), expected 0x$('{0:X}' -f $Machine) ($Arch)" }
if ($h.Subsystem -ne 2) { throw "$Exe has PE subsystem $($h.Subsystem), expected 2 (Windows GUI)" }
Write-Output "ok ${Exe}: $Arch, PE subsystem $($h.Subsystem)"
# The gateway talks to MCP clients over stdin and stdout, so it stays a console program (3).
$g = Get-PeHeader (Join-Path $Bin $GatewayExe)
if ($g.Machine -ne $Machine) { throw "$GatewayExe is for machine 0x$('{0:X}' -f $g.Machine), expected 0x$('{0:X}' -f $Machine) ($Arch)" }
if ($g.Subsystem -ne 3) { throw "$GatewayExe has PE subsystem $($g.Subsystem), expected 3 (console)" }
Write-Output "ok ${GatewayExe}: $Arch, PE subsystem $($g.Subsystem)"
$Stage = Join-Path $TargetDir "windows-package\$Arch"
Remove-Item -Recurse -Force $Stage -ErrorAction SilentlyContinue
New-Item -ItemType Directory -Force -Path $Stage | Out-Null
# Dependency font notices are required even without optional craft-fonts.
Copy-Item -LiteralPath (Join-Path $Root 'NOTICE') -Destination $Stage
Copy-Item (Join-Path $Bin $Exe) $Stage
Copy-Item (Join-Path $Bin $GatewayExe) $Stage
& (Join-Path $PSScriptRoot 'sign.ps1') (Join-Path $Stage $Exe)
& (Join-Path $PSScriptRoot 'sign.ps1') (Join-Path $Stage $GatewayExe)
# ---- MSI ---------------------------------------------------------------------------------------
# The setup wizard's art, drawn here (System.Drawing) in getartcraft.com's style so the MSI shows
# ArtCraft rather than WiX's stock bitmaps. Both must be 24-bit BMPs:
# - dialog, 493x312: the Welcome and Finish pages' backdrop. Their text sits on the right, so
# that stays white; the left panel is ours: the blue ArtCraft mark, the white wordmark, a mono
# "Launcher" label and the Craft apps' icons in a hairline grid.
# - banner, 493x58: across the top of the inner pages. The page title is drawn over its left
# side, so that stays white; the right end is a dark cell with the mark.
# The ArtCraft mark and wordmark are drawn as supplied (docs/brand/LICENSE-brand.txt).
function New-InstallerArt([string] $BannerOut, [string] $DialogOut) {
Add-Type -AssemblyName System.Drawing
$ink = [System.Drawing.ColorTranslator]::FromHtml('#121316')
$accent = [System.Drawing.ColorTranslator]::FromHtml('#2d81ff')
$muted = [System.Drawing.Color]::FromArgb(153, 242, 241, 238)
$line = [System.Drawing.Color]::FromArgb(38, 242, 241, 238)
# The Craft App Suite, in the launcher's order (crates/core/src/catalog.rs).
$apps = 'photocraft', 'vectorcraft', 'filmcraft', 'lightcraft', 'pdfcraft', 'effectcraft',
'anicraft', 'designcraft', 'figcraft', 'wordcraft', 'soundcraft', 'deckcraft', 'cadcraft', 'gridcraft', 'craft-anything', 'texturecraft', 'materialcraft'
$mark = [System.Drawing.Image]::FromFile((Join-Path $Root 'assets\app-icon\hicolor\256x256\apps\ai.storyteller.artcraft-launcher.png'))
$wordmark = [System.Drawing.Image]::FromFile((Join-Path $Root 'docs\brand\artcraft-logo-white.png'))
$icons = $apps | ForEach-Object { [System.Drawing.Image]::FromFile((Join-Path $Root "assets\app-icons\$_.png")) }
# The site's label face; GDI+ draws a variable font at its default instance (Regular).
$fonts = New-Object System.Drawing.Text.PrivateFontCollection
$fonts.AddFontFile((Join-Path $Root 'assets\fonts\GeistMono-Variable.ttf'))
$labelFont = New-Object System.Drawing.Font $fonts.Families[0], 9, ([System.Drawing.FontStyle]::Regular), ([System.Drawing.GraphicsUnit]::Pixel)
try {
foreach ($spec in @(@($BannerOut, 493, 58), @($DialogOut, 493, 312))) {
$bmp = New-Object System.Drawing.Bitmap $spec[1], $spec[2], ([System.Drawing.Imaging.PixelFormat]::Format24bppRgb)
$g = [System.Drawing.Graphics]::FromImage($bmp)
$panel = New-Object System.Drawing.SolidBrush $ink
$stripe = New-Object System.Drawing.SolidBrush $accent
try {
$g.InterpolationMode = [System.Drawing.Drawing2D.InterpolationMode]::HighQualityBicubic
$g.PixelOffsetMode = [System.Drawing.Drawing2D.PixelOffsetMode]::HighQuality
$g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
$g.TextRenderingHint = [System.Drawing.Text.TextRenderingHint]::AntiAliasGridFit
$g.Clear([System.Drawing.Color]::White)
if ($spec[2] -eq 58) {
$g.FillRectangle($panel, 405, 0, 88, 58)
$g.FillRectangle($stripe, 405, 0, 2, 58)
$g.DrawImage($mark, 431, 11, 36, 36)
} else {
$g.FillRectangle($panel, 0, 0, 164, 312)
$g.FillRectangle($stripe, 162, 0, 2, 312)
$g.DrawImage($mark, 16, 18, 44, 44)
$g.DrawImage($wordmark, 22, 74, 120, [int](120 * $wordmark.Height / $wordmark.Width))
# "LAUNCHER" in mono capitals, spaced like the site's labels (0.15 em).
$brush = New-Object System.Drawing.SolidBrush $muted
$x = 22.0
foreach ($ch in 'LAUNCHER'.ToCharArray()) {
$g.DrawString([string]$ch, $labelFont, $brush, $x, 94, [System.Drawing.StringFormat]::GenericTypographic)
$x += $g.MeasureString([string]$ch, $labelFont, 100, [System.Drawing.StringFormat]::GenericTypographic).Width + 1.35
}
$brush.Dispose()
# The seventeen apps in four columns of 30 px cells: x=22..142, y=118..268.
$pen = New-Object System.Drawing.Pen $line, 1
$left = 22; $top = 118; $cell = 30; $columns = 4
for ($i = 0; $i -lt $icons.Count; $i++) {
$cx = $left + ($i % $columns) * $cell
$cy = $top + [math]::Floor($i / $columns) * $cell
$g.DrawRectangle($pen, $cx, $cy, $cell, $cell)
$g.DrawImage($icons[$i], $cx + 5, $cy + 5, $cell - 10, $cell - 10)
}
$pen.Dispose()
}
} finally { $panel.Dispose(); $stripe.Dispose(); $g.Dispose() }
$bmp.Save($spec[0], [System.Drawing.Imaging.ImageFormat]::Bmp)
$bmp.Dispose()
}
} finally {
$labelFont.Dispose(); $fonts.Dispose(); $mark.Dispose(); $wordmark.Dispose()
$icons | ForEach-Object { $_.Dispose() }
}
}
$Banner = Join-Path $Stage 'installer-banner.bmp'
$Dialog = Join-Path $Stage 'installer-dialog.bmp'
New-InstallerArt $Banner $Dialog
$Msi = Join-Path $Dist "$Pkg-$Version-windows-$Arch.msi"
& (Join-Path $PSScriptRoot 'check-icons.ps1')
Invoke-Native 'wix build' {
wix build (Join-Path $PSScriptRoot "$Pkg.wxs") -arch $Arch `
-ext WixToolset.UI.wixext -ext WixToolset.Util.wixext `
-culture en-US -loc (Join-Path $PSScriptRoot "$Pkg.en-us.wxl") `
-d "Version=$MsiVersion" -d "DisplayVersion=$Version" -d "BinDir=$Stage" -d "IconPath=$(Join-Path $Root "assets\app-icon\$Pkg.ico")" `
-d "BannerBmp=$Banner" -d "DialogBmp=$Dialog" `
-o $Msi
}
Invoke-Native 'MSI shortcut icon validation (ICE50)' {
wix msi validate $Msi -ice ICE50 -intermediateFolder (Join-Path $Stage 'msi-validation')
}
& (Join-Path $PSScriptRoot 'check-install-policy.ps1') -MsiPath $Msi
# wix writes its debug symbols (.wixpdb) next to the MSI; keep them out of the release assets.
Remove-Item -Force -ErrorAction SilentlyContinue ([IO.Path]::ChangeExtension($Msi, '.wixpdb'))
& (Join-Path $PSScriptRoot 'sign.ps1') $Msi
# ---- portable zip ------------------------------------------------------------------------------
$Portable = Join-Path $TargetDir "windows-package\$Pkg-$Version-windows-$Arch-portable"
Remove-Item -Recurse -Force $Portable -ErrorAction SilentlyContinue
New-Item -ItemType Directory -Force -Path $Portable | Out-Null
Copy-Item (Join-Path $Stage $Exe) $Portable
Copy-Item (Join-Path $Stage $GatewayExe) $Portable
foreach ($f in 'README.md', 'LICENSE-MIT', 'LICENSE-APACHE', 'NOTICE', 'ATTRIBUTION.md') {
$p = Join-Path $Root $f
if (Test-Path $p) { Copy-Item $p $Portable }
}
# portable.txt beside artcraft-launcher.exe switches on portable mode: settings and the download
# cache go to ArtCraftLauncherData\ next to the exe instead of %APPDATA%.
Copy-Item (Join-Path $PSScriptRoot 'portable.txt') $Portable
$Zip = Join-Path $Dist "$Pkg-$Version-windows-$Arch-portable.zip"
Remove-Item -Force $Zip -ErrorAction SilentlyContinue
Compress-Archive -Path $Portable -DestinationPath $Zip
Get-Item $Msi, $Zip | Format-Table Name, Length