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

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

php中世界最好的语言
發布: 2018-05-21 13:56:41
原創
2104 人瀏覽過

這次帶給大家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中文网其它相关文章!

推荐阅读:

php生成随机数字、字母或数字字母混合的字符串

php裁剪图片为固定大小步骤详解

以上是Nodejs發布自己的npm套件並製作成命令列工具步驟詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板