Release notes v14.0.0

Release Details

v14.0.0-rc1 - release canidate-canidate beta.

This is the pre-release version of uSync v14 for Umbraco v14-rc1. It conains the working of uSync for Umbraco v14 with the new backoffice UI.

Release Notes.

The core functionality of uSync is present in this release so you can sync between sites, and key your site version controlled while working on Umbraco v14 - there are however there are several notes and cavieates to working with this release and Umbraco 14-rc1 - you should familiarize yourself with them to set expectations.

Known issues.

Umbraco Issues

There are a number of Umbraco issues that we have logged during the testing of this uSync release they affect certain types of property editors and settings within them that can cause pages or bits of your site to become un-editable, you should be aware of this issues:

[!WARNING] There are a couple of bugs, which mean for certain types and settings you will see errors or blank pages inside umbraco, these are not uSync issues

"Migrating" from older version.

At the moment there is no legacy to new property editor migration inside uSync, (you can however use uSync.Migrations). So migrating a site that has now discontinued property editors on (Grid, Nested Content) will not work.

It is our intention to provide a smoother migration within uSync as we approach release. but for now uSync.Migrations will provide you with the ability to migrate to BlockGrid and BlockList on a v13 site.

[!NOTE] Post RC1 - some inline migration tools for legacy to supported types will be included in uSync

DataType Migration

Internally inside Umbraco the storage and settings for a large number of the existing datatypes has changed, as such the settings stored inside any uSync files will need updating.

For known changes and types we have build this into the release! -

  • Importing files from Umbraco v13 with known types will result in uSync automagically converting those datatype config values to the new format on import
  • After import and when you are happy things are as expected you should perform a full export to write these new configurations out to disk

[!NOTE] RC1 - uSync will dynamically conver datatype configuration for know "supported" types from v13 to v14 formats on import

Breaking Changes

  • Moving from v9-13 the default uSync folder has been renamed from uSync/v9 to uSync/v14
  • The format of the configuration for datatypes has changed, migration of known types is built into to v14 (see datatype migrations) - but again custom code, might need adjusting
  • There are changes to the ISyncHandler, ISyncMapper and IConfigurationSerializer interfaces any custom code might/will need updating.

[!WARNING] Custom code will need to be examined, updated and you might need to copy things to a new folder

Summary

So with that all that said and absorbed, you can download and enjoy uSync as part of your brave new Umbraco world experiences.

dotnet add package uSync --prerelease

Full Changelog: https://github.com/KevinJump/uSync/compare/v13.2.0...v14.0.0-rc1