[API] Warning: The .read and .rebuild APIs will stop working in the next Broccoli version

What

This issue is to help inform Broccoli & Ember-CLI users when they experience this error/warning and to help with the transition.

Why

This warning is presented when broccoli is used with a plugin that is implementing the deprecated .read/.rebuild API. This API has been deprecated for some time, and will be removed very shortly when we switch to using Broccoli 2.0 in Ember-CLI.

The warning is generated here: https://github.com/ember-cli/broccoli-builder/blob/0-18-x/lib/builder.js#L241-L246

Unfortunately, due to the warning not being presented until build time, the instantiation stack of the plugin is lost, giving few details and limited introspect-ability to the source of the offender.

If you encounter this error after installing a new ember addon, please report the error to the addon author, and ask them to update their addon (or its dependencies).

If you encounter this error after updating ember-cli on an existing project, chances are you or an addon is using an old version of the broccoli-plugin API. Please post your error along with all the ember-addons you are using, and is possible a link to your project repository.

A temporary work around for plugin authors is to use https://github.com/broccolijs/broccoli-read-compat however we STRONGLY encourage you to update your plugin to the latest https://github.com/broccolijs/broccoli-plugin API

Thanks, we hope this journey is smooth.

Deprecated

These packages are deprecated and showing warnings, if there is demand we will put forward fixes:

ef4/ember-browserify

Fixed

Addons/plugins already aware/fixed:

ef4/ember-browserify#130 simplabs/ember-simple-auth#1615 ember-template-lint/ember-cli-template-lint#345 mixonic/ember-cli-deprecation-workflow#52 buschtoens/broccoli-flatiron#3 ef4/ember-code-snippet#52 ef4/ember-auto-import#52

[piotrpalek]

Hey it seems that ember-power-select-with-create also causes this issue for me because it relies on (a probably older version of) ember-native-dom-helpers which in turn has an older version of broccoli-templater.

For anyone having this issue, what helped me find out which addons cause this issue was to search in node_modules for broccoli-templater and look for which addons had the 1.x version.

[jrjohnson]

Just wanted to add https://github.com/mixonic/ember-cli-deprecation-workflow/issues/52 to the list. It is the actual source of ember-template-lint/ember-cli-template-lint#345 according to https://github.com/ember-template-lint/ember-cli-template-lint/issues/345#issuecomment-419923817