Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: remove speeding update ngcc section #36049

Closed
wants to merge 1 commit into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
28 changes: 3 additions & 25 deletions aio/content/guide/ivy.md
Expand Up @@ -43,29 +43,6 @@ CLI commands run `ngcc` as needed when performing an Angular build.

For more information on how to publish libraries see [Publishing your Library](guide/creating-libraries#publishing-your-library).

{@a speeding-up-ngcc-compilation}
### Speeding up ngcc compilation

The standalone `ngcc` program can run in parallel over your third party modules, making it more efficient than letting Angular CLI run it as needed.

You can run `ngcc` after each installation of node_modules by adding a `postinstall` [npm script](https://docs.npmjs.com/misc/scripts):

<code-example language="json" header="package.json">
{
"scripts": {
"postinstall": "ngcc --properties es2015 browser module main --first-only --create-ivy-entry-points"
}
}
</code-example>

<div class="alert is-important">

The `postinstall` script will run on every installation of `node_modules`, including those performed by `ng update` and `ng add`.

If you perform multiple installs in a row, this can end up being slower than letting Angular CLI run `ngcc` on builds.

</div>

{@a maintaining-library-compatibility}
### Maintaining library compatibility

Expand All @@ -92,8 +69,9 @@ You can run `ngcc` after each installation of node_modules by adding a `postinst

<div class="alert is-important">

Don't use `--create-ivy-entry-points` as this will cause Node not to resolve the Ivy version of the packages correctly.

* The `postinstall` script will run on every installation of `node_modules`, including those performed by `ng update` and `ng add`.
* Don't use `--create-ivy-entry-points` as this will cause Node not to resolve the Ivy version of the packages correctly.

</div>

{@a opting-out-of-angular-ivy}
Expand Down