Addon Formatting
Support for addon's without an entry point script (either index.js
by default or the script specified by ember-addon main) in the addon's package.json
has been removed. An addon must have at least the following:
module.exports = {
name: "addons-name-here"
};
This should not pose a problem for the vast majority of addons.
Addon Nesting
This release updates the way that addons can be nested, and contains some breaking changes in non-default addon configurations.
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 the majority of apps, the update from 0.1.15 to 0.2.0 is non-breaking and should not cause significant concern.
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.
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
-- 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
-- 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.9. Install withnpm install --save-dev ember-cli-qunit@0.3.9
. - Updated
ember-data
to 1.0.0-beta.15. Install withnpm install --save-dev ember-data@1.0.0-beta.15
. - Updated
ember-cli-dependency-checker
to 0.0.8. Install withnpm install --save-dev ember-cli-dependency-checker@0.0.8
. - Updated
ember-cli-app-version
to 0.3.2. Install withnpm install --save-dev ember-cli-app-version@0.3.2
.
- 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
. - Updated
ember-resolver
to 0.1.12. Install withbower install --save ember-resolver
. - Updated
loader.js
to 3.2.0.
- 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
- #3246 [ENHANCEMENT] Update the service blueprint to use
Ember.Service
(and remove usage of an initializer). @ohcibi - #3054 [ENHANCEMENT] Updated
loader.js
to the latest version. @stefanpenner - #3216 [BUGFIX] Do not default to development asset @martndemus
- #3237 [BUGFIX] Blueprint templates with undefined variables should fallback to raw text @davewasmer
- #3288 [ENHANCEMENT] Override default port with
PORT
env var @knownasilya - #3158 [INTERNAL] add more steps to release.md @raytiley
- #3160 [BUGFIX] Don't override the request's path @dmathieu
- #3367 [ENHANCEMENT] Prevent spotlight from indexing
tmp
. @stefanpenner - #3336 [ENHANCEMENT] Nested addons should be overrideable from parent. @rwjblue
- #3335 [ENHANCEMENT] Allow shared nested addons to be properly discovered. @rwjblue
- #3312 [BUGFIX] ADDON_HOOKS.md - fixed broken and outdated links @leandrocp
- #3326 [ENHANCEMENT] Print deprecation warning for Node 0.10. @rwjblue
- #3317 [ENHANCEMENT] Remove express & glob from default app package.json. @rwjblue
- #3383 [ENHANCEMENT] Use Ember.HTMLBars by default in new helpers. @maxwerr
- #3355 [ENHANCEMENT] Add
ui
toProject
andAddon
instances. @rwjblue - #3341 [ENHANCEMENT] Improve blueprint help output method (markdown support) @trabus
- #3349 [BUGFIX] Allow deprecated lookup of invalid packages. @rwjblue
- #3353 [BUGFIX] Allow generated acceptance tests to be in directories @koriroys
- #3345 [ENHANCEMENT] Check if blueprint exists before printing help @trabus
- #3338 [ENHANCEMENT] Update resolver to 0.1.12 @teddyzeenny
- #3401 [BUGFIX] Fixes accidental global Error object pollution. @stefanpenner
- #3363 [ENHANCEMENT] Bump ember-cli-dependency-checker to v0.0.8 @quaertym
- #3358 [ENHANCEMENT] CI=true puts the UI into
silent
writeLevel @ember-cli - #3361 [ENHANCEMENT] Update
loader.js
to 3.0.2 @stefanpenner - #3356 [ENHANCEMENT] Generate blueprint inside addon generates into addon folder with re-export in app folder @trabus
- #3378 [ENHANCEMENT] Only generate JSHint warnings for the addon being developed @teddyzeenny
- #3375 [ENHANCEMENT] JSHint addon before preprocessing the JS @teddyzeenny
- #3373 [ENHANCEMENT] Provide a helpful error when an addon does not have a template compiler. @rwjblue
- #3386 [ENHANCEMENT] Display localhost in console instead of 0.0.0.0. @rwjblue
- #3391 [ENHANCEMENT] Update ember-cli-qunit to 0.3.9. @rwjblue
- #3410 [ENHANCEMENT] Use correct bound helper params for HTMLBars @jbrown
- #3428 [BUGFIX] Lock glob and rimraf to prevent EEXISTS errors. @raytiley
- #3435 [ENHANCEMENT] Update bundled npm @ember-cli
- #3436 [ENHANCEMENT] Update Broccoli to 0.13.6 to provide errors on new API. @rwjblue
- #3438 [BUGFIX] Ensure nested addon registry matches addon order. @rwjblue
- #3456 [BUGFIX] Update ember-cli-app-version to 0.3.2 @taras
Thank you to all who took the time to contribute!