Upgrading from Angular beta to Angular RC is a little painful, and things are going to break. I’ve put together some links that helped reduce some of that pain for me.
A few weeks ago, I had the pleasure of upgrading a client’s singe page application from Angular 2.0.0-beta.12 to Angular 2.0.0-rc.4. As soon as I updated package.json, it broke. I was not surprised, I figured this would happen. Unfortunately, there were more than a few things to fix. Fortunately, the fixes fell into three categories:. 1) The Angular namespace changed. 2) The router changed. 3) Unit tests had to be changed.
None of this was fun, but I got through it. The hardest part was the lack of documentation. I found plenty of out-dated articles with tons of information that was useless to me. Awesome. But the official documentation was minimal to none. And what I found was either tedious or virtually useless. C’mon ng-folks, you can do better than that.
Here are some links that did provide helpful content for this upgrade:
angular/CHANGELOG.md at master · angular/angular
https://github.com/angular/angular/blob/master/CHANGELOG.md
Details: Essential information for each version release. I can’t imagine living without this. In particular, you can find out about namespace changes.
Forms Upcoming Change Proposal
https://docs.google.com/document/u/1/d/1RIezQqE4aEhBRmArIAS1mRIZtWFf6JxN_7B4meyWK0Y/pub
Details: Explains the thought-process behind their change to forms. At the very bottom of the article is critical information about how to opt-in to the deprecated forms, or use the new forms module.
Issues after Migration to RC4 in angular2 – Stack Overflow
http://stackoverflow.com/questions/38154399/issues-after-migration-to-rc4-in-angular2
Details: Some helpful information on breaking changes.
Routing & Navigation – ts
https://angular.io/docs/ts/latest/guide/router.html
Details: A very detailed explanation of how the new router works. A long read, but also one of the few thorough their documentation pages.
Defining Child Routes · Rangle.io : Angular 2 Training
http://angular-2-training-book.rangle.io/handout/routing/child_routes.html
Details: Another very detailed explanation of how the new router works.
Plunker
https://plnkr.co/edit/6Mdn7qUblMtktpQyFJAc?p=preview
Details: This plunker is very helpful if you need a quick-and-dirty working example of how child routes work in the new router.
