首頁 > 文章 > web前端 > Nodejs發布自己的npm套件並製作成命令列工具步驟詳解

Nodejs發布自己的npm套件並製作成命令列工具步驟詳解

php中世界最好的语言原創: 2018-05-21 13:56:412003瀏覽

這次帶給大家Nodejs發布自己的npm套件並製作成命令列工具步驟詳解，Nodejs發布自己的npm套件並製作成命令列工具的注意事項有哪些，以下就是實戰案例，一起來看一下。

<span style="font-family:Arial, Helvetica, sans-serif;background-color:rgb(255,255,255);">近日当我在使用npm上已经存在的一个包时，发现它有bug；于是决定自己实现这个功能，自己写一个npm包。</span>

下面我記錄自己的實作過程。

1. npm init

#選擇一個資料夾，然後用命令列cd進去，然後執行npm init ，這時會產生一長串表單，根據自己的實際情況填寫內容

name：填寫你這個包的名字，預設是你這個資料夾的名字。不過這裡要著重說一下，最好先去npm找找有沒有同名的包包。最好的測試方式就是，在命令列裡面輸入npm install 你要取的名字，如果報錯，那麼很好，npm上沒有跟你同名的包，你可以放心大膽地把包發佈出去。如果成功下載下來了。。。那麼很不幸，改名字吧。。。

version：你這個套件的版本，預設是1.0.0

#description：其實我也不知道是什麼，按回車就好了。。。，這個用一句話描述你的套件是幹嘛用的

entry point：入口檔案，預設是Index.js，你也可以自己填入你自己的檔名

test command：測試指令，這個直接回車就好了，因為目前還不需要這個。

git repository：這個是git倉庫地址，如果你的包是先放到github上或其他git倉庫裡，這時候你的資料夾裡面會存在一個隱藏的. git目錄，npm會讀到這個目錄作為這一項的預設值。如果沒有的話，直接回車繼續。

keyword：這個是一個重點，這個關係到有多少人會搜到你的npm套件。盡量使用貼切的關鍵字作為這個包的索引。我這個包嘛，第一個是在express下工作的，然後又是一個插件plugin，然後又是一個註冊路由route用的，而這個路由又是基於文件目錄dir，所以很好就得出我的包的索引關鍵字。

author：寫你的帳號或你的github帳號吧

license：這個直接回車，開源檔案來著。。。

然後它就會問你Are you ok?

回車Ok！

然後我們回到我們的文件目錄裡面去看一看，發現多出來一個package.json文件

然後，在目錄下新建一個index.js文件，或者你剛剛修改了那個entry point的值，那麼你這個檔名也跟著改為那個值。

我的npm工程目錄結構就是這樣的，注意其中的bin資料夾是我為了製作命令列工具才產生的，後面會講到怎麼產生命令列工具；當然，如果那不想產生命令列工具，這個資料夾就不需要了。

因為我把封裝好的程式碼都丟在lib裡面，所以，index.js裡面也就一句話：

module.exports=require('./lib')

然後，最重要的，寫好README.md，一個要為大家描述你的套件的markdown文件，如果大家都不知道你的程式碼是做什麼的，會有人去下載你的程式碼嗎？哦，對了，最好寫英文。

2. npm publish

#寫完自己的npm包，測試運行沒問題後就可以發佈到npm上

首先得註冊個npm帳號

用npm指令登陸一下

然後，在你的目錄下使用npm publish

注意：一般情況下，一旦你要修改你已經發布後的程式碼，然後又要執行發布操作，務必到package.json裡面，把version改一下，例如從1.0.0改為1.0.1，然後在執行npm publish，這樣就可以成功發布了。

3. 產生命令列工具

在使用 Nodejs 过程中，有很多包都支持全局安装，提供一个命令，然后在命令行我们就可以完成一些任务。有时候我们也需要开发这样的命令工具。在Node.js 中发现弄个命令行工具特别轻松。我使用的是commander包来生成命令行工具

$ npm install commander

然后cd到bin目录下，新建一个.js文件（名字自取）,编写代码，在js文件顶部加上#!/usr/bin/env node

例如我的geAsar.js:

#!/usr/bin/env node
var asar = require('../lib/geAsar')
var program = require('commander');
program.version('v' + require('../package.json').version)
  .description('Manipulate asar archive files')
program.command('pack <dir> <output>')
  .alias('p')
  .description('create asar archive')
  .action(function (dirpath, output) {
   asar.geAsar(dirpath,output);
   console.log(output+"文件成功生成");
  })
program.parse(process.argv)
if (program.args.length === 0) {
 program.help()
}

然后还需在package.json中添加

"bin": { 
 "geAsar": "./bin/geAsar.js" 
 },

运行 node bin/geAsar.js 会显示当前文件夹下的所以文件和文件夹名。这个玩意儿真的跑起来了.

全局运行命令调试

install

如果在项目目录下运行没有问题，可以将当前目录模块安装到全局，也可以采用此方法来更新你的命令行工具

sudo npm install . -g

link

或者目录输入 npm link 会自动添加全局的 symbolic link ，然后就可以使用自己的命令了。 (我用的是这个)

相信看了本文案例你已经掌握了方法，更多精彩请关注php中文网其它相关文章！

Nodejs發布自己的npm套件並製作成命令列工具步驟詳解

相關文章