fa47890032
- Introduces `CompilerFactory` which can be part of a `PlatformRef`.
- Introduces `WorkerAppModule`, `WorkerUiModule`, `ServerModule`
- Introduces `serverDynamicPlatform` for applications using runtime compilation
on the server.
- Changes browser bootstrap for runtime and offline compilation (see below for an example).
* introduces `bootstrapModule` and `bootstrapModuleFactory` in `@angular/core`
* introduces new `browserDynamicPlatform` in `@angular/platform-browser-dynamic
- Changes `initTestEnvironment` (which used to be `setBaseTestProviders`) to not take a compiler factory any more (see below for an example).
BREAKING CHANGE:
## Migration from `setBaseTestProviders` to `initTestEnvironment`:
- For the browser platform:
BEFORE:
```
import {setBaseTestProviders} from ‘@angular/core/testing’;
import {TEST_BROWSER_DYNAMIC_PLATFORM_PROVIDERS,
TEST_BROWSER_DYNAMIC_APPLICATION_PROVIDERS} from ‘@angular/platform-browser-dynamic/testing’;
setBaseTestProviders(TEST_BROWSER_DYNAMIC_PLATFORM_PROVIDERS,
TEST_BROWSER_DYNAMIC_APPLICATION_PROVIDERS);
```
AFTER:
```
import {initTestEnvironment} from ‘@angular/core/testing’;
import {browserDynamicTestPlatform,
BrowserDynamicTestModule} from ‘@angular/platform-browser-dynamic/testing’;
initTestEnvironment(
BrowserDynamicTestModule,
browserDynamicTestPlatform());
```
- For the server platform:
BEFORE:
```
import {setBaseTestProviders} from ‘@angular/core/testing’;
import {TEST_SERVER_PLATFORM_PROVIDERS,
TEST_SERVER_APPLICATION_PROVIDERS} from ‘@angular/platform-server/testing/server’;
setBaseTestProviders(TEST_SERVER_PLATFORM_PROVIDERS,
TEST_SERVER_APPLICATION_PROVIDERS);
```
AFTER:
```
import {initTestEnvironment} from ‘@angular/core/testing’;
import {serverTestPlatform,
ServerTestModule} from ‘@angular/platform-browser-dynamic/testing’;
initTestEnvironment(
ServerTestModule,
serverTestPlatform());
```
## Bootstrap changes
```
@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 {browserPlatform} from ‘@angular/platform-browser’;
import {bootstrapModuleFactory} from ‘@angular/core’;
bootstrapModuleFactory(MyModuleNgFactory, browserPlatform());
// runtime compile long form
import {browserDynamicPlatform} from ‘@angular/platform-browser-dynamic’;
import {bootstrapModule} from ‘@angular/core’;
bootstrapModule(MyModule, browserDynamicPlatform());
```
Closes #9922
Part of #9726
118 lines
4.7 KiB
TypeScript
118 lines
4.7 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 {COMMON_DIRECTIVES, COMMON_PIPES, PlatformLocation} from '@angular/common';
|
|
import {APPLICATION_COMMON_PROVIDERS, AppModule, AppModuleFactory, AppModuleRef, ExceptionHandler, NgZone, OpaqueToken, PLATFORM_COMMON_PROVIDERS, PLATFORM_INITIALIZER, PlatformRef, ReflectiveInjector, RootRenderer, SanitizationService, Testability, assertPlatform, createPlatform, createPlatformFactory, getPlatform, isDevMode} from '@angular/core';
|
|
|
|
import {wtfInit} from '../core_private';
|
|
import {AnimationDriver} from '../src/dom/animation_driver';
|
|
import {WebAnimationsDriver} from '../src/dom/web_animations_driver';
|
|
|
|
import {BrowserDomAdapter} from './browser/browser_adapter';
|
|
import {BrowserPlatformLocation} from './browser/location/browser_platform_location';
|
|
import {BrowserGetTestability} from './browser/testability';
|
|
import {ELEMENT_PROBE_PROVIDERS} from './dom/debug/ng_probe';
|
|
import {getDOM} from './dom/dom_adapter';
|
|
import {DomRootRenderer, DomRootRenderer_} from './dom/dom_renderer';
|
|
import {DOCUMENT} from './dom/dom_tokens';
|
|
import {DomEventsPlugin} from './dom/events/dom_events';
|
|
import {EVENT_MANAGER_PLUGINS, EventManager} from './dom/events/event_manager';
|
|
import {HAMMER_GESTURE_CONFIG, HammerGestureConfig, HammerGesturesPlugin} from './dom/events/hammer_gestures';
|
|
import {KeyEventsPlugin} from './dom/events/key_events';
|
|
import {DomSharedStylesHost, SharedStylesHost} from './dom/shared_styles_host';
|
|
import {isBlank} from './facade/lang';
|
|
import {DomSanitizationService, DomSanitizationServiceImpl} from './security/dom_sanitization_service';
|
|
|
|
|
|
/**
|
|
* A set of providers to initialize the Angular platform in a web browser.
|
|
*
|
|
* Used automatically by `bootstrap`, or can be passed to `platform`.
|
|
*
|
|
* @experimental API related to bootstrapping are still under review.
|
|
*/
|
|
export const BROWSER_PLATFORM_PROVIDERS: Array<any /*Type | Provider | any[]*/> = [
|
|
PLATFORM_COMMON_PROVIDERS, {provide: PLATFORM_INITIALIZER, useValue: initDomAdapter, multi: true},
|
|
{provide: PlatformLocation, useClass: BrowserPlatformLocation}
|
|
];
|
|
|
|
/**
|
|
* @security Replacing built-in sanitization providers exposes the application to XSS risks.
|
|
* Attacker-controlled data introduced by an unsanitized provider could expose your
|
|
* application to XSS risks. For more detail, see the [Security Guide](http://g.co/ng/security).
|
|
* @experimental
|
|
*/
|
|
export const BROWSER_SANITIZATION_PROVIDERS: Array<any> = [
|
|
{provide: SanitizationService, useExisting: DomSanitizationService},
|
|
{provide: DomSanitizationService, useClass: DomSanitizationServiceImpl},
|
|
];
|
|
|
|
/**
|
|
* A set of providers to initialize an Angular application in a web browser.
|
|
*
|
|
* Used automatically by `bootstrap`, or can be passed to {@link PlatformRef
|
|
* PlatformRef.application}.
|
|
*
|
|
* @experimental API related to bootstrapping are still under review.
|
|
*/
|
|
export const BROWSER_APP_PROVIDERS: Array<any /*Type | Provider | any[]*/> = [
|
|
APPLICATION_COMMON_PROVIDERS, BROWSER_SANITIZATION_PROVIDERS,
|
|
{provide: ExceptionHandler, useFactory: _exceptionHandler, deps: []},
|
|
{provide: DOCUMENT, useFactory: _document, deps: []},
|
|
{provide: EVENT_MANAGER_PLUGINS, useClass: DomEventsPlugin, multi: true},
|
|
{provide: EVENT_MANAGER_PLUGINS, useClass: KeyEventsPlugin, multi: true},
|
|
{provide: EVENT_MANAGER_PLUGINS, useClass: HammerGesturesPlugin, multi: true},
|
|
{provide: HAMMER_GESTURE_CONFIG, useClass: HammerGestureConfig},
|
|
{provide: DomRootRenderer, useClass: DomRootRenderer_},
|
|
{provide: RootRenderer, useExisting: DomRootRenderer},
|
|
{provide: SharedStylesHost, useExisting: DomSharedStylesHost},
|
|
{provide: AnimationDriver, useFactory: _resolveDefaultAnimationDriver}, DomSharedStylesHost,
|
|
Testability, EventManager, ELEMENT_PROBE_PROVIDERS
|
|
];
|
|
|
|
/**
|
|
* @experimental API related to bootstrapping are still under review.
|
|
*/
|
|
export const browserPlatform = createPlatformFactory('browser', BROWSER_PLATFORM_PROVIDERS);
|
|
|
|
export function initDomAdapter() {
|
|
BrowserDomAdapter.makeCurrent();
|
|
wtfInit();
|
|
BrowserGetTestability.init();
|
|
}
|
|
|
|
export function _exceptionHandler(): ExceptionHandler {
|
|
return new ExceptionHandler(getDOM());
|
|
}
|
|
|
|
export function _document(): any {
|
|
return getDOM().defaultDoc();
|
|
}
|
|
|
|
export function _resolveDefaultAnimationDriver(): AnimationDriver {
|
|
if (getDOM().supportsWebAnimation()) {
|
|
return new WebAnimationsDriver();
|
|
}
|
|
return AnimationDriver.NOOP;
|
|
}
|
|
|
|
/**
|
|
* The app module for the browser.
|
|
*
|
|
* @experimental
|
|
*/
|
|
@AppModule({
|
|
providers: [
|
|
BROWSER_APP_PROVIDERS,
|
|
],
|
|
directives: COMMON_DIRECTIVES,
|
|
pipes: COMMON_PIPES
|
|
})
|
|
export class BrowserModule {
|
|
}
|