Node.js的包管理工具是npm,而对于deno而言,任何一个资源服务器都能够是资源的提供方,一般来说,它是一个CDN网站。
除了比拟出名的用来转换node包的https://cdn.skypack.dev/和https://esm.sh/之外,官网的CDN地址是这里:https://deno.land/x。
如何公布模块
如何公布一个deno的模块?
操作其实很简略。
- 前提是你有一个github账号,新建一个对外开放的工程。
- 公布前,在你的工程里,最好先配置好标签与形容。标签用来在deno.land中搜寻,形容便于其余开发者理解你的用图。
- 回到https://deno.land/x页面。点击Publish a module,呈现以下弹窗:
- 点击下一步
- 填写一个惟一的模块名称,比方xx_test。如果没有反复的,就能够点击下一步。
- 填写要公布的工程中文件夹门路,个别状况下咱们都是根目录,不填即可。
- 下一步是提醒页面
- 按上一步的提醒一步步就能够实现了。这里我再具体点,到咱们的github工程,找到设置-Webhooks,点击减少webhook按钮。
- 填写Payload URL为提醒页面的地址;批改Content-type为application/json。
- 抉择Which events would you like to trigger this webhook?的最初一项。只勾选第一个。
- 点击Add webhook按钮
- 页面会主动回到这里,看到有了一条记录。
- 点击编辑,会有2个tab页,第一个就是你方才配置的页面,第二个是你当前所有hooks的状态。如果失败了,能够在这里看详细信息。
- 你的工程应用git打标签,如git tag -a v0.0.1 -m "feat: xxx",推送到github,就会触发hooks。
- 回到https://deno.land/x,在上面就能看到你新推送的模块了。
- 点击你的带版本号的工程,能够看到弹出的地址是https://deno.land/x/xx_test@v...。每有一个新tag的推送,就会有一个新的版本。
须要留神的一点是,deno对集体公布模块的数量限度为15个,超过须要向管理员发邮件(modules@deno.com)申请,所以没事儿不要发垃圾的包上去,撤销也是须要向管理员申请的,而且也不肯定会通过。
疾速公布
个别状况下,咱们须要在根目录下创立一个README.md,阐明你的模块性能与应用办法。
以我的工程oak_nest为例,通常有段应用示例:
import { Body, Context, UseGuards,} from "https://deno.land/x/oak_nest@v1.2.1/mod.ts";
示例里有你的模块地址,这个地址的版本号如果每次公布都要手动批改,那就太麻烦了。
全局装置一个命令:
deno install --allow-read --allow-write --allow-run --unstable -n deno_tag -f https://deno.land/x/jw_cli@v0.2.7/cli/tag/mod.ts
在根目录下创立一个scripts.yml文件,内容大抵如下:
version: 0.0.1name: xx_test
之后就能够应用deno_tag来更新版本,并推送到服务器。具体阐明具体见这里。
版本更新
版本号更新的命令应用patch/minor/major,与npm的一样。
deno_tagdeno_tag patch # 与下面等价deno_tag minordeno_tag major
会更新根目录下的scripts.yml文件和README.md,如果后者有应用scripts.yml中配置的name,将会对应替换。
比方工程的名称为oak_nest@v1.2.1,那么执行deno_tag后,README.md中oak_nest@v1.2.1会对应替换为oak_nest@v1.2.2。
如果执行deno_tag minor后,README.md中oak_nest@v1.2.1会对应替换为oak_nest@v1.3.0。
如果执行deno_tag major后,README.md中oak_nest@v1.2.1会对应替换为oak_nest@v2.0.0。
版本号不以v结尾
假如你推送的tag版本号不想以v结尾,那么能够增加一个参数-L或者--local:
deno_tag patch -L
增加自定义信息
打标签时默认提交信息是版本号,如果想自定义信息,能够应用-M或者--msg:
deno_tag minor -M "feat: change some"
更新所有目录的README.md文件
如果想要更新所有目录的README.md文件,能够应用-D或者--deep:
deno_tag -D
本地调试
如果你的另一个我的项目中应用这个模块,那可能会遇到调试问题,如果每次公布都推送一次,那太不合理了(尽管你能够这么干,github的hooks也是秒级的)。
你能够在本地启动一个服务器。
全局装置file_server
deno install --allow-net --allow-read https://deno.land/std@0.125.0/http/file_server.ts
在你的模块目录下,执行命令:
$ file_server .Downloading https://deno.land/std@0.125.0/http/file_server.ts...[...]HTTP server listening on http://0.0.0.0:4507/
- 这样关上http://0.0.0.0:4507/就能够看到当前目录的文件了。
你在另一个工程里应用这个地址就能够进行调试了。须要留神的一点是,你原来是这样运行代码的:
deno run -A aa.ts
当初须要换成:
deno run -A --reload=http://localhost:4507/ aa.ts
不然永远用的是旧的代码。
总结
本文介绍了如何利用github的hooks来公布一个deno模块到deno.land上,如何疾速更新版本,如何本地调试。