mirror of
https://github.com/libsdl-org/SDL.git
synced 2025-11-04 01:34:38 +00:00
e07e446a3f
According to Steam's OS stats, Windows 8.0 use is pretty much nil. Further, Microsoft hasn't support Windows 8.0 development in any of their actively-updated toolchains, and setting it up can be a pain. In theory, SDL2 still supports Windows 8.0, however building of Windows 8.0 .dlls is no longer the default, if and when using the 'winrtbuild.*' scripts. The MSVC 2012 project files for building Windows 8.0 dlls remain, though, for the time being.
301 lines
12 KiB
PowerShell
301 lines
12 KiB
PowerShell
#
|
|
# winrtbuild.ps1 -- A Powershell script to build all SDL/WinRT variants,
|
|
# across all WinRT platforms, in all of their supported, CPU architectures.
|
|
#
|
|
# Initial version written by David Ludwig <dludwig@pobox.com>
|
|
#
|
|
# This script can be launched from Windows Explorer by double-clicking
|
|
# on winrtbuild.bat
|
|
#
|
|
# Output will be placed in the following subdirectories of the SDL source
|
|
# tree:
|
|
# * VisualC-WinRT\lib\ -- final .dll, .lib, and .pdb files
|
|
# * VisualC-WinRT\obj\ -- intermediate build files
|
|
#
|
|
# Recommended Dependencies:
|
|
# * Windows 8.1 or higher
|
|
# * Powershell 4.0 or higher (included as part of Windows 8.1)
|
|
# * Visual C++ 2012, for building Windows 8.0 and Windows Phone 8.0 binaries.
|
|
# * Visual C++ 2013, for building Windows 8.1 and Windows Phone 8.1 binaries
|
|
# * SDKs for Windows 8.0, Windows 8.1, Windows Phone 8.0, and
|
|
# Windows Phone 8.1, as needed
|
|
#
|
|
# Commom parameters/variables may include, but aren't strictly limited to:
|
|
# * PlatformToolset: the name of one of Visual Studio's build platforms.
|
|
# Different PlatformToolsets output different binaries. One
|
|
# PlatformToolset exists for each WinRT platform. Possible values
|
|
# may include:
|
|
# - "v110": Visual Studio 2012 build tools, plus the Windows 8.0 SDK
|
|
# - "v110_wp80": Visual Studio 2012 build tools, plus the Windows Phone 8.0 SDK
|
|
# - "v120": Visual Studio 2013 build tools, plus the Windows 8.1 SDK
|
|
# - "v120_wp81": Visual Studio 2013 build tools, plus the Windows Phone 8.1 SDK
|
|
# * VSProjectPath: the full path to a Visual Studio or Visual C++ project file
|
|
# * VSProjectName: the internal name of a Visual Studio or Visual C++ project
|
|
# file. Some of Visual Studio's own build tools use this name when
|
|
# calculating paths for build-output.
|
|
# * Platform: a Visual Studio platform name, which often maps to a CPU
|
|
# CPU architecture. Possible values may include: "Win32" (for 32-bit x86),
|
|
# "ARM", or "x64" (for 64-bit x86).
|
|
#
|
|
|
|
# Base version of SDL, used for packaging purposes
|
|
$SDLVersion = "2.0.4"
|
|
|
|
# Gets the .bat file that sets up an MSBuild environment, given one of
|
|
# Visual Studio's, "PlatformToolset"s.
|
|
function Get-MSBuild-Env-Launcher
|
|
{
|
|
param(
|
|
[Parameter(Mandatory=$true,Position=1)][string]$PlatformToolset
|
|
)
|
|
|
|
if ($PlatformToolset -eq "v110") { # Windows 8.0 (not Windows Phone), via VS 2012
|
|
return "C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\vcvarsall.bat"
|
|
}
|
|
if ($PlatformToolset -eq "v110_wp80") { # Windows Phone 8.0, via VS 2012
|
|
return "C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\WPSDK\WP80\vcvarsphoneall.bat"
|
|
}
|
|
if ($PlatformToolset -eq "v120") { # Windows 8.1 (not Windows Phone), via VS 2013
|
|
return "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\vcvarsall.bat"
|
|
}
|
|
if ($PlatformToolset -eq "v120_wp81") { # Windows Phone 8.1, via VS 2013
|
|
return "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\vcvarsall.bat"
|
|
}
|
|
if ($PlatformToolset -eq "v140") { # Windows 10, via VS 2015
|
|
return "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat"
|
|
}
|
|
return ""
|
|
}
|
|
|
|
# Gets a string that identifies the build-variant of SDL/WinRT that is specific
|
|
# to a particular Visual Studio PlatformToolset.
|
|
function Get-SDL-WinRT-Variant-Name
|
|
{
|
|
param(
|
|
[Parameter(Mandatory=$true,Position=1)][string]$PlatformToolset,
|
|
|
|
# If true, append a string to this function's output, identifying the
|
|
# build-variant's minimum-supported version of Visual Studio.
|
|
[switch]$IncludeVSSuffix = $false
|
|
)
|
|
|
|
if ($PlatformToolset -eq "v110") { # Windows 8.0 (not Windows Phone), via VS 2012 project files
|
|
if ($IncludeVSSuffix) {
|
|
return "WinRT80_VS2012"
|
|
} else {
|
|
return "WinRT80"
|
|
}
|
|
}
|
|
if ($PlatformToolset -eq "v110_wp80") { # Windows Phone 8.0, via VS 2012 project files
|
|
if ($IncludeVSSuffix) {
|
|
return "WinPhone80_VS2012"
|
|
} else {
|
|
return "WinPhone80"
|
|
}
|
|
}
|
|
if ($PlatformToolset -eq "v120") { # Windows 8.1 (not Windows Phone), via VS 2013 project files
|
|
if ($IncludeVSSuffix) {
|
|
return "WinRT81_VS2013"
|
|
} else {
|
|
return "WinRT81"
|
|
}
|
|
}
|
|
if ($PlatformToolset -eq "v120_wp81") { # Windows Phone 8.1, via VS 2013 project files
|
|
if ($IncludeVSSuffix) {
|
|
return "WinPhone81_VS2013"
|
|
} else {
|
|
return "WinPhone81"
|
|
}
|
|
}
|
|
if ($PlatformToolset -eq "v140") { # Windows 10, via VS 2015 project files
|
|
if ($IncludeVSSuffix) {
|
|
return "UWP_VS2015"
|
|
} else {
|
|
return "UWP"
|
|
}
|
|
}
|
|
return ""
|
|
}
|
|
|
|
# Returns the internal name of a Visual Studio Project.
|
|
#
|
|
# The internal name of a VS Project is encoded inside the project file
|
|
# itself, inside a set of <ProjectName></ProjectName> XML tags.
|
|
function Get-VS-ProjectName
|
|
{
|
|
param(
|
|
[Parameter(Mandatory=$true,Position=1)]$VSProjectPath
|
|
)
|
|
|
|
# For now, just do a regex for the project name:
|
|
$matches = (Get-Content $VSProjectPath | Select-String -Pattern ".*<ProjectName>([^<]+)<.*").Matches
|
|
foreach ($match in $matches) {
|
|
if ($match.Groups.Count -ge 1) {
|
|
return $match.Groups[1].Value
|
|
}
|
|
}
|
|
return $null
|
|
}
|
|
|
|
# Build a specific variant of SDL/WinRT
|
|
function Build-SDL-WinRT-Variant
|
|
{
|
|
#
|
|
# Read in arguments:
|
|
#
|
|
param (
|
|
# name of an SDL project file, minus extensions and
|
|
# platform-identifying suffixes
|
|
[Parameter(Mandatory=$true,Position=1)][string]$SDLProjectName,
|
|
|
|
[Parameter(Mandatory=$true,Position=2)][string]$PlatformToolset,
|
|
|
|
[Parameter(Mandatory=$true,Position=3)][string]$Platform
|
|
)
|
|
|
|
#
|
|
# Derive other properties from read-in arguments:
|
|
#
|
|
|
|
# The .bat file to setup a platform-appropriate MSBuild environment:
|
|
$BatchFileForMSBuildEnv = Get-MSBuild-Env-Launcher $PlatformToolset
|
|
|
|
# The full path to the VS Project that'll be built:
|
|
$VSProjectPath = "$PSScriptRoot\..\VisualC-WinRT\$(Get-SDL-WinRT-Variant-Name $PlatformToolset -IncludeVSSuffix)\$SDLProjectName-$(Get-SDL-WinRT-Variant-Name $PlatformToolset).vcxproj"
|
|
|
|
# The internal name of the VS Project, used in some post-build steps:
|
|
$VSProjectName = Get-VS-ProjectName $VSProjectPath
|
|
|
|
# Where to place output binaries (.dll, .lib, and .pdb files):
|
|
$OutDir = "$PSScriptRoot\..\VisualC-WinRT\lib\$(Get-SDL-WinRT-Variant-Name $PlatformToolset)\$Platform"
|
|
|
|
# Where to place intermediate build files:
|
|
$IntermediateDir = "$PSScriptRoot\..\VisualC-WinRT\obj\$SDLProjectName-$(Get-SDL-WinRT-Variant-Name $PlatformToolset)\$Platform"
|
|
|
|
#
|
|
# Build the VS Project:
|
|
#
|
|
cmd.exe /c " ""$BatchFileForMSBuildEnv"" x86 & msbuild ""$VSProjectPath"" /p:Configuration=Release /p:Platform=$Platform /p:OutDir=""$OutDir\\"" /p:IntDir=""$IntermediateDir\\""" | Out-Host
|
|
$BuildResult = $?
|
|
|
|
#
|
|
# Move .dll files into place. This fixes a problem whereby MSBuild may
|
|
# put output files into a sub-directory of $OutDir, rather than $OutDir
|
|
# itself.
|
|
#
|
|
if (Test-Path "$OutDir\$VSProjectName\") {
|
|
Move-Item -Force "$OutDir\$VSProjectName\*" "$OutDir"
|
|
}
|
|
|
|
#
|
|
# Clean up unneeded files in $OutDir:
|
|
#
|
|
if (Test-Path "$OutDir\$VSProjectName\") {
|
|
Remove-Item -Recurse "$OutDir\$VSProjectName"
|
|
}
|
|
Remove-Item "$OutDir\*.exp"
|
|
Remove-Item "$OutDir\*.ilk"
|
|
Remove-Item "$OutDir\*.pri"
|
|
|
|
#
|
|
# All done. Indicate success, or failure, to the caller:
|
|
#
|
|
#echo "RESULT: $BuildResult" | Out-Host
|
|
return $BuildResult
|
|
}
|
|
|
|
|
|
#
|
|
# Build each variant, with corresponding .dll, .lib, and .pdb files:
|
|
#
|
|
$DidAnyDLLBuildFail = $false
|
|
$DidAnyNugetBuildFail = $false
|
|
|
|
# Build for Windows Phone 8.0, via VC++ 2012:
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v110_wp80" "ARM")) { $DidAnyDLLBuildFail = $true }
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v110_wp80" "Win32")) { $DidAnyDLLBuildFail = $true }
|
|
|
|
# Build for Windows Phone 8.1, via VC++ 2013:
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v120_wp81" "ARM")) { $DidAnyDLLBuildFail = $true }
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v120_wp81" "Win32")) { $DidAnyDLLBuildFail = $true }
|
|
|
|
# Build for Windows 8.0 and Windows RT 8.0, via VC++ 2012:
|
|
#
|
|
# Win 8.0 auto-building was disabled on 2017-Feb-25, by David Ludwig <dludwig@pobox.com>.
|
|
# Steam's OS-usage surveys indicate that Windows 8.0 use is pretty much nil, plus
|
|
# Microsoft hasn't supported Windows 8.0 development for a few years now.
|
|
# The commented-out lines below may still work on some systems, though.
|
|
#
|
|
#if ( ! (Build-SDL-WinRT-Variant "SDL" "v110" "ARM")) { $DidAnyDLLBuildFail = $true }
|
|
#if ( ! (Build-SDL-WinRT-Variant "SDL" "v110" "Win32")) { $DidAnyDLLBuildFail = $true }
|
|
#if ( ! (Build-SDL-WinRT-Variant "SDL" "v110" "x64")) { $DidAnyDLLBuildFail = $true }
|
|
|
|
# Build for Windows 8.1 and Windows RT 8.1, via VC++ 2013:
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v120" "ARM")) { $DidAnyDLLBuildFail = $true }
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v120" "Win32")) { $DidAnyDLLBuildFail = $true }
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v120" "x64")) { $DidAnyDLLBuildFail = $true }
|
|
|
|
# Build for Windows 10, via VC++ 2015
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v140" "ARM")) { $DidAnyDLLBuildFail = $true }
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v140" "Win32")) { $DidAnyDLLBuildFail = $true }
|
|
if ( ! (Build-SDL-WinRT-Variant "SDL" "v140" "x64")) { $DidAnyDLLBuildFail = $true }
|
|
|
|
# Build NuGet packages, if possible
|
|
if ($DidAnyDLLBuildFail -eq $true) {
|
|
Write-Warning -Message "Unable to build all variants. NuGet packages will not be built."
|
|
$DidAnyNugetBuildFail = $true
|
|
} else {
|
|
$NugetPath = (Get-Command -CommandType Application nuget.exe | %{$_.Path}) 2> $null
|
|
if ("$NugetPath" -eq "") {
|
|
Write-Warning -Message "Unable to find nuget.exe. NuGet packages will not be built."
|
|
$DidAnyNugetBuildFail = $true
|
|
} else {
|
|
Write-Host -ForegroundColor Cyan "Building SDL2 NuGet packages..."
|
|
Write-Host -ForegroundColor Cyan "... via NuGet install: $NugetPath"
|
|
$NugetOutputDir = "$PSScriptRoot\..\VisualC-WinRT\lib\nuget"
|
|
Write-Host -ForegroundColor Cyan "... output directory: $NugetOutputDir"
|
|
$SDLHGRevision = $($(hg log -l 1 --repository "$PSScriptRoot\.." | select-string "changeset") -Replace "changeset:\W*(\d+).*",'$1') 2>$null
|
|
Write-Host -ForegroundColor Cyan "... HG Revision: $SDLHGRevision"
|
|
|
|
# Base options to nuget.exe
|
|
$NugetOptions = @("pack", "PACKAGE_NAME_WILL_GO_HERE", "-Output", "$NugetOutputDir")
|
|
|
|
# Try attaching hg revision to NuGet package:
|
|
$NugetOptions += "-Version"
|
|
if ("$SDLHGRevision" -eq "") {
|
|
Write-Warning -Message "Unable to find the Mercurial revision (maybe hg.exe can't be found?). NuGet packages will not have this attached to their name."
|
|
$NugetOptions += "$SDLVersion-Unofficial"
|
|
} else {
|
|
$NugetOptions += "$SDLVersion.$SDLHGRevision-Unofficial"
|
|
}
|
|
|
|
# Create NuGet output dir, if not yet created:
|
|
if ($(Test-Path "$NugetOutputDir") -eq $false) {
|
|
New-Item "$NugetOutputDir" -type directory
|
|
}
|
|
|
|
# Package SDL2:
|
|
$NugetOptions[1] = "$PSScriptRoot\..\VisualC-WinRT\SDL2-WinRT.nuspec"
|
|
&"$NugetPath" $NugetOptions -Symbols
|
|
if ( ! $? ) { $DidAnyNugetBuildFail = $true }
|
|
|
|
# Package SDL2main:
|
|
$NugetOptions[1] = "$PSScriptRoot\..\VisualC-WinRT\SDL2main-WinRT-NonXAML.nuspec"
|
|
&"$NugetPath" $NugetOptions
|
|
if ( ! $? ) { $DidAnyNugetBuildFail = $true }
|
|
}
|
|
}
|
|
|
|
|
|
# Let the script's caller know whether or not any errors occurred.
|
|
# Exit codes compatible with Buildbot are used (1 for error, 0 for success).
|
|
if ($DidAnyDLLBuildFail -eq $true) {
|
|
Write-Error -Message "Unable to build all known variants of SDL2 for WinRT"
|
|
exit 1
|
|
} elseif ($DidAnyNugetBuildFail -eq $true) {
|
|
Write-Warning -Message "Unable to build NuGet packages"
|
|
exit 0 # Should NuGet package build failure lead to a non-failing result code instead?
|
|
} else {
|
|
exit 0
|
|
}
|