Deprecating ASP.NET Core MvcPrecompilation tool

[analogrelay]

Deprecating ASP.NET Core MvcPrecompilation tool

In ASP.NET Core 1.1, we introduced the Microsoft.AspNetCore.Mvc.Razor.ViewCompilation (MVC precompilation tool) package that added support for publish time compilation of Razor files (.cshtml files). Starting in ASP.NET Core 2.1, we introduced the Razor SDK that expanded on the features of the precompilation tool by adding support for build and publish time of Razor files. The SDK allows for verifying the correctness of cshtml files at build time while also improving on startup time for applications. The Razor SDK is on by default and no gesture is required to start using it.

In 3.0, we removed the earlier MVC precompilation tool. Earlier versions of the package will continue receiving important bug and security fixes as part of our patch release.

For users of ASP.NET Core 2.1 or later, we recommend migrating to the Razor SDK if you haven't already. If you're currently using the precompilation tool and are unable to migrate to the Razor SDK due to bugs or missing features, please file an issue at https://github.com/aspnet/Razor/issues.

Version introduced

3.0

Old behavior

The Microsoft.AspNetCore.Mvc.Razor.ViewCompilation was used to pre-compile MVC Razor Views.

New behavior

The Razor SDK natively supports this functionality. The Microsoft.AspNetCore.Mvc.Razor.ViewCompilation is no longer updated.

Reason for change

The Razor SDK provides more functionality and allows for verifying the correctness of cshtml files at build time while also improving on startup time for applications.

Recommended action

Update to use the native support for precompilation in the Razor SDK.

Category

• ASP.NET Core

Affected APIs

Not detectable via API analysis

---

Issue metadata

• Issue type: breaking-change