Github Codespace 中进行开发
Dobot+ 插件的开发也支持在 Github 的 Codespaces 中进行云端开发。
开发者可以创建一份 Dobot+ 插件模板的拷贝,并在自己的分支上进行云端开发,无需在计算机本地搭建开发环境。
- Dobot+ 插件模板仓库:https://github.com/toadyokai/dobot-plus-template.git
- Dobot+ 插件模板 NPM 包:https://www.npmjs.com/package/@dobot-plus/template
开发者可以针对模板仓库执行 fork 操作,到自己的代码仓库中,或者,可以手动下载 Dobot+ 插件模板,在本地创建仓库,并推送到 Github。
Codespaces 该服务会收取一定的费用。
个人开发者每月的免费额度为 15G 的存储空间和 120 小时的计算时长
环境初始化
在页面 Code 菜单下,用户可以创建当前仓库的 Codespaces 工作区间。
在工作区间创建完成后,浏览器界面上会展示 VScode 的编码界面
界面右下角在第一次进入时,会有弹窗提示 Dobot+ 模板项目推荐安装的 vscode 插件,这些插件对于开发效率的提升很有帮助,建议开发者进行安装。
在远端容器初始化时,会自动执行项目依赖的安装和@dobot-plus/cli
依赖的安装,在 codespace 打开后,开发者可以在其中命令行工具中进行查看确认。
node -v # 查看node版本
pnpm -v # 查看pnpm版本
dpt -v # 查看dpt开发工具版本
注意
如果自动化程序失效,开发者可以自行进行依赖初始化操作:
# 当前模板项目的 npm 依赖的安装
pnpm i
# 安装Dobot+ 开发调试工具
npm install @dobot-plus/cli --global
在完成上述操作后,云端基础的开发环境就搭建完成了。
开发者可以在命令行中执行以下指令,查看工具版本是否符合要求。
开发调试
codespace 初始化完成后,在命令行中执行
dpt dev
上述操作与本地执行
dpt dev
效果一致,开发者需要在浏览器地址栏中保证页面弹窗提示功能打开,以确保可以实现预览页面的自动打开和重定向。
注意
codespace 端的调试需要使用虚拟控制器进行连接,开发者需要自行申请虚拟控制器用于开发 调试,同时将虚拟控制器 ip 更新到项目的 dpt.json
配置文件中。
当上述指令顺利执行后,浏览器会自动打开插件预览界面,如下
开发者可以根据需求,调试对应插件界面的交互和样式。
当存在页面无法自动弹出的情况时,开发者也可以根据当前 Codespaces 的 url 地址,手动拼凑预览界面的地址,并在浏览器中打开,默认的预览端口号为 8080.
修改 .github.dev
前的部分,增加 -8080
,可在浏览器中手动打开界面预览链接。
插件打包
在 Codespaces 命令行中执行插件构建指令
dpt build
在构建操作执行完毕后,在界面左侧文件菜单中打开 output
文件夹,右键选择其中的 zip 文件,执行下载操作,稍等片刻后打包压缩后插件包会自动下载到浏览器的文件下载目录。
继续开发
使用 Codespaces 需要保持设备联网状态,在完成某次开发后,如果项目 Codespaces 不主动删除销毁,会一直保存,开发者可以点击对应的 Codespaces 再次进入,进行新的开发工作。
参考资料