Introduce Scheduler briding logic for native Choreographer implementations

Summary:
This diff adds a scaffolding allowing for the Animation Backend to access platform-specific animation frame scheduling.

# Changelog
[General] [Added] - `schedulerShouldResumeAnimationFrameCallbacks` and `schedulerShouldPauseAnimationFrameCallbacks` methods to `SchedulerDelegate`

Differential Revision: D89663244

Author: Bartlomiej Bloniarz

packages/react-native/React/Fabric/RCTScheduler.mm

@@ -78,6 +78,18 @@ void schedulerDidUpdateShadowTree(const std::unordered_map<Tag, folly::dynamic>
     // This delegate method is not currently used on iOS.
   }
 
+  void schedulerShouldResumeAnimationFrameCallbacks() override
+  {
+    // Does nothing.
+    // This delegate method is not currently used on iOS.
+  }
+
+  void schedulerShouldPauseAnimationFrameCallbacks() override
+  {
+    // Does nothing.
+    // This delegate method is not currently used on iOS.
+  }
+
  private:
   void *scheduler_;
 };

packages/react-native/ReactAndroid/src/main/jni/react/fabric/FabricUIManagerBinding.cpp

@@ -764,6 +764,10 @@ void FabricUIManagerBinding::schedulerDidUpdateShadowTree(
   // no-op
 }
 
+void FabricUIManagerBinding::schedulerShouldResumeAnimationFrameCallbacks() {}
+
+void FabricUIManagerBinding::schedulerShouldPauseAnimationFrameCallbacks() {}
+
 void FabricUIManagerBinding::onAnimationStarted() {
   auto mountingManager = getMountingManager("onAnimationStarted");
   if (!mountingManager) {

packages/react-native/ReactAndroid/src/main/jni/react/fabric/FabricUIManagerBinding.h

@@ -112,6 +112,10 @@ class FabricUIManagerBinding : public jni::HybridClass<FabricUIManagerBinding>,
 
   void schedulerDidUpdateShadowTree(const std::unordered_map<Tag, folly::dynamic> &tagToProps) override;
 
+  void schedulerShouldResumeAnimationFrameCallbacks() override;
+
+  void schedulerShouldPauseAnimationFrameCallbacks() override;
+
   void setPixelDensity(float pointScaleFactor);
 
   void driveCxxAnimations();

packages/react-native/ReactCommon/react/renderer/scheduler/SchedulerDelegate.h

@@ -60,6 +60,18 @@ class SchedulerDelegate {
 
   virtual void schedulerDidUpdateShadowTree(const std::unordered_map<Tag, folly::dynamic> &tagToProps) = 0;
 
+  /*
+   * Called when the animation backend should start receiving frame callbacks.
+   * This is used to control the platform-specific animation frame scheduling.
+   */
+  virtual void schedulerShouldResumeAnimationFrameCallbacks() = 0;
+
+  /*
+   * Called when the animation backend should stop receiving frame callbacks.
+   * This is used to pause the platform-specific animation frame scheduling.
+   */
+  virtual void schedulerShouldPauseAnimationFrameCallbacks() = 0;
+
   virtual ~SchedulerDelegate() noexcept = default;
 };
 

packages/react-native/ReactCxxPlatform/react/renderer/scheduler/SchedulerDelegateImpl.cpp

@@ -63,4 +63,12 @@ void SchedulerDelegateImpl::schedulerDidUpdateShadowTree(
   mountingManager_->onUpdateShadowTree(tagToProps);
 }
 
+void SchedulerDelegateImpl::schedulerShouldResumeAnimationFrameCallbacks() {
+  // no-op for ReactCxxPlatform
+}
+
+void SchedulerDelegateImpl::schedulerShouldPauseAnimationFrameCallbacks() {
+  // no-op for ReactCxxPlatform
+}
+
 } // namespace facebook::react

packages/react-native/ReactCxxPlatform/react/renderer/scheduler/SchedulerDelegateImpl.h

@@ -47,6 +47,10 @@ class SchedulerDelegateImpl : public SchedulerDelegate {
 
   void schedulerDidUpdateShadowTree(const std::unordered_map<Tag, folly::dynamic> &tagToProps) override;
 
+  void schedulerShouldResumeAnimationFrameCallbacks() override;
+
+  void schedulerShouldPauseAnimationFrameCallbacks() override;
+
   std::shared_ptr<IMountingManager> mountingManager_;
 };