diff --git a/aio/content/guide/ivy.md b/aio/content/guide/ivy.md index ab47c40a3b..255f57859a 100644 --- a/aio/content/guide/ivy.md +++ b/aio/content/guide/ivy.md @@ -1,38 +1,24 @@ -# Opting into Angular Ivy +# Opting out of Angular Ivy -Ivy is the code name for Angular's [next-generation compilation and rendering pipeline](https://blog.angular.io/a-plan-for-version-8-0-and-ivy-b3318dfc19f7). Starting with Angular version 8, you can choose to opt in to start using a preview version of Ivy and help in its continuing development and tuning. +Ivy is the code name for Angular's [next-generation compilation and rendering pipeline](https://blog.angular.io/a-plan-for-version-8-0-and-ivy-b3318dfc19f7). +Starting with Angular version 9, Ivy compilation and rendering pipeline is enabled by default. +The previous compilation and rendering pipeline, View Engine, is deprecated in version 9, and will be removed at a later date. +You can choose to opt out of Ivy and continue using View Engine while making the transition. -
- - To preview Ivy, use `@angular/core@next` version of Angular (8.1.x), rather than `@angular/core@latest` (8.0.x), as it contains all the latest bug fixes and improvements. - -
- - -## Using Ivy in a new project - -To start a new project with Ivy enabled, use the `--enable-ivy` flag with the [`ng new`](cli/new) command: - -```sh -ng new shiny-ivy-app --enable-ivy -``` - -The new project is automatically configured for Ivy. Specifically, the enableIvy option is set to `true` in the project's `tsconfig.app.json` file. - - -## Using Ivy in an existing project - -To update an existing project to use Ivy, set the `enableIvy` option in the `angularCompilerOptions` in your project's `tsconfig.app.json`. +To opt out of Ivy and continue using View Engine for an existing project, set the `enableIvy` option in the `angularCompilerOptions` in your project's `tsconfig.json` to `false`. ```json { "compilerOptions": { ... }, "angularCompilerOptions": { - "enableIvy": true + "enableIvy": false } } ``` -AOT compilation with Ivy is faster and should be used by default. In the `angular.json` workspace configuration file, set the default build options for your project to always use AOT compilation. +AOT compilation with Ivy is faster than with View Engine, and can be used for development. +If you opt out of Ivy, AOT compilation will be slower, and should not be used for development in large projects. +When Ivy is disabled for a large project, make sure that the `aot` build option in that project configuration is +set to `false` and it's only set to `true` in the `production` configuration. ```json { @@ -42,7 +28,13 @@ AOT compilation with Ivy is faster and should be used by default. In the `angula "build": { "options": { ... - "aot": true, + "aot": false, + }, + "configurations": { + "production": { + ... + "aot": true + } } } } @@ -50,6 +42,3 @@ AOT compilation with Ivy is faster and should be used by default. In the `angula } } ``` - -To stop using the Ivy compiler, set `enableIvy` to `false` in `tsconfig.app.json`, or remove it completely. Also remove `"aot": true` from your default build options if you didn't have it there before. - diff --git a/aio/content/navigation.json b/aio/content/navigation.json index 0197a1295f..2bcc126d61 100644 --- a/aio/content/navigation.json +++ b/aio/content/navigation.json @@ -579,7 +579,7 @@ { "url": "guide/ivy", "title": "Angular Ivy", - "tooltip": "Opting into Angular Ivy with Angular CLI." + "tooltip": "Opting out of Angular Ivy with Angular CLI." }, { "url": "guide/web-worker",