react-native-tvos 0.80.1-0 → 0.81.0-0rc2

package/ReactAndroid/src/main/java/com/facebook/react/fabric/mounting/MountingManager.kt

@@ -0,0 +1,373 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+package com.facebook.react.fabric.mounting
+
+import android.view.View
+import androidx.annotation.AnyThread
+import androidx.annotation.UiThread
+import com.facebook.common.logging.FLog
+import com.facebook.infer.annotation.ThreadConfined
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.bridge.ReactSoftExceptionLogger.logSoftException
+import com.facebook.react.bridge.ReadableArray
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.RetryableMountingLayerException
+import com.facebook.react.bridge.UiThreadUtil.assertOnUiThread
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.common.annotations.UnstableReactNativeAPI
+import com.facebook.react.common.mapbuffer.MapBuffer
+import com.facebook.react.fabric.events.EventEmitterWrapper
+import com.facebook.react.fabric.mounting.mountitems.MountItem
+import com.facebook.react.touch.JSResponderHandler
+import com.facebook.react.uimanager.RootViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.ViewManagerRegistry
+import com.facebook.react.uimanager.common.ViewUtil
+import com.facebook.react.uimanager.events.EventCategoryDef
+import com.facebook.yoga.YogaMeasureMode
+import java.util.Queue
+import java.util.concurrent.ConcurrentHashMap
+import java.util.concurrent.CopyOnWriteArrayList
+
+/**
+ * Class responsible for actually dispatching view updates enqueued via
+ * [com.facebook.react.fabric.FabricUIManager.scheduleMountItem] on the UI thread.
+ */
+internal class MountingManager(
+    private val viewManagerRegistry: ViewManagerRegistry,
+    private val mountItemExecutor: MountItemExecutor
+) {
+  private val surfaceIdToManager = ConcurrentHashMap<Int, SurfaceMountingManager>() // any thread
+
+  private val stoppedSurfaceIds = CopyOnWriteArrayList<Int>()
+
+  private var mostRecentSurfaceMountingManager: SurfaceMountingManager? = null
+  private var lastQueriedSurfaceMountingManager: SurfaceMountingManager? = null
+
+  private val jsResponderHandler = JSResponderHandler()
+  private val rootViewManager = RootViewManager()
+
+  internal fun interface MountItemExecutor {
+    @UiThread @ThreadConfined(ThreadConfined.UI) fun executeItems(items: Queue<MountItem?>?)
+  }
+
+  /**
+   * Starts surface without attaching the view. All view operations executed against that surface
+   * will be queued until the view is attached.
+   */
+  @AnyThread
+  fun startSurface(
+      surfaceId: Int,
+      reactContext: ThemedReactContext?,
+      rootView: View?
+  ): SurfaceMountingManager {
+    val surfaceMountingManager =
+        SurfaceMountingManager(
+            surfaceId,
+            jsResponderHandler,
+            viewManagerRegistry,
+            rootViewManager,
+            mountItemExecutor,
+            checkNotNull(reactContext))
+
+    // There could technically be a race condition here if addRootView is called twice from
+    // different threads, though this is (probably) extremely unlikely, and likely an error.
+    // This logic to protect against race conditions is a holdover from older code, and we don't
+    // know if it actually happens in practice - so, we're logging soft exceptions for now.
+    // This *will* crash in Debug mode, but not in production.
+    surfaceIdToManager.putIfAbsent(surfaceId, surfaceMountingManager)
+    if (surfaceIdToManager[surfaceId] !== surfaceMountingManager) {
+      logSoftException(
+          TAG,
+          IllegalStateException(
+              "Called startSurface more than once for the SurfaceId [$surfaceId]"))
+    }
+
+    mostRecentSurfaceMountingManager = surfaceIdToManager[surfaceId]
+
+    if (rootView != null) {
+      surfaceMountingManager.attachRootView(rootView, reactContext)
+    }
+
+    return surfaceMountingManager
+  }
+
+  @AnyThread
+  fun attachRootView(surfaceId: Int, rootView: View?, themedReactContext: ThemedReactContext?) {
+    val surfaceMountingManager = getSurfaceManagerEnforced(surfaceId, "attachView")
+
+    if (surfaceMountingManager.isStopped) {
+      logSoftException(TAG, IllegalStateException("Trying to attach a view to a stopped surface"))
+      return
+    }
+
+    surfaceMountingManager.attachRootView(rootView, themedReactContext)
+  }
+
+  @AnyThread
+  fun stopSurface(surfaceId: Int) {
+    val surfaceMountingManager = surfaceIdToManager[surfaceId]
+    if (surfaceMountingManager != null) {
+      // Maximum number of stopped surfaces to keep track of
+      while (stoppedSurfaceIds.size >= MAX_STOPPED_SURFACE_IDS_LENGTH) {
+        val staleStoppedId = stoppedSurfaceIds[0]
+        checkNotNull(staleStoppedId)
+        surfaceIdToManager.remove(staleStoppedId)
+        stoppedSurfaceIds.remove(staleStoppedId)
+        FLog.d(TAG, "Removing stale SurfaceMountingManager: [%d]", staleStoppedId)
+      }
+      stoppedSurfaceIds.add(surfaceId)
+
+      surfaceMountingManager.stopSurface()
+
+      if (mostRecentSurfaceMountingManager === surfaceMountingManager) {
+        mostRecentSurfaceMountingManager = null
+      }
+      if (lastQueriedSurfaceMountingManager === surfaceMountingManager) {
+        lastQueriedSurfaceMountingManager = null
+      }
+    } else {
+      logSoftException(
+          TAG,
+          IllegalStateException("Cannot call stopSurface on non-existent surface: [$surfaceId]"))
+    }
+  }
+
+  fun getSurfaceManager(surfaceId: Int): SurfaceMountingManager? {
+    if (lastQueriedSurfaceMountingManager?.surfaceId == surfaceId) {
+      return lastQueriedSurfaceMountingManager
+    }
+
+    if (mostRecentSurfaceMountingManager?.surfaceId == surfaceId) {
+      return mostRecentSurfaceMountingManager
+    }
+
+    val surfaceMountingManager = surfaceIdToManager[surfaceId]
+    lastQueriedSurfaceMountingManager = surfaceMountingManager
+    return surfaceMountingManager
+  }
+
+  fun getSurfaceManagerEnforced(surfaceId: Int, context: String): SurfaceMountingManager =
+      getSurfaceManager(surfaceId)
+          ?: throw RetryableMountingLayerException(
+              ("Unable to find SurfaceMountingManager for surfaceId: [$surfaceId]. Context: $context"))
+
+  fun surfaceIsStopped(surfaceId: Int): Boolean {
+    if (stoppedSurfaceIds.contains(surfaceId)) {
+      return true
+    }
+
+    val surfaceMountingManager = getSurfaceManager(surfaceId)
+    return surfaceMountingManager != null && surfaceMountingManager.isStopped
+  }
+
+  fun isWaitingForViewAttach(surfaceId: Int): Boolean {
+    val mountingManager = getSurfaceManager(surfaceId) ?: return false
+
+    if (mountingManager.isStopped) {
+      return false
+    }
+
+    return !mountingManager.isRootViewAttached
+  }
+
+  /**
+   * Get SurfaceMountingManager associated with a ReactTag. Unfortunately, this requires lookups
+   * over N maps, where N is the number of active or recently-stopped Surfaces. Each lookup will
+   * cost `log(M)` operations where M is the number of reactTags in the surface, so the total cost
+   * per lookup is `O(N * log(M))`.
+   *
+   * To mitigate this cost, we attempt to keep track of the "most recent" SurfaceMountingManager and
+   * do lookups in it first. For the vast majority of use-cases, except for events or operations
+   * sent to off-screen surfaces, or use-cases where multiple surfaces are visible and interactable,
+   * this will reduce the lookup time to `O(log(M))`. Someone smarter than me could probably figure
+   * out an amortized time.
+   *
+   * @param reactTag
+   * @return
+   */
+  fun getSurfaceManagerForView(reactTag: Int): SurfaceMountingManager? {
+    if (mostRecentSurfaceMountingManager?.getViewExists(reactTag) == true) {
+      return mostRecentSurfaceMountingManager
+    }
+
+    for ((_, smm) in surfaceIdToManager) {
+      if (smm !== mostRecentSurfaceMountingManager && smm.getViewExists(reactTag)) {
+        if (mostRecentSurfaceMountingManager == null) {
+          mostRecentSurfaceMountingManager = smm
+        }
+        return smm
+      }
+    }
+    return null
+  }
+
+  @AnyThread
+  fun getSurfaceManagerForViewEnforced(reactTag: Int): SurfaceMountingManager =
+      getSurfaceManagerForView(reactTag)
+          ?: throw RetryableMountingLayerException(
+              "Unable to find SurfaceMountingManager for tag: [$reactTag]")
+
+  fun getViewExists(reactTag: Int): Boolean = getSurfaceManagerForView(reactTag) != null
+
+  @Deprecated(
+      "receiveCommand with Int is deprecated, you should use receiveCommand with commandId:String",
+      ReplaceWith("receiveCommand(Int,Int,String,ReadableArray)"))
+  fun receiveCommand(surfaceId: Int, reactTag: Int, commandId: Int, commandArgs: ReadableArray) {
+    assertOnUiThread()
+    @Suppress("DEPRECATION")
+    getSurfaceManagerEnforced(surfaceId, "receiveCommand:int")
+        .receiveCommand(reactTag, commandId, commandArgs)
+  }
+
+  fun receiveCommand(
+      surfaceId: Int,
+      reactTag: Int,
+      commandId: String?,
+      commandArgs: ReadableArray
+  ) {
+    assertOnUiThread()
+    getSurfaceManagerEnforced(surfaceId, "receiveCommand:string")
+        .receiveCommand(reactTag, checkNotNull(commandId), commandArgs)
+  }
+
+  /**
+   * Send an accessibility eventType to a Native View. eventType is any valid `AccessibilityEvent.X`
+   * value.
+   *
+   * Why accept {@ViewUtil.NO_SURFACE_ID}(-1) SurfaceId? Currently there are calls to
+   * UIManager.sendAccessibilityEvent which is a legacy API and accepts only reactTag. We will have
+   * to investigate and migrate away from those calls over time.
+   *
+   * @param surfaceId that identifies the surface or {@ViewUtil.NO_SURFACE_ID}(-1) to temporarily
+   *   support backward compatibility.
+   * @param reactTag that identifies the react Tag of the view.
+   * @param eventType that identifies Android eventType. see [View.sendAccessibilityEvent]
+   */
+  fun sendAccessibilityEvent(surfaceId: Int, reactTag: Int, eventType: Int) {
+    assertOnUiThread()
+    if (surfaceId == View.NO_ID) {
+      getSurfaceManagerForViewEnforced(reactTag).sendAccessibilityEvent(reactTag, eventType)
+    } else {
+      getSurfaceManagerEnforced(surfaceId, "sendAccessibilityEvent")
+          .sendAccessibilityEvent(reactTag, eventType)
+    }
+  }
+
+  @UiThread
+  fun updateProps(reactTag: Int, props: ReadableMap?) {
+    assertOnUiThread()
+    if (props == null) {
+      return
+    }
+
+    getSurfaceManagerForViewEnforced(reactTag).updateProps(reactTag, props)
+  }
+
+  /**
+   * Clears the JS Responder specified by [SurfaceMountingManager.setJSResponder]. After this method
+   * is called, all the touch events are going to be handled by JS.
+   */
+  @UiThread
+  fun clearJSResponder() {
+    // MountingManager and SurfaceMountingManagers all share the same JSResponderHandler.
+    // Must be called on MountingManager instead of SurfaceMountingManager, because we don't
+    // know what surfaceId it's being called for.
+    jsResponderHandler.clearJSResponder()
+  }
+
+  @AnyThread
+  @ThreadConfined(ThreadConfined.ANY)
+  fun getEventEmitter(surfaceId: Int, reactTag: Int): EventEmitterWrapper? =
+      getSurfaceMountingManager(surfaceId, reactTag)?.getEventEmitter(reactTag)
+
+  /**
+   * Measure a component, given localData, props, state, and measurement information. This needs to
+   * remain here for now - and not in SurfaceMountingManager - because sometimes measures are made
+   * outside of the context of a Surface; especially from C++ before StartSurface is called.
+   */
+  @AnyThread
+  fun measure(
+      context: ReactContext?,
+      componentName: String?,
+      localData: ReadableMap?,
+      props: ReadableMap?,
+      state: ReadableMap?,
+      width: Float,
+      widthMode: YogaMeasureMode?,
+      height: Float,
+      heightMode: YogaMeasureMode?,
+      attachmentsPositions: FloatArray?
+  ): Long =
+      viewManagerRegistry
+          .get(checkNotNull(componentName))
+          .measure(
+              context,
+              localData,
+              props,
+              state,
+              width,
+              widthMode,
+              height,
+              heightMode,
+              attachmentsPositions)
+
+  /**
+   * This prefetch method is experimental, do not use it for production code. it will most likely
+   * change or be removed in the future.
+   *
+   * @param reactContext
+   * @param componentName
+   * @param surfaceId surface ID
+   * @param reactTag reactTag that should be set as ID of the view instance
+   * @param params prefetch request params defined in C++
+   */
+  @Suppress("FunctionName")
+  @AnyThread
+  @UnstableReactNativeAPI
+  fun experimental_prefetchResource(
+      reactContext: ReactContext?,
+      componentName: String?,
+      surfaceId: Int,
+      reactTag: Int,
+      params: MapBuffer?
+  ) {
+    viewManagerRegistry
+        .get(checkNotNull(componentName))
+        .experimental_prefetchResource(reactContext, surfaceId, reactTag, params)
+  }
+
+  fun enqueuePendingEvent(
+      surfaceId: Int,
+      reactTag: Int,
+      eventName: String?,
+      canCoalesceEvent: Boolean,
+      params: WritableMap?,
+      @EventCategoryDef eventCategory: Int
+  ) {
+    val smm = getSurfaceMountingManager(surfaceId, reactTag)
+    if (smm == null) {
+      FLog.d(
+          TAG,
+          "Cannot queue event without valid surface mounting manager for tag: %d, surfaceId: %d",
+          reactTag,
+          surfaceId)
+      return
+    }
+    smm.enqueuePendingEvent(reactTag, eventName, canCoalesceEvent, params, eventCategory)
+  }
+
+  private fun getSurfaceMountingManager(surfaceId: Int, reactTag: Int): SurfaceMountingManager? =
+      if (surfaceId == ViewUtil.NO_SURFACE_ID) getSurfaceManagerForView(reactTag)
+      else getSurfaceManager(surfaceId)
+
+  companion object {
+    val TAG: String = MountingManager::class.java.simpleName
+    private const val MAX_STOPPED_SURFACE_IDS_LENGTH = 15
+  }
+}

package/ReactAndroid/src/main/java/com/facebook/react/fabric/mounting/SurfaceMountingManager.java

@@ -21,6 +21,7 @@ import androidx.collection.SparseArrayCompat;
 import com.facebook.common.logging.FLog;
 import com.facebook.infer.annotation.Assertions;
 import com.facebook.infer.annotation.ThreadConfined;
+import com.facebook.react.bridge.GuardedRunnable;
 import com.facebook.react.bridge.ReactNoCrashSoftException;
 import com.facebook.react.bridge.ReactSoftExceptionLogger;
 import com.facebook.react.bridge.ReadableArray;
@@ -189,57 +190,55 @@ public class SurfaceMountingManager {
     mTagToViewState.put(mSurfaceId, new ViewState(mSurfaceId, rootView, mRootViewManager, true));
 
     Runnable runnable =
-        () -> {
-          // The CPU has ticked since `addRootView` was called, so the surface could technically
-          // have already stopped here.
-          if (isStopped()) {
-            return;
-          }
+        new GuardedRunnable(Assertions.assertNotNull(mThemedReactContext)) {
+          @Override
+          public void runGuarded() {
+            // The CPU has ticked since `addRootView` was called, so the surface could technically
+            // have already stopped here.
+            if (isStopped()) {
+              return;
+            }
 
-          if (rootView.getId() == mSurfaceId) {
-            ReactSoftExceptionLogger.logSoftException(
-                TAG,
-                new IllegalViewOperationException(
-                    "Race condition in addRootView detected. Trying to set an id of ["
-                        + mSurfaceId
-                        + "] on the RootView, but that id has already been set. "));
-          } else if (rootView.getId() != View.NO_ID) {
-            FLog.e(
-                TAG,
-                "Trying to add RootTag to RootView that already has a tag: existing tag: [%d] new"
-                    + " tag: [%d]",
-                rootView.getId(),
-                mSurfaceId);
-            // This behavior can not be guaranteed in hybrid apps that have a native android layer
-            // over
-            // which reactRootViews are added and the native views need to have ids on them in order
-            // to
-            // work.
-            // Hence this can cause unnecessary crashes at runtime for hybrid apps.
-            // So converting this to a soft exception such that pure react-native devs can still see
-            // the
-            // warning while hybrid apps continue to run without crashes
-            ReactSoftExceptionLogger.logSoftException(
-                TAG,
-                new IllegalViewOperationException(
-                    "Trying to add a root view with an explicit id already set. React Native uses"
-                        + " the id field to track react tags and will overwrite this field. If that"
-                        + " is fine, explicitly overwrite the id field to View.NO_ID before calling"
-                        + " addRootView."));
-          }
-          rootView.setId(mSurfaceId);
+            if (rootView.getId() == mSurfaceId) {
+              ReactSoftExceptionLogger.logSoftException(
+                  TAG,
+                  new IllegalViewOperationException(
+                      "Race condition in addRootView detected. Trying to set an id of ["
+                          + mSurfaceId
+                          + "] on the RootView, but that id has already been set. "));
+            } else if (rootView.getId() != View.NO_ID) {
+              FLog.e(
+                  TAG,
+                  "Trying to add RootTag to RootView that already has a tag: existing tag: [%d] new"
+                      + " tag: [%d]",
+                  rootView.getId(),
+                  mSurfaceId);
+              // This behavior can not be guaranteed in hybrid apps that have a native android layer
+              // over which reactRootViews are added and the native views need to have ids on them
+              // in order to work. Hence this can cause unnecessary crashes at runtime for hybrid
+              // apps. So converting this to a soft exception such that pure react-native devs can
+              // still see the warning while hybrid apps continue to run without crashes
+              ReactSoftExceptionLogger.logSoftException(
+                  TAG,
+                  new IllegalViewOperationException(
+                      "Trying to add a root view with an explicit id already set. React Native uses"
+                          + " the id field to track react tags and will overwrite this field. If"
+                          + " that is fine, explicitly overwrite the id field to View.NO_ID before"
+                          + " calling addRootView."));
+            }
+            rootView.setId(mSurfaceId);
 
-          if (rootView instanceof ReactRoot) {
-            ((ReactRoot) rootView).setRootViewTag(mSurfaceId);
-          }
+            if (rootView instanceof ReactRoot) {
+              ((ReactRoot) rootView).setRootViewTag(mSurfaceId);
+            }
 
-          executeMountItemsOnViewAttach();
+            executeMountItemsOnViewAttach();
 
-          // By doing this after `executeMountItemsOnViewAttach`, we ensure
-          // that any operations scheduled while processing this queue are
-          // also added to the queue, instead of being processed immediately
-          // through the queue in `MountItemDispatcher`.
-          mRootViewAttached = true;
+            // By doing this after `executeMountItemsOnViewAttach`, we ensure that any operations
+            // scheduled while processing this queue are also added to the queue, instead of being
+            // processed immediately through the queue in `MountItemDispatcher`.
+            mRootViewAttached = true;
+          }
         };
 
     if (UiThreadUtil.isOnUiThread()) {
@@ -698,7 +697,7 @@ public class SurfaceMountingManager {
   }
 
   @Deprecated
-  public void receiveCommand(int reactTag, int commandId, @Nullable ReadableArray commandArgs) {
+  public void receiveCommand(int reactTag, int commandId, ReadableArray commandArgs) {
     if (isStopped()) {
       return;
     }
@@ -726,8 +725,7 @@ public class SurfaceMountingManager {
     viewState.mViewManager.receiveCommand(viewState.mView, commandId, commandArgs);
   }
 
-  public void receiveCommand(
-      int reactTag, @NonNull String commandId, @Nullable ReadableArray commandArgs) {
+  public void receiveCommand(int reactTag, @NonNull String commandId, ReadableArray commandArgs) {
     if (isStopped()) {
       return;
     }

package/ReactAndroid/src/main/java/com/facebook/react/fabric/mounting/mountitems/DispatchIntCommandMountItem.kt

@@ -14,7 +14,7 @@ internal class DispatchIntCommandMountItem(
     private val surfaceId: Int,
     private val reactTag: Int,
     private val commandId: Int,
-    private val commandArgs: ReadableArray?
+    private val commandArgs: ReadableArray
 ) : DispatchCommandMountItem() {
 
   override fun getSurfaceId(): Int = surfaceId

package/ReactAndroid/src/main/java/com/facebook/react/fabric/mounting/mountitems/DispatchStringCommandMountItem.kt

@@ -14,7 +14,7 @@ internal class DispatchStringCommandMountItem(
     private val surfaceId: Int,
     private val reactTag: Int,
     private val commandId: String,
-    private val commandArgs: ReadableArray?
+    private val commandArgs: ReadableArray
 ) : DispatchCommandMountItem() {
 
   override fun getSurfaceId(): Int = surfaceId

package/ReactAndroid/src/main/java/com/facebook/react/fabric/mounting/mountitems/MountItemFactory.kt

@@ -19,7 +19,7 @@ internal object MountItemFactory {
       surfaceId: Int,
       reactTag: Int,
       commandId: Int,
-      commandArgs: ReadableArray?
+      commandArgs: ReadableArray
   ): DispatchCommandMountItem =
       DispatchIntCommandMountItem(surfaceId, reactTag, commandId, commandArgs)
 
@@ -29,7 +29,7 @@ internal object MountItemFactory {
       surfaceId: Int,
       reactTag: Int,
       commandId: String,
-      commandArgs: ReadableArray?
+      commandArgs: ReadableArray
   ): DispatchCommandMountItem =
       DispatchStringCommandMountItem(surfaceId, reactTag, commandId, commandArgs)