Skip to content

Commit

Permalink
Migrate UIManager interface to Kotlin (facebook#44589)
Browse files Browse the repository at this point in the history
Summary:
Pull Request resolved: facebook#44589

## Changelog:
[Internal] -

As in the title.

Reviewed By: tdn120

Differential Revision: D57434432
  • Loading branch information
rshest authored and facebook-github-bot committed Jun 13, 2024
1 parent 4afa4ed commit ec2cc73
Show file tree
Hide file tree
Showing 2 changed files with 160 additions and 162 deletions.

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,160 @@
/*
* 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.bridge

import android.view.View
import androidx.annotation.AnyThread
import androidx.annotation.UiThread
import com.facebook.infer.annotation.ThreadConfined
import com.facebook.react.common.annotations.UnstableReactNativeAPI

@OptIn(UnstableReactNativeAPI::class)
public interface UIManager : PerformanceCounter {
/** Registers a new root view. @Deprecated call startSurface instead */
@UiThread
@ThreadConfined(ThreadConfined.UI)
@Deprecated("")
public fun <T : View?> addRootView(rootView: T, initialProps: WritableMap?): Int

/** Registers a new root view with width and height. */
@AnyThread
public fun <T : View?> startSurface(
rootView: T,
moduleName: String,
initialProps: WritableMap?,
widthMeasureSpec: Int,
heightMeasureSpec: Int
): Int

/**
* Stop a surface from running in JS and clears up native memory usage. Assumes that the native
* View hierarchy has already been cleaned up. Fabric-only.
*/
@AnyThread public fun stopSurface(surfaceId: Int)

/**
* Updates the layout specs of the RootShadowNode based on the Measure specs received by
* parameters. offsetX and offsetY are the position of the RootView within the screen.
*/
@UiThread
@ThreadConfined(ThreadConfined.UI)
public fun updateRootLayoutSpecs(
rootTag: Int,
widthMeasureSpec: Int,
heightMeasureSpec: Int,
offsetX: Int,
offsetY: Int
)

/**
* Dispatches the commandId received by parameter to the view associated with the reactTag. The
* command will be processed in the UIThread.
*
* Receiving commands as ints is deprecated and will be removed in a future release.
*
* Pre-Fabric, this is only called on the Native Module Thread.
*
* @param reactTag that identifies the view that will receive this command
* @param commandId command id
* @param commandArgs [ReadableArray] parameters associated with the command
*/
public fun dispatchCommand(reactTag: Int, commandId: Int, commandArgs: ReadableArray?)

/**
* Dispatches the commandId received by parameter to the view associated with the reactTag. The
* command will be processed in the UIThread.
*
* Pre-Fabric, this is only called on the Native Module Thread.
*
* @param reactTag that identifies the view that will receive this command
* @param commandId command id
* @param commandArgs [ReadableArray] parameters associated with the command
*/
public fun dispatchCommand(reactTag: Int, commandId: String, commandArgs: ReadableArray?)

/** @return the [EventDispatcher] object that is used by this class. */
public fun <T> getEventDispatcher(): T

/**
* Used by native animated module to bypass the process of updating the values through the shadow
* view hierarchy. This method will directly update native views, which means that updates for
* layout-related propertied won't be handled properly. Make sure you know what you're doing
* before calling this method :)
*
* @param reactTag that identifies the view that will be updated
* @param props [ReadableMap] props that should be immediately updated in view
*/
@UiThread
@ThreadConfined(ThreadConfined.UI)
public fun synchronouslyUpdateViewOnUIThread(reactTag: Int, props: ReadableMap?)

/**
* Dispatch an accessibility event to a view asynchronously.
*
* Pre-Fabric, this is only called on the Native Module Thread.
*
* @param reactTag
* @param eventType
*/
public fun sendAccessibilityEvent(reactTag: Int, eventType: Int)

/**
* Register a [UIManagerListener] with this UIManager to receive lifecycle callbacks.
*
* @param listener
*/
public fun addUIManagerEventListener(listener: UIManagerListener?)

/**
* Unregister a [UIManagerListener] from this UIManager to stop receiving lifecycle callbacks.
*
* @param listener
*/
public fun removeUIManagerEventListener(listener: UIManagerListener?)

/**
* Resolves a view based on its reactTag. Do not mutate properties on this view that are already
* managed by React, as there are no guarantees this changes will be preserved.
*
* @param reactTag tag
* @return view if found
* @throws IllegalViewOperationException if tag could not be resolved.
*/
public fun resolveView(reactTag: Int): View?

/**
* This method dispatches events from RN Android code to JS. The delivery of this event will not
* be queued in EventDispatcher class.
*
* @param reactTag tag
* @param eventName name of the event
* @param event parameters
*/
@Deprecated("", ReplaceWith("receiveEvent(surfaceId, reactTag, eventName, event)"))
public fun receiveEvent(reactTag: Int, eventName: String, event: WritableMap?)

/**
* This method dispatches events from RN Android code to JS. The delivery of this event will not
* be queued in EventDispatcher class.
*
* @param surfaceId
* @param reactTag tag
* @param eventName name of the event
* @param event parameters
*/
public fun receiveEvent(surfaceId: Int, reactTag: Int, eventName: String, event: WritableMap?)

/** Resolves Direct Event name exposed to JS from the one known to the Native side. */
@Deprecated("") public fun resolveCustomDirectEventName(eventName: String): String?

/** This method is called after [ReactApplicationContext] has been created. */
public fun initialize()

/** Called before React Native instance is destroyed. */
public fun invalidate()
}

0 comments on commit ec2cc73

Please sign in to comment.