docs: deprecate ViewEngine-based JIT Compiler symbols (#43710)

DEPRECATION:

In ViewEngine, [JIT compilation](https://angular.io/guide/glossary#jit) required special providers (like `Compiler`, `CompilerFactory`, etc) to be injected in the app and corresponding methods to be invoked. With Ivy, JIT compilation takes place implicitly if the Component, NgModule, etc have not already been [AOT compiled](https://angular.io/guide/glossary#aot). Those special providers were made available in Ivy for backwards-compatibility with ViewEngine to make the transition to Ivy smoother. Since ViewEngine is deprecated and will soon be removed, those symbols are now deprecated as well:

- `ModuleWithComponentFactories`
- `Compiler`
- `CompilerFactory`
- `JitCompilerFactory`
- `NgModuleFactory`

Important note: this deprecation doesn't affect JIT mode in Ivy (JIT remains available with Ivy).

PR Close #43710
This commit is contained in:
Andrew Kushnir
2021-10-04 18:27:04 -07:00
committed by Dylan Hunn
parent 7acf3bece4
commit e3d6e97050
6 changed files with 60 additions and 7 deletions
@@ -171,6 +171,11 @@ export const COMPILER_PROVIDERS__POST_R3__ =
export const COMPILER_PROVIDERS = COMPILER_PROVIDERS__PRE_R3__;
/**
* @publicApi
*
* @deprecated
* Ivy JIT mode doesn't require accessing this symbol.
* See [JIT API changes due to ViewEngine deprecation](guide/deprecations#jit-api-changes) for
* additional context.
*/
export class JitCompilerFactory implements CompilerFactory {
private _defaultOptions: CompilerOptions[];