build.ps1

[CmdletBinding()]
param (
  [Parameter(Mandatory = $true,
    Position = 0,
    HelpMessage = "Path to a JSON installer configuration file.")]
  [Alias("PSPath")]
  [ValidateNotNullOrEmpty()]
  [string]
  $ConfigFile,

  [Parameter(HelpMessage = "Path to MSYS2 installation. MSYS2 will be downloaded and installed to this path if it doesn't exist.")]
  [ValidatePattern('[\\\/]msys64$')]
  [string]
  $MSYS2Path = '.\build\msys64',

  [switch]
  $SkipDownload,

  [switch]
  $SkipSigning,

  [ValidateSet('zlib', 'bzip2', 'lzma')]
  [string]
  $Compression = 'lzma',

  [ValidateSet('system', 'user')]
  [string]
  $BuildType = 'system'
)

#Requires -Version 7.2

Set-StrictMode -Version Latest
$ErrorActionPreference = 'Stop'
$ProgressPreference = 'SilentlyContinue'

. "$PSScriptRoot\common.ps1"

Write-Host "Building from $ConfigFile"

$basename = "pico-setup-windows"
$version = (Get-Content "$PSScriptRoot\version.txt").Trim()
$build = (Get-Date -Format FileDateTimeUniversal)
$suffix = [io.path]::GetFileNameWithoutExtension($ConfigFile) + ($BuildType -eq 'user' ? '-user' : '' )
$binfile = "bin\$basename-$suffix.exe"

$tools = (Get-Content '.\config\tools.json' | ConvertFrom-Json).tools
$repositories = (Get-Content '.\config\repositories.json' | ConvertFrom-Json).repositories
$config = Get-Content $ConfigFile | ConvertFrom-Json
$bitness = $config.bitness
$mingw_arch = $config.mingwArch
$downloads = $config.downloads
$componentSelection = ($config | Get-Member componentSelection) ? $config.componentSelection : $false

mkdirp "build"
mkdirp "bin"

($downloads + $tools) | ForEach-Object {
  $_ | Add-Member -NotePropertyName 'shortName' -NotePropertyValue ($_.name -replace '[^a-zA-Z0-9]', '')
  $outfile = "downloads/$($_.file)"

  if ($SkipDownload) {
    Write-Host "Checking $($_.name): " -NoNewline
    if (-not (Test-Path $outfile)) {
      Write-Error "$outfile not found"
    }
  }
  else {
    Write-Host "Downloading $($_.name): " -NoNewline
    exec { curl.exe --fail --silent --show-error --url "$($_.href)" --location --output "$outfile" --create-dirs --remote-time --time-cond "downloads/$($_.file)" }
  }

  # Display versions of packaged installers, for information only. We try to
  # extract it from:
  # 1. The file name
  # 2. The download URL
  # 3. The version metadata in the file
  #
  # This fails for MSYS2, because there is no version number (only a timestamp)
  # and the version that gets reported is 7-zip SFX version.
  $fileVersion = ''
  $versionRegEx = '([0-9]+\.)+[0-9]+'
  if ($_.file -match $versionRegEx -or $_.href -match $versionRegEx) {
    $fileVersion = $Matches[0]
  } else {
    $fileVersion = (Get-ChildItem $outfile).VersionInfo.ProductVersion
  }

  if ($fileVersion) {
    Write-Host $fileVersion
  } else {
    Write-Host $_.file
  }

  if ($_ | Get-Member dirName) {
    $strip = 0;
    if ($_ | Get-Member extractStrip) { $strip = $_.extractStrip }

    mkdirp "build\$($_.dirName)" -clean
    exec { tar -xf $outfile -C "build\$($_.dirName)" --strip-components $strip }
  }
}

if (-not (Get-Command cmake -ErrorAction SilentlyContinue)) {
  $env:PATH = $env:PATH + ';' + (Resolve-Path .\build\cmake\bin).Path
}

if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
  $env:PATH = $env:PATH + ';' + (Resolve-Path .\build\git\cmd).Path
}

$repositories | ForEach-Object {
  $repodir = Join-Path 'build' ([IO.Path]::GetFileNameWithoutExtension($_.href))

  if ($SkipDownload) {
    Write-Host "Checking ${repodir}: " -NoNewline
    if (-not (Test-Path $repodir)) {
      Write-Error "$repodir not found"
    }
    exec { git -C "$repodir" describe --all }
  }
  else {
    if (Test-Path $repodir) {
      Remove-Item $repodir -Recurse -Force
    }

    exec { git clone -b "$($_.tree)" --depth=1 -c advice.detachedHead=false "$($_.href)" "$repodir" }

    if ($_ | Get-Member submodules) {
      exec { git -C "$repodir" submodule update --init --depth=1 }
    }
  }
}

# BTstack needs the PyCryptodome module
if (Test-Path .\build\python\python.exe) {
  exec { .\build\python\python.exe .\downloads\pip.pyz install pycryptodome }
  Add-Content -Path .\build\python\python*._pth -Value 'import site'
}

# Clone additional Pico-specific submodules in TinyUSB
exec { git -C .\build\pico-sdk\lib\tinyusb submodule update --init --depth=1 hw\mcu\raspberry_pi }

$sdkVersion = (cmake -P .\packages\pico-setup-windows\pico-sdk-version.cmake -N | Select-String -Pattern 'PICO_SDK_VERSION_STRING=(.*)$').Matches.Groups[1].Value
if (-not ($sdkVersion -match $versionRegEx)) {
  Write-Error 'Could not determine Pico SDK version.'
}
$sdkVersionClean = $Matches[0]
$sdkVersionCommit = (git -C .\build\pico-sdk rev-parse --short HEAD)
$product = "Raspberry Pi Pico SDK v$sdkVersion"
$productDir = "Raspberry Pi\Pico SDK v$sdkVersion"
$company = "Raspberry Pi Ltd"

Write-Host "SDK version: $sdkVersion ($sdkVersionCommit)"
Write-Host "Installer version: $version"

if (-not (Test-Path $MSYS2Path)) {
  Write-Host 'Extracting MSYS2'
  exec { & .\downloads\msys2.exe -y "-o$(Resolve-Path (Split-Path $MSYS2Path -Parent))" }
}

function sign {
  param ([string[]] $filesToSign)

  if ($SkipSigning) {
    Write-Warning "Skipping code signing."
  } else {
    $cert = Get-ChildItem -Path Cert:\CurrentUser\My -CodeSigningCert | Where-Object { $_.Subject -like "CN=Raspberry Pi*" }
    if (-not $cert) {
      Write-Error "No suitable code signing certificates found."
    }

    $filesToSign | Set-AuthenticodeSignature -Certificate $cert -TimestampServer "http://timestamp.digicert.com" -HashAlgorithm SHA256 | Tee-Object -Variable signatures
    $signatures | ForEach-Object {
      if ($_.Status -ne 0) {
        Write-Error "Error signing $($_.Path)"
      }
    }
  }
}

function msys {
  param ([string] $cmd)

  exec { & "$MSYS2Path\usr\bin\bash" -leo pipefail -c "$cmd" }
}

# Preserve the current working directory
$env:CHERE_INVOKING = 'yes'
# Start MINGW32/64 environment
$env:MSYSTEM = "MINGW$bitness"

if (-not $SkipDownload) {
  # First run setup
  msys 'uname -a'
  # Core update
  msys 'pacman --noconfirm -Syuu'
  # Normal update
  msys 'pacman --noconfirm -Suu'

  msys "pacman -S --noconfirm --needed autoconf automake git libtool make pactoys pkg-config wget"
  # pacboy adds MINGW_PACKAGE_PREFIX to package names suffixed with :p
  msys "pacboy -S --noconfirm --needed cmake:p ninja:p toolchain:p libusb:p hidapi:p"
}

if (-not (Test-Path ".\build\openocd-install\mingw$bitness")) {
  msys "cd build && ../packages/openocd/build-openocd.sh $bitness $mingw_arch"
}

if (-not (Test-Path ".\build\picotool-install\mingw$bitness")) {
  msys "cd build && ../packages/picotool/build-picotool.sh $bitness $mingw_arch"
}

$template = Get-Content ".\packages\pico-sdk-tools\pico-sdk-tools-config-version.cmake" -Raw
$ExecutionContext.InvokeCommand.ExpandString($template) | Set-Content ".\build\pico-sdk-tools\mingw$bitness\pico-sdk-tools-config-version.cmake"

exec { .\build\pandoc\pandoc.exe --from gfm --to gfm --output .\build\ReadMe.txt .\docs\tutorial.md }

mkdirp .\build\pico-examples\.vscode
Copy-Item .\packages\pico-examples\ide\vscode\*.json .\build\pico-examples\.vscode\ -Force
exec {  tar -a -cf "build\pico-examples.zip" -C "build" "pico-examples" "pico-extras" "pico-playground" }

$endl = '$\r$\n'

function writeFile {
  param ([string] $filename)

  begin {
    "FileOpen `$9 '$filename' w`r`n"
  }
  process {
    $_  -split "[\r\n]+" | ForEach-Object {
      "FileWrite `$9 ``${_}${endl}```r`n"
    }
  }
  end {
    "FileClose `$9`r`n"
  }
}

@"
!include "FileFunc.nsh"
!include "LogicLib.nsh"
!include "MUI2.nsh"
!include "WinCore.nsh"
!include "WordFunc.nsh"
!include "x64.nsh"
!include "packages\pico-setup-windows\aumi.nsh"

!define TITLE "$product"
!define PICO_INSTALL_DIR "$productDir"
; The repos need to be cloned into a dir with a fairly short name, because CMake generates build
; defs with long hashes in the paths. Both CMake and Ninja currently have problems working with
; long paths on Windows.
; We use "%USERPROFILE%" here so that it resolves at runtime to the actual user's profile, rather
; than the admin user which is used to elevate the installer.
!define PICO_REPOS_DIR "`%USERPROFILE%\Documents\Pico-v$sdkVersion"
!define PICO_SHORTCUTS_DIR "`$SMPROGRAMS\$product"
!define PICO_WINTERM_DIR "`$LOCALAPPDATA\Microsoft\Windows Terminal\Fragments\$product"
!define PICO_REG_ROOT SHELL_CONTEXT
!define PICO_REG_KEY "Software\$productDir"
!define UNINSTALL_KEY "Software\Microsoft\Windows\CurrentVersion\Uninstall\$product"
!define PICO_AppUserModel_ID "RaspberryPi.PicoSDK.$sdkVersion"

Name "`${TITLE}"
Caption "`${TITLE}"
XPStyle on
ManifestDPIAware true
Unicode true
SetCompressor $Compression
RequestExecutionLevel $($BuildType -eq 'system' ? 'admin' : 'user')

VIAddVersionKey "FileDescription" "`${TITLE}"
VIAddVersionKey "InternalName" "$basename"
VIAddVersionKey "ProductName" "`${TITLE}"
VIAddVersionKey "FileVersion" "$version-$build"
VIAddVersionKey "ProductVersion" "$sdkVersion-$sdkVersionCommit"
VIAddVersionKey "LegalCopyright" "$company"
VIAddVersionKey "CompanyName" "$company"
VIFileVersion $version.0
VIProductVersion $sdkVersionClean.0

; Since we're packaging up a bunch of installers, the "Space required" shown is inaccurate
SpaceTexts "none"

; We set the default INSTDIR ourselves in .onInit
InstallDir ""

Var ReposDir

!ifdef BUILD_UNINSTALLER

OutFile "build\build-uninstaller-$suffix.exe"

!define MUI_UNICON "resources\raspberrypi.ico"

!insertmacro MUI_PAGE_INSTFILES
!insertmacro MUI_PAGE_FINISH

!insertmacro MUI_UNPAGE_CONFIRM
!insertmacro MUI_UNPAGE_INSTFILES
!insertmacro MUI_UNPAGE_FINISH

!insertmacro MUI_LANGUAGE "English"

Function un.onInit

  SetShellVarContext $($BuildType -eq 'system' ? 'all' : 'current')
  SetRegView $bitness

  ReadRegStr `$ReposDir HKCU "`${PICO_REG_KEY}" "ReposPath"

FunctionEnd

Section "Uninstall"

  RMDir /r /REBOOTOK "`${PICO_SHORTCUTS_DIR}"
  RMDir /r /REBOOTOK "`${PICO_WINTERM_DIR}"

  RMDir /r /REBOOTOK "`$INSTDIR\cmake"
  RMDir /r /REBOOTOK "`$INSTDIR\gcc-arm-none-eabi"
  RMDir /r /REBOOTOK "`$INSTDIR\git"
  RMDir /r /REBOOTOK "`$INSTDIR\ninja"
  RMDir /r /REBOOTOK "`$INSTDIR\openocd"
  RMDir /r /REBOOTOK "`$INSTDIR\python"

  RMDir /r /REBOOTOK "`$INSTDIR\pico-sdk-tools"
  RMDir /r /REBOOTOK "`$INSTDIR\picotool"
  RMDir /r /REBOOTOK "`$INSTDIR\resources"

  Delete /REBOOTOK "`$INSTDIR\install.log"
  Delete /REBOOTOK "`$INSTDIR\pico-code.ps1"
  Delete /REBOOTOK "`$INSTDIR\pico-env.cmd"
  Delete /REBOOTOK "`$INSTDIR\pico-env.ps1"
  Delete /REBOOTOK "`$INSTDIR\pico-setup.cmd"
  Delete /REBOOTOK "`$INSTDIR\pico-setup.lnk"
  Delete /REBOOTOK "`$INSTDIR\ReadMe.txt"
  Delete /REBOOTOK "`$INSTDIR\version.ini"

  Delete /REBOOTOK "`$INSTDIR\uninstall.exe"

  RMDir /REBOOTOK "`$INSTDIR"
  ; Remove the C:\Program Files\Raspberry Pi directory if it is empty
  `${GetParent} "`$INSTDIR" `$R0
  RMDir `$R0

  `${If} `$ReposDir != ""
    RMDir /r /REBOOTOK "`$ReposDir\pico-examples"
    RMDir /r /REBOOTOK "`$ReposDir\pico-extras"
    RMDir /r /REBOOTOK "`$ReposDir\pico-playground"
    RMDir "`$ReposDir"
  `${EndIf}

  DeleteRegValue `${PICO_REG_ROOT} "Software\Kitware\CMake\Packages\pico-sdk-tools" "v$sdkVersion"
  DeleteRegKey /ifempty `${PICO_REG_ROOT} "Software\Kitware\CMake\Packages\pico-sdk-tools"

  DeleteRegKey `${PICO_REG_ROOT} "`${UNINSTALL_KEY}"

  DeleteRegKey `${PICO_REG_ROOT} "`${PICO_REG_KEY}"
  DeleteRegKey HKCU "`${PICO_REG_KEY}"

SectionEnd

Section

  WriteUninstaller `$INSTDIR\uninstall-$suffix.exe

SectionEnd

!else

OutFile "$binfile"

!define MUI_ICON "resources\raspberrypi.ico"
!define MUI_ABORTWARNING
!define MUI_WELCOMEPAGE_TITLE "`${TITLE}"

!insertmacro MUI_PAGE_WELCOME
$($componentSelection ? '!insertmacro MUI_PAGE_COMPONENTS' : '')
!insertmacro MUI_PAGE_DIRECTORY
!define MUI_PAGE_CUSTOMFUNCTION_LEAVE DumpLog
!insertmacro MUI_PAGE_INSTFILES

!define FINISHPAGE_RUN_FUNCTION RunBuild
!define MUI_FINISHPAGE_SHOWREADME "`$INSTDIR\ReadMe.txt"
!define MUI_FINISHPAGE_SHOWREADME_TEXT "Show ReadMe"
!include "packages\pico-setup-windows\FinishPage.nsh"
!insertmacro MUI_PAGE_FINISH

!insertmacro MUI_LANGUAGE "English"

!include "packages\pico-setup-windows\DumpLog.nsh"

Function .onInit

  SetShellVarContext $($BuildType -eq 'system' ? 'all' : 'current')
  SetRegView $bitness

  ; No /D= on the command line
  `${If} `$INSTDIR == ""
    ReadRegStr `$INSTDIR `${PICO_REG_ROOT} "`${UNINSTALL_KEY}" "InstallPath"
  `${EndIf}

  ; Nothing in the registry either; use the defaults
  `${If} `$INSTDIR == ""
    $(if ($BuildType -eq 'system') {
    "StrCpy `$INSTDIR `"`$PROGRAMFILES$bitness`""
    } else {
    'GetKnownFolderPath $INSTDIR ${FOLDERID_UserProgramFiles}
    ${If} $INSTDIR == ""
      StrCpy $INSTDIR "$LOCALAPPDATA\Programs"
    ${EndIf}'
    })

    StrCpy `$INSTDIR "`$INSTDIR\`${PICO_INSTALL_DIR}"
  `${EndIf}

  StrCpy `$ReposDir "`${PICO_REPOS_DIR}"

  ReadRegStr `$R0 HKCU "`${PICO_REG_KEY}" "ReposPath"
  `${If} `$R0 != ""
    StrCpy `$ReposDir "`$R0"
  `${EndIf}

  ClearErrors
  `${GetParameters} `$R1
  `${GetOptions} "`$R1" "/REPOSDIR=" `$R0
  `${IfNot} `${Errors}
    StrCpy `$ReposDir "`$R0"
  `${EndIf}

FunctionEnd

Section

  SetOutPath `$INSTDIR

  $(if ($bitness -eq '64') {
  '${IfNot} ${IsNativeAMD64}
    Abort "This installer only supports x86-64 versions of Windows."
  ${EndIf}'
  })

  ; Uninstall previous version
  ReadRegStr `$R0 HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\$basename-$sdkVersion" "UninstallString"
  `${If} `$R0 == ""
    ReadRegStr `$R0 `${PICO_REG_ROOT} "`${UNINSTALL_KEY}" "UninstallString"
  `${EndIf}
  `${If} `$R0 != ""
    `${GetParent} "`$R0" `$R1
    DetailPrint "Uninstalling previous version..."
    ExecWait '"`$R0" /S _?=`$R1' `$1
    DetailPrint "Uninstaller returned `$1"
  `${EndIf}

  InitPluginsDir

  CreateDirectory "`${PICO_SHORTCUTS_DIR}"

  SetOutPath `$INSTDIR\resources
  File /r resources\*.*

  SetOutPath `$INSTDIR

SectionEnd

$($downloads | ForEach-Object {
@"

Section "$($_.name)" Sec$($_.shortName)

  ClearErrors

  $(if ($_ | Get-Member additionalFiles) {
    $_.additionalFiles | ForEach-Object {
      "File /oname=`$PLUGINSDIR\$(Split-Path -Leaf $_) $_`r`n"
    }
  })

  $(if (($_ | Get-Member exec) -or ($_ | Get-Member execToLog)) {
@"
    SetOutPath "`$TEMP"
    File "downloads\$($_.file)"
    StrCpy `$0 "`$TEMP\$($_.file)"

    $(if ($_ | Get-Member exec) {
      "ExecWait ``$($_.exec)`` `$1"
    })

    $(if ($_ | Get-Member execToLog) {
      "nsExec::ExecToLog ``$($_.execToLog)```r`n"
      "Pop `$1"
    })

    DetailPrint "$($_.name) returned `$1"
    Delete /REBOOTOK "`$0"

    `${If} `${Errors}
      Abort "Installation of $($_.name) failed"
    $(if ($_ | Get-Member rebootExitCodes) {
      $_.rebootExitCodes | ForEach-Object {
        "`${ElseIf} `$1 = $_`r`n    SetRebootFlag true"
      }
    })
    `${ElseIf} `$1 <> 0
      Abort "Installation of $($_.name) failed"
    `${EndIf}
"@
  })

  $(if ($_ | Get-Member dirName) {
    "SetOutPath '`$INSTDIR\$($_.dirName)'`r`n"
    "File /r build\$($_.dirName)\*.*"
  })

SectionEnd

LangString DESC_Sec$($_.shortName) `${LANG_ENGLISH} "$($_.name)"

"@
})

Section "-OpenOCD" SecOpenOCD

  SetOutPath "`$INSTDIR\openocd"
  File "build\openocd-install\mingw$bitness\bin\*.*"
  SetOutPath "`$INSTDIR\openocd\scripts"
  File /r "build\openocd-install\mingw$bitness\share\openocd\scripts\*.*"

SectionEnd

!include "packages\pico-setup-windows\VSCodeUtils.nsh"

Section VSCode

  `${FindVSCode}

  `${If} `$VSCodeExePath != ""
    DetailPrint "Found VS Code: `$VSCodeExePath"
  `${Else}
    DetailPrint "Could not find VS Code. Installing..."
    `${InstallVSCode}
  `${EndIf}

  $((Get-Content 'packages\pico-examples\ide\vscode\extensions.json' | ConvertFrom-Json).recommendations | ForEach-Object {
    "`${VSCodeCmd} '--install-extension $_'`r`n"
    "Pop `$0`r`n"
  })

SectionEnd

Section "-Pico environment" SecPico

  SetOutPath "`$INSTDIR\pico-sdk"
  File /r "build\pico-sdk\*.*"

  SetOutPath "`$INSTDIR\pico-sdk-tools"
  File "build\pico-sdk-tools\mingw$bitness\*.*"
  WriteRegStr `${PICO_REG_ROOT} "Software\Kitware\CMake\Packages\pico-sdk-tools" "v$sdkVersion" "`$INSTDIR\pico-sdk-tools"

  SetOutPath "`$INSTDIR\picotool"
  File "build\picotool-install\mingw$bitness\*.*"

  SetOutPath "`$INSTDIR"
  File "build\pico-examples.zip"
  WriteINIStr "`$INSTDIR\version.ini" "pico-setup-windows" "PICO_SDK_VERSION" "$sdkVersion"
  WriteINIStr "`$INSTDIR\version.ini" "pico-setup-windows" "PICO_INSTALL_PATH" "`$INSTDIR"
  WriteINIStr "`$INSTDIR\version.ini" "pico-setup-windows" "PICO_REG_KEY" "`${PICO_REG_KEY}"
  File "packages\pico-setup-windows\pico-code.ps1"
  File "packages\pico-setup-windows\pico-env.ps1"
  File "packages\pico-setup-windows\pico-env.cmd"
  File "packages\pico-setup-windows\pico-setup.cmd"
  File "build\ReadMe.txt"

  File /oname=uninstall.exe "build\uninstall-$suffix.exe"
  WriteRegStr `${PICO_REG_ROOT} "`${UNINSTALL_KEY}" "DisplayName" "$($BuildType -eq 'system' ? $product : "$product (User)")"
  WriteRegStr `${PICO_REG_ROOT} "`${UNINSTALL_KEY}" "UninstallString" "`$INSTDIR\uninstall.exe"
  WriteRegStr `${PICO_REG_ROOT} "`${UNINSTALL_KEY}" "InstallPath" "`$INSTDIR"
  WriteRegStr `${PICO_REG_ROOT} "`${UNINSTALL_KEY}" "DisplayIcon" "`$INSTDIR\resources\raspberrypi.ico"
  WriteRegStr `${PICO_REG_ROOT} "`${UNINSTALL_KEY}" "DisplayVersion" "$version"
  WriteRegStr `${PICO_REG_ROOT} "`${UNINSTALL_KEY}" "Publisher" "$company"

  `${IfNot} `${FileExists} "`$VSCodeExePath"
    # Just use the default (user) install location for the icon, in case the user installs VS Code later
    StrCpy `$VSCodeExePath "%LOCALAPPDATA%\Programs\Microsoft VS Code\Code.exe"
    DetailPrint "Could not find Visual Studio Code."
    MessageBox MB_OK|MB_ICONEXCLAMATION "Installation of Visual Studio Code failed. Please install it manually by downloading the installer from:${endl}${endl}https://code.visualstudio.com/" /SD IDOK
  `${EndIf}

  `${CreateShortcutEx} "`${PICO_SHORTCUTS_DIR}\Pico - Developer Command Prompt.lnk" "`${PICO_AppUserModel_ID}!cmd" ``"cmd.exe" '/k "`$INSTDIR\pico-env.cmd"'``
  `${CreateShortcutEx} "`${PICO_SHORTCUTS_DIR}\Pico - Developer PowerShell.lnk" "`${PICO_AppUserModel_ID}!powershell" ``"powershell.exe" '-NoExit -ExecutionPolicy Bypass -File "`$INSTDIR\pico-env.ps1"'``
  `${CreateShortcutEx} "`${PICO_SHORTCUTS_DIR}\Pico - Visual Studio Code.lnk" "`${PICO_AppUserModel_ID}!code" ``"powershell.exe" '-NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File "`$INSTDIR\pico-code.ps1"' "`$VSCodeExePath" "" SW_SHOWMINIMIZED``

  SetOutPath "`${PICO_WINTERM_DIR}"
  `${WordReplace} "`$INSTDIR" "\" "\\" "+" `$7
  $( @"
{
  "profiles": [
    {
      "name": "Pico - Developer Command Prompt (SDK v$sdkVersion)",
      "commandline": "cmd.exe /k \"`$7\\pico-env.cmd\"",
      "icon": "`$7\\resources\\raspberrypi.ico",
      "startingDirectory": "`$7"
    },
    {
      "name": "Pico - Developer PowerShell (SDK v$sdkVersion)",
      "commandline": "powershell.exe -NoExit -ExecutionPolicy Bypass -File \"`$7\\pico-env.ps1\"",
      "icon": "`$7\\resources\\raspberrypi.ico",
      "startingDirectory": "`$7"
    }
  ]
}
"@ | writeFile "pico-terminals.json")

  CreateDirectory "`${PICO_SHORTCUTS_DIR}\Pico - Documentation"
  WriteINIStr "`${PICO_SHORTCUTS_DIR}\Pico - Documentation\Pico Datasheet.url" "InternetShortcut" "URL" "https://datasheets.raspberrypi.com/pico/pico-datasheet.pdf"
  WriteINIStr "`${PICO_SHORTCUTS_DIR}\Pico - Documentation\Pico W Datasheet.url" "InternetShortcut" "URL" "https://datasheets.raspberrypi.com/picow/pico-w-datasheet.pdf"
  WriteINIStr "`${PICO_SHORTCUTS_DIR}\Pico - Documentation\Pico C C++ SDK.url" "InternetShortcut" "URL" "https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-c-sdk.pdf"
  WriteINIStr "`${PICO_SHORTCUTS_DIR}\Pico - Documentation\Pico Python SDK.url" "InternetShortcut" "URL" "https://datasheets.raspberrypi.com/pico/raspberry-pi-pico-python-sdk.pdf"

  ; Reset working dir for pico-setup launched from the finish page
  SetOutPath "`$INSTDIR"

SectionEnd

Function RunBuild

  ; We need to run pico-setup.cmd un-elevated, to avoid problems with builds later on.
  ; So we create a shortcut with the command line to use, and have explorer.exe launch it.
  ; http://mdb-blog.blogspot.com/2013/01/nsis-lunch-program-as-user-from-uac.html
  CreateShortcut "`$INSTDIR\pico-setup.lnk" "cmd.exe" '/k call "`$INSTDIR\pico-setup.cmd" "`$ReposDir" 1'
  Exec '"`$WINDIR\explorer.exe" "`$INSTDIR\pico-setup.lnk"'

FunctionEnd

!if $($componentSelection ? 1 : 0)
!insertmacro MUI_FUNCTION_DESCRIPTION_BEGIN
$($downloads | ForEach-Object {
  "  !insertmacro MUI_DESCRIPTION_TEXT `${Sec$($_.shortName)} `$(DESC_Sec$($_.shortName))`n"
})
!insertmacro MUI_FUNCTION_DESCRIPTION_END
!endif

!endif # BUILD_UNINSTALLER
"@ | Set-Content ".\$basename-$suffix.nsi"

exec { .\build\NSIS\makensis /DBUILD_UNINSTALLER ".\$basename-$suffix.nsi" }

# The 'installer' that just writes the uninstaller asks for admin access, which is not actually needed.
$env:__COMPAT_LAYER = "RunAsInvoker"
exec { Start-Process -FilePath ".\build\build-uninstaller-$suffix.exe" -ArgumentList "/S /D=$PSScriptRoot\build" -Wait }
$env:__COMPAT_LAYER = ""

# Sign files before packaging up the installer
sign "build\uninstall-$suffix.exe",
"build\openocd-install\mingw$bitness\bin\openocd.exe",
"build\pico-sdk-tools\mingw$bitness\elf2uf2.exe",
"build\pico-sdk-tools\mingw$bitness\pioasm.exe",
"build\picotool-install\mingw$bitness\picotool.exe"

exec { .\build\NSIS\makensis ".\$basename-$suffix.nsi" }
Write-Host "Installer saved to $binfile"

# Sign the installer
sign $binfile

# Package OpenOCD separately as well

$version = (cmd /c ".\build\openocd-install\mingw$bitness\bin\openocd.exe" --version '2>&1')[0]
if (-not ($version -match 'Open On-Chip Debugger (?<version>[a-zA-Z0-9\.\-+]+) \((?<timestamp>[0-9\-:]+)\)')) {
  Write-Error 'Could not determine openocd version'
}

$filename = 'openocd-{0}-{1}-{2}.zip' -f
  ($Matches.version -replace '-dirty$', ''),
  ($Matches.timestamp -replace '[:-]', ''),
  $suffix

Write-Host "Saving OpenOCD package to $filename"
exec { tar -a -cf "bin\$filename" -C "build\openocd-install\mingw$bitness\bin" * -C "..\share\openocd" "scripts" }