やりたかったこと
最近個人的に Electron で小さなアプリを作る機会があったが、公開するにあたってビルド -> Release のフローを自動化したかった。当初 TravisCI を使っていたが、この機会に GitHub Actions を使ってみたのでその時のメモ。
ちなみに今回想定しているフローは、
- 新しい Tag を Push (e.g., v0.0.2)
- Tag Push をトリガーに GitHub Actions の build job がスタート
- 成功すると、Tag 名の Release (draft) を作成し、ビルドした成果物 (e.g.,
.exe.dmg) ファイルを作成した Release の Assets としてアップロード。 - Release を行う (手動で draft -> public release として更新する)
勝手に public release まで公開してほしくはなかったので、今回のゴールは draft 状態の Release までです。
イメージ
electron-builder
Electron アプリをビルドするには、
- electron-forge
- electron-builder
- electron-packager
といったツールがありますが、おそらく electron-builder が1番使われていると思います。今回は electron-builderを使います。
electron-builder 本体の GitHub インテグレーション
今回は GitHub Actions の中でビルドしたパッケージを Release に紐付ける、という事をやるのでこの機能は使いませんが、electron-builder 自体がもっている GitHub インテグレーションを使うことでも、同様に Release の作成 -> ビルドしたパッケージを紐付け、が可能です (-pオプション)。当初 TravisCI ではこの機能を使っていました。
.travis.ymlの設定例も公開されています。
https://www.electron.build/multi-platform-build#sample-travisyml-to-build-electron-app-for-macos-linux-and-windows
build options
実際にビルドする時には下記のようなコマンドを使います。
# macOS 用にビルド$ electron-builder --mac# Windows 用にビルド$ electron-builder --win--x64* 使っているネイティブモジュールがビルド対象となる OS 用の prebuilt バイナリを提供していない場合は、実際にその OS 上でしかビルドができない。(i.e., Windows 用のパッケージは Windows 上でしかビルドできない)
この時、色々なオプションが指定でき、通常は package.json内に buildオプションを記載していきます。
https://github.com/electron-userland/electron-builder#quick-setup-guide
package.json内に書かず、個別に YAML ファイルとして保存し、-cで指定することもできます。
GitHub Actions 設定
ワークフローの YAML は下記のようになりました。
name:CIon:push:tags:# "v" で始まる Tag 名の push だけをトリガーの対象にします (e.g., "v0.0.2")-'v*'jobs:# macOS 用の job 定義build_on_mac:runs-on:macos-lateststeps:-uses:actions/checkout@v2-name:Use Node.js 12.xuses:actions/setup-node@v1with:node-version:12.x-name:npm installrun:npm install# ここでアプリをビルド-name:build applicationrun:npm run build:mac# Release の作成とビルドしたパッケージのアップロード-name:create releaseuses:softprops/action-gh-release@v1if:startsWith(github.ref, 'refs/tags/')with:# 作成される Release は draft に留めておきたいdraft:true# アップロード対象となるファイル名files:|dist/*.dmgenv:GITHUB_TOKEN:${{ secrets.GITHUB_TOKEN }}# Windows 用の job 定義build_on_win:runs-on:windows-lateststeps:-uses:actions/checkout@v2-name:Use Node.js 12.xuses:actions/setup-node@v1with:node-version:12.x-name:npm installrun:npm install-name:build applicationrun:npm run build:win-name:create releaseuses:softprops/action-gh-release@v1if:startsWith(github.ref, 'refs/tags/')with:draft:truefiles:|dist/*.exeenv:GITHUB_TOKEN:${{ secrets.GITHUB_TOKEN }}今回はアプリに対して署名を行わず、あくまでもオレオレアプリとしての公開だったので内容はとてもシンプルです。使っているパッケージも少なく、いずれも prebuilt バイナリが提供されていたので、実際には Windows 環境は使わなくてもビルドできたのですが、試しに綺麗に分けてみました。
TravisCI から切り替えて良かった点
- 体感ではビルド時間が早くなった (個人的な感覚)。
- Token をいちいち発行して env に設定、みたいな手間がなくなった。
- なんかいい