SourceLink doesn't work well with WPF projects

[tmat]

Error

Microsoft.Managed.Core.targets(90,5): SourceRoot items must include at least one top-level (not nested) item when DeterministicSourcePaths is true [C:\Temp\WpfApp1\WpfApp1\WpfApp1_3qoc4wf0_wpftmp.csproj]

is reported when building with /p:ContinuousIntegrationBuild=true.

Due to NuGet/Home#5894 - WPF projects do not import .props and .targets files from NuGet packages.

[tmat]

The workaround is to add

<DeterministicSourcePaths Condition="'$(EnableSourceLink)' == ''">false</DeterministicSourcePaths>

to the .csproj file.

[JamesNK]

I get this in Newtonsoft.Json.Tests and Newtonsoft.Json.TestConsole when I build. I'm guessing because IsPackable is false?

[JamesNK]

Or is the issue that I am building an entire solution and source link doesn't like multiple csprojs?

I've fixed the error by adding the code above to the two test projects - https://github.com/JamesNK/Newtonsoft.Json/pull/1746/files#diff-9d91529ee3797584a27061bbad1d49ceR16

[tmat]

The issue in Newtonsoft.Json is related but different than the WPF issue.

When DeterministicSourcePaths is enabled the compiler needs to know the set of directories that all source code resides under. This set is specified by SourceRoot items.
In projects that reference SourceLink package SourceRoot items are populated by SourceLink since it knows where the repository root is.

In projects that do not reference SourceLink package this SourceRoot is undefined and hence the compiler doesn’t know how to normalize the paths and reports the error [1].

The recommendation is to include the SourceLink package reference to all projects in the repo (even to test projects). This can be easily accomplished via adding Directory.Build.props file in the root of the repository that includes the SoruceLink package:

<Project>
  <PackageReference Include="Microsoft.SourceLink.GitHub" Version="..." PrivateAssets="all"/>
</Project>

[1] The compiler does not infer the source root(s) based on source file paths it is given as this might produce confusing results. Consider a repo with two projects:

.../src/ProjectA/ProjectA.csproj
.../src/ProjectA/Program.cs
.../src/ProjectB/ProjectB.csproj
.../src/ProjectB/Program.cs

If the compiler inferred the source roots for these projects they would be .../src/ProjectA/ and .../src/ProjectB/ and the paths embedded in DLLs and PDBs to Program.cs files would be /_/Program.cs for both .../src/ProjectA/Program.cs and .../src/ProjectB/Program.cs. So it would be impossible to distinguish which Program.cs is which.

[xied75]

In my case I have a src project with .NET Framework and a test project, building and packaging in a Jenkins. So that I need to turn on DeterministicSourcePaths for the msbuild.exe. (Turn on ContinuousIntegrationBuild has no effects at all.)

Then the work around suggested above won't work anymore, as the Property value supplied at command line to msbuild.exe overrides csproj settings. In order to "remove" the test project from sourcelink process, I need to add this to the test csproj file:

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" DefaultTargets="Build" TreatAsLocalProperty="DeterministicSourcePaths" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
...
  <DeterministicSourcePaths>false</DeterministicSourcePaths>
  </PropertyGroup>

[tmat]

Turn on ContinuousIntegrationBuild has no effects at all.

Does your project set Deterministic property to true?

in order to "remove" the test project from sourcelink process

Why do you need to remove it?

[xied75]

@tmat

if you mean /Deterministic to the Roslyn, I didn't set it.

Why do you need to remove it?

Because I don't want to install SourceLink nuget package into my testing project, and then the compile would error out.

[tmat]

Since you do not import Microsoft.Net.Sdk and do not set Deterministic then ContinuousIntegrationBuild has no effect since only affects deterministic builds.

the compile would error out.

What error does it report?

[xied75]

(InitializeSourceRootMappedPaths target) -> 
  C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\MSBuild\15.0\bin\Roslyn\Microsoft.Managed.Core.targets(90,5): error : SourceRoot items must include at least one top-level (
not nested) item when DeterministicSourcePaths is true [C:\github\xxx\src\Shared.Utilities\tests\Shared.Utilities.Test.csproj]

    0 Warning(s)
    1 Error(s)

msbuild on the src csproj alone would work, if msbuild the solution file, which including the test project, would give above error.

[tmat]

Right, so that's because you don't have SourceLink and you switch DeterministicSourcePaths to true. I guess I do not understand why you don't want SourceLink in your testing project.