打造一个上传图片到图床利器的插件（Mac版 开源）

写markdown博客如何将截图快速上传到图床——记一个工具插件的实现(windows版 开源)（2017-05-31 20:23）

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

鉴于写博客截图手动上传到图床的步骤过于繁琐，好久以前写了一个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.framework
drwxr-xr-x  3 zexu  staff    96B  6 24 16:48 Katana Helper EH.app
drwxr-xr-x  3 zexu  staff    96B  6 24 16:48 Katana Helper NP.app
drwxr-xr-x  3 zexu  staff    96B  6 24 16:48 Katana Helper.app
drwxr-xr-x  7 zexu  staff   224B  6 24 16:48 Mantle.framework
drwxr-xr-x  7 zexu  staff   224B  6 24 16:48 ReactiveCocoa.framework
drwxr-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

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

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

软件的整个工做流程是下面这样的：

• 把AK,SK,Scope和Default Domain配置好，不熟悉这几个参数的参考windows版的软件配置。

• save以后这些参数被持久化到文件中。

• 截图的时候，先调用Mac的截图接口，生成截图文件保存到以下路径中：

  ~/.katana/uploads

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

• markdown格式的图片连接会拷贝到剪贴板中，commond+v将其复制到编辑器中。

具体代码细节就不介绍了，感兴趣本身去github看吧。qiniu的官方文档感受比较乱。研究了一些时间，把这段代码贴一下：

const ak = _qiniuService.accessKey
const sk = _qiniuService.secretKey
const sc = _qiniuService.Scope
const dm = _qiniuService.defaultDomain

var 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_z1
var 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)
  }
})

• 注意：上面的代码中， zone是写死的，因此这个插件目前只支持华北的服务器。若支持其它地区的服务器，修改下面的语句：
  config.zone = qiniu.zone.Zone_z1

各个地区以及对应的zone变量值以下：

• 华东 qiniu.zone.Zone_z0
• 华北 qiniu.zone.Zone_z1
• 华南 qiniu.zone.Zone_z2
• 北美 qiniu.zone.Zone_na0

Download

给一个打包好的连接，感兴趣的能够玩一下：

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

源码连接,在dev分支上开发的：

https://github.com/harlanc/katana