search

EWSoftware / SHFB

Sandcastle Help File Builder (SHFB). A standalone GUI, Visual Studio integration package, and MSBuild tasks providing full configuration and extensibility for building help files with the Sandcastle tools.
Other
2.18k stars 367 forks source link

Documenting a `net8.0` project when using `msbuild.exe` #1052

Closed Zastai closed 1 week ago

Zastai commented 4 months ago

I am running into the following issue:

It looks like SHFB is applying a .NET Framework style dependency resolution (which would require all dependencies to be in the same folder) to a .NET library (which has a My.Assembly.deps.json alongside My.Assembly.dll file describing where dependencies are located).

I would love to leave the old .NET Framework implementation of MSBuild behind, but unfortunately, Visual Studio still uses that one, so it needs to work too.

Setting CopyLocalLockFileAssemblies to true in the project being documented resolves this error, but is not a solution - it's highly undesirable to duplicate dependency DLLs all over the place.

EWSoftware commented 1 month ago

Can you attach an example demonstrating the issue?

Zastai commented 1 month ago

Will try. An initial barebones case seems to work (although obviously complaining it can't resolve outside references). Will try to get it as close to my real case as possible to see if it's any particular setting that triggers it.

Zastai commented 1 month ago

I can't seem to reproduce it easily from scratch so will have to spend a lot more time trying to reduce the solution where I do have the issue to something I can share, and I don't currently have that time. Feel free to mark as On Hold for the time being (same for #1051).

Zastai commented 2 weeks ago

Thanks to #1057 I now have a reproduction test case.

  1. Extract the zip file
  2. Build the solution by whatever means
  3. Use msbuild.exe to build the doc project

issue-1051-1052.zip