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 アプリを迅速かつ安全にユーザーへ配布でき、その後の反復開発と更新も容易になります。

その他の拡張