Files
GameLauncher/Engines/Tkool/TkoolPackagedExtractionService.cs
T
armonica 8cea2a147d refactor: reorganize engine-based structure and add agent rules
- Engines/ 配下へエンジン別に再編 (Common/Rgss/Tkool/Tyrano/Wolf/Unity/Nwjs)
- ゲーム個別処理を Engines/<Engine>/Games/<GameName>/ へ分離し、共通処理から明示呼び出し
- 外部ツールを Engines/<Engine>/Tools/ へ移動し、AppPathHelper 経由で解決
- 旧 Tools/ 直下参照と不要な参照ファイル/バックアップを削除
- エージェント規則 AGENTS.md を追加し、README から参照
- publish.ps1 を Engines/<Engine>/Tools/ の再帰配置に対応
2026-10-07 02:30:49 +09:00

250 lines
11 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using System;
using System.IO;
using System.Linq;
using System.Threading.Tasks;
using GameLauncher.Engines.Nwjs;
namespace GameLauncher.Engines.Tkool
{
/// <summary>
/// nw.js boxed(exe埋め込み package.nw)等の単体exe梱包ツクールゲームの解析と
/// ゲームフォルダ内 `_extracted` への冪等展開を行うオーケストレーター。
///
/// 役割分担(恒久・再利用可能を目的とした汎用設計):
/// - 本サービス = 抽出の「進行役(オーケストレーター)」。
/// - <see cref="NwjsPackageUnpacker"/> = 組み込みの埋め込みZIPコンテナ検出・展開。
/// - <see cref="NwjsUnpackerToolProvider"/> = 外部アンパッカーの取得・呼び出し。
///
/// 展開戦略(順に試行):
/// 1. 組み込みZIP展開: exe内の標準ZIPコンテナ(package.nw)を検出して展開。
/// 2. 外部ツール委譲: Tools\ 配下の外部アンパッカー(未配置なら自動取得)へ委譲。
///
/// 設計方針:
/// - 1.14GB級exeを対象に含むため、組み込み検出は限定/逐次走査で行う。
/// - 展開はゲームフォルダ内 `_extracted` のみ。他ゲームへは一切影響しない。
/// - 冪等: 展開済み(plugins.js 存在)なら再展開しない。
/// - 既存公開API(GetExtractedDir / ContainsPackageNwMarker / IsExtractionComplete /
/// ExeBackupSuffix / ExtractPackageNw)のシグネチャは維持し、後方互換を壊さない。
/// </summary>
public sealed class TkoolPackagedExtractionService
{
/// <summary>ゲームフォルダ内の展開先フォルダ名(Asar/SRPG の慣習に合わせる)</summary>
public const string ExtractedDirName = NwjsPackageUnpacker.ExtractedDirName;
/// <summary>exe内コンテナ改変時のバックアップ拡張子</summary>
public const string ExeBackupSuffix = ".glbak";
/// <summary>展開戦略の種別。将来の新形式追加を見据え、列挙型で差し替え可能にする。</summary>
public enum UnpackStrategy
{
/// <summary>組み込みの埋め込みZIPコンテナ検出・展開</summary>
BuiltInZip = 0,
/// <summary>外部アンパッカーへの委譲</summary>
ExternalTool = 1,
}
/// <summary>ゲームフォルダ内の展開先ディレクトリ(物理パス)</summary>
public static string GetExtractedDir(string gameRootDir)
=> NwjsPackageUnpacker.GetExtractedDir(gameRootDir);
/// <summary>
/// exeに package.nw マーカーが含まれるかを限定部分読み(4MB窓×数点)で判定します。
/// 全走査は行いません(1.14GB級exe対策)。
/// </summary>
public static bool ContainsPackageNwMarker(string exePath)
{
try
{
const int windowSize = 4 * 1024 * 1024;
using var fs = new FileStream(exePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
long size = fs.Length;
if (size < 1024)
{
return false;
}
double[] fractions = { 0.25, 0.5, 0.75, 0.9 };
foreach (var frac in fractions)
{
long start = (long)(size * frac);
int readLen = (int)Math.Min(windowSize, size - start);
if (readLen <= 0)
{
continue;
}
var buf = new byte[readLen];
fs.Seek(start, SeekOrigin.Begin);
int read = fs.Read(buf, 0, buf.Length);
var text = System.Text.Encoding.ASCII.GetString(buf, 0, read);
if (text.IndexOf("package.nw", StringComparison.Ordinal) >= 0 ||
text.IndexOf("package.json", StringComparison.Ordinal) >= 0)
{
return true;
}
}
}
catch { }
return false;
}
/// <summary>
/// exe内ZIPのローカルヘッダ(PK\x03\x04)offsetを限定ウィンドウで検出します。
/// exe先頭の自己展開部を除いた中盤以降のみを対象にし、全走査を避けます。
/// </summary>
public static long? FindEmbeddedZipOffset(string exePath, long searchStart = 0, int windowBytes = 8 * 1024 * 1024)
{
try
{
using var fs = new FileStream(exePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
long size = fs.Length;
// searchStart が 0 の場合は中盤〜後半(package.nw は後半に置かれる傾向)のみを走査
double[] fractions = searchStart > 0 ? new[] { (double)searchStart / Math.Max(1, size) } : new[] { 0.5, 0.65, 0.8, 0.9 };
foreach (var frac in fractions)
{
long start = (long)(size * frac);
int readLen = (int)Math.Min(windowBytes, size - start);
if (readLen <= 4)
{
continue;
}
var buf = new byte[readLen];
fs.Seek(start, SeekOrigin.Begin);
int read = fs.Read(buf, 0, buf.Length);
for (int i = 0; i < read - 3; i++)
{
if (buf[i] == 0x50 && buf[i + 1] == 0x4B && buf[i + 2] == 0x03 && buf[i + 3] == 0x04)
{
return start + i;
}
}
}
}
catch { }
return null;
}
/// <summary>
/// 既存 `_extracted` が完全か(plugins.js が存在するか)を判定します。
/// </summary>
public static bool IsExtractionComplete(string extractedDir, out string? pluginsJsPath)
=> NwjsPackageUnpacker.IsExtractionComplete(extractedDir, out pluginsJsPath, out _);
/// <summary>
/// exe内ZIP(package.nw 等)をゲームフォルダ内 `_extracted` へ冪等に全展開し、
/// 展開後の js/plugins.js(相対パス)を返します。展開できなければ null。
///
/// 展開戦略を順に試行します: 組み込みZIP展開 → 外部ツール委譲。
/// 後方互換のため同期シグネチャを維持します(外部ツールの自動取得は内部で同期待機)。
/// </summary>
public string? ExtractPackageNw(string exePath, string gameRoot, out string extractedDir, IProgress<string>? progress = null)
{
extractedDir = GetExtractedDir(gameRoot);
try
{
if (!File.Exists(exePath))
{
return null;
}
// 冪等: 展開済みならスキップ
if (Directory.Exists(extractedDir) && IsExtractionComplete(extractedDir, out _))
{
progress?.Report("既に展開済みです(_extracted を再利用)。");
return NwjsPackageUnpacker.IsExtractionComplete(extractedDir, out _, out var rel) ? rel : "js/plugins.js";
}
// 戦略1: 組み込みZIP展開
progress?.Report("展開戦略: 組み込みZIP展開を試行します。");
var relBuiltin = NwjsPackageUnpacker.ExtractEmbeddedZip(exePath, extractedDir, progress);
if (relBuiltin != null)
{
return relBuiltin;
}
// 戦略2: 外部ツール委譲
progress?.Report("展開戦略: 外部アンパッカーへの委譲を試行します。");
var relExternal = ExtractViaExternalTool(exePath, extractedDir, progress);
if (relExternal != null)
{
return relExternal;
}
progress?.Report("展開できませんでした(起動のみ対応)。");
return null;
}
catch (Exception ex)
{
progress?.Report($"展開処理中にエラーが発生しました: {ex.Message}");
return null;
}
}
/// <summary>
/// 外部アンパッカー(未配置なら自動取得)で exe 内コンテナを `_extracted` へ展開します。
/// 失敗(ネット未接続等)時は例外を投げず null を返し、呼び出し側で「起動のみ」へフォールバックさせます。
/// </summary>
private static string? ExtractViaExternalTool(string exePath, string extractedDir, IProgress<string>? progress)
{
try
{
// 外部ツールの可用性確保(初回は自動ダウンロード)。同期待機で取得。
var available = NwjsUnpackerToolProvider.IsToolAvailable()
|| Task.Run(() => NwjsUnpackerToolProvider.EnsureToolAvailableAsync(progress)).GetAwaiter().GetResult();
if (!available)
{
progress?.Report("外部アンパッカーを取得できませんでした(ネット未接続等)。起動のみ対応へフォールバックします。");
return null;
}
var tool = NwjsUnpackerToolProvider.GetToolPath();
if (tool == null)
{
return null;
}
// 展開先を一旦クリーンにする(部分展開の混在を避ける)
try
{
if (Directory.Exists(extractedDir))
{
Directory.Delete(extractedDir, recursive: true);
}
}
catch { }
if (!NwjsUnpackerToolProvider.ExtractWithExternalTool(tool, exePath, extractedDir, progress))
{
return null;
}
// 展開結果から plugins.js を解決
var plugins = NwjsPackageUnpacker.ResolvePluginsJs(extractedDir);
if (plugins == null)
{
progress?.Report("展開は完了しましたが、js/plugins.js が見つかりませんでした。");
return null;
}
var rel = Path.GetRelativePath(extractedDir, plugins).Replace(Path.DirectorySeparatorChar, '/');
progress?.Report($"外部アンパッカーでの展開が完了しました: {rel}");
return rel;
}
catch (Exception ex)
{
progress?.Report($"外部アンパッカー委譲でエラーが発生しました: {ex.Message}");
return null;
}
}
}
}