.NET 6 MAUI应用发布为MSIX包时配置错误求助

问题原因 #

错误提示Improper project configuration: WindowsPackageType is set to None, but PublishAppxPackage is set to true的核心是项目配置不匹配：当启用PublishAppxPackage=true（发布MSIX包）时，WindowsPackageType必须设置为MSIX（或Appx），而非None。如果解决方案中的主项目或引用项目存在这种配置冲突，就会导致发布失败。

修复步骤 #

1. 修改主MAUI项目的.csproj配置 #

打开主MAUI项目的.csproj文件，确保以下配置正确：

<PropertyGroup>
  <!-- 明确指定包类型为MSIX -->
  <WindowsPackageType>MSIX</WindowsPackageType>
  <!-- 保持发布MSIX包的设置为true -->
  <PublishAppxPackage>true</PublishAppxPackage>
  <!-- 若需自包含运行时，添加此配置（可选） -->
  <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>
</PropertyGroup>

2. 统一配置所有引用的.NET 6项目 #

对于解决方案中所有被引用的类库项目，打开它们的.csproj文件，添加或修改以下配置，避免被误识别为需发布的包项目：

<PropertyGroup>
  <!-- 类库项目不需要打包，设置为None -->
  <WindowsPackageType>None</WindowsPackageType>
  <!-- 禁用类库的Appx包发布 -->
  <PublishAppxPackage>false</PublishAppxPackage>
</PropertyGroup>

3. 完善package.appxmanifest文件 #

你的package.appxmanifest中存在大量占位符（如$placeholder$），需要替换为实际内容：

• 将所有$placeholder$替换为你的应用名称、图标路径（确保图标文件存在于项目中）
• 确认<Identity>节点的Name、Publisher、Version信息正确（Publisher可使用测试证书，发布时Visual Studio会引导你创建）
• 保留<rescap:Capability Name="runFullTrust" />，MAUI桌面应用需要此权限

4. 正确执行发布流程 #

在Visual Studio中：

• 右键主MAUI项目 → 发布
• 选择Windows → 打包（MSIX）
• 选择旁加载（因为不发布到Microsoft Store），按照向导配置证书（可创建测试证书）
• 完成配置后启动发布，此时会正确打包包含字体等资源的MSIX包

补充说明 #

发布为独立exe时缺失字体等资源，是因为独立exe发布未正确打包MAUI的资源文件；而MSIX包会自动包含项目中标记为嵌入资源或内容的文件，解决资源缺失问题。

内容的提问来源于stack exchange，提问作者Andreas