RELEASE.md

Making a release build

One-time setup

These steps are performed on a trusted build machine.

Ensure the following software is installed:

1. Visual Studio 2019 or later.
2. Windows Driver Kit (WDK) version 10.0.18362.1 or later.
3. Windows 10, version 2004 or later.

Configure signing locally:

1. Install Safenet Authentication Client.
2. Register EV certificate in user store.

Configure signing in Microsoft partner portal:

1. Partner portal login page (use Azure account): Partner Portal
2. Instructions for registering EV certificate with Microsoft: Add or Update a code signing certificate
3. Instructions for configuring attestation signing: Attestation signing a kernel driver for public release

Preparations

1. Ensure changelog is updated and includes all relevant changes.
2. Make appropriate changes to version number components in src/version.h. Push changes.
3. Create and push a signed Git tag which is named after the current updated version, e.g. v1.2.3.4.

Building

1. Clone/pull updated driver code on trusted build machine.
2. Launch Developer Command Prompt for VS 2019.
3. cd into driver repository.
4. Run build.bat <certificate-sha1-thumbprint> to build and sign the driver.
5. Artifacts are prepared under bin/dist/:
   1. mullvad-split-tunnel-amd64.cab is an intermediate driver package for Windows 10.
   2. mullvad-split-tunnel.pdb contains debug information.
6. Upload intermediate driver package to Microsoft for attestation signing.
7. Download attestation signed driver package.

Updating dependent repositories

1. In the mullvadvpn-app-binaries repository:
   1. In subfolder x86_64-pc-windows-msvc/split-tunnel/:
      1. Extract attestation signed driver package.
      2. Update driver PDB file.
   2. Merge file updates into master.
2. In the mullvadvpn-app repository:
   1. Update the mullvadvpn-app-binaries submodule reference.
   2. Merge reference update into master.