When should copy-local be set to true and when should it not?

.net msbuild reference copy-local
Fadeproof picture Fadeproof · Mar 2, 2009 · Viewed 72k times · Source

I am wondering if there are any heuristics for when to set copy-local=true for references?

If referenced types are only used internally can I set copy-local to true but if referenced types are exposed as parameters or return values I set copy-local to false and indicate that a specific version of the dependency should be referenced when my library should be used?

Can anyone clarify this for me?

Answer

JaredPar picture JaredPar · Mar 2, 2009

Copy local is important for deployment scenarios and tools. As a general rule you should use CopyLocal=True if the reference is not contained within the GAC.

Copy Local essentially means I must manually deploy this DLL in order for my application to work. When it's false it essentially means "I depend on another component which must be installed separately or chained, the DLL will just be there already".

Related questions

How to make MSBuild to automatically copy all indirect references to output (bin) folder

Subj. "Automatically" is essential here. References from GAC must not be copied. I've seen e.g. VS2008.NET: Getting a referenced project’s dependencies to copy to main project’s bin folder, and this isn't interesting for me. I'd like …

Read More
Found conflicts between different versions of the same dependent assembly that could not be resolved

When I clean and then build my solution that has several projects, the output window reports that the build succeeded. However, when I view the Error List Window, it shows me this warning: Found conflicts between different versions of the …

Read More
Resolving MSB3247 - Found conflicts between different versions of the same dependent assembly

A .NET 3.5 solution ended up with this warning when compiling with msbuild. Sometimes NDepend might help out but in this case it didn't give any further details. Like Bob I ended up having to resort to opening each assembly in …

Read More