@next2d/builder 0.1.7 → 0.1.10

package/templates/xbox/src/v8/V8Runtime.cpp

@@ -1,7 +1,9 @@
 #include "V8Runtime.h"
 
 #include "V8Util.h"
+#include "CodeCache.h"
 #include "HostContext.h"
+#include "EmbeddedAssets.h"
 #include "bindings/Bindings.h"
 
 #include <filesystem>
@@ -43,16 +45,33 @@ V8Runtime::~V8Runtime()
 void V8Runtime::InitializeProcess(const char* exec_path)
 {
     // Xbox(GDK) / Nintendo Switch のリテール環境は動的コード生成(JIT)を禁止する。
-    // V8 を jitless (Ignition インタプリタのみ・TurboFan/Sparkplug/RWXページ無し) で動かす。
-    // prebuilt V8 (build-v8.yml) は v8_jitless=true + turbofan/wasm 無効でビルドされる。
-    // wasm/opt 系フラグはそのビルドに存在しないため渡さない (未知フラグ警告を避ける)。
-    v8::V8::SetFlagsFromString("--jitless");
+    // - JS: --jitless (Ignition インタプリタのみ・RWX ページ無し)
+    // - WebAssembly: --wasm-jitless (DrumBrake = V8 の wasm インタープリタ。
+    //   prebuilt V8 r2 は v8_enable_drumbrake=true でビルドされている)
+    // - --no-flush-bytecode: V8 は既定でしばらく実行されない関数のバイトコードを
+    //   破棄し、次回実行時に再パースする (メモリ最適化)。ゲームでは画面遷移で
+    //   久々に呼ばれる関数の再パースがフレームヒッチになるため無効化する
+    //   (ゲームバンドル数 MB 程度ならバイトコード常駐のメモリ増は許容範囲)。
+    // 注: PC ビルドも意図的に jitless で統一する。コンソール実機の性能を PC 検証で
+    //     忠実に再現するため (PC だけ JIT で速くするとレギュレーション下の実機で
+    //     性能問題が再発する)。
+    v8::V8::SetFlagsFromString("--jitless --wasm-jitless --no-flush-bytecode");
 
     v8::V8::InitializeICUDefaultLocation(exec_path);
     v8::V8::InitializeExternalStartupData(exec_path);
     platform_ = v8::platform::NewDefaultPlatform();
     v8::V8::InitializePlatform(platform_.get());
     v8::V8::Initialize();
+
+    // WebAssembly (DrumBrake) はメモリ境界検査を guard page + trap handler で行うため、
+    // embedder が trap handler を有効化する必要がある (d8/Chrome も起動時に行う)。
+    // 未設定のまま wasm を実行するとインタープリタ初期化で fail-fast する。
+    // コンソール実機で VEH が使えない場合は、V8 を v8_drumbrake_bounds_checks=true
+    // (明示境界チェック) でビルドし直すこと。
+    if (!v8::V8::EnableWebAssemblyTrapHandler(true)) {
+        std::cerr << "warning: EnableWebAssemblyTrapHandler failed"
+                  << " - WebAssembly may not work" << std::endl;
+    }
 }
 
 void V8Runtime::ShutdownProcess()
@@ -69,6 +88,14 @@ bool V8Runtime::Initialize(HostContext* host)
     create_params_.array_buffer_allocator =
         v8::ArrayBuffer::Allocator::NewDefaultAllocator();
 
+    // 60fps のゲームはフレーム毎に短命オブジェクト (ディスクリプタ/一時配列) を
+    // 大量生成する。young generation を既定 (十数 MB) から 64MB へ拡大して
+    // scavenge (minor GC) の頻度を下げ、マイクロヒッチを減らす。
+    // scavenge の停止時間は生存オブジェクト量に比例し空間サイズには比例しないため、
+    // 拡大はほぼ純粋に頻度低減として効く。
+    create_params_.constraints.set_max_young_generation_size_in_bytes(
+        64 * 1024 * 1024);
+
     isolate_ = v8::Isolate::New(create_params_);
     isolate_->SetData(kHostContextSlot, host);
     isolate_->SetData(kRuntimeSlot, this);
@@ -76,6 +103,35 @@ bool V8Runtime::Initialize(HostContext* host)
     // 例外時に未処理を潰さないよう、明示的に MicrotasksPolicy を制御する
     isolate_->SetMicrotasksPolicy(v8::MicrotasksPolicy::kExplicit);
 
+    // 未処理の Promise 拒否を stderr へ報告する。framework の boot は async のため、
+    // この報告が無いと例外がどこにも出ずゲームが無音で停止する (実際に発生した)。
+    isolate_->SetPromiseRejectCallback([](v8::PromiseRejectMessage message) {
+        if (message.GetEvent() != v8::kPromiseRejectWithNoHandler) {
+            return;   // 後からハンドラが付く分などは報告しない
+        }
+        v8::Isolate* isolate = v8::Isolate::GetCurrent();
+        v8::HandleScope hs(isolate);
+        v8::Local<v8::Value> value = message.GetValue();
+        std::string text = "(no value)";
+        std::string stack;
+        if (!value.IsEmpty()) {
+            text = v8util::ToStdString(isolate, value);
+            v8::Local<v8::Context> ctx = isolate->GetCurrentContext();
+            if (!ctx.IsEmpty() && value->IsObject()) {
+                v8::Local<v8::Value> s;
+                if (value.As<v8::Object>()
+                        ->Get(ctx, v8util::Str(isolate, "stack")).ToLocal(&s) &&
+                    s->IsString()) {
+                    stack = v8util::ToStdString(isolate, s);
+                }
+            }
+        }
+        std::cerr << "[V8] Unhandled promise rejection: " << text << std::endl;
+        if (!stack.empty() && stack != text) {
+            std::cerr << stack << std::endl;
+        }
+    });
+
     v8::Isolate::Scope isolate_scope(isolate_);
     v8::HandleScope handle_scope(isolate_);
 
@@ -123,8 +179,9 @@ bool V8Runtime::RunScript(const std::string& source, const std::string& name)
     v8::ScriptOrigin origin(v8util::Str(isolate_, name));
     v8::Local<v8::String> src = v8util::Str(isolate_, source);
 
+    // バイトコードキャッシュ込みでコンパイル (2回目以降の起動でパースを省略)
     v8::Local<v8::Script> script;
-    if (!v8::Script::Compile(ctx, src, &origin).ToLocal(&script)) {
+    if (!codecache::Compile(ctx, src, origin, name, source).ToLocal(&script)) {
         ReportException(&try_catch);
         return false;
     }
@@ -149,10 +206,17 @@ v8::MaybeLocal<v8::Module> V8Runtime::LoadModule(const std::string& path,
         return cached->second.Get(isolate_);
     }
 
-    const std::string source = ReadTextFile(abs);
-    if (source.empty() && !fs::exists(abs)) {
-        v8util::ThrowTypeError(isolate_, "Module not found: " + abs);
-        return v8::MaybeLocal<v8::Module>();
+    // 埋め込みモード優先: exe 内に格納された assets/app を先に探す (平文 JS を置かない)。
+    // 埋め込みが無い開発ビルドでは nullptr が返り、従来どおりファイルから読む。
+    std::string source;
+    if (const auto* embedded = GetEmbeddedAssetByAbsPath(abs)) {
+        source.assign(embedded->begin(), embedded->end());
+    } else {
+        source = ReadTextFile(abs);
+        if (source.empty() && !fs::exists(abs)) {
+            v8util::ThrowTypeError(isolate_, "Module not found: " + abs);
+            return v8::MaybeLocal<v8::Module>();
+        }
     }
 
     v8::Local<v8::String> src = v8util::Str(isolate_, source);
@@ -163,9 +227,10 @@ v8::MaybeLocal<v8::Module> V8Runtime::LoadModule(const std::string& path,
         false, false, /*is_module*/ true
     );
 
-    v8::ScriptCompiler::Source compiler_source(src, origin);
+    // バイトコードキャッシュ込みでコンパイル。アプリ本体 (数 MB の ESM バンドル) の
+    // 毎起動フルパースを 2 回目以降省略する (起動時間の主要因)。
     v8::Local<v8::Module> module;
-    if (!v8::ScriptCompiler::CompileModule(isolate_, &compiler_source).ToLocal(&module)) {
+    if (!codecache::CompileModule(isolate_, src, origin, abs, source).ToLocal(&module)) {
         return v8::MaybeLocal<v8::Module>();
     }
 

package/templates/xbox/src/v8/V8Util.h

@@ -2,8 +2,11 @@
 #pragma once
 
 #include <v8.h>
+#include <iostream>
+#include <fstream>
 #include <string>
 #include <string_view>
+#include <unordered_map>
 
 namespace next2d::v8util {
 
@@ -16,6 +19,32 @@ inline v8::Local<v8::String> Str(v8::Isolate* isolate, std::string_view s)
     ).ToLocalChecked();
 }
 
+// プロパティ名 v8::String のキャッシュ。
+// バインディングのディスクリプタ解析 (webgpu::Prop/HasProp/U32 等) は毎フレーム
+// 数千回呼ばれ、その度に NewFromUtf8 が JS ヒープ確保 + ハッシュ計算をしていた。
+// internalized string (isolate 内で重複排除され、プロパティ検索がポインタ比較で済む)
+// を v8::Eternal で保持し、2 回目以降はハッシュマップ参照のみにする。
+// jitless では JS↔C++ 境界のコストが相対的に重いため、ここの削減が全体に効く。
+// キーは内容比較 (std::string) なので呼び出し元がリテラル以外を渡しても安全。
+// ホストは単一 Isolate 運用 (worker も同一 Isolate の別 Context) だが、
+// 念のため isolate が変わったらキャッシュを破棄する (Eternal は isolate 寿命に紐づく)。
+inline v8::Local<v8::String> PropName(v8::Isolate* isolate, const char* key)
+{
+    static v8::Isolate* cached_isolate = nullptr;
+    static std::unordered_map<std::string, v8::Eternal<v8::String>> cache;
+    if (cached_isolate != isolate) {
+        cache.clear();
+        cached_isolate = isolate;
+    }
+    auto it = cache.find(key);
+    if (it == cache.end()) {
+        v8::Local<v8::String> s = v8::String::NewFromUtf8(
+            isolate, key, v8::NewStringType::kInternalized).ToLocalChecked();
+        it = cache.emplace(key, v8::Eternal<v8::String>(isolate, s)).first;
+    }
+    return it->second.Get(isolate);
+}
+
 // v8::Value -> std::string (UTF-8)
 inline std::string ToStdString(v8::Isolate* isolate, v8::Local<v8::Value> value)
 {
@@ -53,4 +82,54 @@ inline void ThrowTypeError(v8::Isolate* isolate, std::string_view message)
     isolate->ThrowException(v8::Exception::TypeError(Str(isolate, message)));
 }
 
+// TryCatch が例外を保持していれば stderr へ報告する。
+// rAF / タイマー / onmessage / イベントリスナーのコールバックは TryCatch で
+// 保護されるが、報告しないと例外が無音で消えて原因究明が不可能になる
+// (レンダラ worker が毎フレーム throw していても黒画面にしか見えない)。
+// 例外を stderr に加えてログファイルにも残す。GUI 実行(ダブルクリック)では stderr が
+// 捨てられて例外が見えないため、rAF/タイマー/リスナーで無音死する不具合(例: Tween の
+// rAF チェーンが UPDATE リスナの throw で再登録されず停止)を実行後に追跡できるように
+// する。暴走ログ防止に先頭 200 件までに制限。ファイルは実行ディレクトリの next2d-error.log。
+inline void AppendErrorLog(const std::string& line)
+{
+    static int written = 0;
+    if (written >= 200) {
+        return;
+    }
+    ++written;
+    std::ofstream ofs("next2d-error.log", std::ios::app);
+    if (ofs) {
+        ofs << line << std::endl;
+    }
+}
+
+inline void ReportCaught(v8::Isolate* isolate, v8::TryCatch* tc, const char* where)
+{
+    if (!tc->HasCaught()) {
+        return;
+    }
+    v8::HandleScope hs(isolate);
+    v8::Local<v8::Context> ctx = isolate->GetCurrentContext();
+    const std::string text = ToStdString(isolate, tc->Exception());
+    const std::string head = std::string("[JS] exception in ") + where + ": " + text;
+    std::cerr << head << std::endl;
+    AppendErrorLog(head);
+    v8::Local<v8::Value> stack;
+    if (!ctx.IsEmpty() && tc->StackTrace(ctx).ToLocal(&stack)) {
+        const std::string s = ToStdString(isolate, stack);
+        if (!s.empty() && s != text) {
+            std::cerr << s << std::endl;
+            AppendErrorLog(s);
+        }
+    }
+    v8::Local<v8::Message> message = tc->Message();
+    if (!message.IsEmpty() && !ctx.IsEmpty()) {
+        const std::string loc = std::string("  at ")
+            + ToStdString(isolate, message->GetScriptOrigin().ResourceName())
+            + ":" + std::to_string(message->GetLineNumber(ctx).FromMaybe(0));
+        std::cerr << loc << std::endl;
+        AppendErrorLog(loc);
+    }
+}
+
 } // namespace next2d::v8util

package/templates/xbox/src/v8/WeakHandle.h

@@ -0,0 +1,45 @@
+// SetWeak (GC 連動の解放) の正しい運用ヘルパー。
+//
+// V8 の規約では、第一パスの weak callback 内で対応する v8::Global を必ず
+// Reset しなければならない。違反すると GC 時に fatal
+// 「Check failed: Handle not reset in first callback.」で落ちる。
+// payload と Global を束ねて所有し、GC で Reset + delete の両方を行う。
+#pragma once
+
+#include <v8.h>
+
+namespace next2d::v8util {
+
+template <typename T>
+class WeakHandle {
+public:
+    static void Attach(v8::Isolate* isolate, v8::Local<v8::Object> obj, T* payload)
+    {
+        auto* w = new WeakHandle<T>(payload);
+        w->handle_.Reset(isolate, obj);
+        w->handle_.SetWeak(w, &WeakHandle::OnGC, v8::WeakCallbackType::kParameter);
+    }
+
+private:
+    explicit WeakHandle(T* payload) : payload_(payload) {}
+
+    static void OnGC(const v8::WeakCallbackInfo<WeakHandle<T>>& info)
+    {
+        WeakHandle<T>* w = info.GetParameter();
+        w->handle_.Reset();   // 第一パスでの Reset (V8 の必須要件)
+        delete w->payload_;
+        delete w;
+    }
+
+    v8::Global<v8::Object> handle_;
+    T* payload_;
+};
+
+// オブジェクトが GC されたときに `delete payload` する弱参照を張る。
+template <typename T>
+inline void AttachWeak(v8::Isolate* isolate, v8::Local<v8::Object> obj, T* payload)
+{
+    WeakHandle<T>::Attach(isolate, obj, payload);
+}
+
+} // namespace next2d::v8util