npm 包發(fā)布經(jīng)驗(yàn)分享

重點(diǎn)闡述 npm 包發(fā)布前后所踩坑~

踩坑札記

https

若 npm 包中 method 含協(xié)議類型為 http請求(可跨域請求),但調(diào)用服務(wù)協(xié)議類型為 https尚蝌,將報錯:

[blocked] The page at https://XXX was not allowed to display insecure content from http://XXX

請將接口服務(wù)升級 https,url 書寫方案:

  • https://XXX:http 服務(wù)請求 https 接口 無報錯充尉;https 服務(wù)請求 https 接口 無報錯飘言。

  • //XXX:請求協(xié)議類型隨服務(wù)協(xié)議類型 自動轉(zhuǎn)化

環(huán)境變量

若 npm 包中 method 執(zhí)行需區(qū)分服務(wù)環(huán)境驼侠,通過 process.env.NODE_ENV 獲取 環(huán)境變量 是否準(zhǔn)確(node npm 包無上述準(zhǔn)確性問題)姿鸿?即便準(zhǔn)確,命名規(guī)范也 未統(tǒng)一倒源,如生產(chǎn)環(huán)境可由 prod苛预、production 等指代∷癜荆可考慮傳參 約定的 環(huán)境變量热某。

轉(zhuǎn)碼

轉(zhuǎn)碼即將 ES6、ES7 轉(zhuǎn) ES5胳螟,先附贈 Babel 轉(zhuǎn)碼教程昔馋,再科普忽視轉(zhuǎn)碼的危害:

  • 未轉(zhuǎn)碼 前端包 引用于 低版本瀏覽器 不兼容。

另外糖耸,含未轉(zhuǎn)碼片段的 vendor.js(通常將所依賴 node_modules 模塊打包至 vendor.js)若先于 app.js 執(zhí)行將直接導(dǎo)致較低版本瀏覽器 白屏秘遏。

  • 未轉(zhuǎn)碼 node 包 引用于 低版本 node 服務(wù) 拋異常。

若服務(wù)器所安裝 node 版本較低嘉竟,引用未轉(zhuǎn)碼包將導(dǎo)致接口 拋異常邦危。更糟糕的是若被頁面加載前置中間件依賴,直接引發(fā) 白屏舍扰。

此刻或許有同學(xué)考慮植入 babel-polyfill...

請求

含請求的 npm method铡俐,采用 Axios 等第三方 HTTP 庫將受業(yè)務(wù)對 Axios Request 攔截的影響。建議使用原生 XMLHttpRequest 對象封裝妥粟。


附贈科普如何發(fā)布 npm 包~

發(fā)布流程

注冊賬號

開啟終端輸入:

npm adduser

根據(jù)提示輸入 username审丘、password、email 即刻注冊成功勾给,已注冊用戶請忽略上述步驟滩报。登錄請直接:

npm login

初始化包

新建一文件夾如 bridge锅知,而后:

cd bridge
npm init

依提示完成初始化并完善目錄:

.eslintrc、.gitignore脓钾、package.json售睹、node_modules 不必過多解釋,各位前端大大知曉可训。src 內(nèi)為未經(jīng) Babel 轉(zhuǎn)碼 的源代碼昌妹,轉(zhuǎn)碼后置于 bridge 根目錄,Babel 通過 .babelrc 配置握截。至于 README.md飞崖,共享包說明書必不可少。

發(fā)布包

首先設(shè)置版本號谨胞,規(guī)則請參考 Semver固歪,而后:

npm publish

理想情況下,包已成功發(fā)布至 npm胯努,下述為非理想情況:

  • 命名問題

npm ERR! you do not have permission to publish XXX. Are you logged in as the correct user?

檢查 npm name 是否被占用牢裳,若被占用請更改后重新發(fā)布。

  • 版本號問題

npm ERR! forbidden cannot modify pre-existing version: 1.0.9: XXX

當(dāng)前版本已發(fā)布叶沛,請更新版本號蒲讯。

  • 鏡像配置問題

npm ERR! no_perms Private mode enable, only admin can publish this module: XXX

為加速 npm 部分同學(xué)利用淘寶鏡像代理,請恢復(fù)原配置:

npm config set registry=http://registry.npmjs.org

作者:呆戀小喵

我的后花園:https://sunmengyuan.github.io/garden/

我的 github:https://github.com/sunmengyuan

原文鏈接:https://sunmengyuan.github.io/garden/2018/12/18/npm.html

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末灰署,一起剝皮案震驚了整個濱河市判帮,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌氓侧,老刑警劉巖脊另,帶你破解...
    沈念sama閱讀 217,509評論 6 504
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異约巷,居然都是意外死亡偎痛,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,806評論 3 394
  • 文/潘曉璐 我一進(jìn)店門独郎,熙熙樓的掌柜王于貴愁眉苦臉地迎上來踩麦,“玉大人,你說我怎么就攤上這事氓癌∥角” “怎么了?”我有些...
    開封第一講書人閱讀 163,875評論 0 354
  • 文/不壞的土叔 我叫張陵贪婉,是天一觀的道長反粥。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么才顿? 我笑而不...
    開封第一講書人閱讀 58,441評論 1 293
  • 正文 為了忘掉前任莫湘,我火速辦了婚禮,結(jié)果婚禮上郑气,老公的妹妹穿的比我還像新娘幅垮。我一直安慰自己,他們只是感情好尾组,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,488評論 6 392
  • 文/花漫 我一把揭開白布忙芒。 她就那樣靜靜地躺著,像睡著了一般讳侨。 火紅的嫁衣襯著肌膚如雪呵萨。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,365評論 1 302
  • 那天爷耀,我揣著相機(jī)與錄音甘桑,去河邊找鬼拍皮。 笑死歹叮,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的铆帽。 我是一名探鬼主播咆耿,決...
    沈念sama閱讀 40,190評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼爹橱!你這毒婦竟也來了萨螺?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,062評論 0 276
  • 序言:老撾萬榮一對情侶失蹤愧驱,失蹤者是張志新(化名)和其女友劉穎慰技,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體组砚,經(jīng)...
    沈念sama閱讀 45,500評論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡吻商,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,706評論 3 335
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了糟红。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片艾帐。...
    茶點(diǎn)故事閱讀 39,834評論 1 347
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖盆偿,靈堂內(nèi)的尸體忽然破棺而出柒爸,到底是詐尸還是另有隱情,我是刑警寧澤事扭,帶...
    沈念sama閱讀 35,559評論 5 345
  • 正文 年R本政府宣布捎稚,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏今野。R本人自食惡果不足惜晰奖,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,167評論 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望腥泥。 院中可真熱鬧匾南,春花似錦、人聲如沸蛔外。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,779評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽夹厌。三九已至豹爹,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間矛纹,已是汗流浹背臂聋。 一陣腳步聲響...
    開封第一講書人閱讀 32,912評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留或南,地道東北人孩等。 一個月前我還...
    沈念sama閱讀 47,958評論 2 370
  • 正文 我出身青樓,卻偏偏與公主長得像采够,于是被迫代替她去往敵國和親肄方。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,779評論 2 354

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