Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Bug] docfx metadata appears to be broken with 9.0.200 #10542

Open
groogiam opened this issue Feb 14, 2025 · 7 comments
Open

[Bug] docfx metadata appears to be broken with 9.0.200 #10542

groogiam opened this issue Feb 14, 2025 · 7 comments
Labels
dotnet Generate .NET API reference docs

Comments

@groogiam
Copy link

Describe the bug
After updating to the lates version of the sdk docfx metadata .\docfx.json. The failures seem to be related to blazor framework libraries.

To Reproduce
Steps to reproduce the behavior:

  1. Run docfx metadata .\docfx.json in on metadat project that previously worked.
error: D:\source\MyWeb.Ui\Components\Help\HelpLinksComponent.razor.cs(46,32): error CS0115: 'HelpLinksComponent.SetParametersAsync(ParameterView)': no suitable method found to override

Expected behavior
Metadata generation should resolve blazor base classes.

Context (please complete the following information):

  • OS: Windows 11
  • Docfx version: 2.78.2+3ff9ae7a9700029e0023a7ece18a723d351f1e9b

Additional context
Add any other context about the problem here.

@groogiam groogiam added the bug label Feb 14, 2025
@groogiam
Copy link
Author

groogiam commented Feb 14, 2025

There is also an warning after all the errors. warning: No .NET API detected for .

My installed SDK's and Runtimes

.NET SDKs installed:
  9.0.200 [C:\Program Files\dotnet\sdk]

.NET runtimes installed:
  Microsoft.AspNetCore.App 8.0.13 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
  Microsoft.AspNetCore.App 9.0.2 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]
  Microsoft.NETCore.App 8.0.13 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  Microsoft.NETCore.App 9.0.2 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  Microsoft.WindowsDesktop.App 8.0.13 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]
  Microsoft.WindowsDesktop.App 9.0.2 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]

@filzrev
Copy link
Contributor

filzrev commented Feb 15, 2025

When using .NET SDK version 9.0.103. (It's released at the same time as 9.0.200)
It works successfully.

So I'm suspecting it's caused by .NET SDK 9.0.200 specific problems.

@groogiam
Copy link
Author

Is there any way to work around this? I'm kind of stuck between being able to build my documentation or keep Visual Studio up to date as it typically installs the latest SDK releases when it updates. Thanks.

@filzrev
Copy link
Contributor

filzrev commented Feb 16, 2025

As a temporary workaround.
It can switch SDK version by using global.json file.

  1. Ensure both version of .NET SDKs are installed. (9.0.103 and 9.0.200)
  2. Create global.json to source directory with dotnet new globaljson --sdk-version 9.0.103 command
  3. Run docfx metadata command
  4. Dekete global.json file.

@yufeih yufeih added .NET dotnet Generate .NET API reference docs and removed bug labels Feb 20, 2025
@groogiam
Copy link
Author

@filzrev Thanks for the work around. Any idea when the issue might be resolved so the latest SDK can be used? Thanks.

@groogiam
Copy link
Author

@yufeih Any update on an ETA for a fix? Thanks.

@filzrev
Copy link
Contributor

filzrev commented Mar 12, 2025

Reported issue is caused by .NET SDK (or Roslyn MSBuildWorkspace) problem.
So I thought, it can't be resolved by docfx side.

There are similar issue that relating MSBuildWorkspace and Microsoft.CodeAnalysis.Razor.Compiler on .NET SDK 9.0.200.
But there seems to be no progress at the moment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dotnet Generate .NET API reference docs
Projects
None yet
Development

No branches or pull requests

3 participants