Skip to content

Binary Releases

Rajesh Malviya edited this page Aug 29, 2023 · 5 revisions

The binary releases are built to provide an easy way to get started without having to build wgpu-native yourself. The releases should generally not be regarded as major milestones, but rather as snapshots of the current state of wgpu-native, wgpu-core and Naga.

Versioning

The versioning (currently) follows wgpu-core, with one extra "build number". The version number will thus typically have 4 numbers.

The wgpuGetVersion function

The library provides a function to obtain the version number matching the Github release version. It returns an uint32 where each byte represents one element of the version number.

Linux builds

The binaries for Linux are built using manylinux, a Docker image that is designed such that any binaries built would work on large variety of other Linux distributions.

Currently wgpu-native uses manylinux_2_28 version of manylinux image, because that's the only image that ships recent enough version of clang, which is unfortunately required by the bindgen crate.

Creating a release

To create a release (by devs with push-rights to this repo):

  • git tag va.b.c.d, with a.b.c the version of wgpu-core as specified in Cargo.toml, and d the "build number".
  • git push the tag.
  • Github Actions does the rest.