Home » Oreps » Angular CLI » All Releases » v12.0.0 Release

angular/angular-cli

CLI tool for Angular

Watch

Basic Details Issues Addressed Top Contributors Directory Browser Release Notes

Angular CLI v12.0.0

Angular CLI: v12.0.0 Release

Release date:

May 12, 2021

Previous version:

v12.0.0-rc.3 (released May 10, 2021)

Magnitude:

1 Diff Delta

Contributors:

1 total committer

Data confidence:

Commits:

1 Commit in this Release

Ordered by the degree to which they evolved the repo in this version.

release: v12.0.0

Authored May 12, 2021

Browse Other Releases

Latest Pending Unreleased 😎

v12.0.4 Released June 9, 2021

498 Δ

v12.0.3 Released June 2, 2021

274 Δ

v12.0.2 Released May 26, 2021

153 Δ

v12.0.1 Released May 19, 2021

114 Δ

v12.0.0 Released May 12, 2021

1 Δ

v12.0.0-rc.3 Released May 10, 2021

63 Δ

v12.0.0-rc.2 Released May 6, 2021

472 Δ

v12.0.0-rc.1 Released April 28, 2021

0 Δ

v12.0.0-rc.0 Released April 19, 2021

67 Δ

v12.0.0-next.9 Released April 14, 2021

1,189 Δ

Top Contributors in v12.0.0

kyliau

Directory Browser for v12.0.0

We haven't yet finished calculating and confirming the files and directories changed in this release. Please check back soon.

Release Notes Published

Commits

<tr><td colspan=3><h3>@angular-devkit/architect (0.1200.0)</h3></td></tr> <tr> <td><b>Commit</b> <td><b>Description</b> <td><b>Notes</b> </tr>

<tr>

<td>add implementation for defaultConfiguration</td>

<tr><td colspan=3><h3>@angular-devkit/build-angular (12.0.0)</h3></td></tr> <tr> <td><b>Commit</b> <td><b>Description</b> <td><b>Notes</b> </tr>

<tr>

<td>add postcss-preset-env with stage 3 features</td>

<tr>

<td>drop support for karma version 5.2</td>

<tr>

<td>drop support for ng-packagr version 11</td>

<tr>

<td>enable inlineCritical by default</td>

<tr>

<td>show warning during build when project requires IE 11 support</td>

<tr>

<td>expose legacy-migrate message format</td>

<tr>

<td>integrate JIT mode linker</td>

<td> <a href="https://github.com/angular/angular-cli/issues/20281"> [Closes #20281]<br /> </a>

</td> </tr>

<tr>

<td>upgrade to Webpack 5 throughout the build system</td>

<tr>

<td>support processing component inline CSS styles</td>

<tr>

<td>support specifying stylesheet language for inline component styles</td>

<tr>

<td>remove left-over experimentalRollupPass option</td>

<tr>

<td>support writing large Webpack stat outputs</td>

<tr>

<td>ensure output directory is present before writing stats JSON</td>

<tr>

<td>remove deprecated View Engine support for i18n extraction</td>

<tr>

<td>remove usage of deprecated View Engine compiler</td>

<tr>

<td>remove deprecated i18nLocale and i18nFormat options from i18n-extract</td>

<tr>

<td>update karma builder to use non-deprecated API</td>

<tr>

<td>disable webpack cache when using NG_BUILD_CACHE</td>

<tr>

<td>remove duplicate application bundle generation complete message</td>

<tr>

<td>mark programmatic builder execution functions as experimental</td>

<tr>

<td>avoid double build optimizer processing</td>

<tr>

<td>replace Webpack 4 hashForChunk hook usage</td>

<tr>

<td>use new Webpack watch API in karma webpack plugin</td>

<tr>

<td>recover from CSS optimization errors</td>

<tr>

<td>disable Webpack 5 automatic public path support</td>

<tr>

<td>always inject live reload client when using live reload</td>

<tr>

<td>change several builder options defaults</td>

<tr>

<td>show warning when using stylus</td>

<tr>

<td>avoid triggering file change after file build</td>

<tr>

<td>remove left-over forkTypeChecker option</td>

<tr>

<td>disable CSS declaration sorting optimizations</td>

<td> <a href="https://github.com/angular/angular-cli/issues/20693"> [Closes #20693]<br /> </a>

</td> </tr>

<tr>

<td>disable showCircularDependencies by default</td>

<tr>

<td>use Webpack's GC memory caching in watch mode</td>

<tr>

<td>improve incremental time during Karma tests</td>

<tr>

<td>avoid async downlevel for known ES2015 code</td>

<tr><td colspan=3><h3>@angular-devkit/build-optimizer (0.1200.0)</h3></td></tr> <tr> <td><b>Commit</b> <td><b>Description</b> <td><b>Notes</b> </tr>

<tr>

<td>support Webpack 5</td>

<tr><td colspan=3><h3>@angular-devkit/build-webpack (0.1200.0)</h3></td></tr> <tr> <td><b>Commit</b> <td><b>Description</b> <td><b>Notes</b> </tr>

<tr>

<td>provide output path in builder results</td>

<tr>

<td>support Webpack 5</td>

<tr><td colspan=3><h3>@angular-devkit/core (12.0.0)</h3></td></tr> <tr> <td><b>Commit</b> <td><b>Description</b> <td><b>Notes</b> </tr>

<tr>

<td>add handling for defaultConfiguration target definition property</td>

<tr>

<td>update schema validator</td>

<tr>

<td>ensure job input values are processed in order</td>

<tr>

<td>improve handling of set schema values</td>

<td> <a href="https://github.com/angular/angular-cli/issues/20594"> [Closes #20594]<br /> </a>

</td> </tr>

<tr><td colspan=3><h3>@angular/cli (12.0.0)</h3></td></tr> <tr> <td><b>Commit</b> <td><b>Description</b> <td><b>Notes</b> </tr>

<tr>

<td>add defaultConfiguration property to architect schema</td>

<tr>

<td>deprecate --prod command line argument</td>

<tr>

<td>confirm ng add action before installation</td>

<tr>

<td>support TypeScript 4.2</td>

<tr>

<td>ensure odd number Node.js version message is a warning</td>

<tr>

<td>remove npm 7 incompatibility notification</td>

<tr>

<td>avoid exceptions for expected errors in architect commands</td>

<tr>

<td>ensure update migrations are fully executed</td>

<tr>

<td>exclude deprecated packages with removal migrations from update</td>

<tr>

<td>add message update updating from non LTS versions of the CLI</td>

<tr>

<td>ignore tsickle during updates</td>

<tr>

<td>run all migrations when updating from or between prereleases</td>

<tr>

<td>add package manager name and version in ng version output</td>

<tr>

<td>Support XDG Base Directory Specfication</td>

<tr>

<td>don't display options multiple times in schematics help output</td>

<tr>

<td>change package installation to async</td>

<tr>

<td>infer schematic defaults correctly when using --project</td>

<td> <a href="https://github.com/angular/angular-cli/issues/20666"> [Closes #20666]<br /> </a>

</td> </tr>

<tr>

<td>propagate update's force option to package managers</td>

<tr>

<td>allow unsetting config when value is undefined</td>

<tr>

<td>allow config object to be of JSON.</td>

<tr>

<td>disallow additional properties in builders sections</td>

<tr><td colspan=3><h3>@ngtools/webpack (12.0.0)</h3></td></tr> <tr> <td><b>Commit</b> <td><b>Description</b> <td><b>Notes</b> </tr>

<tr>

<td>support Webpack 5</td>

<tr>

<td>drop support for string based lazy loading</td>

<tr>

<td>support multiple plugin instances per compilation</td>

<tr>

<td>support generating data URIs for inline component styles in JIT</td>

<tr>

<td>support processing inline component styles in AOT</td>

<tr>

<td>remove Webpack 5 deprecation warning in resource loader</td>

<tr>

<td>use correct Webpack asset stage in resource loader</td>

<tr>

<td>remove Webpack plugin for deprecated ViewEngine compiler</td>

<tr>

<td>only track actual resource file dependencies</td>

<tr>

<td>avoid adding transitive dependencies to Webpack's dependency graph</td>

<tr>

<td>use precalculated dependencies in unused file check</td>

<tr>

<td>only check affected files for Angular semantic diagnostics</td>

<tr>

<td>cache results of processed inline resources</td>

<tr>

<td>rebuild Angular required files asynchronously</td>

<tr>

<td>reduce source file and Webpack module iteration</td>

<tr><td colspan=3><h3>@schematics/angular (12.0.0)</h3></td></tr> <tr> <td><b>Commit</b> <td><b>Description</b> <td><b>Notes</b> </tr>

<tr>

<td>add migration to remove deprecated options from 'angular.json'</td>

<tr>

<td>strict mode by default</td>

<tr>

<td>use new zone.js entry-points</td>

<tr>

<td>add migration to use new zone.js entry-points</td>

<tr>

<td>add migration to remove emitDecoratorMetadata</td>

<tr>

<td>augment universal schematics to import platform-server shims</td>

<td> <a href="https://github.com/angular/angular/issues/40559"> [Closes #40559]<br /> </a>

</td> </tr>

<tr>

<td>update new project dependencies version</td>

<td> <a href="https://github.com/angular/angular-cli/issues/20106"> [Closes #20106]<br /> </a>

</td> </tr>

<tr>

<td>production builds by default</td>

<tr>

<td>deprecate legacyBrowsers application and ng-new option</td>

<tr>

<td>add migration to remove lazyModules configuration option</td>

<tr>

<td>add migration to update lazy loading string syntax to use dynamic imports</td>

<tr>

<td>update several TypeScript compilation target (Syntax)</td>

<tr>

<td>remove tslint and codelyzer from new projects</td>

<td> <a href="https://github.com/angular/angular-cli/issues/20105"> [Closes #20105]<br /> </a>

<a href="https://github.com/angular/angular-cli/issues/18465"> [Closes #18465]<br /> </a>

</td> </tr>

<tr>

<td>add production by default optional migration</td>

<tr>

<td>update new workspaces to use Karma 6.3</td>

<tr>

<td>remove entryComponent from component schematic</td>

<tr>

<td>configure new libraries to be published in Ivy partial mode</td>

<tr>

<td>update jasmine-spec-reporter to version 7</td>

<tr>

<td>migrate web workers to support Webpack 5</td>

<tr>

<td>only update removed v12 options in migration</td>

<tr>

<td>add additionalProperties to all schemas</td>

<tr>

<td>remove references to the prod flag</td>

<tr>

<td>only show legacy browsers deprecation warning when option is used</td>

<tr>

<td>remove leftover workspace tslint config</td>

<tr>

<td>correctly handle adding multi-line strings to @NgModule metadata</td>

<tr>

<td>run update-i18n migration for server builder</td>

<tr>

<td>update web-worker to support Webpack 5</td>

<tr>

<td>set inlineStyleLanguage when application style option is used</td>

<tr>

<td>set inlineStyleLanguage for universal if present in build options</td>

<tr>

<td>remove jasmine-spec-reporter and ts-node from default workspace</td>

<tr>

<td>remove Protractor from home page</td>

<tr>

<td>remove lint command from package.json</td>

<td> <a href="https://github.com/angular/angular-cli/issues/20618"> [Closes #20618]<br /> </a>

</td> </tr>

<tr>

<td>fix migration for namedChunks and option</td>

<tr>

<td>add "type" option in enum schematic</td>

<tr>

<td>only run emitDecoratorMetadata removal migration in safe workspaces</td>

<tr>

<td>replace clientProject with project</td>

</tbody> </table>

Breaking Changes

<h3> @schematics/angular: remove stylus from style options (<a href="https://github.com/angular/angular-cli/commit/fd729aca0e74c242797d4697786fbede06bc844b">fd729ac</a>) </h3> styl (Stylus) is no longer a supported value as style in application, component, ng-new schematics. Stylus is not actively maintained and only 0.3% of the Angular CLI users use it.

(cherry picked from commit 0272fc55b67d1a3f986b996c8eb21aea31eedf51)

<h3> @angular-devkit/build-angular: change several builder options defaults (<a href="https://github.com/angular/angular-cli/commit/656f8d75a3368a5affd1c55145841123dafdb007">656f8d7</a>) </h3> A number of browser and server builder options have had their default values changed. The aim of these changes is to reduce the configuration complexity and support the new "production builds by default" initiative.

Browser builder | Option | Previous default value | New default value | |----------------------------------------|---------------------------|-------------------| | optimization | false | true | | aot | false | true | | buildOptimizer | false | true | | sourceMap | true | false | | extractLicenses | false | true | | namedChunks | true | false | | vendorChunk | true | false |

Server builder | Option | Previous default value | New default value | |---------------|------------------------|-------------------| | optimization | false | true | | sourceMap | true | false |

(cherry picked from commit 0a74d0d28daf68510459ed73ef048c91bfcabbbc)

<h3> @angular-devkit/core: update schema validator (<a href="https://github.com/angular/angular-cli/commit/08753138d336fb870a66face70f5624ba64b4c69">0875313</a>) </h3> support for JSON Schema draft-04 and draft-06 is removed. If you have schemas using the id keyword replace them with $id. For an interim period we will auto rename any top level id keyword to $id.

NB: This change only effects schematics and builders authors.

<h3> @angular-devkit/build-angular: upgrade to Webpack 5 throughout the build system (<a href="https://github.com/angular/angular-cli/commit/d883ce5d7e39de774fe90e4ccdbc9a84a600b7e8">d883ce5</a>) </h3> Webpack 5 lazy loaded file name changes Webpack 5 generates similar but differently named files for lazy loaded JavaScript files in development configurations (when the namedChunks option is enabled). For the majority of users this change should have no effect on the application and/or build process. Production builds should also not be affected as the namedChunks option is disabled by default in production configurations. However, if a project's post-build process makes assumptions as to the file names then adjustments may need to be made to account for the new naming paradigm. Such post-build processes could include custom file transformations after the build, integration into service-side frameworks, or deployment procedures. Example development file name change: lazy-lazy-module.js --> src_app_lazy_lazy_module_ts.js

Webpack 5 now includes web worker support. However, the structure of the URL within the Worker constructor must be in a specific format that differs from the current requirement. Web worker usage should be updated as shown below (where ./app.worker should be replaced with the actual worker name): Before: new Worker('./app.worker', ...) After: new Worker(new URL('./app.worker', import.meta.url), ...)

<h3> @ngtools/webpack: remove Webpack plugin for deprecated ViewEngine compiler (<a href="https://github.com/angular/angular-cli/commit/160102ae57d780dded6c9002faf07b601a866d3d">160102a</a>) </h3> Removal of View Engine support from application builds With the removal of the deprecated View Engine compiler in Angular version 12 for applications, the View Engine Webpack plugin has been removed. The Ivy-based Webpack plugin is the default used within the Angular CLI. If using a custom standalone Webpack configuration, the removed AngularCompilerPlugin should be replaced with the Ivy-based AngularWebpackPlugin.

<h3> @angular-devkit/build-angular: remove deprecated i18n options from server and browser builder (<a href="https://github.com/angular/angular-cli/commit/5cf9a08dc7a1c84568d00df8f957d55b10ce0193">5cf9a08</a>) </h3> Removal of deprecated browser and server command options. - i18nFile, use locales object in the project metadata instead. - i18nFormat, No longer needed as the format will be determined automatically. - i18nLocale, use localize option instead.

<h3> @angular-devkit/build-angular: remove deprecated i18nLocale and i18nFormat options from i18n-extract (<a href="https://github.com/angular/angular-cli/commit/eca5a01f6e8d1c3ad874d74c58e6ffbddab6a031">eca5a01</a>) </h3> Removal of deprecated extract-i18n command options The deprecated i18nLocale option has been removed and the i18n.sourceLocale within a project's configuration should be used instead. The deprecated i18nFormat option has been removed and the format option should be used instead.

<h3> @angular-devkit/build-angular: remove usage of deprecated View Engine compiler (<a href="https://github.com/angular/angular-cli/commit/677913fc389f0ffa20e3e1928d7244427c07ef35">677913f</a>) </h3> Removal of View Engine support from application builds With the removal of the deprecated View Engine compiler in Angular version 12 for applications, Ivy-based compilation will always be used when building an application. The default behavior for applications is to use the Ivy compiler when building and no changes are required for these applications. For applications that have opted-out of Ivy, a warning will be shown and an Ivy-based build will be attempted. If the build fails, the application may need to be updated to become Ivy compatible.

<h3> @schematics/angular: remove entryComponent from component schematic (<a href="https://github.com/angular/angular-cli/commit/8582ddc35e153b8bc409d0505f29bc43e6cef455">8582ddc</a>) </h3> entryComponent option has been removed from the component schematic as this was intended to be used with the the now no longer supported ViewEngine rendering engine.

<h3> @angular-devkit/build-angular: remove view engine app-shell generation (<a href="https://github.com/angular/angular-cli/commit/1c2aeeb46a23fd511c89f9c8800ac2a5ab0c2734">1c2aeeb</a>) </h3> App-shell builder now only supports generation using Ivy

<h3> @angular-devkit/build-angular: remove deprecated View Engine support for i18n extraction (<a href="https://github.com/angular/angular-cli/commit/012700ace56d6d0e35d6798c5a19534ffa5a5a0e">012700a</a>) </h3> Removal of View Engine support from i18n extraction With the removal of the deprecated View Engine compiler in Angular version 12 for applications, the ng extract-i18n command will now always use the Ivy compiler. The --ivy option has also been removed as Ivy-based extraction is always enabled. The default behavior for applications is to use the Ivy compiler for building/extraction and no changes are required for these applications. For applications that have opted-out of Ivy, a warning will be shown and Ivy-based extraction will be attempted. If the extraction fails, the application may need to be updated to become Ivy compatible.

<h3> @angular/cli: confirm ng add action before installation (<a href="https://github.com/angular/angular-cli/commit/985dc1a4c71693ad78c35f5d6e95397f9753239e">985dc1a</a>) </h3> The ng add command will now ask the user to confirm the package and version prior to installing and executing an uninstalled package. This new behavior allows a user to abort the action if the version selected is not appropriate or if a typo occurred on the command line and an incorrect package would be installed. A --skip-confirmation option has been added to skip the prompt and directly install and execute the package. This option is useful in CI and non-TTY scenarios such as automated scripts.

<h3> @angular-devkit/build-angular: remove deprecated lazyModules option (<a href="https://github.com/angular/angular-cli/commit/8d669123236c49e7f6bee1a7171c002abe03df1a">8d66912</a>) </h3> Server and Browser builder lazyModules option has been removed without replacement.

<h3> @ngtools/webpack: drop support for string based lazy loading (<a href="https://github.com/angular/angular-cli/commit/0dc73276cafd42415dcaa6507ab221f1116273b5">0dc7327</a>) </h3> With this change we drop support for string based lazy loading ./lazy.module#LazyModule use dynamic imports instead.

The following options which were used to support the above syntax were removed without replacement. - discoverLazyRoutes - additionalLazyModules - additionalLazyModuleResources - contextElementDependencyConstructor

<h3> @angular-devkit/build-angular: enable inlineCritical by default (<a href="https://github.com/angular/angular-cli/commit/aa3ea885ed69cfde0914abae547e15d6d499a908">aa3ea88</a>) </h3> Critical CSS inlining is now enabled by default. If you wish to turn this off set inlineCritical to false.

See: https://angular.io/guide/workspace-config#optimization-configuration

<h3> @angular-devkit/build-angular: drop support for zone.js 0.10 (<a href="https://github.com/angular/angular-cli/commit/f309516bcdcee711fc5693b5f14d6fef1cfa5dba">f309516</a>) </h3> Minimum supported zone.js version is 0.11.4

<h3> @angular-devkit/build-angular: drop support for ng-packagr version 11 (<a href="https://github.com/angular/angular-cli/commit/44e75be5b127545bf87e2d6d61370944f4d380a1">44e75be</a>) </h3> Minimum supported ng-packagr version is 12.0.0-next

<h3> @angular-devkit/build-angular: drop support for karma version 5.2 (<a href="https://github.com/angular/angular-cli/commit/fa5cf53b644c96a50d09dce5f9e9ee401bf66053">fa5cf53</a>) </h3> Minimum supported karma version is 6.0.0

<h3> set minimum Node.js version to 12.13 (<a href="https://github.com/angular/angular-cli/commit/d1f616930de4a8312e3441410098d9f248855d9d">d1f6169</a>) </h3> Node.js version 10 will become EOL on 2021-04-30. Angular CLI 12 will require Node.js 12.13+ or 14.15+. Node.js 12.13 and 14.15 are the first LTS releases for their respective majors.

<h3> @angular-devkit/build-angular: remove file-loader dependency (<a href="https://github.com/angular/angular-cli/commit/6732294ff34ca35698cec5a9ca91b664dd684289">6732294</a>) </h3> The unsupported/undocumented, Webpack specific functionality to import/require() a non-module file has been removed.

Before js import img from './images/asset.png';

After html <img src="images/asset.png">

Special Thanks

Alan Agius, Charles Lyding, Keen Yee Liau, Joey Perrott, Doug Parker, Cédric Exbrayat, Douglas Parker, George Kalpakas, Sam Bulatov, Joshua Chapman, Santosh Yadav, David Shevitz, Kristiyan Kostadinov