stride3d / stride3d/stride-docs

bug: Local docs build doesn't generate API docs for .NET 10

Open
#430 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
PowerShell
Stars
39
Forks
74
Avg merge
3h 36m
Merged PRs (30d)
2

Description

Two issues:

  1. The build fails if sources/assets/Stride.Core.Assets/Stride.Core.Assets.csproj is present in the en/docfx.json.
  2. If the above is removed, the build doesn't generate APIs docs, most likely because of the error below

Test:

docfx metadata en/docfx.json

or run run.bat, select en, select y.

Tested on my dev PC and also on clean PC with Windows 11 + VS 2026.

Error:

Identical errors listed below..

warning: [Failure] Msbuild failed when processing the file 'C:\Projects\GitHub\stride\sources\core\Stride.Core\Stride.Core.csproj' with message: SDK Resolver Failure: "The SDK resolver "Microsoft.DotNet.MSBuildSdkResolver" failed while attempting to resolve the SDK "Microsoft.NET.Sdk". Exception: "System.MissingMethodException: Method not found: 'Void System.Text.Json.Utf8JsonReader..ctor(System.ReadOnlySpan1<Byte>, Boolean, System.Text.Json.JsonReaderState)'. at Microsoft.NET.Sdk.WorkloadManifestReader.WorkloadManifestReader.Utf8JsonStreamReader..ctor(Stream stream, JsonReaderOptions readerOptions) at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.GlobalJsonReader.GetWorkloadVersionFromGlobalJson(String globalJsonPath, Nullable1& shouldUseWorkloadSets)
at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.RefreshWorkloadManifests()
at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider..ctor(String sdkRootPath, String sdkVersion, Func2 getEnvironmentVariable, String userProfileDir, String globalJsonPath, String workloadSetVersion) at Microsoft.NET.Sdk.WorkloadMSBuildSdkResolver.CachingWorkloadResolver.Resolve(String sdkReferenceName, String dotnetRootPath, String sdkVersion, String userProfileDir, String globalJsonPath) at Microsoft.DotNet.MSBuildSdkResolver.DotNetMSBuildSdkResolver.Resolve(SdkReference sdkReference, SdkResolverContext context, SdkResultFactory factory) at Microsoft.Build.BackEnd.SdkResolution.SdkResolverService.TryResolveSdkUsingSpecifiedResolvers(IReadOnlyList1 resolvers, Int32 submissionId, SdkReference sdk, LoggingContext loggingContext, ElementLocation sdkReferenceLocation, String solutionPath, String projectPath, Boolean interactive, Boolean isRunningInVisualStudio, SdkResult& sdkResult, IEnumerable1& errors, IEnumerable1& warnings)"" C:\Projects\GitHub\stride\sources\targets\Stride.Core.props

Possible issue:
All projects are pointing to sources\targets\Stride.Core.props which might be causing an issue.

Multiple identical errors:

Only some are listed..

C:\Projects\GitHub\stride\sources\core\Stride.Core\Stride.Core.csproj : warning NU1510: PackageReference System.ValueTuple will not be pruned. Consider removing this package from your dependencies, as it is likely unnecessary.
  All projects are up-to-date for restore.
warning: [Failure] Msbuild failed when processing the file 'C:\Projects\GitHub\stride\sources\core\Stride.Core\Stride.Core.csproj' with message: SDK Resolver Failure: "The SDK resolver "Microsoft.DotNet.MSBuildSdkResolver" failed while attempting to resolve the SDK "Microsoft.NET.Sdk". Exception: "System.MissingMethodException: Method not found: 'Void System.Text.Json.Utf8JsonReader..ctor(System.ReadOnlySpan`1<Byte>, Boolean, System.Text.Json.JsonReaderState)'.
   at Microsoft.NET.Sdk.WorkloadManifestReader.WorkloadManifestReader.Utf8JsonStreamReader..ctor(Stream stream, JsonReaderOptions readerOptions)
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.GlobalJsonReader.GetWorkloadVersionFromGlobalJson(String globalJsonPath, Nullable`1& shouldUseWorkloadSets)
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.RefreshWorkloadManifests()
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider..ctor(String sdkRootPath, String sdkVersion, Func`2 getEnvironmentVariable, String userProfileDir, String globalJsonPath, String workloadSetVersion)
   at Microsoft.NET.Sdk.WorkloadMSBuildSdkResolver.CachingWorkloadResolver.Resolve(String sdkReferenceName, String dotnetRootPath, String sdkVersion, String userProfileDir, String globalJsonPath)
   at Microsoft.DotNet.MSBuildSdkResolver.DotNetMSBuildSdkResolver.Resolve(SdkReference sdkReference, SdkResolverContext context, SdkResultFactory factory)
   at Microsoft.Build.BackEnd.SdkResolution.SdkResolverService.TryResolveSdkUsingSpecifiedResolvers(IReadOnlyList`1 resolvers, Int32 submissionId, SdkReference sdk, LoggingContext loggingContext, ElementLocation sdkReferenceLocation, String solutionPath, String projectPath, Boolean interactive, Boolean isRunningInVisualStudio, SdkResult& sdkResult, IEnumerable`1& errors, IEnumerable`1& warnings)""  C:\Projects\GitHub\stride\sources\targets\Stride.Core.props
Loading project C:/Projects/GitHub/stride/sources/core/Stride.Core.IO/Stride.Core.IO.csproj
  Determining projects to restore...
C:\Projects\GitHub\stride\sources\core\Stride.Core\Stride.Core.csproj : warning NU1510: PackageReference System.ValueTuple will not be pruned. Consider removing this package from your dependencies, as it is likely unnecessary. [C:\Projects\GitHub\stride\sources\core\Stride.Core.IO\Stride.Core.IO.csproj]
  All projects are up-to-date for restore.
warning: [Failure] Msbuild failed when processing the file 'C:\Projects\GitHub\stride\sources\core\Stride.Core.IO\Stride.Core.IO.csproj' with message: SDK Resolver Failure: "The SDK resolver "Microsoft.DotNet.MSBuildSdkResolver" failed while attempting to resolve the SDK "Microsoft.NET.Sdk". Exception: "System.MissingMethodException: Method not found: 'Void System.Text.Json.Utf8JsonReader..ctor(System.ReadOnlySpan`1<Byte>, Boolean, System.Text.Json.JsonReaderState)'.
   at Microsoft.NET.Sdk.WorkloadManifestReader.WorkloadManifestReader.Utf8JsonStreamReader..ctor(Stream stream, JsonReaderOptions readerOptions)
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.GlobalJsonReader.GetWorkloadVersionFromGlobalJson(String globalJsonPath, Nullable`1& shouldUseWorkloadSets)
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.RefreshWorkloadManifests()
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider..ctor(String sdkRootPath, String sdkVersion, Func`2 getEnvironmentVariable, String userProfileDir, String globalJsonPath, String workloadSetVersion)
   at Microsoft.NET.Sdk.WorkloadMSBuildSdkResolver.CachingWorkloadResolver.Resolve(String sdkReferenceName, String dotnetRootPath, String sdkVersion, String userProfileDir, String globalJsonPath)
   at Microsoft.DotNet.MSBuildSdkResolver.DotNetMSBuildSdkResolver.Resolve(SdkReference sdkReference, SdkResolverContext context, SdkResultFactory factory)
   at Microsoft.Build.BackEnd.SdkResolution.SdkResolverService.TryResolveSdkUsingSpecifiedResolvers(IReadOnlyList`1 resolvers, Int32 submissionId, SdkReference sdk, LoggingContext loggingContext, ElementLocation sdkReferenceLocation, String solutionPath, String projectPath, Boolean interactive, Boolean isRunningInVisualStudio, SdkResult& sdkResult, IEnumerable`1& errors, IEnumerable`1& warnings)""  C:\Projects\GitHub\stride\sources\targets\Stride.Core.props
Loading project C:/Projects/GitHub/stride/sources/core/Stride.Core.Mathematics/Stride.Core.Mathematics.csproj
  Determining projects to restore...
C:\Projects\GitHub\stride\sources\core\Stride.Core\Stride.Core.csproj : warning NU1510: PackageReference System.ValueTuple will not be pruned. Consider removing this package from your dependencies, as it is likely unnecessary. [C:\Projects\GitHub\stride\sources\core\Stride.Core.Mathematics\Stride.Core.Mathematics.csproj]
  All projects are up-to-date for restore.
warning: [Failure] Msbuild failed when processing the file 'C:\Projects\GitHub\stride\sources\core\Stride.Core.Mathematics\Stride.Core.Mathematics.csproj' with message: SDK Resolver Failure: "The SDK resolver "Microsoft.DotNet.MSBuildSdkResolver" failed while attempting to resolve the SDK "Microsoft.NET.Sdk". Exception: "System.MissingMethodException: Method not found: 'Void System.Text.Json.Utf8JsonReader..ctor(System.ReadOnlySpan`1<Byte>, Boolean, System.Text.Json.JsonReaderState)'.
   at Microsoft.NET.Sdk.WorkloadManifestReader.WorkloadManifestReader.Utf8JsonStreamReader..ctor(Stream stream, JsonReaderOptions readerOptions)
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.GlobalJsonReader.GetWorkloadVersionFromGlobalJson(String globalJsonPath, Nullable`1& shouldUseWorkloadSets)
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.RefreshWorkloadManifests()
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider..ctor(String sdkRootPath, String sdkVersion, Func`2 getEnvironmentVariable, String userProfileDir, String globalJsonPath, String workloadSetVersion)
   at Microsoft.NET.Sdk.WorkloadMSBuildSdkResolver.CachingWorkloadResolver.Resolve(String sdkReferenceName, String dotnetRootPath, String sdkVersion, String userProfileDir, String globalJsonPath)
   at Microsoft.DotNet.MSBuildSdkResolver.DotNetMSBuildSdkResolver.Resolve(SdkReference sdkReference, SdkResolverContext context, SdkResultFactory factory)
   at Microsoft.Build.BackEnd.SdkResolution.SdkResolverService.TryResolveSdkUsingSpecifiedResolvers(IReadOnlyList`1 resolvers, Int32 submissionId, SdkReference sdk, LoggingContext loggingContext, ElementLocation sdkReferenceLocation, String solutionPath, String projectPath, Boolean interactive, Boolean isRunningInVisualStudio, SdkResult& sdkResult, IEnumerable`1& errors, IEnumerable`1& warnings)""  C:\Projects\GitHub\stride\sources\targets\Stride.Core.props
Loading project C:/Projects/GitHub/stride/sources/core/Stride.Core.MicroThreading/Stride.Core.MicroThreading.csproj
  Determining projects to restore...
C:\Projects\GitHub\stride\sources\core\Stride.Core\Stride.Core.csproj : warning NU1510: PackageReference System.ValueTuple will not be pruned. Consider removing this package from your dependencies, as it is likely unnecessary. [C:\Projects\GitHub\stride\sources\core\Stride.Core.MicroThreading\Stride.Core.MicroThreading.csproj]
  All projects are up-to-date for restore.
warning: [Failure] Msbuild failed when processing the file 'C:\Projects\GitHub\stride\sources\core\Stride.Core.MicroThreading\Stride.Core.MicroThreading.csproj' with message: SDK Resolver Failure: "The SDK resolver "Microsoft.DotNet.MSBuildSdkResolver" failed while attempting to resolve the SDK "Microsoft.NET.Sdk". Exception: "System.MissingMethodException: Method not found: 'Void System.Text.Json.Utf8JsonReader..ctor(System.ReadOnlySpan`1<Byte>, Boolean, System.Text.Json.JsonReaderState)'.
   at Microsoft.NET.Sdk.WorkloadManifestReader.WorkloadManifestReader.Utf8JsonStreamReader..ctor(Stream stream, JsonReaderOptions readerOptions)
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.GlobalJsonReader.GetWorkloadVersionFromGlobalJson(String globalJsonPath, Nullable`1& shouldUseWorkloadSets)
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider.RefreshWorkloadManifests()
   at Microsoft.NET.Sdk.WorkloadManifestReader.SdkDirectoryWorkloadManifestProvider..ctor(String sdkRootPath, String sdkVersion, Func`2 getEnvironmentVariable, String userProfileDir, String globalJsonPath, String workloadSetVersion)
   at Microsoft.NET.Sdk.WorkloadMSBuildSdkResolver.CachingWorkloadResolver.Resolve(String sdkReferenceName, String dotnetRootPath, String sdkVersion, String userProfileDir, String globalJsonPath)
   at Microsoft.DotNet.MSBuildSdkResolver.DotNetMSBuildSdkResolver.Resolve(SdkReference sdkReference, SdkResolverContext context, SdkResultFactory factory)
   at Microsoft.Build.BackEnd.SdkResolution.SdkResolverService.TryResolveSdkUsingSpecifiedResolvers(IReadOnlyList`1 resolvers, Int32 submissionId, SdkReference sdk, LoggingContext loggingContext, ElementLocation sdkReferenceLocation, String solutionPath, String projectPath, Boolean interactive, Boolean isRunningInVisualStudio, SdkResult& sdkResult, IEnumerable`1& errors, IEnumerable`1& warnings)""  C:\Projects\GitHub\stride\sources\targets\Stride.Core.props
Loading project C:/Projects/GitHub/stride/sources/core/Stride.Core.Serialization/Stride.Core.Serialization.csproj
  Determining projects to restore...

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the failure with docfx metadata en/docfx.json or run.bat, selecting en and confirming the build. Start with en/docfx.json, sources/targets/Stride.Core.props, and the referenced .csproj files; done means the local documentation build completes without SDK resolver failures and generates API documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
build-system, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.