Skip to main content

systemversion

Specifies the target operation system min and max versions.

systemversion ("value")

Parameters

value is a colon-delimited string specifying the min and max version, min:max.

Ranges are currently only supported by the Windows targets with the Visual Studio actions.

Otherwise, only a minimum version can be set for macOS/iOS targets with xcode and gmake-based actions.

Applies To

Project.

Availability

Premake 5.0 or later.

Examples

filter "system:windows"
systemversion "10.0.10240.0" -- To specify the version of the SDK you want
filter "system:windows"
systemversion "latest" -- To use the latest version of the SDK available
filter "system:windows"
systemversion "10.0.10240.0:latest" -- To specify a range of minumum and maximum versions
filter "system:macosx"
systemversion "13.0" -- To target a minimum macOS deployment version of 13.0

Apple Targets

Under macOS this sets the minimum version of the operating system required for the app to run and is equivalent to setting the -macosx-version-min (or newer -macos-version-min) compiler flag.

The same is true for iOS, iPadOS, tvOS, and watchOS system targets except it is equivalent to setting the -miphoneos-version-min (or newer ios-version-min) compiler flag.

warning

There is also a -miphonesimulator-version or mios-simulator-version-min compiler flag, but iOS simulator targets are not yet supported by Premake.

For the xcode action this is equivalent to the MACOSX_DEPLOYMENT_TARGET Xcode setting.

Windows Targets

Under Windows and Visual Studio actions, this is equivalent to setting the WindowsTargetPlatformVersion (and WindowsTargetPlatformMinVersion if targetting UWP) MSBuild properties.

See Also