Overview:
A couple of weeks back we announced the decision to postpone the beta release of Umbraco on .NET Core from the end of March to end of April. It’s important for us to ship a beta version that’s feature complete and ready for proper testing - that’s why, together with the Unicore Team, we have found it necessary to postpone the beta release as more work is needed on certain functionality before it’s ready for public testing.
We also recognize that package developers are eager to get their hands (and packages) dirty with .NET Core and that’s why we’ve decided to create this fourth alpha. The necessary changes have been made to start working on migrations of existing packages as well as creating new ones.
Final thing before we dive into the alpha release: On Wednesday, April 7th, I will be hosting a Community Office hours session together with the Unicore Team. If you have any questions about the Unicore Project (Umbraco on .NET Core) you can ask questions beforehand and see current questions here. We hope to get a lot of questions and look forward to answering them.
Since the last alpha release, a couple of cool changes are now available including:
One of the main reasons we could not recommend package developers to start on earlier alpha releases, was because we still hadn’t updated the namespaces to match new file locations. The reason this was delayed until now, was mainly to ease the merges of commits from Umbraco 8 into our working branch. All namespaces are now updated:
We have reintroduced the extension methods on `IPublishedContent` that do not require all dependencies injected. The reason this was not part of earlier releases, was to ensure we are not using these extension methods internally, due to the fact that using these makes unit testing harder.
We have aligned our NuGet packages with best practice in .NET Core - One package per assembly. Using this structure makes it easier and less error-prone for us to generate the NuGet packages. Furthermore, it is a step towards allowing users to have backoffice only or website only Umbraco instances in a load-balanced setup.
The latest changes from Umbraco 8 is now part of this project. Including new features like Unattended upgrades, Updated flow for creating Document Types and of course all the bug fixes and performance enhancements.
Instead of relying on static C# events, we have introduced an in-process event aggregator inspired by notifications from MediatR. Now all notification handlers need to be registered in the DI Container, and the event aggregator will ensure these handlers are executed every time the specific notifications are published. Even though we already migrated a lot of events, we still have many to go.
Since the last alpha release, Microsoft has released preview-versions of .NET 6. We have therefore added the option to the Umbraco dotnet new template to create the project using .NET 6.
We still have lots of documentation to revisit but the process of documenting the next major release of Umbraco is well under way. The updated documentation currently only lives as a Github repository, but you can find the updated articles there.
The last alpha versions had an annoying error with ambient scopes, that forced users to redo the operation they did quite often. This is now fixed together with a series of other smaller bug fixes.
Unlike the other alpha releases, this release is mainly addressed to package developers that are eager to get started migrating their packages. Developers who have an interest in helping out, testing and finalizing the project are of course more than welcome to give it a spin as well. Keep in mind a few APIs are still subject to change (see known “Known issues” below).
Are you a package developer? Why not sign-up for the Umbraco package newsletter and get news like this sent directly to your inbox.
Furthermore, since this is an alpha release, you should not expect that any data stored in the database or on the filesystem will work on later versions. In other words - please don’t start solutions on this release that will end in production.
But please do start testing and help us move forward with the project. The earlier we have feedback, the easier it will be to improve the releases.
The procedure to get started using this alpha is the same as for the other alpha versions.
Ensure you update your Umbraco dotnet new template, and then you are ready to create new projects running on alpha 4. See a full description and other interesting notes about the project here.
If you want to be on the bleeding edge, we also offer nightly builds. But be aware these are not tested as intensively as the alpha releases.
If you are going to create or update a package, you will now need to have a reference on one or both of the following NuGet packages: `Umbraco.Cms.Web.Website` or `Umbraco.Cms.Web.BackOffice`, depending on whether your package is an extension for the website part, the backoffice part or both.
Furthermore, we have tried to make it a little easier, by making a little guide here
While using the alpha beware of the following known issues and missing parts:
These are all known issues and missing parts, meaning you don’t need to report these. We try to keep the list of known issues up-to-date in the Umbraco .NET Core documentation. If you find other issues that are not already reported, please report them on the GitHub tracker by following the link or selecting “🌟 .Net Core Bug Report” when creating a new issue.
We aim for having the first beta release ready by the end of April, if nothing unexpected shows up. The beta releases are defined as a feature-complete CMS, but still without the HQ packages. We expect to ship multiple beta releases when we fix issues found or other improvements are ready.
Some of the most significant parts that are still to come are:
These parts will be released in future beta releases or the release candidates. We will, of course, make sure to keep you updated in future blog posts and Product Update blog posts so you know when you’re able to test the different parts.
If you'd like to pull down the source code that this template is built from, the latest .NET Core Umbraco branch is on the "netcore/dev" branch. You can find a list of open issues on the issue tracker. All help and pull requests are very welcome!
We’ve been thrilled to see such significant contributions to this release from across the Umbraco community.
First of all, our Unicore team has again contributed across a number of crucial areas such as discussions, advising, coding and testing the release. Huge thanks to Emma, Benjamin, Steve, Andy and Simone.
Furthermore, we’ve had a massive amount of contributions from the community member Kenn Jacobsen.
H5YR to everyone who has helped us on this release 🙌
If you have any questions about the project that you would like to ask the Unicore team, remember, they will be hosting the Umbraco Community Office hours on April 7th. You can submit questions beforehand or see current questions here.
Now - help us get even further by testing out the alpha 4!
It’s time for the 3rd alpha release of Umbraco on .NET Core. This release includes routing and website rendering, updates to dependency injection and more. A lot of the progress is made possible by community contributions and the Unicore community team. Let’s take a look at what’s in the release.