怎麼使用Nodejs 發布npm套件並製作成命令列工具
- php中世界最好的语言原創
- 2018-05-29 17:25:131275瀏覽
這次帶給大家怎麼使用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中文网其它相关文章！
推荐阅读：
vue项目中type=”file“ change事件只执行一次怎样处理
以上是怎麼使用Nodejs 發布npm套件並製作成命令列工具的詳細內容。更多資訊請關注PHP中文網其他相關文章！