Electron パッケージングと配布
Electron アプリの開発が完了したら、アプリをデスクトップ実行可能ファイルにパッケージングし、ユーザーに公開する必要があります。
パッケージングと配布のプロセスには、ツールの選択、設定、署名、更新戦略など複数の段階が含まれます。
パッケージングツールの紹介
electron-builder
- 高度に自動化され、Windows、macOS、Linux をサポート
- 自動更新機能をサポート
- 設定が簡単で、本番環境に適している
- 生成可能
.exe、.dmg、.AppImageなどの形式
electron-packager
- 公式推奨のパッケージングツール、軽量
- 実行可能ファイルの生成のみを担当し、自動更新は含まない
- 設定は簡単だが、インストーラーと署名の処理には他のツールと組み合わせる必要がある
electron-forge
- パッケージング、テンプレート、自動更新、公開プロセスを統合
- すぐに使え、初心者がプロジェクトを迅速に開始するのに適している
- Webpack / ESBuild のビルドサポートを内蔵
ツールの比較と選択
| ツール | 特徴 | 利点 | 適用シーン |
|---|---|---|---|
| electron-builder | 自動化度が高く、クロスプラットフォーム、更新をサポート | 設定が簡単、本番環境に適している | 複雑なアプリケーションの公開 |
| electron-packager | 軽量、公式サポート | 他のツールと柔軟に組み合わせ可能 | シンプルなアプリのパッケージング |
| electron-forge | 開発ツールを統合、迅速な起動 | すぐに使える、ビルド内蔵 | 初心者または迅速なプロトタイプ |
パッケージングパラメータの設定
package.json の設定
"build": {
"appId": "com.example.myapp",
"productName": "MyElectronApp",
"directories": {
"output": "dist"
},
"files": ["**/*"],
"extraResources": ["assets/"],
"mac": {
"category": "public.app-category.utilities"
},
"win": {
"target": "nsis",
"icon": "build/icon.ico"
},
"linux": {
"target": ["AppImage", "deb"],
"icon": "build/icon.png"
}
}
プラットフォーム別設定
- Windows:インストーラーの種類(NSIS、Squirrel)、アイコン
.ico - macOS:アプリのカテゴリ、署名、
.icnsアイコン - Linux:ターゲット形式(AppImage、deb、rpm)、アイコン PNG
アイコンとリソースファイル
- アイコンのサイズと形式は、プラットフォームの要件を満たす必要があります
- 追加リソースは
extraResources或extraFiles追加できます
マルチプラットフォームパッケージング
Windows パッケージング
electron-builder --win
- 生成可能
.exe或.msiインストールファイル - NSIS インストールウィザード、サイレントインストールをサポート
macOS パッケージング
electron-builder --mac
- 生成可能
.dmg或.pkg - 公証(Notarization)と組み合わせることで、macOS Gatekeeper を通過できます
Linux パッケージング
electron-builder --linux
- 一般的な形式:AppImage、deb、rpm
- さまざまなディストリビューションのデスクトップ配布に適している
クロスコンパイル
- Electron-builder はクロスプラットフォームビルドをサポートしますが、macOS アプリは macOS 上で署名する必要があります
- Windows / Linux は、Linux または Windows のビルド用仮想マシンを使用してクロスパッケージングを実現できます
コード署名
Windows コード署名
- デジタル証明書(.pfx)を使用して署名
.exe或.msi - 例:
electron-builder --win --csc-link path/to/certificate.pfx --csc-key-password yourpassword
- ユーザーの信頼を高め、SmartScreen によるブロックを回避
macOS 公証(Notarization)
- Apple は、アプリが Gatekeeper を通過するために公証を公式に要求しています
- Apple Developer アカウントが必要
- ビルド例:
electron-builder --mac --publish never
- 使用
notarizeAPI を使用してアプリをアップロードし、自動公証を実行
証明書の申請と管理
- Windows:EV または標準のコード署名証明書を購入
- macOS:Apple Developer アカウントで開発者証明書を申請
- 証明書は安全に保管し、漏洩を防ぐ必要があります
自動更新
electron-updater の使用
- electron-builder と連携し、差分更新をサポート
- インストール
electron-updater:npm install electron-updater
メインプロセス例:
const { autoUpdater } = require('electron-updater')
autoUpdater.on('update-available', () => console.log('发现新版本'))
autoUpdater.on('update-downloaded', () => autoUpdater.quitAndInstall())
autoUpdater.checkForUpdates()
更新サーバーの構築
- GitHub Releases、プライベートサーバー、または CDN を使用できます
- 最新バージョン情報を記述する JSON ファイルを提供
差分更新
- 変更されたファイルのみをダウンロードし、帯域幅の消費を削減
- electron-updater は NSIS / Squirrel / AppImage の差分更新を内蔵サポート
更新戦略
- 自動更新チェック(起動時または定期的に)
- 手動による更新トリガー
- ポップアップでユーザーに即時更新するか遅延更新するかを通知
まとめ
Electron パッケージングと配布の中核フロー:
- ツールの選択:electron-builder、electron-packager、electron-forge
- パラメータの設定:package.json でプラットフォーム、アイコン、リソースを定義
- マルチプラットフォームパッケージング:Windows、macOS、Linux
- コード署名:アプリの信頼性を確保し、セキュリティ警告を回避
- 自動更新:ユーザーエクスペリエンスを向上させ、差分更新をサポート
ベストプラクティスに従うことで、Electron アプリを迅速かつ安全にユーザーへ配布でき、その後の反復開発と更新も容易になります。
その他の拡張