Electron 開発ツール
Electron 開発ツールとしては VS Code の使用をおすすめします。まだ VS Code に慣れていない場合は、私たちのチュートリアルを参照してください:VS Code チュートリアル。
VS Code ダウンロード先:https://code.visualstudio.com/。
VS Code 自体が Electron で構築されているため、Electron 開発に対して自然なサポート利点があります:
- 内蔵ターミナル統合
- 強力なデバッグ機能
- 豊富なプラグインエコシステム
- Git 統合
- IntelliSense スマート提案
- 完全無料かつオープンソース
VS Code 必須プラグインのおすすめ
| プラグイン名 | 機能説明 |
|---|---|
| Electron Snippets | Electron API のコードスニペットと自動補完を提供 |
| Prettier – Code Formatter | コードスタイルを統一し、自動フォーマット |
| ESLint | 構文エラーとスタイルの問題をチェック |
| Debugger for Chrome | VS Code 内でフロントエンドのレンダープロセスをデバッグ可能にする |
| Node.js Modules Intellisense | Node.js モジュール関数を自動提案 |
| Path Intellisense | ファイルパスのスマート提案 |
| npm Intellisense | npm パッケージ名を自動提案 |
| Auto Rename Tag / Auto Close Tag | HTML タグのスマート補完 |
| GitLens | Git コードバージョンの可視化体験を向上 |
Chrome DevTools デバッグ(レンダープロセス)
Electron のレンダープロセスは実際にはChromium ブラウザのページです,
そのため、ウェブページをデバッグするのと同じように、Chrome DevTools で直接デバッグできます。
DevTools を有効にする
にmain.jsウィンドウ作成時に追加:
例
const win = new BrowserWindow({
width: 800,
height: 600
});
win.loadFile('index.html');
// 開発者ツールを開く
win.webContents.openDevTools();
width: 800,
height: 600
});
win.loadFile('index.html');
// 開発者ツールを開く
win.webContents.openDevTools();
デバッグできる内容
- HTML / CSS / JS コード
- ネットワークリクエスト(Network)
- コンソールログ(Console)
- DOM 構造
- パフォーマンス分析(Performance)
- メモリリーク(Memory)
ヒント
レンダープロセスのデバッグは Chrome とほぼ同じです。そのため:
- 以下を使用できます:
console.log()デバッグ情報を出力 - Chrome のショートカットキー(
Cmd + Option + I/Ctrl + Shift + I)で DevTools を開くこともできます
Electron メインプロセスのデバッグテクニック
メインプロセスはウェブページではなく Node.js 環境のため、デバッグ方法はウェブページとは異なります。
方法1:VS Code 内蔵デバッガを使用
プロジェクトのルートディレクトリに.vscode/launch.jsonファイルを作成します。
内容は以下の通りです(そのまま使用可能):
{
"version": "0.2.0",
"configurations": [
{
"name": "Electron 主进程调试",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/node_modules/electron/dist/electron.js",
"args": ["."],
"outputCapture": "std",
"runtimeExecutable": null,
"cwd": "${workspaceFolder}"
}
]
}
その後、
main.jsにブレークポイントを設定し、デバッグ ▶️ をクリックするだけです。
方法2:コマンドラインによるリモートデバッグ
起動時にパラメータを追加:
electron . --inspect=5858
その後、Chrome のアドレスバーで以下を開きます:
chrome://inspect
メインプロセスにリモート接続でき、Node.js をデバッグするようにブレークポイントデバッグができます。
よくあるデバッグテクニックまとめ
| デバッグ対象 | ツール/方法 | 説明 |
|---|---|---|
| ウィンドウ画面のカクつき | Chrome DevTools → Performance | レンダリングの所要時間、JS 実行のボトルネックを分析 |
| ウィンドウの突然終了 | メインプロセスで try/catch を追加するか、electron-logログ記録を使用 |
メインプロセスの例外をキャッチ |
| IPC 通信の異常 | にipcMain / ipcRendererにログを追加 |
メインとレンダー間の通信をデバッグ |
| ファイルパスエラー | を使用path.join(__dirname, 'xxx') |
相対パスの問題を回避 |
| パッケージングデバッグ | を使用electron-builder --dirまずディレクトリモードでビルド |
直接実行してデバッグ可能 |
上級者向けツールのおすすめ
| ツール | 用途 |
|---|---|
| Electron Forge | 公式推奨のスキャフォールディングツール。プロジェクトの作成・パッケージングを迅速に行う |
| Electron Builder | 強力なパッケージング・リリースツール |
| Electron Reload | ファイル変更後にアプリを自動リフレッシュ |
| Spectron | Electron アプリの自動化テストに使用 |
| Devtron | Electron 公式デバッグ拡張機能。アプリの内部状態を分析 |
| React / Vue DevTools | フロントエンドフレームワークを使用する場合、コンポーネントの状態デバッグに非常に便利 |
その他の拡張機能VS Code で書き、DevTools で確認し、launch.json でデバッグし、Builder でパッケージングする——これがプロの Electron 開発者の完全なツールチェーンです。