Latest SDK Version API

The Latest Vulkan SDK API allows you to

Get the latest SDK version

All Platforms

curl https://vulkan.lunarg.com/sdk/latest.json

Returns the following (formatted here):

{
    "linux": "1.2.141.2",
    "mac": "1.2.141.2",
    "windows": "1.2.141.2"
}

Platform-specific

Platform-specific request can return JSON (.json) or plain text (.txt). Use the extension for whichever type you would like.

JSON examples:

# Linux
curl https://vulkan.lunarg.com/sdk/latest/linux.json
# Mac
curl https://vulkan.lunarg.com/sdk/latest/mac.json
# Windows
curl https://vulkan.lunarg.com/sdk/latest/windows.json

Returns:

{
  "linux": "1.2.141.2"
}

Text examples:

# Linux
curl https://vulkan.lunarg.com/sdk/latest/linux.txt
# Mac
curl https://vulkan.lunarg.com/sdk/latest/mac.txt
# Windows
curl https://vulkan.lunarg.com/sdk/latest/windows.txt

Returns only the value:

1.2.141.2

Automated SDK Downloads

There are two options to pull the latest SDK version:

  1. Use the "latest" URL
  2. Get the latest version and then pull that version with a version-specific URL.

Use Latest URL

# curl -O https://sdk.lunarg.com/sdk/download/latest/PLATFORM/vulkan_sdk.[exe|tar.gz|dmg]
# Linux:
curl -O https://sdk.lunarg.com/sdk/download/latest/linux/vulkan_sdk.tar.gz
# Mac:
curl -O https://sdk.lunarg.com/sdk/download/latest/mac/vulkan_sdk.dmg
# Windows:
curl -O https://sdk.lunarg.com/sdk/download/latest/windows/vulkan_sdk.exe

Use Latest Version (Linux example)

# Get the latest version (a simple text string is returned)
SDK_VERSION=`curl https://vulkan.lunarg.com/sdk/latest/linux.txt`
# Get the latest SDK with the latest version variable
curl -O https://sdk.lunarg.com/sdk/download/${SDK_VERSION}/linux/vulkan_sdk.tar.gz

For other operating systems change the platform to windows or mac and the file extension to exe or dmg respectively. Note: Depending on your shell, you may have to alter how variables are set and used in the URL. The example above is Bash.

NOTE: If you get an error because of too many downloads from your IP, please append "?Human=true" to the SDK download URL. This is to help mitigate excessive bot downloads.

Get the Config that specifies the packages that make up the SDK

The config.json file that you pull specifies the packages that make up the SDK. The URL is comprised of:

https://vulkan.lunarg.com/sdk/config/VERSION/PLATFORM/config.json where VERSION is latest or a specific version like 1.2.154.0 and PLATFORM is linux, mac, or windows.

# Latest Linux
curl -O https://vulkan.lunarg.com/sdk/config/latest/linux/config.json

# Specific MacOS version
SDK_VERSION=`curl https://vulkan.lunarg.com/sdk/latest/mac.txt`
curl -O https://vulkan.lunarg.com/sdk/config/${SDK_VERSION}/mac/config.json

NOTE: config.json files are not available for SDKs prior to version 1.2.154.0

If you need assistance, please open a ticket