[0.83] Backport performance debugging improvements

[huntie]

Summary

Backports some CDP Performance features and stability improvements to 0.83-stable. This supports a validation project with these features within Expo.

This includes:

• Remaining implementation of Frame Timings and screenshot capture in performance traces (Android)
• New support for Frame Timings and screenshot capture on iOS
• Optimisations to trace chunk generation, memory usage during performance recording
• Page.captureScreenshot (Android, iOS)

All features remain gated behind feature flags (fuseboxFrameRecordingEnabled, fuseboxScreenshotCaptureEnabled).

Commits applied

This branch is a squashed version of https://github.com/huntie/react-native/tree/0.83-perf-trace-backcompat-raw. All commits except those prefixed [LOCAL] (last 3) are picks from main.

54 commits

• Define TracingCategory enum (Define TracingCategory enum #54377) bd6c6bf
• Use TracingCategory in TraceEvent (Use TracingCategory in TraceEvent #54378) ce60f27
• Simple parser for serialized tracing categories (Simple parser for serialized tracing categories #54379) 62275b6
• Propagate tracing categories to recording state (Propagate tracing categories to recording state #54380) 3841ef0
• Re-land "Revert D85999774: [rn][android] Add FrameTiming module" (Re-land "Revert D85999774: [rn][android] Add FrameTiming module" #54502) 85905ad
• Add screenshot category (Add screenshot category #54537) 5d9cb80
• Define HostTargetTracingDelegate (Define HostTargetTracingDelegate #54622) be0dae0
• Define TracingDelegate for Android Host (Define TracingDelegate for Android Host #54628) a212e95
• Use new API for tracing state on Android (Use new API for tracing state on Android #54629) 532d0be
• Internalize TracingState interface (Internalize TracingState interface #54631) 58ec261
• Move TracingState interfaces to inspector package (Move TracingState interfaces to inspector package #54632) 10d0d99
• Rename values of TracingState enum (TracingState rename enum values #54630) be94707
• FrameTiming module to subscribe to Inspector tracing lifecycle (FrameTiming module to subscribe to Inspector tracing lifecycle #54633) 04ee02b
• Clarify HostTracingProfile and HostTraceRecordingState (Clarify HostTracingProfile and HostTraceRecordingState #54677) ec92f12
• Introduce TimeWindowedBuffer (Introduce TimeWindowedBuffer #54679) d6ee54f
• Keep tracing time window on TraceRecordingState (Keep tracing time window on TraceRecordingState #54673) e651563
• Define FrameTimingSequence (Define FrameTimingSequence #54674) 5b7d92f
• Define an endpoint on HostTarget to capture frame timings (Define an endpoint on HostTarget to capture frame timings #54672) f469aa3
• Extract frame trace events construction logic (Extract frame trace events construction logic #54675) 57973fa
• Define serializers for frame timings as part of HostTargetTracingProfile (Define serializers for frame timings as part of HostTargetTracingProfile #54681) 587d360
• Propagate Frames data through Host (Propagate Frames data through Host #54671) 26ff069
• Cleanup no longer used jni layer for frame timings (Cleanup no longer used jni layer for frame timings #54678) 9ba4ce6
• Fix screenshot typo (Fix screenshot typo #54742) 52186a3
• Add optional screenshot argument to FrameTimingSequence (Add optional screenshot argument to FrameTimingSequence #54743) 57c29fc
• Frame screenshot event generation (Frame screenshot event generation #54744) b447d26
• Frame screenshots capture implementation (Frame screenshots capture implementation #54745) f3c9a8d
• BeginDrawing: INTENDED_VSYNC_TIMESTAMP -> VSYNC_TIMESTAMP (BeginDrawing: INTENDED_VSYNC_TIMESTAMP -> VSYNC_TIMESTAMP #54765) 9221772
• Add frames category (Add frames category #54768) 31a0c9a
• Specify correct category for SetLayerTreeId event (Specify correct category for SetLayerTreeId event #54769) cd055e9
• Reduce the screenshots size (Reduce the screenshots size #54800) e4a5a56
• Remove Commit from FrameTimingSequence (Remove Commit from FrameTimingSequence #54779) 39f7703
• Fix potential bitmap leaks in FrameTimingsObserver (Fix potential bitmap leaks in FrameTimingsObserver #55652) 3918dd1
• Capture initial screenshot when starting frame timing trace (Capture initial screenshot when starting frame timing trace #55720) 863f5c0
• Refactor FrameTimingsObserver for multi-activity support (Refactor FrameTimingsObserver for multi-activity support #55740) 8230f3b
• Reorder FrameTimingsObserver methods (Reorder FrameTimingsObserver methods #55743) f56b295
• Increase frame capture quality, apply scaling after DPI normalization (Increase frame capture quality, apply scaling after DPI normalization #55731) e5f9f5f
• Fix FrameTimingsObverver to initiate PixelCopy on main thread (Fix FrameTimingsObverver to initiate PixelCopy on main thread #55744) d552f2a
• Fix bitmap reuse race condition in FrameTimingsObserver (Fix bitmap reuse race condition in FrameTimingsObserver #55745) 3924768
• Fix trailing frame capture after recording ended (Fix trailing frame capture after recording ended #55704) 47684ca
• Move base64Encode into react/utils (Move base64Encode into react/utils #55873) 422770d
• Move screenshot Base64 encoding to trace serialization (Move screenshot Base64 encoding to trace serialization #55803) dc4c36e
• Restore inspector addPage listener callback (Restore inspector addPage listener callback #55925) 8c763fc
• Add tracing helper functions for RNDT traces in C++ and Kotlin (Add tracing helper functions for RNDT traces in C++ and Kotlin #55935) 4f3f536
• Introduce fuseboxFrameRecordingEnabled flag, gate existing code (Introduce fuseboxFrameRecordingEnabled flag, gate existing code #55941) 1aa7a32
• Implement Performance frames and screenshots on iOS (Implement Performance frames and screenshots on iOS #56015) 64a1a10
• Add pixel diffing to RCTFrameTimingsObserver (Add pixel diffing to RCTFrameTimingsObserver #56043) 9d231af
• Add dynamic sampling to frame screenshots (Add dynamic sampling to frame screenshots #56048) d309cda
• Switch trace event chunks from event count to size based (Switch trace event chunks from event count to size based #56080) d3b33f5
• Increase trace screenshot scale factor to 1x (Increase trace screenshot scale factor to 1x (#56079) #56079) 972a30d
• Add Page.captureScreenshot CDP support (Add Page.captureScreenshot CDP support (#56307) #56307) 77332d2
• Fix data race on PerformanceObserver entry buffer (Fix data race on PerformanceObserver entry buffer #56352) 5eb1ca1
• [LOCAL] Remove stale frame event code from PerformanceTracer
• [LOCAL] Update Podfile.lock

Another view: What isn't picked from main from jsinspector-modern

Diff of this branch vs facebook/main

Features on main not included in the 0.83-perf-trace-backcompat branch:

1. Perf monitor overlay improvements (Android) — Auto-expiring issue counts (20s), auto-hide in CDP mode, custom perf issue icon.
2. Background trace stashing in C++ HostTarget — Stash-and-emit lifecycle owned by C++ rather than platform Java layer.
3. Stack traces on measures/timestamps — rnStackTrace field on reportMeasure() and reportTimeStamp() trace events.
4. ResourceReceivedData network trace event — encodedDataLength tracking for network resource timeline events.
5. Multi-agent NetworkIOAgent — Per-agent enable/disable with agent IDs and destructor cleanup.
6. iOS RCTHost API changes — RCTBundleConfiguration param, updated host:didInitializeRuntime: delegate with deprecation shim.

Changelog: [Internal]

Test Plan

Compile locally. No Hermes updates are required.

yarn test-release-local -t RNTester -p [Android|iOS]

Flags disabled (default)

Record a performance trace (existing features).

Android	iOS
✅ Success	✅ Success

Flags enabled

Note

Depends on facebook/react-native-devtools-frontend#248, which will be opened as a separate pick request. (Locally applied via node scripts/debugger-frontend/sync-and-build --branch 0.83- perf-trace-backcompat)

Android	iOS
✅ Feature enabled NUX	✅ Feature enabled NUX
	Incoming
✅ Frames track with screenshots	✅ Frames track with screenshots

[github-actions]

Warning

JavaScript API change detected

This PR commits an update to ReactNativeApi.d.ts, indicating a change to React Native's public JavaScript API.

• Please include a clear changelog message.
• This change will be subject to additional review.

This change was flagged as: BREAKING