跳到主要內容

使用NPM套件管理工具



NPM 的全名是 Node Package Manger,  是Node.js 的套件管理系統,   用來管理其背後龐大的開放原始碼, 透過NPM 我們可以很方便地加入第三方開發的套件到我們的專案裡, 縮短開發時間而這也是使用Node.js 開發應用程式的優點 (其實有點像 .Net 的NuGet, 或是 Python 的 Pypi),


如何安裝套件

> npm install simple-export-excel --save
simple-export-excel 即我們要下載的套件


如果想要全域安裝而不是侷限在某個專案裡我們可以使用-g參數

> npm install -g "你的套件名稱"


如何使用套件

使用的時候就呼叫 require 把剛剛下載的套件匯入專案

var xlsHelper = require("simple-export-excel")






Package.json

Package.json是用來表示這個專案的相關資訊
像是名稱, 版本, 以及相依的套件(dependencies)等等
如果安裝套件的時候有帶 --save 的指令的話, 套件資訊就會被寫入到 dependencies

{
"name": "node",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "",
"license": "ISC",
"dependencies": {
"simple-export-excel": "^1.0.3"
}
}

因為有Package.json紀錄相依套件的資訊, 所以在部屬時可以不用特地把node_modules裡的所有東西連帶地一起複製到production server,
只要使用npm install
相依的套件就會被安裝


Package-lock.json

在NPM 5以前,
若使用NPM 安裝套件, 除了指定套件會被安裝之外, 其相依的套件也會跟著被安裝, 但是這些相依套件的版本資訊並沒有被特別紀錄起來, 當被安裝的相依套件不相容於目前套件時, 就會導致指定套件無法被使用

所以NPM5之後, 為了避免以上的問題發生
做完npm install 之後, 資料夾內會多一個用來紀錄相依套件資訊的package-lock.json



Semantic versioning(SEMVER)

Semantic versioning是NPM上用來管理套件版本的規則
當大家都遵守這規則的話, 我們就很容易判別如果相依套件有新版的話是否要進行更新

MajorVersion.MinorVersion.Patch

Patch: 指的是當我們修了某些bug時, 通常我們會更新這邊的數字
Minor Version: 則是有新功能加入但不會影響原本的功能時, 我們會更新這邊的數字, 也就是更新之後也不會有任何side effect
Major Version:  則是更新之後可能會有些功能不能用, 也就是說如果你有一套件它的最新版的Major Version比目前還大, 此時可能要思考一下更新後會不會影響到原本的程式




更新套件
實際上我們可以使用npm outdated來檢查是否有需要的套件要更新

如果需要更新可以
> npm update

上傳套件
如果你覺得自己開發到套件可以幫助到其他人, 那你也可以選擇發布你的套件讓其他人使用

如果第一次使用的話需要加入使用者
> npm adduser
接著, npm使用者登陸
> npm login



套件進版
> npm version minor
或是你也可以直接編輯Package.json來進版

上傳
> npm publish



留言

這個網誌中的熱門文章

如何在 QNAP QuTS hero 上設定共享資料夾與 NFS 存取權限

如何在 QNAP QuTS hero 上設定共享資料夾與 NFS 存取權限 How to Set Up Shared Folders and NFS Access on QNAP QuTS Hero QNAP 的 QuTS hero 是一個強大的儲存解決方案,結合 ZFS 檔案系統,提供高效能和高可靠性的數據管理功能。如果您需要在 QuTS hero 上建立共享資料夾並啟用 NFS 存取權限,以下是完整的教學步驟,適合用於數據密集型工作負載。 步驟 1:建立共享資料夾並設定儲存屬性 首先,透過以下指令建立一個名為 test123 的共享資料夾,同時設定壓縮啟用、快速複製 (Fast Clone)、以及適合 VDI 或資料庫的 4KB 記錄大小: # 建立共享資料夾並設定儲存屬性 qcli_sharedfolder -s sharename=test123 poolID=1 \ compress=1 \ dedup=0 \ read_cache=0 \ fast_clone=1 \ sync=0 \ record_size=4 \ type=1 \ worm_type=0 \ size=107374182400 參數說明: compress=1 :啟用壓縮以節省存儲空間。 dedup=0 :關閉重複數據刪除以降低系統負擔。 record_size=4 :設定 4KB 記錄大小,適合資料庫應用。 fast_clone=1 :啟用快速複製以提升數據處理效率。 size=107374182400: 100 Gb 步驟 2:啟用並設定 NFS 存取 共享資料夾建立完成後,接下來啟用 NFS 存取,並設定所有主機 ( * ) 皆具有讀寫權限: # 啟用 NFS 存取 qcli_sharedfolder -N sharename=test123 Access=Enabled qcli_sharedfolder -U sharename=test123 userrw=guest # 為所有主機設定 NFS 權限 qcli_sharedfolder -K sharename=test123 remove_HostIP="*" qcli_sharedfolder -T sharename=test123 HostIP="*...

[解決方法] docker: permission denied

前言 當我們執行docker 指令時若出現以下錯誤訊息 docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post http://%2Fvar%2Frun%2Fdocker.sock/v1.26/containers/create: dial unix /var/run/docker.sock: connect: permission denied. See 'docker run --help'. 表示目前的使用者身分沒有權限去存取docker engine, 因為docker的服務基本上都是以root的身分在執行的, 所以在指令前加sudo就能成功執行指令 但每次實行docker指令(就連docker ps)都還要加sudo實在有點麻煩, 正確的解法是 我們可以把目前使用者加到docker群組裡面, 當docker service 起來時, 會以這個群組的成員來初始化相關服務 sudo groupadd docker sudo usermod -aG docker $USER 需要退出重新登錄後才會生效 Workaround 因為問題是出在權限不足, 如果以上方法都不管用的話, 可以手動修改權限來解決這個問題 sudo chmod 777 /var/run/docker.sock https://docs.docker.com/install/linux/linux-postinstall/

[C#] Visual Studio, 如何在10分鐘內快速更改命名專案名稱

前言: 由於工作需要, 而且懶得再重寫類似的專案, 所以常常將之前寫的專案複製一份加料後, 再重新命名編譯 假設今天我有一個專案HolyUWP, 我想把它重新命名成 BestUWP 時該怎麼做? 以下是幾個簡單的的步驟 使用Visual Studio 2017 備份原來專案 更改Solution名稱 更改Assembly name, Default namespce 更改每支程式碼的Namespace 更改專案資料夾名稱 備份原來專案 由於怕改壞掉, 所以在改之前先備份 更改Solution名稱 更改sln的名稱, 這邊我改成BestUWP.sln 使用Visual Studio打開你的.sln, 右鍵點擊Solution後選擇Rename, 這邊我把它重新命名成BestUWP(跟檔案名稱一致) 必要的話可以順便修改Porject名稱 更改Assembly name, Default namespce 進入 Project > OOXX Properties    修改Assembly Name, Default namesapce 更改每支程式碼的Namespace 基本上隨便挑一支有用到預設Namesapce(HolyUWP)的程式碼來改就好了 重新命名後點擊Apply,  這個動作做完後所有用到舊Namespace的程式碼都會被改成新的 更改專案資料夾名稱 以上動作做完後, 基本上就可以把專案編譯出來測看看了~