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.
65 lines
1.9 KiB
TypeScript
65 lines
1.9 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 {Math, StringWrapper} from '../src/facade/lang';
|
|
|
|
import {OpaqueToken} from './di';
|
|
|
|
|
|
/**
|
|
* A DI Token representing a unique string id assigned to the application by Angular and used
|
|
* primarily for prefixing application attributes and CSS styles when
|
|
* {@link ViewEncapsulation#Emulated} is being used.
|
|
*
|
|
* If you need to avoid randomly generated value to be used as an application id, you can provide
|
|
* a custom value via a DI provider <!-- TODO: provider --> configuring the root {@link Injector}
|
|
* using this token.
|
|
* @experimental
|
|
*/
|
|
export const APP_ID: any = /*@ts2dart_const*/ new OpaqueToken('AppId');
|
|
|
|
export function _appIdRandomProviderFactory() {
|
|
return `${_randomChar()}${_randomChar()}${_randomChar()}`;
|
|
}
|
|
|
|
/**
|
|
* Providers that will generate a random APP_ID_TOKEN.
|
|
* @experimental
|
|
*/
|
|
export const APP_ID_RANDOM_PROVIDER =
|
|
/*@ts2dart_const*/ /* @ts2dart_Provider */ {
|
|
provide: APP_ID,
|
|
useFactory: _appIdRandomProviderFactory,
|
|
deps: <any[]>[]
|
|
};
|
|
|
|
function _randomChar(): string {
|
|
return StringWrapper.fromCharCode(97 + Math.floor(Math.random() * 25));
|
|
}
|
|
|
|
/**
|
|
* A function that will be executed when a platform is initialized.
|
|
* @experimental
|
|
*/
|
|
export const PLATFORM_INITIALIZER: any =
|
|
/*@ts2dart_const*/ new OpaqueToken('Platform Initializer');
|
|
|
|
/**
|
|
* A function that will be executed when an application is initialized.
|
|
* @experimental
|
|
*/
|
|
export const APP_INITIALIZER: any =
|
|
/*@ts2dart_const*/ new OpaqueToken('Application Initializer');
|
|
|
|
/**
|
|
* A token which indicates the root directory of the application
|
|
* @experimental
|
|
*/
|
|
export const PACKAGE_ROOT_URL: any =
|
|
/*@ts2dart_const*/ new OpaqueToken('Application Packages Root URL');
|