SuperAPI AI 工具集

winui-setup

通用与其它

查看项目

更新于 10-16 00:32

技能介绍

用途:安装并校验其他 winui-* 技能所依赖的前置条件,包括 .NET SDK、WinApp CLI 和开发者模式,并识别特定工作流的附加要求。该技能按幂等方式工作:先检测全部状态,再只安装或升级缺失项,最后输出一份汇总。

主要能力:检测 .NET SDK 是否达到 8.0.100+(项目模式的 winapp run 需要);检测 WinApp CLI 是否达到已发布的 0.7.0+(预发布版不算满足要求,除非用户要求预览验证);检测注册表项 AllowDevelopmentWithoutDevLicense 是否为 1(开发者模式)。随后按需安装或升级,并将 Native AOT、Windows Sandbox 的需求与基础工具链分开报告。

使用方式:需用户批准后才执行需要管理员权限或体积较大的安装,例如 .NET SDK、开发者模式和 Native AOT 编译工具。WinApp CLI 是按用户安装的 MSIX 包,可直接安装或升级并告知用户变化。安装命令保持原样:winget install --id Microsoft.DotNet.SDK.10 --exact --silent --accept-package-agreements --accept-source-agreements;winget install --id Microsoft.WinAppCli --exact --silent --accept-package-agreements --accept-source-agreements;winget upgrade --id Microsoft.WinAppCli --exact --silent --accept-package-agreements --accept-source-agreements。安装或升级后需刷新 PATH。开发者模式通过 UAC 提权修改注册表:Start-Process powershell -Verb RunAs -ArgumentList @('-NoProfile','-Command',"New-Item -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock' -Force | Out-Null; Set-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock' -Name AllowDevelopmentWithoutDevLicense -Type DWord -Value 1") -Wait。

适用场景:为 WinUI 3 应用开发准备环境;Native AOT 发布/运行需要 Visual Studio 或 Build Tools 的桌面 C++ 工作负载及对应架构工具与 Windows SDK;Windows Sandbox 应用运行与 UI 自动化需要 Windows 11 24H2+、硬件虚拟化及可用的沙盒功能,支持的版本为 Pro、Enterprise、Education,不含 Home。启用 Windows Sandbox 由用户操作(管理员权限加重启)。

限制:不要单独安装模板包,模板发现与安装由 WinApp CLI 0.7 通过 winapp new 管理。不安装 Visual Studio(可选),Native AOT 只需 MSVC C++ 编译工具。不安装或升级用户的 AI 编码工具。不要为整个会话提权,只对特定已批准的操作请求提权。安装失败不要静默重试。若已装版本满足 CLI 最低要求及项目目标框架/global.json,不要重复安装其他 SDK。缺失事实暂未提供。