Getting Started: C# / WPF

Applies to

Windows

MacOS

Linux

Get started with .NET 5+ (cross-platform) or .NET Framework.

1

Install Velopack NuGet package

Install the Velopack NuGet Package in your main project. This is the project that will contain the Main method of your application.

2

Create a Main method

Though it is possible to simply put the Velopack bootstrap call within App.xaml.cs, we recommend creating a custom Main method to avoid any WPF overhead when applying updates.

First, change the Build Actio of App.xaml to Page (right-click the file in Solution Explorer, select Properties, and change the Build Action). The project file should contain the following lines:

<ItemGroup>
    <ApplicationDefinition Remove="App.xaml"/>
    <Page Include="App.xaml"/>
</ItemGroup>

While editing the project file, change the StartupObject to point to your App class. Add the following PropertyGroup to your .csproj file:

<PropertyGroup>
    <StartupObject>YourNamespace.App</StartupObject>
</PropertyGroup>

Add a Main method to your App.xaml.cs file. It should look similar to this:

public partial class App : Application
{
    [STAThread]
    private static void Main(string[] args)
    {
        App app = new();
        app.InitializeComponent();
        app.Run();
    }
    // The rest of your App.xaml.cs code goes here
}

Verify the changes by ensuring your app still starts correctly.

3

Configure Velopack at the beginning of Main

Velopack needs to be able to bootstrap your application and handle updates. You can do this by calling VelopackApp.Build().Run() at the start of your Main method.

static void Main(string[] args)
{
    VelopackApp.Build().Run();
    // ... your other startup code below
}

4

Add update check within your app

Velopack provides a simple way to check for updates and apply them. The following show how to implement a basic update check within your application.

You can also split up the various methods to allow your users to control when to check for updates, download them, or apply them.

private static async Task UpdateMyApp()
{
    var mgr = new UpdateManager("https://the.place/you-host/updates");

    // check for new version
    var newVersion = await mgr.CheckForUpdatesAsync();
    if (newVersion == null)
        return; // no update available

    // download new version
    await mgr.DownloadUpdatesAsync(newVersion);

    // install new version and restart app
    mgr.ApplyUpdatesAndRestart(newVersion);
}

6

Publish App

Before building a Velopack release, you must first build your application and publish it to a directory.

For simplicity, we recommend publishing it as a self-contained application.

dotnet publish yourApp.csproj -c Release --self-contained -r win-x64 -o .\publish

tip

Starting with .NET 7, the -o/--output option can no longer be used with a solution file.

Starting with .NET 8 and later, the dotnet publish command defaults to the Release configuration, so you can omit the -c Release option. For more details see https://learn.microsoft.com/en-us/dotnet/core/compatibility/sdk/8.0/dotnet-publish-config.

If you execute the dotnet publish command from within the same directory as the .csproj file, you can omit the project argument. You can find more details on the dotnet publish documentation.

6

Install vpk

Velopack uses a command line tool called vpk to package and publish releases. It is distributed as a .NET global tool. Though Velopack can be used with app from various languages, the .NET is required to install and run vpk. You can install the .NET SDK from the .NET download page.

Once .NET is installed, you can install vpk by running:

dotnet tool install -g vpk

7

Build Velopack release!

You are now ready to build a Velopack release for your application.

The --packId can be any unique application identifier that you wish to use. Because this must be unique across all applications, we recommend including your company name: <CompanyName>.<AppName>.

The --mainExe option is only required if your executable name is different than the --packId of your application.

See the CLI reference for more details on the available options.

vpk pack --packId YourAppId --packVersion 1.0.0 --packDir .\publish --mainExe yourMainApp.exe

✅ You're Done! Your app now has auto-updates and an installer. You can upload your release to your website, or use the vpk upload command to publish it to the destination of your choice.

You can also check out our Sample Apps to see completed examples that leverage Velopack.