默认情况下将“复制本地”设置为False？

Question

我可以将 Visual Studio 中“复制本地”的默认选项设置为 False 吗？在大多数情况下，当我添加一个 dll 作为项目的依赖项时，我希望将 Copy Local 属性设置为 False。默认情况下，它是 True。有没有办法改变 Visual Studio 的默认行为？ (2008)

Answer 1

否 - Visual Studio 使用一组内部规则来确定将本地复制设置为什么。

来自MSDN：

1. 如果引用是另一个项目，称为项目到项目引用，则值为 true。
2. 如果在全局程序集缓存中找到程序集，则值为 false。
3. 作为一种特殊情况，mscorlib.dll 引用的值为false。
4. 如果在 Framework SDK 文件夹中找到程序集，则值为 false。
5. 否则，该值为true。

Answer 2

其实可以的。你需要几样东西：

1. 创建 .targets 文件，使 copylocal（准确地说是<Private> 标签）false by default。
2. 在.csproj 文件中导入目标。您可以在最后一行添加它，在关闭 </Project> 标签之前，它看起来像 <Import Project="..\Build\yourtarget.targets" />。

现在每个具有此目标的项目都默认禁用了本地复制。

缺点是您需要修改每个 csproj 文件，包括新文件。您可以通过modifying the VS project template 解决新项目问题。您需要修改Class.vstemplate（在同一个zip文件中），而不是博客文章中描述的Class.cs。

使用这种方法，还有一个问题 - 路径本身。如果你在新生成的 csproj 文件中使用硬编码的相对路径，它们可能是错误的（除非你有扁平的项目结构）。

你可以：

• 让VS生成正确的相对路径。不知道该怎么做，也不知道这是否可能。
• 忽略它并为每个新的 csproj 手动更改路径（取决于您拥有的新项目的数量，虽然不理想，但可能是可以容忍的）。
• 使用环境变量而不是相对路径。在这种情况下，每个开发人员都需要相同的变量集。

一定有更好的解决方案，但还没有找到。

Answer 3

从 msbuild v 15 开始，您可以在包含源代码的根文件夹中复制一个名为 Directory.Build.props 的文件：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<ItemDefinitionGroup>
  <Reference>
    <Private>False</Private>
  </Reference>
  <ProjectReference>
     <Private>False</Private>
  </ProjectReference>
</ItemDefinitionGroup>
</Project>

没什么可做的！这适用于 Visual Studio 2017 以及 vNext Build。您可能必须关闭 Visual Studio，然后再次打开您的解决方案才能使文件生效。

https://docs.microsoft.com/en-us/visualstudio/msbuild/customize-your-build#directorybuildprops-and-directorybuildtargets

Answer 4

我们不使用 .targets 文件（正如 ya23 的回答中所建议的那样），因此我们只需在文本编辑器中手动编辑 .csproj 项目文件并将 <Private> 元素添加到引用中，如下所示：

<Reference Include="[...]">
  <Private>False</Private>
  [...]
</Reference>

<Private> 元素的值与“复制本地”属性的值相匹配。例如，如果<Private> 设置为 False，则“复制本地”也是 false..

Answer 5

因为现在似乎有一个 nuget 包允许这样做...

https://nuget.org/packages/CopyLocalFalse

还没试过，希望对你有帮助。

Answer 6

关于@herzbube 发布的解决方案，如果您想为 .csproj 文件中的所有（或大部分）引用关闭“复制本地”，则无需设置<Private>False</Private> 分别在每个 Reference 上，您可以直接在 .csproj 中输入以下内容：

<ItemDefinitionGroup>
  <Reference>
    <Private>False</Private>
  </Reference>
</ItemDefinitionGroup>

这不会影响使用 <ProjectReference> 引用的项目，但您可以为这些项目做同样的事情 - 或者也可以这样做：

<ItemDefinitionGroup>
  <ProjectReference>
    <Private>False</Private>
  </ProjectReference>
</ItemDefinitionGroup>

如果你想要这两个，你可以将它们合并到一个组中：

<ItemDefinitionGroup>
  <Reference>
    <Private>False</Private>
  </Reference>
  <ProjectReference>
    <Private>False</Private>
  </ProjectReference>
</ItemDefinitionGroup>

确保将这些覆盖放在您想要影响的第一个实际<Reference … > 或<ProjectReference … > 之前，因为这些块仅适用于出现在它们下方的那些引用。然后，如果您确实确实想要在本地复制一些内容，则可以单独覆盖那些back（即，在单个标签本身），这次使用True。

对于更高级的情况，您可以在同一个 .csproj 文件中多次在 True 和 False 之间来回切换覆盖值。另一种先进的技术是策略性地将您的一些引用放置在这些块下方，而其他一些则放在上面，这样后者就不会受到影响。

所有这些都应该使您的 .csproj 中的 XML 更加清晰和易于阅读。但是还有更多好消息，请继续阅读...

---

至于选择哪些项目应该标记<Private>False</Private>，这通常取决于具体情况，但有一些基本的每个人可以和应该为初学者做。这是一个如此基本、简单和有效的步骤，它提供了如此巨大的 MSBuild 可靠性改进^1. 和构建时间加速 - 而且几乎没有缺点 - 每个大型解决方案使用默认（即每个项目的本地）C# 输出位置几乎总是应该进行此调整：

在构建多个 C# 类库的任何 Visual Studio 解决方案中，具有任意数量的 <ProjectReference> 相互依赖关系，最终构建一个更多应用程序（即可执行文件）：

1. 在每个类库的 .csproj 顶部附近，插入上面显示的 <ProjectReference> 块。
   原因：任何 .dll 都不需要将它引用的任何库收集到它自己的子目录中，因为从该位置没有运行任何可执行文件。如此猖獗的复制是无用的忙碌工作，并且可能会不必要地减慢您的构建速度，甚至可能非常显着。

2. 另一方面，不要为您解决方案的任何应用程序修改 .csproj。 原因：可执行文件需要在其各自的子目录中拥有所有他们需要的私有库，但是每个应用程序的构建应该负责单独收集每个依赖项，直接从其各自的子目录到应用程序的子目录中目录。

这非常有效，因为一个类库的 .csproj 可以引用多个其他类库，但一个可执行文件的 .csproj 通常从不引用另一个可执行文件。因此，对于每个本地构建的库，其 bin 文件夹中唯一的 .dll 将是其自身，而每个本地构建的 application 将包含完整的本地- 构建它引用的库。

方便的是，对于不是由您的解决方案构建的引用库，没有任何变化，因为这些库通常使用<Reference> 而不是<ProjectReference>，我们根本没有修改前一个标签。但请注意刚才提到的假设；如果您的某些项目违反了它，您可能需要进行一些调整。

_{[1.] 可靠性改进可能与从依赖关系图中的多个不相交路径收集相同库时可能发生的文件冲突有关，尤其是在并发构建中。}