Tobias Bosch
3f55aa609f
This introduces the `BrowserModule` to be used for long form
bootstrap and offline compile bootstrap:
```
@AppModule({
modules: [BrowserModule],
precompile: [MainComponent],
providers: […], // additional providers
directives: […], // additional platform directives
pipes: […] // additional platform pipes
})
class MyModule {
constructor(appRef: ApplicationRef) {
appRef.bootstrap(MainComponent);
}
}
// offline compile
import {bootstrapModuleFactory} from ‘@angular/platform-browser’;
bootstrapModuleFactory(MyModuleNgFactory);
// runtime compile long form
import {bootstrapModule} from ‘@angular/platform-browser-dynamic’;
bootstrapModule(MyModule);
```
The short form, `bootstrap(...)`, can now creates a module on the fly,
given `directives`, `pipes, `providers`, `precompile` and `modules`
properties.
Related changes:
- make `SanitizationService`, `SecurityContext` public in `@angular/core` so that the offline compiler can resolve the token
- move `AnimationDriver` to `platform-browser` and make it
public so that the offline compiler can resolve the token
BREAKING CHANGES:
- short form bootstrap does no longer allow
to inject compiler internals (i.e. everything
from `@angular/compiler). Inject `Compiler` instead.
To provide custom providers for the compiler,
create a custom compiler via `browserCompiler({providers: [...]})`
and pass that into the `bootstrap` method.
70 lines
2.3 KiB
TypeScript
70 lines
2.3 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google Inc. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {BaseException} from '../facade/exceptions';
|
|
import {ConcreteType, Type, stringify} from '../facade/lang';
|
|
import {AppModuleMetadata} from '../metadata/app_module';
|
|
|
|
import {AppModuleFactory} from './app_module_factory';
|
|
import {ComponentFactory} from './component_factory';
|
|
|
|
|
|
/**
|
|
* Low-level service for running the angular compiler duirng runtime
|
|
* to create {@link ComponentFactory}s, which
|
|
* can later be used to create and render a Component instance.
|
|
*
|
|
* Each `@AppModule` provides an own `Compiler` to its injector,
|
|
* that will use the directives/pipes of the app module for compilation
|
|
* of components.
|
|
* @stable
|
|
*/
|
|
export class Compiler {
|
|
/**
|
|
* Loads the template and styles of a component and returns the associated `ComponentFactory`.
|
|
*/
|
|
compileComponentAsync<T>(component: ConcreteType<T>): Promise<ComponentFactory<T>> {
|
|
throw new BaseException(
|
|
`Runtime compiler is not loaded. Tried to compile ${stringify(component)}`);
|
|
}
|
|
/**
|
|
* Compiles the given component. All templates have to be either inline or compiled via
|
|
* `compileComponentAsync` before.
|
|
*/
|
|
compileComponentSync<T>(component: ConcreteType<T>): ComponentFactory<T> {
|
|
throw new BaseException(
|
|
`Runtime compiler is not loaded. Tried to compile ${stringify(component)}`);
|
|
}
|
|
/**
|
|
* Compiles the given App Module. All templates of the components listed in `precompile`
|
|
* have to be either inline or compiled before via `compileComponentAsync` /
|
|
* `compileAppModuleAsync`.
|
|
*/
|
|
compileAppModuleSync<T>(moduleType: ConcreteType<T>, metadata: AppModuleMetadata = null):
|
|
AppModuleFactory<T> {
|
|
throw new BaseException(
|
|
`Runtime compiler is not loaded. Tried to compile ${stringify(moduleType)}`);
|
|
}
|
|
|
|
compileAppModuleAsync<T>(moduleType: ConcreteType<T>, metadata: AppModuleMetadata = null):
|
|
Promise<AppModuleFactory<T>> {
|
|
throw new BaseException(
|
|
`Runtime compiler is not loaded. Tried to compile ${stringify(moduleType)}`);
|
|
}
|
|
|
|
/**
|
|
* Clears all caches
|
|
*/
|
|
clearCache(): void {}
|
|
|
|
/**
|
|
* Clears the cache for the given component/appModule.
|
|
*/
|
|
clearCacheFor(type: Type) {}
|
|
}
|