Intro
This release updates the way that addons can be nested, and contains some breaking changes in non-default addon configurations. For the majority of apps, the update from 0.1.15 to 0.2.0 is non-breaking and should not cause significant concern.
Prior versions of Ember CLI maintained a flat addon structure, so that all addons (of any depth) would be added to the consuming
application. This has led to many issues, like the inability to use preprocessors (i.e. ember-cli-htmlbars, ember-cli-sass, etc)
in nested addons.
For addon creators, make sure to update to use the setupPreprocessorRegistry
hook (documented here) if you need to add a preprocessor to the registry. You can review the update process in ember-cli-htmlbars#38 or ember-cli-coffeescript#60 which show how to maintain support for both 0.1.x and 0.2.0 in an addon.
Upgrading
In order to ensure a safe and easy upgrade please follow the following steps (from within your project directory):
Setup
npm uninstall -g ember-cli
-- Remove old global ember-clinpm cache clean
-- Clear NPM cachebower cache clean
-- Clear Bower cachenpm install -g ember-cli@0.2.0-beta.1
-- Install new global ember-cli
Project Update
rm -rf node_modules bower_components dist tmp
-- Delete temporary development folders.npm install --save-dev ember-cli@0.2.0-beta.1
-- Update project'spackage.json
to use latest version.npm install
-- Reinstall NPM dependencies.bower install
-- Reinstall bower dependencies.ember init
-- This runs the new project blueprint on your projects directory. Please follow the prompts, and review all changes (tip: you can see a diff by pressing d). The most common source of upgrade pain is missing changes in this step.
Changes
The following changes are required if you are upgrading from the previous
version:
- Users
ember new
diff- Upgrade your project's ember-cli version - docs
- The 6to5 project has been renamed to Babel. See the blog post for more details.
- The default blueprint has been updated to work with Ember 1.10 by default.
- Update the following packages in your
package.json
:- Remove
broccoli-ember-hbs-template-compiler
. Uninstall withnpm uninstall --save-dev broccoli-ember-hbs-template-compiler
. - Remove
ember-cli-6to5
. Uninstall withnpm uninstall --save-dev ember-cli-6to5
. - Add
ember-cli-babel
. Install withnpm install --save-dev ember-cli-babel
. - Add
ember-cli-htmlbars
. Install withnpm install --save-dev ember-cli-htmlbars
. - Updated
ember-cli-qunit
to 0.3.8. Install withnpm install --save-dev ember-cli-qunit@0.3.8
. - Updated
ember-data
to 1.0.0-beta.15. Install withnpm install --save-dev ember-data@1.0.0-beta.15
.
- Remove
- Update the following packages in your
bower.json
:- Removed
handlebars
. Uninstall withbower uninstall --save handlebars
. - Updated
ember
to 1.10.0. Install withbower install --save ember#1.10.0
. - Updated
ember-data
to 1.0.0-beta.15. Install withbower install --save ember-data#1.0.0-beta.15
. - Updated
ember-cli-test-loader
to 0.1.3. Install withbower install --save ember-cli-test-loader#0.1.3
.
- Removed
- Addon Developers
ember addon
diff- Usage of the
included
hook to add items to theregistry
will need to be refactored to use the newly addedsetupPreprocessorRegistry
hook instead.
- Core Contributors
- No changes required
Community Contributions
- #3166 [BREAKING ENHANCEMENT] Addon discovery and isolation @lukemelia / @chrislopresto / @rwjblue
- #3285 [INTERNAL ENHANCEMENT] Update to Testem 0.7 @johanneswuerbach
- #3295 [ENHANCEMENT] Update ember-data to 1.0.0-beta.15 @bmac
- #3297 [ENHANCEMENT] Use ember-cli-babel instead of ember-cli-6to5 @fivetanley
- #3298 [BUGFIX] Update ember-cli-qunit to v0.3.8. @rwjblue
- #3301 [BUGFIX] Only add Handlebars to
vendor.js
if present inbower.json
. @rwjblue
Thank you to all who took the time to contribute!