デスクトップ向けのパッケージ化と配布

electron-builderは、Electronアプリを配布可能なインストーラーにパッケージ化する標準ツールです。設定はpackage.jsonの「build」キーの下に記述し、アプリのメタデータ（appId、productName）、アイコンのパス、プラットフォームごとのターゲット形式を指定します。

electron-builderは、macOS（dmgとzip）、Windows（nsisインストーラー）、Linux（AppImageとdeb）をサポートしています。1つのビルドコマンドで複数のプラットフォームを対象にすることも、互換性を最も高めるために、各プラットフォームのネイティブランナーでビルドするようCIを設定することもできます。

macOSでは、Gatekeeperがセキュリティ警告なしでアプリを開けるようにするため、Apple Developer証明書によるコード署名が必要です。electron-builderはビルド中にmacOS Keychainから証明書を読み込み、すべてのバイナリに自動的に署名します。

最新のmacOSでは、コード署名に加えて公証も必要です。これはアプリをAppleの公証サービスに提出し、マルウェアのスキャンを受けてチケットを発行してもらう仕組みです。electron-builderはelectron-notarizeを通じて公証を自動化でき、macOS 10.15以降のユーザーは、公証なしではアプリの実行をブロックされます。

WindowsでSmartScreenにインストーラーを信頼させるには、信頼された認証局（CA）が発行したAuthenticode証明書が必要です。署名がない場合、ユーザーには「Windows protected your PC」という警告が表示されます。Extended Validation（EV）証明書なら警告がすぐに表示されなくなり、標準のOV証明書は時間をかけて信頼を築きます。

ビルドが成功すると、electron-builderはプラットフォーム固有のインストーラーをdist/ディレクトリに書き出します。macOS用のDMGまたはzip、Windows用のNSIS .exe、Linux用のAppImageまたは.debに加えて、自動更新マニフェストのlatest.yml（またはlatest-mac.yml）も生成されます。

Electronアプリでは、プラットフォーム固有の形式のアイコンが必要です。Linuxでは512x512のPNG、macOSではICNSファイル（複数解像度）、WindowsではICOファイル（複数解像度）を使用します。electron-builderでは、--iconフラグを使って1つの1024x1024 PNGからすべての形式を生成できます。

electron-updaterパッケージはelectron-builderと連携し、自動更新を提供します。ビルドをGitHub ReleasesまたはS3に公開すると、electron-updaterが起動時に更新を確認し、バックグラウンドで差分アップデートをダウンロードして、ユーザーに再起動を促せるようになります。

アプリの準備が完了した後、main.jsでautoUpdater.checkForUpdatesAndNotify()を呼び出してください。electron-updaterは公開先から最新のlatest.ymlマニフェストを取得してバージョンを比較し、更新が利用可能であればダウンロードします。インストールの準備が整うと、ネイティブ通知を表示します。

electron-builderは、配布のためにアプリケーションのJavaScriptファイルを1つのASARアーカイブ（tarファイルに似たもの）にまとめます。これによりファイルシステムの検索回数が減り、起動パフォーマンスが向上します。また、ソースコードを直接調べることが難しくなります（不可能になるわけではありません）。

ネイティブNode.jsモジュール（.nodeファイル）はASARアーカイブ内から読み込めないため、ファイルシステムに展開する必要があります。electron-builderでasarUnpackを設定してネイティブモジュールのパターンを指定すると、アーカイブと同じ場所にあるapp.asar.unpackedディレクトリへ配置されます。

macOSで配布する場合、コード署名だけでなく公証も必要なのはなぜでしょうか。

Electronアプリの配布では、electron-builderのターゲットを設定し、macOS（公証を含む）とWindows（Authenticode）の両方でコードに署名し、必要に応じてelectron-updaterによる自動更新を設定します。ASARアーカイブはアプリを配布用にまとめ、ネイティブモジュールは別途展開します。堅牢なCI/CDパイプラインを構築すれば、これらの手順をプラットフォームごとに自動処理できます。