打造一个上传图片到图床利器的插件(Mac版 开源)
2019-11-28

打造一个上传图片到图床利器的插件

鉴于写博客截图手动上传到图床的步骤过于繁琐,很久之前写了一个windows版的截图软件插件,用于把图片快速上传到图床

重新打包用户量过亿的开源截图软件——加入图片自动上传到图床的功能

现在换系统了,由windows换成了Mac,系统确实好用,但截图上传到图床的功能没法子弄过来,网上搜了下现成的软件,都不太好用。Mac免费软件不像windows那么多。在windows系统上是在Greenshot的基础上实现的七牛图床插件,这个软件在Mac下也有,但是不开源。所以还是自己动手吧,实现一个mac版的上传到七牛图床的软件插件。好了,先上最终效果图:

选择一款mac版开源截图软件

选择的截图软件需要满足两个条件:

一个是易用性,界面友好另外一个是这个软件要支持插件

google了一下,搜了几个,最后觉的katana这个软件还不错。

虽然功能简单了点,但界面做的比较专业,而且支持service,上面的imgur是一个国外的免费的图床服务。好了,就在这上面整吧。

研究打包

这个软件是用Javascript写的,才知道用javascrpit还能做出Mac的app,开发工具选择使用WebStorm。研究源码的时候一般是边操作软件,边看代码,大概把整个软件轮廓和相关的细节了解了一下。

接下来比较棘手的其实是如何把源码打包成mac app,把github上打包好的软件下载下来研究了一番。看一下它的目录结构,看到了Framework这个文件夹,进到里面看一下:

drwxr-xr-x 6 zexu staff 192B 6 24 16:48 Electron Framework.frameworkdrwxr-xr-x 3 zexu staff 96B 6 24 16:48 Katana Helper EH.appdrwxr-xr-x 3 zexu staff 96B 6 24 16:48 Katana Helper NP.appdrwxr-xr-x 3 zexu staff 96B 6 24 16:48 Katana Helper.appdrwxr-xr-x 7 zexu staff 224B 6 24 16:48 Mantle.frameworkdrwxr-xr-x 7 zexu staff 224B 6 24 16:48 ReactiveCocoa.frameworkdrwxr-xr-x 7 zexu staff 224B 6 24 16:48 Squirrel.framework

看到了Electron这个东西,接着google,下面是官网的介绍:

使用 JavaScript, HTML 和 CSS 构建跨平台的桌面应用

看到package.json下面有下面几个依赖包:

"devDependencies": { "electron": "^2.0.3", "electron-packager": "^12.0.2", "standard": "^11.0.1" }

应该就是它了,用的是electron框架打包的app。

安装依赖

npm install

把所有依赖包安装到本地,然后cd到项目根目录执行下面的命令:

zexudeMacBook-Pro:katana zexu$ electron-packager . --overwrite --platform=darwin --arch=x64 --icon=./app/static/images/icon.icns --prune=true --out=release-builds注意,我把electron-packager 进行全局安装了。

就一条命令,打包就成了,竟然如此简洁。

研究源码和功能实现

先把qiniu的npm包装上:

npm install qiniu --save

为这个软件写插件需要写css,html和一写js的功能函数。一个软件的功能很多,但要快速聚焦到相关的功能点,有时候光看代码的效率实在是低。把代码跑起来,看一些log输出是不错的快速熟悉代码的方法。

如何才能debug呢。看下图,按照红色字体添加一个新的Debug Configurations:

网上说解释器的路径要写成下面这样:

~/github/katana/node_modules/.bin/electron

试了半天没有成功,发现这个文件是一个软链,指向的是上图中的解释器路径,所以直接写成图片上的路径。网上的帖子说设置好之后是可以加断点调试的。试了几次没有成功,这个软件应该是多进程的,应该和这个有关。log到是能看了,但有些Log不能打印到控制台上,还是多进程的问题,最后找到了解决方法,使用下面的变量来打印log:

const con = require("electron").remote.getGlobal("console")

软件的整个工作流程是下面这样的:

把AK,SK,Scope和Default Domain配置好,不熟悉这几个参数的参考windows版的软件配置。save之后这些参数应该是持久化到文件中了,具体没有研究。

截图的时候,先调用Mac的截图接口,生成截图文件保存到如下路径中:

~/.katana/uploads

最后调用qiniu的接口把文件上传到七牛图床。

具体代码细节就不介绍了,感兴趣自己去github看吧。qiniu的官方文档感觉比较乱。研究了一些时间,把这段代码贴一下:

const ak = _qiniuService.accessKeyconst sk = _qiniuService.secretKeyconst sc = _qiniuService.Scopeconst dm = _qiniuService.defaultDomainvar key = path.basename(file)var mdpath = "![](" + path.join(dm, key) + ")"const link = {link: mdpath}var mac = new qiniu.auth.digest.Mac(ak, sk)var options = { scope: sc + ":" + key, expires: 0}var putPolicy = new qiniu.rs.PutPolicy(options)var uploadToken = putPolicy.uploadToken(mac)var config = new qiniu.conf.Config()config.zone = qiniu.zone.Zone_z1var formUploader = new qiniu.form_up.FormUploader(config)var putExtra = new qiniu.form_up.PutExtra()formUploader.putFile(uploadToken, key, file, putExtra, function ( respErr, respBody, respInfo) { console.log("status:" + respInfo.statusCode) if (respErr) { callback(null, respErr) throw respErr } if (respInfo.statusCode === 200) { callback(link) console.log(respBody) } else { console.log(respInfo.statusCode) console.log(respBody) //callback(link) }})

Download

给一个打包好的链接,感兴趣的可以玩一下:

链接:https://pan.baidu.com/s/1JEej70eO5FCqF6CibOmdLQ 密码:qnq7

源码链接,在dev分支上开发的:

https://github.com/harlanc/katana