angular/modules/@angular
Tobias Bosch fa47890032 refactor(core): clean up platform bootstrap and initTestEnvironment
- 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
2016-07-08 13:41:38 -07:00
..
common refactor: misc cleanup 2016-07-08 10:34:22 -07:00
compiler refactor(core): clean up platform bootstrap and initTestEnvironment 2016-07-08 13:41:38 -07:00
compiler-cli refactor(core): clean up platform bootstrap and initTestEnvironment 2016-07-08 13:41:38 -07:00
core refactor(core): clean up platform bootstrap and initTestEnvironment 2016-07-08 13:41:38 -07:00
docs docs: update cheatsheet import lines (#9614) 2016-06-26 07:31:35 -07:00
examples fix(animations): change trigger binding syntax to function as a property binding [] 2016-07-07 14:13:06 -07:00
facade doc(api): fix invalid doc links (#9873) 2016-07-07 23:02:35 -07:00
forms feat(forms): updateValue() for form groups and form arrays (#9901) 2016-07-08 13:04:25 -07:00
http docs(api): fix links (#9852) 2016-07-06 14:34:27 -07:00
platform-browser refactor(core): clean up platform bootstrap and initTestEnvironment 2016-07-08 13:41:38 -07:00
platform-browser-dynamic refactor(core): clean up platform bootstrap and initTestEnvironment 2016-07-08 13:41:38 -07:00
platform-server refactor(core): clean up platform bootstrap and initTestEnvironment 2016-07-08 13:41:38 -07:00
router refactor(core): clean up platform bootstrap and initTestEnvironment 2016-07-08 13:41:38 -07:00
router-deprecated doc(api): fix invalid doc links (#9873) 2016-07-07 23:02:35 -07:00
upgrade feat(testing): add implicit test module 2016-07-06 18:04:19 -07:00
license-banner.txt chore(package.json): make the packages installable 2016-05-27 17:21:34 -07:00
package.json repackaging: all the file moves 2016-05-01 20:51:00 -07:00
pubspec.yaml repackaging: all the file moves 2016-05-01 20:51:00 -07:00
README.dart.md repackaging: all the file moves 2016-05-01 20:51:00 -07:00
README.js.md repackaging: all the file moves 2016-05-01 20:51:00 -07:00

Angular2

The sources for this package are in the main Angular2 repo. Please file issues and pull requests against that repo. This is the repository for the upcoming 2.0 version. If you're looking for the current official version of Angular you should go to angular/angular.js

This package contains different sources for different users:

  1. The files located in the root folder can be consumed using CommonJS.
  2. The files under /es6 are es6 compatible files that can be transpiled to es5 using any transpiler. This contains:
    • dev/: a development version that includes runtime type assertions
    • prod/: a production version that does not include runtime type assertions
  3. The files under /ts are the TypeScript source files.

License: Apache MIT 2.0