Files
STM32F4-Base/simulator/build_sim.ps1
wandering1 dc5d6a0680
CI / L0 静态门禁 (pre-commit) (push) Failing after 7m4s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 3m6s
fix(ci): ui-golden 需要机器级 SDL2 SDK——补 DTU_SDL2_DIR、配置期护栏与 build 缓存自愈
2026-10-27 17:32:35 +08:00

155 lines
6.4 KiB
PowerShell
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#Requires -Version 5.1
<#
.SYNOPSIS
LVGL PC 模拟器一键构建(Visual Studio 版本自适应,x64)。
.DESCRIPTION
不同开发机安装的 VS 版本不同,CMake 生成器必须与本机 VS 大版本一致,
因此构建入口不写死生成器:本脚本用 vswhere 自动探测本机 Visual Studio
(VS / BuildTools 均可),按大版本映射 CMake 生成器,取已安装的最高版本:
16 = "Visual Studio 16 2019"
17 = "Visual Studio 17 2022"
18 = "Visual Studio 18 2026"
若 build/ 目录缓存的生成器与探测结果不一致(换机/升级 VS 后),
自动删除 build/ 重新配置,避免 MSBuild 报生成器不匹配。
退出码:0=成功;1=构建失败;3=环境预检失败(无 cmake / 无 VS / VS 版本过新)。
.PARAMETER Config
构建配置,默认 Debug(可选 Release)。
.PARAMETER Clean
强制删除 build/ 后全量重建。
.EXAMPLE
& 'simulator\build_sim.ps1' # 仓库根目录执行,日常增量构建
& 'simulator\build_sim.ps1' -Clean # 全量重建
& 'simulator\build_sim.ps1' -Config Release # Release 构建
#>
param(
[ValidateSet('Debug', 'Release')]
[string]$Config = 'Debug',
[switch]$Clean
)
$ErrorActionPreference = 'Stop'
# 本脚本位于 simulator/ 目录
$simDir = $PSScriptRoot
$buildDir = Join-Path $simDir 'build'
# --- 1. 环境预检 -----------------------------------------------------------
$cmake = Get-Command cmake -ErrorAction SilentlyContinue
if (-not $cmake) {
Write-Host '[build_sim] 预检失败:PATH 中找不到 cmake' -ForegroundColor Red
exit 3
}
# vswhere:DTU_VSWHERE 显式覆盖 > %ProgramFiles(x86)% 推导(不保留固定 C 盘值)
$vswhere = $env:DTU_VSWHERE
if ($vswhere) {
if (-not (Test-Path -LiteralPath $vswhere)) {
Write-Host "[build_sim] 预检失败:DTU_VSWHERE 已设置但文件不存在:$vswhere" -ForegroundColor Red
exit 3
}
} elseif (${env:ProgramFiles(x86)}) {
$vswhere = Join-Path ${env:ProgramFiles(x86)} 'Microsoft Visual Studio\Installer\vswhere.exe'
}
if (-not $vswhere -or -not (Test-Path -LiteralPath $vswhere)) {
Write-Host '[build_sim] 预检失败:未找到 vswhere(本机未安装 Visual Studio / BuildTools,或布局非标准;可用 DTU_VSWHERE 指向 vswhere.exe 完整路径)' -ForegroundColor Red
exit 3
}
# --- 2. 探测 VS 大版本 → 选择生成器 ----------------------------------------
$raw = & $vswhere -products * -format json
$instances = @($raw | ConvertFrom-Json) # 单实例时 PS5.1 返回裸对象,@() 统一成数组
$instances = $instances | Where-Object { $_ -and $_.installationVersion }
if (-not $instances) {
Write-Host '[build_sim] 预检失败:vswhere 未返回任何 VS 实例' -ForegroundColor Red
exit 3
}
$best = $instances |
Sort-Object { [version]$_.installationVersion } |
Select-Object -Last 1
$major = [version]$best.installationVersion
switch ($major.Major) {
16 { $generator = 'Visual Studio 16 2019' }
17 { $generator = 'Visual Studio 17 2022' }
18 { $generator = 'Visual Studio 18 2026' }
default {
Write-Host "[build_sim] 预检失败:不支持的 VS 大版本 $($major.Major)($($best.installationPath)),仅支持 16/17/18" -ForegroundColor Red
exit 3
}
}
Write-Host "[build_sim] 探测到 VS $($best.installationVersion) -> 生成器 '$generator'"
# 删除 build/ 目录(带重试:抗杀软瞬时锁/文件占用;彻底失败则提示用户)
function Remove-BuildDir([string]$Dir) {
for ($i = 1; $i -le 3; $i++) {
try {
Remove-Item $Dir -Recurse -Force -ErrorAction Stop
return $true
} catch {
if ($i -lt 3) {
Write-Host "[build_sim] build/ 删除失败(可能有文件被占用),重试 $i/3 ..."
Start-Sleep -Seconds 2
}
}
}
Write-Host '[build_sim] 无法删除 build/:若模拟器窗口仍开着,请先关闭再重试' -ForegroundColor Red
return $false
}
# --- 3. 生成器一致性检查(缓存不匹配则删 build/ 重建)-----------------------
if ($Clean -and (Test-Path $buildDir)) {
if (-not (Remove-BuildDir $buildDir)) { exit 3 }
Write-Host '[build_sim] -Clean:已删除 build/'
}
$cache = Join-Path $buildDir 'CMakeCache.txt'
if (Test-Path $cache) {
# CMake 缓存中 CMAKE_GENERATOR 的类型随版本为 STRING 或 INTERNAL,统一按行首匹配
$cached = (Select-String -Path $cache -Pattern '^CMAKE_GENERATOR:' |
Select-Object -First 1).Line -replace '^CMAKE_GENERATOR:[A-Z]+=', ''
if ($cached -cne $generator) {
Write-Host "[build_sim] build/ 由 '$cached' 配置,与本机 '$generator' 不符 -> 删除重建"
if (-not (Remove-BuildDir $buildDir)) { exit 3 }
}
}
# 半截缓存检查:上一次配置如果在 CMakeLists 里 FATAL_ERROR 中断(例如缺 SDL2 SDK),
# CMakeCache.txt 已经写下、工程文件却根本没生成,于是下面「有缓存就不配置」会跳过配置,
# 失败点跑到离根因很远的 MSBuild(MSB1009: 项目文件不存在)——2026-10-27 在 CI 等价工作区
# 实测:设好 DTU_SDL2_DIR 之后仍然红,红因就是这个残留缓存。与上面的生成器不符同理,
# 删掉 build/ 重来,让报错回到配置期那一行。
if ((Test-Path $cache) -and -not (Test-Path (Join-Path $buildDir 'ALL_BUILD.vcxproj'))) {
Write-Host '[build_sim] build/ 有缓存但没有工程文件(上次配置中断)-> 删除重建' -ForegroundColor Yellow
if (-not (Remove-BuildDir $buildDir)) { exit 3 }
}
# --- 4. 配置 + 构建 ---------------------------------------------------------
if (-not (Test-Path (Join-Path $buildDir 'CMakeCache.txt'))) {
Write-Host '[build_sim] CMake 配置 ...'
& cmake -S $simDir -B $buildDir -G $generator -A x64
if ($LASTEXITCODE -ne 0) {
Write-Host '[build_sim] CMake 配置失败' -ForegroundColor Red
exit $LASTEXITCODE
}
}
Write-Host "[build_sim] 构建($Config)..."
& cmake --build $buildDir --config $Config
if ($LASTEXITCODE -ne 0) {
Write-Host '[build_sim] 构建失败' -ForegroundColor Red
exit $LASTEXITCODE
}
$exe = Join-Path $buildDir (Join-Path $Config 'lvgl_sim.exe')
if (Test-Path $exe) {
Write-Host "[build_sim] OK:$exe" -ForegroundColor Green
exit 0
}
Write-Host "[build_sim] 构建退出码 0 但未找到 $exe" -ForegroundColor Red
exit 1