npm 是 Node.js 的程式包管理器,日常開發中我們常用它安裝與移除套件。其實,「發布」自己的程式包同樣也是由它一手包辦。本文將帶你走過配置 package.json、註冊帳號到正式發布的完整流程。
要打包程式,首先得配置好各項設定,這些都由程式包根目錄下的 package.json 指定。它的內容必須是嚴格的 JSON 格式,也就是:
1. 字串要用雙引號括起來,不能用單引號;
2. 屬性名一定要加雙引號;
3. 最後一個屬性後千萬不要多一個逗號。
常用屬性包括:
1. name:程式包名,不能與現有程式包重複。
2. version:版本號。
3. description:簡短介紹。
4. author:作者資訊,含 name、email、url。
5. bin:若有可執行檔(主要在命令列呼叫),在此指定,可多個。
6. main:使用 require 呼叫本程式包時的程式入口。
7. dependencies:相依的程式包,可指定版本號。
配置好後,可以先在本地打包安裝測試:
代碼如下:另外還有一條潛規則:如果你希望程式包中的可執行檔在 Node.js 環境中運行,請在程式入口檔最前面加上這行:
代碼如下:若少了這行,它會以系統預設方式打開,而非在 Node.js 環境中運行。
要發布程式包,得先有帳號。npm 並未提供網頁版註冊向導,同樣透過命令列進行:
代碼如下:執行後會依序提示輸入用戶名、Email 與密碼,填好等待一會兒即可。
準備工作都完成後,執行下面的命令即可發布:
代碼如下:若要更新程式包,只要修改 package.json 中的版本號,再重新執行發布命令就可以了。掌握這套流程,你就能把自己的成果分享給全世界的 Node.js 開發者。