Files
velopack/docs/bootstrapping.md
2024-01-20 21:44:11 +00:00

2.4 KiB

docs / bootstrapping.md

Bootstrapping

Applies to: Windows

While installing Velopack applications on Windows, it is possible to install other commonly required runtime dependencies using the --framework / -f argument.

It is possibly to specify more than one requirement, using a comma delimited list. For example:

vpk pack ... --framework net6.0-x64-desktop,vcredist142-x64

These dependencies will be downloaded and installed before your application can be installed.

Adding dependencies during updates

Velopack will check that all required dependencies are installed before applying new updates. This means if a new version of your app adds a new dependency, the user will be prompted to install it before your new version is applied.

List of supported frameworks

Any of the following can be passed via the --framework argument.

Edge WebView2

  • webview2

vcredist

  • vcredist100-x86
  • vcredist100-x64
  • vcredist110-x86
  • vcredist110-x64
  • vcredist120-x86
  • vcredist120-x64
  • vcredist140-x86
  • vcredist140-x64
  • vcredist141-x86
  • vcredist141-x64
  • vcredist142-x86
  • vcredist142-x64
  • vcredist143-x86
  • vcredist143-x64
  • vcredist143-arm64

.Net Framework

  • net45
  • net451
  • net452
  • net46
  • net461
  • net462
  • net47
  • net471
  • net472
  • net48
  • net481

dotnet

Every version of dotnet is supported >= 5.0. The framework argument should be supplied in the format $"net{major.minor}-{arch}-{type}".

The valid {arch} values are

  • x86
  • x64
  • arm64

The valid {type} values are

  • runtime
  • aspnetcore
  • desktop

Here are some examples:

  • .NET 6.0 Desktop Runtime (x64) --framework net6.0-x64-desktop
  • .NET 8.0 Runtime (arm64) --framework net8.0-arm64-runtime
  • .NET 5.0 AspNetCore (x86) --framework net5.0-x86-aspnetcore

By default, Velopack will accept any installed release, but always install the latest. That is to say, if your dependency is specified as net6.0-x64-desktop and version 6.0.2 is installed, it will be accepted. If it's not installed, Velopack will download the latest available version (at the time of writing, that's 6.0.26).

If you need a specific version of dotnet, (eg. 6.0.11) - you can specify a third version part in your dependency string: --framework net6.0.11-x64-desktop. In this case, if the installed version is < 6.0.11, then it will be upgraded to the latest available.