如何为ClickOnce添加自定义必备组件？实操疑问求助

调研疑问解答 #

1. Bootstrap目录无.NET 5组件的原因 #

ClickOnce默认必备组件由Visual Studio安装时选择性部署，.NET 5这类较新运行时未被默认纳入Bootstrapper Packages目录，需手动添加自定义组件补充。

2. 配置文件复制后VS不显示新组件的排查点 #

• 文件夹结构错误：必须在c:\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages下新建独立子文件夹（如AspNetCoreRuntime5.x），将product.xml和en文件夹（内含package.xml）放入该子文件夹，不能直接置于Packages根目录。
• 未重启VS：配置文件添加后VS不会自动刷新，需重启才能加载新组件。
• XML语法错误：检查product.xml和package.xml的标签闭合、属性引号等，语法错误会导致加载失败。

3. 组件显示后的配置修改要点 #

product.xml关键配置：

• ProductCode：生成唯一GUID（用VS的「创建GUID」工具），避免与现有组件冲突。
• PackageFile节点：
  • Name填写ASP.NET Core Runtime安装包文件名（如aspnetcore-runtime-5.0.17-win-x86.exe）。
  • PublicKey：通过signtool.exe verify /pa <安装包路径>命令提取官方安装包的公钥。
• InstallChecks节点：添加注册表检测逻辑，判断目标机器是否已安装：

  <RegistryCheck Property="AspNetCoreRuntimeInstalled" Key="HKLM\SOFTWARE\Microsoft\ASP.NET Core\5.0.17" Value="Version" />
  

• Commands节点：配置静默安装命令：

  <Command PackageFile="aspnetcore-runtime-5.0.17-win-x86.exe" Arguments="/quiet /norestart" />
  

en/package.xml关键配置：

• DisplayName：设置VS必备组件列表中显示的名称（如「ASP.NET Core Runtime 5.0.x」）。
• Description：添加组件用途描述，帮助用户理解必要性。

完整操作步骤 #

1. 从微软官方获取对应版本的ASP.NET Core Runtime离线安装包。
2. 在Bootstrapper Packages目录下创建专属子文件夹，将安装包放入其中。
3. 创建或修改product.xml和en/package.xml，按上述要求配置内容。
4. 重启Visual Studio，进入项目属性的「发布」选项卡，点击「必备组件」，即可看到新增的ASP.NET Core Runtime选项，勾选后即可随ClickOnce应用分发。

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