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

發(fā)布到npm

  1. 注冊(cè)npm賬號(hào)（已有可忽略）
  2. 新建文件夾，進(jìn)入該文件夾，運(yùn)行npm init，生成package.json文件
  3. 將需要發(fā)布的代碼放入該文件夾
    如果是第一次發(fā)布，運(yùn)行 npm adduser，如果不是第一次發(fā)包，運(yùn)行 npm login
  4. 進(jìn)入項(xiàng)目文件夾下，運(yùn)行 npm publish 發(fā)布。

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

參看當(dāng)前倉庫地址：npm config get registry

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

參看當(dāng)前包所有版本信息： npm view xxxx versions

參看當(dāng)前包最新版本信息： npm view xxxx version

參看當(dāng)前包所有信息： npm info xxxx

查看當(dāng)前安裝報(bào)的版本： npm ls xxxx

package.json中的name、version就是對(duì)應(yīng)報(bào)的名字和版本

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

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

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

現(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

用密碼和賬號(hào)生成秘鑰

將生成的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版本 需要加上這兩個(gè)參數(shù) --tag beta

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

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

  1. 第一步：發(fā)布第一個(gè)穩(wěn)定版本
 npm publish//1.0.0
  1. 第二步：修改文件繼續(xù)發(fā)布第二個(gè)版本
git add -A && git commit -m "c"
npm version patch
npm publish//1.0.1
  1. 第三步：繼續(xù)修改文件發(fā)布一個(gè)prerelease版本
git add -A && git commit -m "c"
npm version prerelease
npm publish --tag -beta//版本n-n-n-n@1.0.2-0
  1. 第四步：繼續(xù)修改發(fā)布第二個(gè)prerelease版本
git add -A && git commit -m "c"
npm version prerelease
npm publish --tag -beta//版本n-n-n-n@1.0.2-1
  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: {} }

我們只要注意下面者兩個(gè)部分：

'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ù)組中存儲(chǔ)的是所有的版本。

  1. 第六步：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
  1. 第七步：當(dāng)我們的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>

此時(shí)你通過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可以看出來，此時(shí)latest版本已經(jīng)是prerelease版本”1.0.2-1”了！此時(shí)用戶如果直接運(yùn)行npm install就會(huì)安裝我們的prerelease版本了，因?yàn)榘姹疽呀?jīng)更新了！

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

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

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

一、版本號(hào)的位置及簡(jiǎn)述

每個(gè)npm 包都有一個(gè)package.json文件，文件中的version字段即為當(dāng)前包的版本號(hào)。

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

二、修改版本號(hào)的命令

npm version 命令用于更改版本號(hào)的信息，并執(zhí)行commit 操作；該命令執(zhí)行后， package.json 里的 version 會(huì)自動(dòng)更新。

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

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

當(dāng)前包只是修復(fù)了些問題時(shí)，可變更第三位，執(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>] 來查看一個(gè)包的tag，一般來說我們至少會(huì)有三種類型的標(biāo)簽

latest：最后版本，npm install的就是這個(gè)

beta：測(cè)試版本，一般內(nèi)測(cè)使用，需要指定版本號(hào)install，例如3.1.0-beta.0

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

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

npm publish --tag beta

如果你直接執(zhí)行npm publish，那么即使你的版本號(hào)是 -beta.n ，默認(rèn)會(huì)打上 latest 的標(biāo)簽，別人install的時(shí)候也會(huì)下載到。這個(gè)時(shí)候需要我們只要改一下tag：

##### 使用npm dist-tag add更改特別版本的tag
// 不小心發(fā)錯(cuò)了
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ā)布的包指定的版本（不更新版本號(hào)）

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

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

友情鏈接更多精彩內(nèi)容