|
| 1 | +--- |
| 2 | +layout: post |
| 3 | +excerpt: UI-Router 1.0.0-rc.1 is released |
| 4 | +comments: true |
| 5 | +permalink: /blog/:title/ |
| 6 | +--- |
| 7 | + |
| 8 | +{% include toc icon="columns" title="UI-Router 1.0.0-rc.1" %} |
| 9 | + |
| 10 | +We released Angular UI-Router 1.0.0-rc.1 today. |
| 11 | +This release indicates that the APIs are not expected to change before the final release of ui-router 1.0. |
| 12 | + |
| 13 | +This release includes more breaking changes than usual. |
| 14 | +We are making an effort to call out more breaking changes that could potentially break end user applications, even if the prior behavior was unspecified. |
| 15 | + |
| 16 | +## Changes in RC.1 |
| 17 | + |
| 18 | +RC.1 is a major update, which includes many bug fixes and lots of new features. |
| 19 | + |
| 20 | +Please see the [release notes](https://github.com/angular-ui/ui-router/releases/tag/1.0.0-rc.1) for detailed information, including the breaking changes. |
| 21 | + |
| 22 | + |
| 23 | +## Repository split |
| 24 | + |
| 25 | +During the 1.0 alpha phase, we made the UI-Router core agnostic to Angular 1. |
| 26 | +This enabled us to create |
| 27 | +[`ui-router-ng2`](https://ui-router.github.io/ng2/) and |
| 28 | +[`ui-router-react`](https://ui-router.github.io/react/) |
| 29 | +by augmenting the |
| 30 | +[`ui-router-core`](https://github.com/ui-router/core) |
| 31 | +code. |
| 32 | + |
| 33 | +During the betas, both `ui-router-ng2` and the `angular-ui-router` for ng1 code were built from the same repository. |
| 34 | +This seemed like a good idea at the time because it allowed PRs to a monolithic repository. |
| 35 | +However, over time it became apparent that hosting both codebases together was not sustainable. |
| 36 | +So, we split the repositories into: |
| 37 | + |
| 38 | +- http://github.com/angular-ui/ui-router: `angular-ui-router`: UI-Router for AngularJS 1 |
| 39 | +- http://github.com/ui-router/ng2: `ui-router-ng2`: UI-Router for Angular (2.0 and above) |
| 40 | +- http://github.com/ui-router/core: `ui-router-core`: UI-Router core |
| 41 | + |
| 42 | +This release is the first one built from the modular UI-Router repositories. |
| 43 | + |
| 44 | +This release (1.0.0-rc.1) of Angular UI-Router is *not accompanied by a release of UI-Router for Angular 2+*. |
| 45 | +Going forward, the release schedules for Angular 1 and Angular 2 will no longer coincide. |
| 46 | + |
| 47 | + |
| 48 | +#### Upgrading |
| 49 | + |
| 50 | +If you haven't considered upgrading to UI-Router 1.0, now is the time to start planning. |
| 51 | +There are some breaking changes listed, but the should be fairly minimal for the typical UI-Router application. |
| 52 | +Please follow the [migration guide](https://ui-router.github.io/guide/ng1/migrate-to-1_0) when upgrading. |
| 53 | + |
| 54 | + |
0 commit comments