angular-cn/modules_dart
Jeff Cross 604c8bbad5 refactor(lifecycle): prefix lifecycle methods with "ng"
BREAKING CHANGE:
Previously, components that would implement lifecycle interfaces would include methods
like "onChanges" or "afterViewInit." Given that components were at risk of using such
names without realizing that Angular would call the methods at different points of
the component lifecycle. This change adds an "ng" prefix to all lifecycle hook methods,
far reducing the risk of an accidental name collision.

To fix, just rename these methods:
 * onInit
 * onDestroy
 * doCheck
 * onChanges
 * afterContentInit
 * afterContentChecked
 * afterViewInit
 * afterViewChecked
 * _Router Hooks_
 * onActivate
 * onReuse
 * onDeactivate
 * canReuse
 * canDeactivate

To:
 * ngOnInit,
 * ngOnDestroy,
 * ngDoCheck,
 * ngOnChanges,
 * ngAfterContentInit,
 * ngAfterContentChecked,
 * ngAfterViewInit,
 * ngAfterViewChecked
 * _Router Hooks_
 * routerOnActivate
 * routerOnReuse
 * routerOnDeactivate
 * routerCanReuse
 * routerCanDeactivate

The names of lifecycle interfaces and enums have not changed, though interfaces
have been updated to reflect the new method names.

Closes #5036
2015-11-30 16:40:50 -08:00
..
payload/hello_world chore(analytics): Include all of angular2 in hello_world 2015-11-23 20:10:04 +00:00
transform refactor(lifecycle): prefix lifecycle methods with "ng" 2015-11-30 16:40:50 -08:00
README.md docs(modules_dart): add README.md 2015-05-08 13:45:26 -07:00

README.md

This directory contains pure Dart packages that use standard pub layout.

Working with an existing package

  1. Run gulp build.dart
  2. Open the package in any Dart IDE of your choice
  3. Tada!

You do not need to rerun step 1 if you are only making changes in modules_dart. However, you do need to run it again after you make a change in modules. This is because these packages depend on code inside the dist directory via dependency_overrides. Code in modules need to be transpiled into dist before the IDE can "feel" your changes in modules.

Creating a new package

  1. Create a new directory with its own pubspec.yaml and standard pub layout.
  2. Add both a normal dependency on angular2 and a dependency_overrides, like this:
version: 0.0.0
dependencies:
  angular2: '0.0.0'
dependency_overrides:
  angular2:
    path: ../../dist/dart/angular2

The publishing script will automatically rewrite version numbers, so use 0.0.0 both for your package and angular2 version. Similarly, do not include authors and homepage, as they will be auto-populated. However, do provide description, name (prefixed with angular2_), dependencies, and dev_dependencies.