🎯 目標
標準的なReact/Viteのプロダクションビルドを、単一のスタンドアロンで高度にカスタマイズされたネイティブWindows .exe インストーラーに変換します。このラッパーは標準のOSウィンドウフレームをバイパスし、決定論的でシネマティックな5ステップのインストーラーウィザードインターフェースを提供します。
🛠️ コアエンジニアリングモジュール
1. ライフサイクルインターセプションとウィンドウスタイリング(electron.js)
以下の厳格なネイティブプロパティを持つ、ハードコードされた固定レイアウトのウィンドウフットプリント($760 \times 480\text{px}$)を初期化します。
frame: false(すべてのネイティブOSウィンドウ境界/ボーダーを無効化)resizable: false(寸法を固定)transparent: true(カスタムWebスタイリングのための透過バッキングを有効化)
preload.js を介して、分離された安全な非同期IPC(プロセス間通信)アーキテクチャを公開します。これにより、サンドボックスアクセスの安全クラッシュをトリガーすることなく、バックグラウンドランタイムとReactレンダラーレイヤー間でデータをクリーンに受け渡します。
2. システムアセットデプロイメント(Node.jsバックグラウンドレイヤー)
- ディレクトリマッピング:
fs-extraを使用して、ワークスペースの文字列パスを動的に解析し、安全にターゲットフォルダーを構築します。 - ショートカットリンク挿入: ユーザーのデスクトップ環境に直接ネイティブの
.lnkショートカットを構築するために、Windows PowerShellコマンドを実行するバックグラウンド子プロセスをトリガーします。 - OSアプリ一覧レジストリへの登録: ローカルマシンのレジストリインデックスパスに、必要なソフトウェアアプリケーションのテレメトリを直接挿入します。
HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\[AppName]DisplayName、DisplayIcon、インストールディレクトリターゲット、および運用上のアンインストール文字列フックを適切に設定し、アプリケーションをWindowsのアプリと機能ユーティリティにクリーンにバインドします。
🎨 フロントエンドアーキテクチャとステートマシン(React)
インストーラーインターフェースは、Tailwind CSSを使用して、深みのあるミニマルなスレートブルーのプリミティブ(#0a0f1d、#111827)でスタイル設定された、決定論的な5ステップのReactステートマシンとして実行されます。
- ウェルカムオンボーディングフェーズ: ソフトウェアのバージョンと設定フラグを表示する最小限のタイポグラフィヘッダー。
- カスタムテーマディレクトリエクスプローラー: 標準の不適合なWindowsネイティブファイルエクスプローラーをバイパスし、WebアプリケーションのDOMコンテキスト内で直接実行されるカスタムフォルダ選択ダイアログモーダル。
- ワークスペーストグル: デスクトップショートカットファイルの作成とデプロイを制御する、ステートフルなチェックボックスコンポーネント(デフォルトでON)。
- シネマティックプログレススプラッシュフェーズ: 全画面、ボーダーレスレイアウトで、ファイルシステムのコピー実行と同期された正確に3.5秒の線形プログレスアニメーションに合わせた、スムーズなCSSマイクロインタラクションとアニメーションをレンダリング。
- 完了選択肢: 標準の終了トリガー、または「アプリケーションを起動」による即時システム実行を提供する二重分岐の終了画面。
🖼️ アプリケーションロゴ解決プロトコル
インストーラーには、高忠実度のグラフィックプリミティブ(icon.ico と透明な logo.png)が必要です。不足しているビジュアルコンポーネントは、以下のフォールバックシーケンスを使用して解決します。
- プロトコルA: ユーザー提供のブランディング(高階層): ウィザード設定画面を介してカスタムアセットが提供された場合、ファイルオブジェクトをキャプチャし、寸法を検証し、UIレイヤーにストリーミングし、
.icoバリアントを最終的な実行可能ファイルヘッダーメタデータに直接コンパイルします。 - プロトコルB: AI駆動のコンテキストフォールバック(ゼロ知識階層): ブランディングが提供されない場合、アプリケーションメタデータ(名前、説明、業種)を解析します。ベクターまたはリポジトリルックアップを実行して、クリーンで幾何学的、ミニマルなオープンソースアイコンを抽出します。 ガードレール: 混沌とした、装飾的な、または文字通りのクリップアートデザインを絶対に禁止します。抽象的な、高品質なベクター構造のみが有効です。
⚠️ 制約とガードレール
- 相対アセットアドレッシング: ビルド設定内のすべての出力アセットが相対パス(
./static/...)を使用するようにします。絶対的なWeb解決参照は、パッケージ化されたファイルシステム内で壊れ、ランタイムに白い画面エラーを引き起こします。 - セキュリティ分離:
nodeIntegration: falseとcontextIsolation: trueを常に有効に保ちます。すべてのバックグラウンドプラットフォーム操作は、contextBridgeレイヤーを介して安全に遷移する必要があります。
📝 例
例: package.json へのマニフェストターゲットの挿入
"build": {
"appId": "com.whyskai.custominstaller",
"productName": "WhyskAI-CustomInstaller-Maker",
"win": {
"target": ["nsis"],
"icon": "assets/icon.ico"
},
"nsis": {
"oneClick": false,
"allowToChangeInstallationDirectory": true,
"installerIcon": "assets/icon.ico",
"uninstallerIcon": "assets/icon.ico",
"createDesktopShortcut": true,
"runAfterFinish": true
}
}