@@ -67,38 +67,32 @@ In general, cherry picks for LTS should only be done if it meets one of the crit
67
67
68
68
# Release
69
69
70
- Releasing is performed using Angular's unified release tooling. Each week, two releases are expected, ` latest ` and ` next ` on npm.
71
-
72
- ** For a minor OR major release:**
73
-
74
- After FW releases ` -rc.0 ` for an upcoming minor/major version, update the corresponding version in:
70
+ Releasing is performed using Angular's unified release tooling. Each week, two releases are expected, ` latest ` and ` next ` on npm. For major
71
+ and minor releases, some dependencies need to be manually bumped. The following files contain all the version numbers which need to be
72
+ manually updated:
75
73
76
74
- [ ` latest-versions.ts ` ] ( /packages/schematics/angular/utility/latest-versions.ts#L=18 )
77
75
- [ ` latest-versions/package.json ` ] ( /packages/schematics/angular/utility/latest-versions/package.json )
78
76
- [ ` @angular/pwa ` ] ( /packages/angular/pwa/package.json )
79
77
- [ ` @angular-devkit/build-angular ` ] ( /packages/angular_devkit/build_angular/package.json )
80
78
- [ ` @ngtools/webpack ` ] ( /packages/ngtools/webpack/package.json )
81
79
82
- The same needs to be done for a ` -next.0 ` release, and needs to be done for both minor _ and_ major
83
- releases.
80
+ ** DURING a minor OR major CLI release:**
81
+
82
+ Once FW releases the actual minor/major release (for example: ` 13.0.0 ` or ` 13.1.0 ` ), the above versions should be updated to match (remove
83
+ ` -rc.0 ` and ` -next.0 ` ). This ** must** be done as a separate PR which lands _ after_ FW releases (or else CI will fail) but _ before_ the CLI
84
+ release PR. Releases are built before the PR is sent for review, so any changes after that point won't be included in the release.
84
85
85
- Once FW releases the actual minor/major release (for example: ` 13.0.0 ` or ` 13.1.0 ` ), these versions
86
- should be updated to match (remove ` -rc.0 ` and ` -next.0 ` ). This ** must** be done as a separate PR
87
- which lands after FW releases (or else CI will fail) but _ before_ the CLI release PR. Releases are
88
- built before the PR is sent for review, so any changes after that point won't be included in the
89
- release.
86
+ ** AFTER a major CLI release:**
90
87
91
- ** Following a major release:**
88
+ Once a major release is complete, peer dependencies in the above files will need to be updated to "undo" the above change and add the
89
+ prerelease version segment on ` main ` . For example, ` "@angular/compiler-cli": "^13.0.0-next.0" ` should become
90
+ ` "@angular/compiler-cli": "^13.0.0 || ^13.1.0-next.0" ` . This should be done for all the peer deps in the above files.
92
91
93
- When a release is transitioning from a prerelease to a stable release, the semver ranges for Angular
94
- dependencies within the packages' ` package.json ` files will need to be updated to remove the
95
- prerelease version segment. For example, ` "@angular/compiler-cli": "^13.0.0 || ^13.0.0-next" ` in a
96
- prerelease should become ` "@angular/compiler-cli": "^13.0.0" ` in the stable release. This can happen
97
- as a follow-up item _ after_ the release PR and the stable release, actually shipped in the ` 13.0.1 `
98
- release. The current packages that require adjustment are:
92
+ ** AFTER a minor OR major CLI release:**
99
93
100
- - ` @angular-devkit/build-angular ` : [ packages/angular_devkit/build_angular/package.json ] ( /packages/angular_devkit/build_angular/package.json )
101
- - ` @ngtools/webpack ` : [ packages/ngtools/webpack/package.json ] ( /packages/ngtools/webpack/package.json )
94
+ ` latest-versions.ts ` also needs to be updated to use ` -next.0 ` after a major or minor release. However this needs to happen _ after _ FW
95
+ publishes the initial ` -next.0 ` release, which will happen 1 week after the major or minor release.
102
96
103
97
## Releasing the CLI
104
98
0 commit comments