前言
相信很多web
前端开发的小伙伴和我一样,在想到要开发桌面端应用的时候会第一时间想到用Electron
来开发。它可以让我们使用熟悉的HTML
JS
CSS
来开发桌面应用。只需要一套代码,你的应用就可以轻松的运行在Windows
,macOS
,Linux
三大操作系统上。
但是过去开发Electron
应用的时候想要编译出三大系统的应用程序安装包就有点麻烦了,你需要分别在三个操作系统上执行编译命令才能编译出对应系统的安装包。
注:macOS旧版的系统可以利用
Wine
这个虚拟windows
环境直接编译出windows
系统的安装包,在M1芯片的Mac上暂时还不支持运行Wine
。
在不知道本文的方法之前,开发的过程是很开心的,但编译的过程
- 提前运行你的
Windows
系统虚拟机或使用Windows
系统电脑 - 使用虚拟机通过共享目录访问项目目录或重新
clone
项目 - 运行
npm install
安装项目开发环境必备的依赖包 - 运行编译命令
- 编译时会下载对应操作系统的依赖
- 复制你的编译结果去发布应用程序吧
让人痛苦...
当然,1-3只需要在对应的操作系统上设置好一次就行。不过,当你的操作系统升级导致不兼容时,麻烦就又来了。
而上面所说的一切,都会在Github Actions
的加持下,几乎
完美的解决。
Github Actions
Github Actions
是Github
推出的持续集成
/交付
服务。免费,最近我在很多项目中一直在持续白嫖
它。:)
比如以下两篇文章的用法
- 《利用GithubAction实现定时自动生成B站头图》
- 《利用GithubAction爬取Github中国区排名》
利用Github Actions
,我们可以建立一套工作流(workflow
),而一套工作流可以由数个Action
来组合。这里我做个比喻,把发布一个应用程序类比为做一道菜。
配菜
> 洗锅
> 开火
> 加盐
> 加酱油
> 翻炒
> 目测火候
> 出锅上菜
配菜就像是写代码,他决定了我们最后上菜的内容。你甚至可以只提供
配菜
,让客人自己去炒。很多Electron
的开源项目,提供了源码和使用说明,需要开发者自行编译出应用程序。
现在我们把配菜
后的步骤都编辑到一个工作流当中。当我们写完代码,提交项目后,就可以运行这套工作流来自动化的完成后续的工作。
可选的操作系统环境
我们可以给这套工作流指定其运行的操作系统,目前可以选择操作系统如下:
Virtual environment | YAML workflow label | Notes |
---|---|---|
Windows Server 2022 | windows-2022 | The windows-latest label currently uses the Windows Server 2019 runner image. |
Windows Server 2019 | windows-latest or windows-2019 | |
Windows Server 2016[deprecated] | windows-2016 | Migrate to Windows 2019 or Windows 2022. For more information, see the blog post. |
Ubuntu 20.04 | ubuntu-latest or ubuntu-20.04 | |
Ubuntu 18.04 | ubuntu-18.04 | |
macOS Big Sur 11 | macos-latest or macos-11 | The macos-latest label currently uses the macOS 11 runner image. |
macOS Catalina 10.15 | macos-10.15 |
实战演练
当我们需要使用Github Actions
的时候,我们需要在自己的git仓库中新建如下路径
.github/workflows/工作流名称.yml
下面,我们来解读(请看注释
)一个帮我们完成Electron项目编译的工作流来看看它是如何工作的
# 此工作流的名字
name: Build
# 工作流的执行时机,可以设定为定时执行,每次push后执行,手动执行等
on:
# workflow_dispatch为在Github仓库的Actions面板中手动执行
workflow_dispatch:
# 工作/任务,这里的工作是可以并行的。
jobs:
# 工作的名称“编译windows版”
buildwin:
# 运行的操作系统 windows server 2022
runs-on: windows-2022
# 步骤
steps:
# 使用预制action:拉取最新的代码
- uses: actions/checkout@v2
# 步骤一的名称:
- name: Install and Build
# 该步骤运行的终端命令,进入仓库的src目录,安装依赖,运行编译命令
run:
cd src && npm install && npm run buildwin
# 步骤二的名称:将编译后的结果上传
- name: Upload File
# 使用预制action:上传文件,可以将执行路径打包成zip上传
uses: actions/upload-artifact@v2
with:
# 上传后文件的名称
name: windows
# 打包的路径以及文件过滤,此为仅打包dist目录下的exe文件
path: dist/*exe
# 工作的名称“编译macOS版”
buildmac:
# 运行的操作系统 macOS BigSur
runs-on: macos-11
# 步骤
steps:
# 使用预制action:拉取最新的代码
- uses: actions/checkout@v2
# 步骤一的名称:
- name: Install and Build
# 该步骤运行的终端命令,进入仓库的src目录,安装依赖,运行编译命令
run:
cd src && npm install && npm run buildmac
# 步骤二的名称:将编译后的结果上传
- name: Upload File
# 使用预制action:上传文件,可以将执行路径打包成zip上传
uses: actions/upload-artifact@v2
with:
# 上传后文件的名称
name: mac
# 打包的路径以及文件过滤,此为仅打包dist目录下的dmg文件
path: dist/*dmg
关于使用
Github Actions
来执行定时任务工作流的玩法可以看这一篇
注释都仔细看了吗?OK,当github
仓库中具备.github/workflows/工作流名称.yml
的时候,打开Github
仓库的Actions
面板就可以看到可执行的工作流了。
点击Build
,再点击Run workflow
就可以运行这个工作流了
看看,我们多个Job
在同时进行!
另外这个列表可以查看工作流的执行时间,以及是否执行成功。点击列表项还可以查看详细的执行日志
比如我们来看看最后这个失败的Build
,到底在哪一步报错了呢?
这是由于我在开发过程中命令设置有误导致的错误,并不会出现时而正确时而错误的情况。
一目了然对不对!我们再来看看成功的日志
成功后,我们已经自动将编译后的结果上传,点击即可下载。
结语
Github Actions
真的太方便了,一键编译三个操作系统的安装包,这是我打包electron
应用程序从未有过的舒服和惬意。
情人节马上到了,我用Electron开发了一个名为心有灵犀的小软件,已开源。
它的基本功能是这样的,当双方都安装了这个软件,那么在各自的桌面上都会显示一颗红心。当你点击它的时候,双方的小红心都会跳动一下。代表你此刻正在想念对方。而对方在收到心跳的同时,也回应你一个点击,就会产生一次心有灵犀的瞬间。代表你们同时在想对方!
项目地址:https://github.com/ezshine/tinytoy-heartconnect