怎么開發一個npm包


一、注冊npm賬號
* 怎么將代碼提到github,大家都知道需要一個github賬號
* 同樣,開發一個npm包,當然也需要一個npm賬號,將npm包發布到npm的托管服務器
* 注冊地址:[http://npmjs.org](http://npmjs.org)
* 該實例包含了模塊的局部調用和全局調用兩種方式

二、開發npm包

1.目錄構建
* npm init
* 項目結構:
```javascript
.
├── bin //命令配置
├── README.md //說明文檔
├── index.js //主入口
├── src //功能文件
├── package.json //包信息
└── test //測試用例
```
<!--more-->
2.開發模塊
* 入口index.js模塊
非全局安裝(npm install xxx),則多有的函數接口都通過index.js暴露給外部調用
```javascript
/**
* Hello World
* @function hello
**/
const hello = function(key){
console.log('Hello World!');
};

exports.hello = hello;
```
* init.js模塊
```javascript
const exec = require('child_process').exec;

exports.run = function(name) {
//初始化一個空文件夾
exec('mkdir ' + name,function() {
console.log('king init命令已執行...');
});
};

```

* start.js模塊
```javascript
const express = require('express');
const app = express();

exports.run = function(options) {
const port = options.port || 3000;
app.listen(port);
console.log('服務已啟動,正在監聽' + port + '端口...');
};

```

3.配置全局命令
bin目錄下寫配置代碼
* cli.js自定義命令,主要通過引入commander模塊去處理,包括命令描述、參數及執行動作
* king.js文件名稱應與全局命令king保持一致,做命令的入口,具體看demo

三、發布npm包
1.npm login
```bash
npm login
```
2.npm publish
```bash
npm publish
```
四、全局安裝和局部安裝
1.局部安裝
* 所有的函數功能接口都由index.js暴露給外部
* src里面可以放功能代碼,src --> index.js只做output,暴露給外部調用
2.全局安裝
* 包全局安裝的情況,一般是做自動化工具,關鍵在於配置全局命令,與index.js無關
* 通過bin目錄下與全局命令相同的js文件(如king.js)處理command的輸入【如:king start】

五、常見問題
1. npm publish出錯
```javascript
npm ERR! publish Failed PUT 403
npm ERR! Darwin 16.0.0
npm ERR! argv "/usr/local/Cellar/node/5.6.0/bin/node" "/usr/local/bin/npm" "publish"
npm ERR! node v5.6.0
npm ERR! npm v3.10.3
npm ERR! code E403

npm ERR! "You cannot publish over the previously published version 0.0.43." : npm-develop
npm ERR!
npm ERR! If you need help, you may report this error at:
npm ERR! <https://github.com/npm/npm/issues>

npm ERR! Please include the following file with any support request:
npm ERR! /Volumes/work/private/github/npm-develop/npm-debug.log
```
沒有更新package.json的版本號,每次的版本號必須大於上次,否則無法publish

2. 采用sudo npm publish
password應該輸入的是本機開機密碼,非npm賬號密碼

3. 全局命令無效
package.json中的bin命令配置,屬性值應該和腳本名稱一致
```javascript
"bin": {
"king": "./bin/king.js"
}
```
六、使用本例

* github: https://github.com/geneking/npm-develop
* download后修改項目名稱根據第'三'步可發布,全局安裝后可在本機測試,或局部安裝后可調用hello函數測試


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM