Node.js 指南(如何釋出N-API包)

博弈發表於2019-02-16

如何釋出N-API包

使用包iotivity-node說明了以下步驟:

  • 首先,釋出非N-API版本:

    • 更新package.json中的版本,對於iotivity-node,版本變為1.2.0-2
    • 瀏覽釋出清單(確保測試/演示/文件正常)。
    • npm publish
  • 然後,釋出N-API版本:

    • 更新package.json中的版本,在iotivity-node的情況下,版本變為1.2.0-3,對於版本控制,我們建議遵循semver.org所述的預釋出版本方案,例如:1.2.0-napi
    • 瀏覽釋出清單(確保測試/演示/文件正常)。
    • npm publish --tag n-api

在此示例中,使用n-api標記發行版確保了,儘管版本1.2.0-3晚於非N-API釋出版本(1.2.0-2),如果有人選擇通過簡單地執行npm install iotivity-node來安裝iotivity-node,則不會安裝它。這將預設安裝非N-API版本,使用者必須執行npm install iotivity-node@n-api才能接收N-API版本,有關在npm中使用標籤的更多資訊,請檢視“使用dist-tags”

引入包的N-API版本的依賴

要將iotivity-node的N-API版本新增為依賴項,package.json將如下所示:

"dependencies": {
  "iotivity-node": "n-api"
}

注意:如“使用dist-tags”中所述,與常規版本不同,標記版本無法通過版本範圍進行處理,例如package.json中的"^2.0.0",原因是標籤只涉及一個版本。因此,如果軟體包維護者選擇使用相同的標記標記軟體包的更高版本,則npm update將收到更高版本的版本。鑑於N-API目前的實驗性質,這應該是可接受的,要依賴於最新發布的N-API啟用版本,package.json依賴項必須引用如下所示的確切版本:

"dependencies": {
  "iotivity-node": "1.2.0-3"
}

上一篇:域模組剖析

下一篇:ABI穩定性

相關文章