|
| 1 | +--- |
| 2 | +title: Ember 5.3 Released |
| 3 | +authors: |
| 4 | + - jen-weber |
| 5 | + - katie-gengler |
| 6 | + - jared-galanis |
| 7 | +date: 2023-09-21T00:00:00.000Z |
| 8 | +tags: |
| 9 | + - releases |
| 10 | + - '2023' |
| 11 | + - version-5-x |
| 12 | +--- |
| 13 | + |
| 14 | +Today the Ember project is releasing version 5.3 of Ember.js, EmberData, and Ember CLI. <!-- Block start: Uncomment if an LTS candidate --><!--This release of Ember.js is an LTS (Long Term Support) candidate. LTS candidates prioritize stability over the addition of new features, and have an extended support schedule.--><!-- Block end --> |
| 15 | + |
| 16 | +This release kicks off the 5.4 beta cycle for all sub-projects. We encourage our community (especially addon authors) to help test these beta builds and report any bugs before they are published as a final release in six weeks' time. The [ember-try](https://github.com/ember-cli/ember-try) addon is a great way to continuously test your projects against the latest Ember releases. |
| 17 | + |
| 18 | +You can read more about our general release process here: |
| 19 | + |
| 20 | +- [Release Dashboard](http://emberjs.com/releases/) |
| 21 | +- [The Ember Release Cycle](https://blog.emberjs.com/new-ember-release-process/) |
| 22 | +- [The Ember Project](https://blog.emberjs.com/ember-project-at-2-0/) |
| 23 | +- [Ember LTS Releases](https://blog.emberjs.com/announcing-embers-first-lts/) |
| 24 | + |
| 25 | +--- |
| 26 | + |
| 27 | +## Ember.js |
| 28 | + |
| 29 | +Ember.js is the core framework for building ambitious web applications. |
| 30 | + |
| 31 | +### Changes in Ember.js 5.3 |
| 32 | + |
| 33 | +Ember.js 5.3 is an incremental, backwards compatible release of Ember with bug fixes, performance improvements, and minor deprecations. |
| 34 | + |
| 35 | +#### Deprecations |
| 36 | + |
| 37 | +Ember.js 5.3 introduced 1 deprecation. |
| 38 | + |
| 39 | +1. Deprecate implicit record loading in Ember Route per [RFC #774](https://rfcs.emberjs.com/id/0774-implicit-record-route-loading). Please see [the deprecation guide](https://deprecations.emberjs.com/v5.x#toc_deprecate-implicit-route-model) for more information. |
| 40 | +<!-- Block start: If there were no deprecations, remove this block --> |
| 41 | + |
| 42 | +Deprecations are added to Ember.js when an API will be removed at a later date. Each deprecation has an entry in the deprecation guide describing the migration path to a more stable API. Deprecated public APIs are not removed until a major release of the framework. |
| 43 | + |
| 44 | +Consider using the [ember-cli-deprecation-workflow](https://github.com/mixonic/ember-cli-deprecation-workflow) addon if you would like to upgrade your application without immediately addressing deprecations. |
| 45 | + |
| 46 | +<!-- Block end --> |
| 47 | + |
| 48 | +For more details on changes in Ember.js 5.3, please review the [Ember.js 5.3.0 release page](https://github.com/emberjs/ember.js/releases/tag/v5.3.0). |
| 49 | + |
| 50 | +--- |
| 51 | + |
| 52 | +## EmberData |
| 53 | + |
| 54 | +EmberData is the official data persistence library for Ember.js applications. |
| 55 | + |
| 56 | +### Changes in EmberData 5.3 |
| 57 | + |
| 58 | +#### Bug Fixes |
| 59 | + |
| 60 | +EmberData 5.3 introduced 10 bug fixes. Details are in the |
| 61 | +[EmberData 5.3.0 release page](https://github.com/emberjs/data/releases/tag/v5.3.0). |
| 62 | + |
| 63 | +#### Features |
| 64 | + |
| 65 | +EmberData 5.3 introduced several new features. |
| 66 | + |
| 67 | +This release primarily focused on polish for the `RequestManager` story, introducing builder utils, builders for `REST` `ActiveRecord` and `JSON:API` requests as well as serialization utils for `JSON:API` requests. |
| 68 | + |
| 69 | +As part of shipping serialization utils, we implemented several long-awaited cache features to support them: |
| 70 | + |
| 71 | +- `cache.changedRelationships` retrieves a diff of what has been added or removed from each relationship for a resource |
| 72 | +- `cache.hasChangedRelationships` answers whether any relationships have changed for a resource |
| 73 | +- `cache.rollbackRelationships` will reset all relationships for that resource to their "remote" state, removing any local changes. |
| 74 | + |
| 75 | +#### Deprecations |
| 76 | + |
| 77 | +EmberData 5.3 introduced 5 deprecations. |
| 78 | + |
| 79 | +As part of our ongoing efforts to modernize the library and to support the above changes, we implemented several new deprecations. |
| 80 | + |
| 81 | +- Deprecate legacy import paths (`ember-data/`) except for `ember-data/store` |
| 82 | +- Deprecate non-strict-type (e.g. "users" or "myType" instead of "user" and "my-type") |
| 83 | +- Deprecate non-strict-id (e.g . `1` instead of `"1"`) |
| 84 | + |
| 85 | +And in relationships specifically: |
| 86 | + |
| 87 | +- deprecate fixing non-unique relationship payloads (when the same record is referenced multiple times in a related collection) |
| 88 | +- deprecate remote updates clearing local changes (an upcoming blog post will explain the new behavior here in detail) |
| 89 | + |
| 90 | +For more details on changes in EmberData 5.3, please review the |
| 91 | +[EmberData 5.3.0 release page](https://github.com/emberjs/data/releases/tag/v5.3.0). |
| 92 | + |
| 93 | +--- |
| 94 | + |
| 95 | +## Ember CLI |
| 96 | + |
| 97 | +Ember CLI is the command line interface for managing and packaging Ember.js applications. |
| 98 | + |
| 99 | +### Upgrading Ember CLI |
| 100 | + |
| 101 | +You may upgrade Ember CLI using the `ember-cli-update` project: |
| 102 | + |
| 103 | +```bash |
| 104 | +npx ember-cli-update |
| 105 | +``` |
| 106 | + |
| 107 | +This utility will help you to update your app or addon to the latest Ember CLI version. You will probably encounter merge conflicts, in which the default behavior is to let you resolve conflicts on your own. For more information on the `ember-cli-update` project, see [the GitHub README](https://github.com/ember-cli/ember-cli-update). |
| 108 | + |
| 109 | +While it is recommended to keep Ember CLI versions in sync with Ember and EmberData, this is not required. After updating ember-cli, you can keep your current version(s) of Ember or EmberData by editing `package.json` to revert the changes to the lines containing `ember-source` and `ember-data`. |
| 110 | + |
| 111 | +### Changes in Ember CLI 5.3 |
| 112 | + |
| 113 | +#### Features |
| 114 | + |
| 115 | +Ember CLI 5.3 introduced 1 new feature: |
| 116 | + |
| 117 | +- [#10337](https://github.com/ember-cli/ember-cli/pull/10337) - the feature flag for pnpm support was removed, officially allowing using of the `--pnpm` flag. |
| 118 | + |
| 119 | +#### Bug Fixes |
| 120 | + |
| 121 | +Ember CLI 5.3 introduced 3 bug fixes. |
| 122 | + |
| 123 | +#### Deprecations |
| 124 | + |
| 125 | +Ember CLI 5.3 introduced 1 deprecation. |
| 126 | + |
| 127 | +- Deprecate outputPaths build option, as output paths will no longer be predetermined under Embroider |
| 128 | + |
| 129 | +For more details on the changes in Ember CLI 5.3 and detailed upgrade |
| 130 | +instructions, please review the [Ember CLI 5.3.0 release page](https://github.com/ember-cli/ember-cli/releases/tag/v5.3.0). |
| 131 | + |
| 132 | +## Thank You! |
| 133 | + |
| 134 | +As a community-driven open-source project with an ambitious scope, each of these releases serves as a reminder that the Ember project would not have been possible without your continued support. We are extremely grateful to our contributors for their efforts. |
0 commit comments