如何優(yōu)雅升級ng2項目

說明

這里的升級不是指ng1如何升級到ng2,僅使用ng2為栗子,說明拿穴,如何升級一個現(xiàn)有的項目削彬。如果想看下如何從ng1升級到ng2全庸,一定要關(guān)注Angular中文社區(qū) (微信號: angularcn)其中 從ng1到ng2的平滑升級 就是答案!

問題

項目經(jīng)過迭代融痛,package文件中的依賴庫有可能不是最新的壶笼,為及時更新依賴庫,就需要修改package中的版本號雁刷。但是覆劈,有些依賴又會依賴其他的依賴庫,如果僅僅是簡單的更新某個依賴庫到最新版本沛励,極有可能出現(xiàn) peer Dependencies 錯誤责语。那該如何處理這個問題呢? 穩(wěn)步推進(jìn)目派!

package依賴包版本

在講解如何升級之前坤候,先來了解下npm管理依賴包中存在的幾個標(biāo)點符號。

只有版本號

package.json中企蹭,版本號如下:
"@angular/core": "2.0.1" ====> 安裝指定版本

符號 ^

舉栗子: "@angular/core": "^2.0.1"
====> 安裝該版本以及比該版本更新的版本白筹, 如: 2.0.1 , 2.0.2, 2.1.0, 2.7.0
但是徘键,3開頭的不可以

符號 ~

舉栗子: "@angular/core": "~2.0.1"
====> 只能安裝 2.0.1, 2.0.2遍蟋, 吹害。。虚青。它呀。 2.0.9
但是, 2.1.0不可以

符號 >= <=

更有者,可以使用如下形式: >= ... <=
"@angular/core": ">=2.0.1<=3.0.0"

常用npm升級命令

以ng2的ng2-starter-webpack項目為例子說明棒厘,如何優(yōu)雅升級ng2相關(guān)版本纵穿。
package.json 文件內(nèi)容:

"dependencies": {
    "@angular/common": "2.0.1",
    "@angular/compiler": "2.0.1",
    "@angular/core": "2.0.1",
    "@angular/forms": "2.0.1",
    "@angular/http": "2.0.1",
    "@angular/platform-browser": "2.0.1",
    "@angular/platform-browser-dynamic": "2.0.1",
    "@angular/router": "3.0.1",
    "@angular/upgrade": "2.0.1",
    "angular-in-memory-web-api": "0.1.1",
    "bootstrap": "3.3.5",
    "core-js": "2.4.1",
    "reflect-metadata": "0.1.6",
    "rxjs": "5.0.0-beta.12",
    "zone.js": "0.6.23"
  },
  "devDependencies": {
    "html-webpack-plugin": "^2.24.1",
    "ts-loader": "^0.9.5",
    "typescript": "^2.0.6",
    "typings": "^1.5.0",
    "webpack": "^1.13.3",
    "webpack-dev-server": "^1.16.2"
  }

很顯然,ng2的庫不是最新的奢人,那么想升級到最新的庫谓媒,而且不讓他們出現(xiàn)error, 這就需要如下步驟何乎。注意句惯,如果按照上面的package.json文件,npm install會出現(xiàn)問題支救,莫慌抢野,故意為之!

`-- UNMET PEER DEPENDENCY zone.js@0.6.23

原因是 故意降低了 zone.js的版本各墨,正確版本是 0.6.25

npm list --depth 0

簡單查看 依賴庫 的信息.

$ npm list --depth 0
ng2-starter-webpack@0.0.1 E:\Project_Dev\Angularjs2\ng2-starter-webpack
+-- @angular/common@2.0.1
+-- @angular/compiler@2.0.1
+-- @angular/core@2.0.1
+-- @angular/forms@2.0.1
+-- @angular/http@2.0.1
+-- @angular/platform-browser@2.0.1
+-- @angular/platform-browser-dynamic@2.0.1
+-- @angular/router@3.0.1
+-- @angular/upgrade@2.0.1
+-- angular-in-memory-web-api@0.1.1
+-- bootstrap@3.3.5
+-- core-js@2.4.1
+-- html-webpack-plugin@2.24.1
+-- reflect-metadata@0.1.6
+-- rxjs@5.0.0-beta.12
+-- ts-loader@0.9.5
+-- typescript@2.0.10
+-- typings@1.5.0
+-- webpack@1.13.3
+-- webpack-dev-server@1.16.2
`-- UNMET PEER DEPENDENCY zone.js@0.6.23

npm ERR! peer dep missing: zone.js@^0.6.25, required by angular-in-memory-web-api@0.1.1

注意指孤,其中的npm Error: angular-in-memory-web-api@0.1.1需要的zone.js版本是 0.6.25, 所以導(dǎo)致出現(xiàn)了錯誤,這就是常見的 peer dependencies 問題贬堵。

npm ERR! peer dep missing: zone.js@^0.6.25, required by angular-in-memory-web-api@0.1.1

只要修改為正確的版本后恃轩,就不會出現(xiàn)問題了。

npm outdated

該命令是查詢當(dāng)前package中有哪些依賴庫是過時了的黎做。 結(jié)果如下

$ npm outdated
Package                                  Current         Wanted      Latest  Location
@angular/common                            2.0.1          2.0.1       2.2.0  ng2-starter-webpack
@angular/compiler                          2.0.1          2.0.1       2.2.0  ng2-starter-webpack
@angular/core                              2.0.1          2.0.1       2.2.0  ng2-starter-webpack
@angular/forms                             2.0.1          2.0.1       2.2.0  ng2-starter-webpack
@angular/http                              2.0.1          2.0.1       2.2.0  ng2-starter-webpack
@angular/platform-browser                  2.0.1          2.0.1       2.2.0  ng2-starter-webpack
@angular/platform-browser-dynamic          2.0.1          2.0.1       2.2.0  ng2-starter-webpack
@angular/router                            3.0.1          3.0.1       3.2.0  ng2-starter-webpack
@angular/upgrade                           2.0.1          2.0.1       2.2.0  ng2-starter-webpack
angular-in-memory-web-api                  0.1.1          0.1.1      0.1.15  ng2-starter-webpack
bootstrap                                  3.3.5          3.3.5       3.3.7  ng2-starter-webpack
reflect-metadata                           0.1.6          0.1.6       0.1.8  ng2-starter-webpack
rxjs                               5.0.0-beta.12  5.0.0-beta.12  5.0.0-rc.3  ng2-starter-webpack
ts-loader                                  0.9.5          0.9.5       1.2.1  ng2-starter-webpack
typescript                                2.0.10          2.1.1      2.0.10  ng2-starter-webpack
typings                                    1.5.0          1.5.0       2.0.0  ng2-starter-webpack
zone.js                                   0.6.25         0.6.25      0.6.26  ng2-starter-webpack

一目了然叉跛,當(dāng)前的version, 最新的version引几。

不要猴急把package中的版本號都替換為最新的昧互,要考慮依賴的問題。ng2的core庫依賴rxjs.js, zone.js伟桅, 把ng2升級到2.2.0,是否有必要把rxjs 或 zone.js升級為最新的版本呢叽掘? 也不一定楣铁。

npm view xxxpackage/xxx@x.x.x peerDependencies

該命令告訴我們,具體某個依賴包 的依賴關(guān)系更扁。

$ npm view @angular/core@2.2.0 peerDependencies
{ rxjs: '5.0.0-beta.12', 'zone.js': '^0.6.21' }

以查看 @angular/core@2.2.0 為例盖腕,它依賴 ** { rxjs: '5.0.0-beta.12', 'zone.js': '^0.6.21' } , 也就是說升級@angular/core** 到 ** 2.2.0 ** 沒有必要升級rxjs, zone.js版本赫冬,及時他們有更新的版本。

再看一個依賴庫: ** angular-in-memory-web-api@0.1.1 **

$ npm view angular-in-memory-web-api@0.1.1  peerDependencies

{ '@angular/core': '^2.0.0',
  '@angular/http': '^2.0.0',
  'reflect-metadata': '^0.1.3',
  rxjs: '5.0.0-beta.12',
  'zone.js': '^0.6.25' }

以上說明溃列,當(dāng)升級ng2相關(guān)庫為 2.2.0的時候劲厌,可以不用升級 ** angular-in-memory-web-api@0.1.1 **

但是,修改完成 ng相關(guān)庫為 2.2.0后听隐,再次執(zhí)行 npm install补鼻, 還是有錯誤

$ npm list --depth 0
ng2-starter-webpack@0.0.1 E:\Project_Dev\Angularjs2\ng2-starter-webpack
+-- UNMET PEER DEPENDENCY @angular/common@2.2.0
+-- @angular/compiler@2.2.0
+-- UNMET PEER DEPENDENCY @angular/core@2.2.0
+-- @angular/forms@2.2.0
+-- @angular/http@2.2.0
+-- UNMET PEER DEPENDENCY @angular/platform-browser@2.2.0
+-- @angular/platform-browser-dynamic@2.2.0
+-- @angular/router@3.0.1
+-- @angular/upgrade@2.2.0
+-- angular-in-memory-web-api@0.1.1
+-- bootstrap@3.3.5
+-- core-js@2.4.1
+-- html-webpack-plugin@2.24.1
+-- reflect-metadata@0.1.6
+-- rxjs@5.0.0-beta.12
+-- ts-loader@0.9.5
+-- typescript@2.0.10
+-- typings@1.5.0
+-- webpack@1.13.3
+-- webpack-dev-server@1.16.2
`-- zone.js@0.6.25

npm ERR! peer dep missing: @angular/common@2.0.1, required by @angular/router@3.0.1
npm ERR! peer dep missing: @angular/core@2.0.1, required by @angular/router@3.0.1
npm ERR! peer dep missing: @angular/platform-browser@2.0.1, required by @angular/router@3.0.1

本次是angular/router的版本太低了,@3.0.1 要求ng相關(guān)庫是2.0.1雅任, 2.2.0無法使用风范,所以需要升級angular/router 為3.2.0

小結(jié)

升級版本是個細(xì)致的活兒,需要按照科學(xué)的方法來做沪么。否則容易出現(xiàn)各種問題硼婿,腦殼都會抓掉。小結(jié)升級會使用到的命令吧禽车! 總結(jié)為一句話: 看版本寇漫,查依賴,修json殉摔,重復(fù)幾次

step 1 看版本

npm outdated

step 2 查看依賴

npm view xxxpackage/xxx@x.x.x peerDependencies

step 3 修改相關(guān)版本

step 4 重復(fù)來幾次

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末猪腕,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子钦勘,更是在濱河造成了極大的恐慌陋葡,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,265評論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件彻采,死亡現(xiàn)場離奇詭異腐缤,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)肛响,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,078評論 2 385
  • 文/潘曉璐 我一進(jìn)店門岭粤,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人特笋,你說我怎么就攤上這事剃浇。” “怎么了猎物?”我有些...
    開封第一講書人閱讀 156,852評論 0 347
  • 文/不壞的土叔 我叫張陵虎囚,是天一觀的道長。 經(jīng)常有香客問我蔫磨,道長淘讥,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,408評論 1 283
  • 正文 為了忘掉前任堤如,我火速辦了婚禮蒲列,結(jié)果婚禮上窒朋,老公的妹妹穿的比我還像新娘。我一直安慰自己蝗岖,他們只是感情好侥猩,可當(dāng)我...
    茶點故事閱讀 65,445評論 5 384
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著抵赢,像睡著了一般欺劳。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上瓣俯,一...
    開封第一講書人閱讀 49,772評論 1 290
  • 那天杰标,我揣著相機(jī)與錄音,去河邊找鬼彩匕。 笑死腔剂,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的驼仪。 我是一名探鬼主播掸犬,決...
    沈念sama閱讀 38,921評論 3 406
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼绪爸!你這毒婦竟也來了湾碎?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,688評論 0 266
  • 序言:老撾萬榮一對情侶失蹤奠货,失蹤者是張志新(化名)和其女友劉穎介褥,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體递惋,經(jīng)...
    沈念sama閱讀 44,130評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡柔滔,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,467評論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了萍虽。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片睛廊。...
    茶點故事閱讀 38,617評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖杉编,靈堂內(nèi)的尸體忽然破棺而出超全,到底是詐尸還是另有隱情,我是刑警寧澤邓馒,帶...
    沈念sama閱讀 34,276評論 4 329
  • 正文 年R本政府宣布嘶朱,位于F島的核電站,受9級特大地震影響绒净,放射性物質(zhì)發(fā)生泄漏见咒。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 39,882評論 3 312
  • 文/蒙蒙 一挂疆、第九天 我趴在偏房一處隱蔽的房頂上張望改览。 院中可真熱鬧,春花似錦缤言、人聲如沸宝当。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,740評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽庆揩。三九已至,卻和暖如春跌穗,著一層夾襖步出監(jiān)牢的瞬間订晌,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,967評論 1 265
  • 我被黑心中介騙來泰國打工蚌吸, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留锈拨,地道東北人。 一個月前我還...
    沈念sama閱讀 46,315評論 2 360
  • 正文 我出身青樓羹唠,卻偏偏與公主長得像奕枢,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子佩微,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 43,486評論 2 348

推薦閱讀更多精彩內(nèi)容