Skip to content

Latest commit

 

History

History
42 lines (31 loc) · 1.73 KB

runtime.rst

File metadata and controls

42 lines (31 loc) · 1.73 KB

Runtime considerations

Runtime setup

Bazel rules maintain the list of files required to run given executable. When the run is requested (via bazel run or bazel test) then a manifest file is generated by Bazel. Rules_dotnet uses this file to link all runtime files in the same directory as the executable to run.

.NET Core

Bazel works best in the monorepo scenario where all dependencies are built by it using the same .NET Core runtime version. An attempt to build some common open source libraries is maintained here.

However, many .NET Core projects are composed of multiple dependencies gathered via Nuget. Those dependencies are often built using different versions of .NET Core. Typically, msbuild-based build systems handle it automatically by providing appropriate deps.json and runtimeconfig.json files. See this article for a very interesting overview.

Unfoortunately, Bazel dotnet rules currently are not able to generate these files. Therefore, if multiple versions of .NET Core are mixed then a user has to provide them manually.

That's the reason for rules_dotnet to provide its own builds of xunit. This way it does not require the generation of deps.json or runtimeconfig.json.

.NET Framework

.NET Framework uses Global Assembly Cache. Therefore, the runtime .NET Framework dependencies linked by rules_dotnet are not used if the assembly existst in the GAC. It may lead to unexpected errors, particularly when using Nuget packages.