ClickOnce发布时appsettings.json未部署及多版本共存问题求助

一、修复预览项目发布时appsettings.json未纳入Application Files的问题 #

问题根源是预览项目仅引用原项目程序集，原项目的appsettings.json作为内容文件，ClickOnce默认不会自动将引用项目的内容文件加入部署清单（即使文件已复制到本地发布目录）。

修复步骤： #

1. 修改预览项目的.csproj文件，添加对原项目appsettings.json的显式引用，使用<ContentWithTargetPath>确保文件被ClickOnce识别：

<ItemGroup>
  <!-- 替换为你的原项目相对路径，比如..\ProductionProject\appsettings.json -->
  <ContentWithTargetPath Include="..\你的原项目名称\appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
    <TargetPath>appsettings.json</TargetPath>
    <PublishState>Include</PublishState>
  </ContentWithTargetPath>
  
  <!-- 保留已有的appsettings.*.json配置 -->
  <Content Include="appsettings.*.json">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    <CopyToPublishDirectory>Always</CopyToPublishDirectory>
  </Content>
</ItemGroup>

• <ContentWithTargetPath>：指定文件复制到输出目录的目标路径，避免路径混乱
• <PublishState>Include</PublishState>：强制ClickOnce将该文件加入部署清单，使其出现在Application Files中

2. 验证配置：右键预览项目 → 属性 → 发布 → 应用程序文件，确认appsettings.json的发布状态为「包含」，若不是则手动修改。

二、同一项目实现ClickOnce多版本共存的更优方案（无需新建项目） #

新建预览项目的方式繁琐，可通过MSBuild条件配置，在同一个项目中实现生产版/预览版分离发布，避免互相覆盖：

实现步骤： #

1. 创建预览版发布配置：

   • 打开VS顶部工具栏「生成」→「配置管理器」
   • 点击「活动解决方案配置」下拉框 →「新建」，输入名称（如Preview），复制设置自Release，勾选「创建新项目配置」后确定。

2. 修改原项目的.csproj，针对Preview配置设置独立属性：

<!-- 原生产版基础配置 -->
<AssemblyName>YourMainProject</AssemblyName>
<ProductName>YourMainProject</ProductName>
<PublishUrl>\\server\publish\Production\</PublishUrl>

<!-- 预览版专属配置 -->
<PropertyGroup Condition=" '$(Configuration)' == 'Preview' ">
  <AssemblyName>YourMainProject-Preview</AssemblyName>
  <ProductName>YourMainProject 预览版</ProductName>
  <PublishUrl>\\server\publish\Preview\</PublishUrl>
  <InstallUrl>\\server\publish\Preview\</InstallUrl>
  <!-- 可选：自动生成带预览标识的版本号 -->
  <Version>1.0.*-preview</Version>
</PropertyGroup>

• AssemblyName：ClickOnce区分应用的核心标识，修改后预览版与生产版会被视为独立应用，不会互相覆盖
• ProductName：在开始菜单、控制面板中显示的应用名称，方便团队区分
• PublishUrl：指定不同的发布目录，避免文件冲突

3. 自动化发布（可选）：
   使用MSBuild命令行一键发布不同版本：

# 发布生产版
msbuild YourMainProject.csproj /p:Configuration=Release /t:Publish

# 发布预览版
msbuild YourMainProject.csproj /p:Configuration=Preview /t:Publish

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