diff --git a/16/umbraco-deploy/release-notes.md b/16/umbraco-deploy/release-notes.md index 61c99f43a52..8d2252c7c64 100644 --- a/16/umbraco-deploy/release-notes.md +++ b/16/umbraco-deploy/release-notes.md @@ -2,7 +2,7 @@ description: Get an overview of the things changed and fixed in each version of Umbraco Deploy. --- -# Release notes +# Release Notes In this section we have summarised the changes to Umbraco Deploy and [Deploy Contrib](https://github.com/umbraco/Umbraco.Deploy.Contrib) released in each version. Each version is presented with a link to the [Deploy issue tracker](https://github.com/umbraco/Umbraco.Deploy.Issues/issues) showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail. @@ -16,6 +16,25 @@ If you are upgrading to a new major version you can find the details about the b This section contains the release notes for Umbraco Deploy 15 including all changes for this version. +### [16.0.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 12th 2025) + +* Compatibility with Umbraco 16.0.0 + +### [16.0.0-rc5](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 10th 2025) + +* Compatibility with Umbraco 16.0.0-rc6 + +### [16.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 10th 2025) + +* Compatibility with Umbraco 16.0.0-rc5 +* Removed obsolete code + +### [16.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 3rd 2025) + +* Compatibility with Umbraco 16.0.0-rc4 +* Add `deployEntityTypeMapping` manifest to allow mapping client-side entity types (used in workspaces and routes) to their server-side entity types (used in UDIs, artifacts, and service connectors) +* Use default `TryParseUdiRangeFromNodeId` implementation for internally registered entity types + ### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 30th 2025) * Compatibility with Umbraco 16.0.0-rc3 @@ -28,6 +47,22 @@ This section contains the release notes for Umbraco Deploy 15 including all chan ## Umbraco.Deploy.Contrib +### [16.0.0](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0) (May 12th 2025) + +* Compatibility with Umbraco 16.0.0 and Deploy 16.0.0 + +### [16.0.0-rc5](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc5) (May 10th 2025) + +* Compatibility with Umbraco 16.0.0-rc6 and Deploy 16.0.0-rc5 + +### [16.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc4) (May 10th 2025) + +* Compatibility with Umbraco 16.0.0-rc5 and Deploy 16.0.0-rc4 + +### [16.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc3) (May 3rd 2025) + +* Compatibility with Umbraco 16.0.0-rc4 and Deploy 16.0.0-rc3 + ### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc2) (May 30th 2025) * Compatibility with Umbraco 16.0.0-rc3 and Deploy 16.0.0-rc2 diff --git a/16/umbraco-deploy/upgrades/version-specific.md b/16/umbraco-deploy/upgrades/version-specific.md index e283a8c0f7f..2f441f38203 100644 --- a/16/umbraco-deploy/upgrades/version-specific.md +++ b/16/umbraco-deploy/upgrades/version-specific.md @@ -21,14 +21,52 @@ Version 16 contains breaking changes. The breaking changes appear in areas relat #### Entity type registration -Entity type registration is simplified by removing client-side concerns from the server and aligning built-in and custom Umbraco CMS entities (like Forms and Commerce). +Entity type registration is simplified by removing client-side concerns from the server and aligning built-in Umbraco CMS and custom entities (like Forms and Commerce). * `IDiskEntityService.RegisterDiskEntityType(...)` - This now only requires the entity type, removing the `name`, `isUmbracoEntity` and `installedUdisGetter` parameters. * `ITransferEntityService.RegisterTransferEntityType(...)` - This is also simplified, removing the `name`, `isUmbracoEntity`, `treeAlias`, `matchesRoutePath`, `matchesNodeId` and `entitiesGetter` parameters. -The name was only used in the backoffice, for example, to group items in the transfer queue and schema comparison dashboard. It now uses localizations (`deploy_entityTypes_{entityType}` or `general_{entityType}`), falling back to the plain entity type. - -The `isUmbracoEntity` flag was used in the schema comparison dashboard and for setting signatures to fetch entities differently from custom ones. Making `installedUdisGetter` and `entitiesGetter` mandatory could fetch these items, but this is already possible via service connectors (`IServiceConnector.GetRangeAsync()` and `IServiceConnector.GetArtifact()`). +The name was only used in the backoffice, for example, to group items in the transfer queue and schema comparison dashboard. It now uses localizations (`deploy_entityTypes_{entityType}` or `general_{entityType}`), falling back to the plain entity type if no translation is provided. + +The `isUmbracoEntity` flag was used when fetching entities in the schema comparison dashboard and for setting signatures. This could only be enabled for built-in Umbraco entities directly supported by Deploy. Custom entities required providing the `installedUdisGetter` or `entitiesGetter` parameter for these features to work correctly. However, getting all entities is already possible via the service connectors (`IServiceConnector.GetRangeAsync()` and `IServiceConnector.GetArtifact()`), making these parameters redundant. + +The `treeAlias`, `matchesRoutePath`, and `matchesNodeId` parameters are removed because the client-side already tracks the entity types. It's recommended to use the same entity types on both the client (in workspaces and routes) and the server (in UDIs, artifacts, and service connectors). If different, Deploy supports mapping the client-side entity types to their server-side counterpart using a `deployEntityTypeMapping` manifest, as shown in the following example: + +```json +{ + "id": "Umbraco.Commerce.Deploy", + "name": "Umbraco Commerce Deploy", + "version": "16.0.0", + "extensions": [ + { + "type": "localization", + "alias": "Uc.Deploy.Localization.En", + "weight": -100, + "name": "English", + "meta": { + "culture": "en", + "localizations": { + "deploy_entityTypes": { + "umbraco-commerce-product-attribute": "Umbraco Commerce Product Attribute", + "umbraco-commerce-product-attribute-preset": "Umbraco Commerce Product Attribute Preset", + } + } + } + }, + { + "type": "deployEntityTypeMapping", + "alias": "Uc.Deploy.EntityTypeMapping", + "name": "Umbraco Commerce Deploy Entity Type Mapping", + "entityTypes": { + "uc:product-attribute": "umbraco-commerce-product-attribute", + "uc:product-attributes": "umbraco-commerce-product-attribute", + "uc:product-attribute-preset": "umbraco-commerce-product-attribute-preset", + "uc:product-attribute-presets": "umbraco-commerce-product-attribute-preset" + } + } + ] +} +``` ### Dependencies diff --git a/16/umbraco-forms/release-notes.md b/16/umbraco-forms/release-notes.md index 8785c357199..22b10d57a11 100644 --- a/16/umbraco-forms/release-notes.md +++ b/16/umbraco-forms/release-notes.md @@ -37,6 +37,18 @@ This section contains the release notes for Umbraco Forms 16 including all chang This Deploy add-on adds support for transferring, restoring, exporting and importing (including migrating between major versions) of Umbraco Forms data. +### 16.0.0 (June 12th 2025) + +* Update Forms and Deploy dependencies to 16.0.0 + +### 16.0.0-rc5 (June 10th 2025) + +* Update Forms and Deploy dependencies to 16.0.0-rc5 + +### 16.0.0-rc4 (June 10th 2025) + +* Update Forms and Deploy dependencies to 16.0.0-rc4 + ### 16.0.0-rc3 (June 3rd 2025) * Update Forms and Deploy dependencies to 16.0.0-rc3