MAUI Windows端ClickOnce应用启动时无法自动更新问题排查

问题根源 #

你当前发布输出的是MSIX格式包（含.msix文件），而非ClickOnce部署所需的核心结构（缺少.application版本清单文件）。MAUI Windows项目默认采用MSIX发布，若要沿用WPF的ClickOnce自动更新逻辑，需手动指定发布协议并调整配置。

修正步骤 #

1. 切换到ClickOnce发布协议 #

• 新建发布配置：右键MAUI项目 → 「发布」，选择「ClickOnce」作为发布目标（不要选MSIX Package）；
• 编辑现有pubxml：若已有发布配置，打开对应的.pubxml文件，添加/修改关键配置：

  <!-- 指定发布协议为ClickOnce -->
  <PublishProtocol>ClickOnce</PublishProtocol>
  <!-- 应用版本号，每次发布需递增 -->
  <ApplicationVersion>1.8.14.0</ApplicationVersion>
  <ApplicationRevision>1</ApplicationRevision>
  <!-- 启用自动更新 -->
  <UpdateEnabled>true</UpdateEnabled>
  <!-- 更新检查模式：Foreground为启动时检查 -->
  <UpdateMode>Foreground</UpdateMode>
  <!-- 更新源路径：指向文件共享的根目录 -->
  <UpdateUrl>\\你的文件共享服务器\发布根目录\</UpdateUrl>
  

  注意：UpdateUrl必须指向存放.application文件的根目录，而非单个版本的子文件夹。

2. 版本号同步配置 #

每次发布前，确保项目版本与发布配置一致：

• 可在项目属性 → 「打包」 → 「版本」中调整版本号，或直接修改pubxml中的ApplicationVersion；
• 版本号的第四段（修订号）可通过ApplicationRevision自动递增，也可手动修改。

3. 正确部署到文件共享 #

发布完成后，将Visual Studio生成的整个发布根目录（而非单个版本子文件夹）复制到文件共享服务器。该根目录下会包含：

• 顶层的.application文件（版本清单）；
• 各版本的子文件夹（如MauiAppPublishTest_1.8.14.0_Test）；
• 依赖文件与证书文件。

4. 确保客户端信任证书 #

将自签名证书安装到所有目标客户端的本地计算机 → 受信任的根证书颁发机构存储区，避免安装或更新时出现证书信任提示。

验证流程 #

1. 从文件共享服务器的.application文件启动安装（不要直接运行.msix）；
2. 递增版本号后重新发布，并将发布根目录同步到文件共享；
3. 启动已安装的应用，检查是否触发自动更新提示。

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