Disable single-op batching under C++ native animated, otherwise enable by default (#57316)

Summary:
Pull Request resolved: https://github.com/react/react-native/pull/57316

Single-op batching (`queueAndExecuteBatchedOperations`) is incompatible with the C++ native animated backend. Move that guard out of per-product feature-flag overrides and into `NativeAnimatedHelper`: `isSingleOpBatching` is now gated on `Platform.OS === 'android'`, `queueAndExecuteBatchedOperations` being available, and `!cxxNativeAnimatedEnabled()`. With the invariant centralized, the redundant `animatedShouldUseSingleOp` overrides in the panel-app and igvr override files are removed (igvr keeps a passthrough override file wired into IGVRPrelude).

**Single-op batching is most meaningful only on Android**: it collapses many per-operation JNI crossings into a single call, a significant win on the legacy bridge path. On other platforms (and on the C++/JSI path) the calls do not cross JNI, so batching would help performance only marginally while hurting debuggability — the ops are packed into an opaque serialized buffer and callbacks are rerouted through the device event emitter. That trade-off is why it stays Android-only and off under C++ native animated.

Behavior note: with C++ native animated enabled (the default), this is a no-op — single-op was already forced off. Where C++ native animated is disabled on Android, single-op is now on by default (it was previously gated by the `animatedShouldUseSingleOp` flag, which defaulted to off).

Changelog:[Internal]

Reviewed By: javache, christophpurrer

Differential Revision: D109468772

fbshipit-source-id: f904c924e2d2c6454c2bd83d3b25a1b7630ea8f3
This commit is contained in:
Zeya Peng authored and meta-codesync[bot] committed 2026-06-24 12:11:13 -07:00
1 parent a224e03772
commit 2bbd70a897
3 files changed
+5 -4

No files matched your search

@@ -993,7 +993,7 @@ const definitions: FeatureFlagDefinitions = {
ossReleaseStage: 'none',
},
animatedShouldUseSingleOp: {
defaultValue: false,
defaultValue: true,
metadata: {
dateAdded: '2024-02-05',
description:
@@ -56,7 +56,8 @@ const singleOpQueue: Array<unknown> = [];
const isSingleOpBatching =
Platform.OS === 'android' &&
NativeAnimatedModule?.queueAndExecuteBatchedOperations != null &&
ReactNativeFeatureFlags.animatedShouldUseSingleOp();
ReactNativeFeatureFlags.animatedShouldUseSingleOp() &&
!ReactNativeFeatureFlags.cxxNativeAnimatedEnabled();
let flushQueueImmediate = null;
const eventListenerGetValueCallbacks: {
@@ -4,7 +4,7 @@
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*
* @generated SignedSource<<c9804d0743d9a9d905193cb02816da46>>
* @generated SignedSource<<f44477b5f5a4f7030798a61694d0332a>>
* @flow strict
* @noformat
*/
@@ -164,7 +164,7 @@ export const animatedShouldSyncValueBeforeStartCallback: Getter<boolean> = creat
/**
* Enables an experimental mega-operation for Animated.js that replaces many calls to native with a single call into native, to reduce JSI/JNI traffic.
*/
export const animatedShouldUseSingleOp: Getter<boolean> = createJavaScriptFlagGetter('animatedShouldUseSingleOp', false);
export const animatedShouldUseSingleOp: Getter<boolean> = createJavaScriptFlagGetter('animatedShouldUseSingleOp', true);
/**
* Use the deferred cell render update mechanism for focus change in FlatList.