npm包的發佈以及npm包的版本管理

介紹

安裝部署verdaccio私有庫方法見https://blog.csdn.net/yuzheng7002/article/details/104196062。本文主要解決verdaccio私有庫的發佈流程,版本更新等方法。

發佈流程

確認verdaccio配置的部署文件是需要登錄的,建議設置成需要登錄,並做好對應的權限管理。以便管理倉庫。

添加用戶

npm adduser
填寫用戶名,密碼郵箱等,如圖:
adduser

用戶登錄

npm login //用戶登錄命令
填寫對應用戶名 密碼 郵箱。
npm who am i //查看當前的npm用戶名

確定版本

  1. 版本介紹

major: 主版本號
premajor: 預備主版本
minor: 次版本號
preminor: 預備次版本
patch: 修訂號
prepatch: 預備修訂版
prerelease: 預發佈版本
語義化版本https://semver.org/lang/zh-CN/

  1. 版本發佈原則
  • 主版本號:做了不兼容修改或顛覆式的重寫
  • 次版本號:向下兼容的功能性新增
  • 修訂號:向下兼容的問題修正
  • 先行版本號及版本編譯信息可以加到“主版本號.次版本號.修訂號”的後面,作爲延伸。
  • 版本號只能增加,禁止下降,代碼的修改必須以新版本形式更新;最初版本建議是從v0.1.0開始,0.x.y階段是基礎功能、公衆API開發階段。
  1. 1.0.0版本發佈時機:
  • 被用於正式環境
  • 穩定的API被使用者依賴
  • 很擔心向下兼容的問題

萬一不小心把一個不兼容的改版當成了次版本號發行了該怎麼辦?一旦發現自己破壞了語義化版本控制的規範,就要修正這個問題,併發行一個新的次版本號來更正這個問題並且恢復向下兼容。即使是這種情況,也不能去修改已發行的版本

  1. 示例
    執行命令及版本提升示例:
假設初始版本爲0.1.0
➜  xxx git:(master) npm version preminor
v0.1.0-0
➜  xxx git:(master) npm version minor
v0.1.0
➜  xxx git:(master) npm version prepatch
v0.1.1-0
➜  xxx git:(master) npm version patch   
v0.1.1
➜  xxx git:(master) npm version prerelease
v0.1.2-0
➜  xxx git:(master) npm version premajor
v1.0.0-0
➜  xxx git:(master) npm version major   
v1.0.0

----確定版本部分引用自向暖悠悠的博客《版本號及使用npm管理項目版本號》

發佈

npm publish
發佈成功後可打開對應的網站檢查,也可在cmd中查看到到對應信息

常用問題及解決辦法

私有庫發佈時的問題

  1. 413:request entity too large 文件太大
    錯誤描述

解決辦法,找到配置文件在配置文件中添加(配置文件路徑見使用verdaccio搭建npm私有庫
max_body_size: 1000mb

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章