- 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/ の再帰配置に対応
250 lines
11 KiB
C#
250 lines
11 KiB
C#
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;
|
||
}
|
||
}
|
||
}
|
||
}
|