MSIX打包必须使用Visual Studio 2019或更新版本并安装UWP工作负载，主项目需设为自包含单文件发布、正确配置TargetFramework与TargetPlatformMinVersion，引用原生NuGet包，签名证书须受信任，调试需启用启动项目和本地部署。
MSIX打包必须用Visual Studio 2019或更新版本
旧版VS（如2017）不支持MSIX项目模板，强行用MakeAppx.exe手动打包会缺失签名、依赖解析和AppXManifest校验，导致安装失败或运行时崩溃。确认VS版本后，需安装「Universal Windows Platform development」工作负载，否则新建项目时看不到Windows Application Packaging Project模板。
常见错误现象：error APPX0501: The manifest file does not conform to the schema——多半是项目未正确关联UWP目标平台或TargetPlatformMinVersion低于系统支持版本。
- 确保主应用项目（如WPF/WinForms）的
TargetFramework为net6.0-windows10.0.19041.0或更高（推荐net8.0-windows10.0.22621.0） - 打包项目属性中，
TargetPlatformMinVersion不能低于主项目所用的最低Windows版本 - 若引用了第三方NuGet包（如
Microsoft.Data.Sqlite），需确认其含win-x64或win-arm64原生二进制，否则打包后运行时报DLLNotFoundException
WPF/WinForms项目必须启用“单文件发布+自包含”模式
MSIX不接受.NET运行时动态下载，所有依赖必须打包进包内。默认的“框架依赖型”发布方式会导致安装后启动闪退，错误日志里常出现0x80070002或Failed to load hostfxr.dll。
实操关键点：
- 在打包项目属性 → «Package Manifest» → «Application» 页签，勾选«Generate App Bundle»并设为«Always»
- 主应用项目的
.csproj中显式添加：<propertygroup><publishtrimmed>false</publishtrimmed><selfcontained>true</selfcontained><publishsinglefile>true</publishsinglefile><runtimeidentifier>win-x64</runtimeidentifier></propertygroup>
- 若需支持ARM64设备，须单独为
win-arm64生成一个MSIX包，MSIX不支持多RID混合打包
证书签名是安装前提，自签名证书必须被信任
未签名的MSIX只能通过PowerShell用Add-AppxPackage -Register临时注册，且每次重启后失效；双击安装必然失败，提示error 0x800B0109: A certificate chain processed, but terminated in a root certificate which is not trusted by the trust provider。
解决路径：
- 用
MakeCert.exe或New-SelfSignedCertificate生成pfx证书，注意指定-Type CodeSigning - 将该证书导入当前用户「受信任的根证书颁发机构」存储区（非「个人」区）
- 在打包项目属性 → «Signing» 页签中，选择pfx文件并填入密码；勾选«Sign the package after build»
- 若用Azure Pipelines或GitHub Actions自动化构建，需把pfx Base64编码后存为secret，并在CI脚本中解码写入临时文件再签名
调试阶段禁用“仅限本地部署”，否则无法附加调试器
打包项目默认启用«Do not launch application after deployment»，且调试时VS尝试以受限上下文启动，导致断点不命中、Debugger.Launch()无响应、甚至App.xaml.cs中的初始化逻辑被跳过。
必须调整两项设置：
- 打包项目属性 → «Debug» 页签，取消勾选«Do not launch application after deployment»
- 同一页面，将«Start action»改为«Start project»（而非«Start external program»）
- 若主项目是WPF，还需在
App.xaml中确认StartupUri未被注释，且OnStartup中避免调用需要高权限的API（如注册表写入），否则调试时弹UAC框中断流程
MSIX不是简单的“换个后缀”，它强制应用声明能力、隔离资源、依赖系统级部署服务。最易忽略的是：即使只改一行代码，也必须重新生成整个MSIX包——增量构建不可靠，缓存残留常导致Manifest与实际二进制不一致。
