npm 發(fā)包學(xué)習(xí)筆記

發(fā)布到npm

注冊npm賬號（已有可忽略）
新建文件夾，進入該文件夾毯炮，運行npm init蚁袭，生成package.json文件
將需要發(fā)布的代碼放入該文件夾
如果是第一次發(fā)布鱼响，運行 npm adduser竖瘾，如果不是第一次發(fā)包沟突，運行 npm login
進入項目文件夾下，運行 npm publish 發(fā)布捕传。

發(fā)布的地址是當前npm廠庫的地址

參看當前倉庫地址：npm config get registry

設(shè)置倉庫地址： npm config set registry https://registry.npm.taobao.org

參看當前包所有版本信息： npm view xxxx versions

參看當前包最新版本信息： npm view xxxx version

參看當前包所有信息： npm info xxxx

查看當前安裝報的版本： npm ls xxxx

package.json中的name惠拭、version就是對應(yīng)報的名字和版本

具體參考:
https://blog.csdn.net/qq_36256944/article/details/80459383

發(fā)布到公司的私有源

通過發(fā)布到npm公有的源的方式我們通過將發(fā)布的地址改為公司私有源的地址就可以了。（用戶名庸论，密碼這個肯定也要變职辅，流程不變）

現(xiàn)在我們通過另外一種方式來發(fā)布到私有源：以公司的hzero-front為例

發(fā)包的過程：

編譯用于發(fā)布的版本

執(zhí)行如下命令

$ cd packages/<hzero front module>
$ yarn transpile

第一種也是要編譯用于發(fā)布的版本的

生成 auth hash

執(zhí)行如下命令

echo -n 'username:password' | openssl base64

用密碼和賬號生成秘鑰

將生成的auth hash按照如下方式配置

email=yourname@hand-china.com
always-auth=true
_auth=yourbase64hashcode

執(zhí)行如下命令將上面的配置加入到node.js全局環(huán)境變量配置文件.npmrc中

$ npm config edit

再執(zhí)行如下命令發(fā)布即可

$ npm publish --registry http:xxxxxxxxxxxxxxxxxxxxxxx

發(fā)布到指定位置

如果發(fā)布beta版本需要加上這兩個參數(shù) --tag beta

關(guān)于為啥發(fā)布beta 需要加上上面兩個參數(shù)

現(xiàn)在用一個例子來解釋參數(shù)--tag beta的作用

第一步：發(fā)布第一個穩(wěn)定版本

 npm publish//1.0.0

第二步：修改文件繼續(xù)發(fā)布第二個版本

git add -A && git commit -m "c"
npm version patch
npm publish//1.0.1

第三步：繼續(xù)修改文件發(fā)布一個prerelease版本

git add -A && git commit -m "c"
npm version prerelease
npm publish --tag -beta//版本n-n-n-n@1.0.2-0

第四步：繼續(xù)修改發(fā)布第二個prerelease版本

git add -A && git commit -m "c"
npm version prerelease
npm publish --tag -beta//版本n-n-n-n@1.0.2-1

第五步：npm info查看我們的版本信息

{ name: 'n-n-n-n',
  'dist-tags': { latest: '1.0.1', '-beta': '1.0.2-1' },
  versions: [ '1.0.0', '1.0.1', '1.0.2-0', '1.0.2-1' ],
  maintainers: [ 'liangklfang <liangklfang@163.com>' ],
  time:
   { modified: '2017-04-01T12:17:56.755Z',
     created: '2017-04-01T12:15:23.605Z',
     '1.0.0': '2017-04-01T12:15:23.605Z',
     '1.0.1': '2017-04-01T12:16:24.916Z',
     '1.0.2-0': '2017-04-01T12:17:23.354Z',
     '1.0.2-1': '2017-04-01T12:17:56.755Z' },
  homepage: 'https://github.com/liangklfang/n#readme',
  repository: { type: 'git', url: 'git+https://github.com/liangklfang/n.git' },
  bugs: { url: 'https://github.com/liangklfang/n/issues' },
  license: 'ISC',
  readmeFilename: 'README.md',
  version: '1.0.1',
  description: '',
  main: 'index.js',
  scripts: { test: 'echo "Error: no test specified" && exit 1' },
  author: '',
  gitHead: '8123b8addf6fed83c4c5edead1dc2614241a4479',
  dist:
   { shasum: 'a60d8b02222e4cae74e91b69b316a5b173d2ac9d',
     tarball: 'https://registry.npmjs.org/n-n-n-n/-/n-n-n-n-1.0.1.tgz' },
  directories: {} }

我們只要注意下面者兩個部分：

'dist-tags': { latest: '1.0.1', '-beta': '1.0.2-1' },
  versions: [ '1.0.0', '1.0.1', '1.0.2-0', '1.0.2-1' ],

其中最新的穩(wěn)定版本和最新的beta版本可以在dist-tags中看到，而versions數(shù)組中存儲的是所有的版本聂示。

第六步：npm dist-tag命令

npm dist-tag ls n-n-n-n

即npm dist-tag獲取到所有的最新的版本域携，包括prerelease與穩(wěn)定版本，得到下面結(jié)果：

-beta: 1.0.2-1
latest: 1.0.1

第七步：當我們的prerelease版本已經(jīng)穩(wěn)定了鱼喉，重新設(shè)置為穩(wěn)定版本

npm dist-tag add n-n-n-n@1.0.2-1 latest

<a href="#jump">npm dist-tag add理解</a>

此時你通過npm info查看可以知道：

{
   name: 'n-n-n-n',
  'dist-tags': { latest: '1.0.2-1', '-beta': '1.0.2-1' },
  versions: [ '1.0.0', '1.0.1', '1.0.2-0', '1.0.2-1' ],
}

從dist-tags和version可以看出來涵亏，此時latest版本已經(jīng)是prerelease版本”1.0.2-1”了！此時用戶如果直接運行npm install就會安裝我們的prerelease版本了蒲凶，因為版本已經(jīng)更新了！

參考文章： https://blog.csdn.net/liangklfang/article/details/68947786

關(guān)于npm version的用法理解

對于每次發(fā)布包的版本我們可以通過直接修改package.json中的版本也可以通過npm version命令的形式來修改每次發(fā)布的版本

一拆内、版本號的位置及簡述

每個npm 包都有一個package.json文件旋圆，文件中的version字段即為當前包的版本號。

version字段一般由三位數(shù)構(gòu)成麸恍，格式如下：x.x.x灵巧，分別對應(yīng)著version 里面的： major, minor, patch；若帶預(yù)發(fā)號的話抹沪，
格式為： x.x.x-x刻肄，最后一位表示預(yù)發(fā)號。

二融欧、修改版本號的命令

npm version 命令用于更改版本號的信息敏弃，并執(zhí)行commit 操作；該命令執(zhí)行后噪馏， package.json 里的 version 會自動更新麦到。

一般來說绿饵，當版本有較大改動時，變更第一位瓶颠，執(zhí)行命令：npm version major -m "description" , 例如1.0.0 -> 2.0.0;

當前包變動較小時拟赊，可變更第二位，執(zhí)行命令：npm version minor -m "description", 例如: 1.0.0 -> 1.1.0;

當前包只是修復(fù)了些問題時粹淋，可變更第三位吸祟，執(zhí)行命令：npm version patch -m "description", 例如: 1.0.0 -> 1.0.1;

參考文章： https://blog.csdn.net/u011575498/article/details/105863166

<a id='jump'>npm dist-tag add理解</a>

npm的tag

我們可以通過 npm dist-tag ls [<pkg>] 來查看一個包的tag，一般來說我們至少會有三種類型的標簽

latest：最后版本桃移，npm install的就是這個

beta：測試版本屋匕，一般內(nèi)測使用，需要指定版本號install谴轮，例如3.1.0-beta.0

next: 先行版本炒瘟，npm install foo@next安裝，例如3.0.2-alpha.0

如果我們需要發(fā)布一個測試版本第步，在發(fā)布的時候需要執(zhí)行

npm publish --tag beta

如果你直接執(zhí)行npm publish疮装，那么即使你的版本號是 -beta.n ，默認會打上 latest 的標簽粘都，別人install的時候也會下載到廓推。這個時候需要我們只要改一下tag：

##### 使用npm dist-tag add更改特別版本的tag
// 不小心發(fā)錯了
latest: 1.0.1-beta.0
bate: 1.0.0
// 將1.0.1-beta.0設(shè)置為beta
npm dist-tag add my-package@1.0.1-beta.0 beta
// 將1.0.0 設(shè)置為lastest
npm dist-tag add my-package@1.0.0 latest

刪除發(fā)布的包

npm unpublish 包名 --force

更新發(fā)布的包指定的版本（不更新版本號）

在package.json寫定報的版本，然后執(zhí)行npm publish 想當于把當前的版本在重新發(fā)布一下

npm 發(fā)包 學(xué)習(xí)筆記