Linear migration metadata¶

• Linear issue: TAK-267
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-267/generator-guiをhtmljs内包の単体exeとして配布できるようにする
• Linear status: Backlog
• Linear team: Takayuki Komoda
• Linear project: EPAA Core
• Linear assignee:
• Linear labels:
• Linear created: 2026-09-19T12:37:08.570Z
• Linear updated: 2026-09-19T12:37:08.570Z
• Linear archived:

Original description¶

背景¶

現在のEPAA Generator GUIは、EPAA.Generator.Gui.exeが同梱フォルダのfrontend/dist/index.htmlおよび静的アセットをWebView2で読み込む構成になっている。exe単体を移動・配布しても画面が動作するよう、フロントエンド資産の内包を検討する。

目的¶

Generator GUIを、利用者がexe単体として扱える配布形態にする。

対応案¶

• HTML/JS/CSS等のfrontend/dist資産を.NETリソース等としてexeへ埋め込む。
• 起動時に一時フォルダへ展開してWebView2から読み込む方式を第一候補とする。
• 必要に応じてWebView2のリソース要求をフックし、メモリから直接配信する方式も比較する。

受入条件¶

• exe単体を別フォルダへコピーして起動できる。
• 相対パスのJS/CSS/画像等が正常に読み込まれる。
• 既存の帳票設定・アプリ生成・ログ出力等の主要導線が回帰しない。
• 起動時の展開先、更新時の旧資産削除、失敗時のエラー表示とログが整理されている。
• 発行・実行手順をドキュメント化する。

注意事項¶

• .NET single-file publishだけではfrontend/distは自動的に内包されない。
• WebView2ランタイム自体の前提は別途残る可能性がある。
• exeサイズ、起動時間、一時ファイルの権限・クリーンアップ、キャッシュ対策を確認する。

対象外¶

• WebView2ランタイムそのものの同梱・完全ポータブル化。
• 現行のフォルダ配布方式の即時廃止。