跳到主要内容
新架构实战课 实操 + 基建 + 原理全维度包揽,抢先掌握 React Native 新架构精髓 立即查看 >Version: Next

集成到 Android Fragment

与现有应用程序集成指南中详细介绍了如何将全屏 React Native 应用程序作为 Activity 集成到现有 Android 应用程序中。要在现有应用程序的 Fragments 中使用 React Native 组件,需要进行一些额外的设置。这样做的好处是它允许原生应用程序将 React Native 组件与 Activity 中的原生 Fragments 集成在一起。

1. 将 React Native 添加到你的应用程序

按照与现有应用程序集成的指南,直到代码集成部分。继续执行第 1 步:创建一个index.android.js文件;第 2 步:添加本节中的 React Native 代码。

2. 将你的应用程序与 React Native Fragment 集成

你可以将你的 React Native 组件渲染成一个 Fragment,而不是一个全屏的 React Native Activity。该组件可以称为"screen"或"fragment",它的功能与 Android Fragment 相同,可能包含子组件。这些组件可以放在/fragments文件夹中,用于组成 Fragment 的子组件可以放在/components文件夹中。

你需要在主应用程序 Java/Kotlin 类中实现ReactApplication接口。如果你使用默认活动从 Android Studio 创建了一个新项目,则需要创建一个新类(例如MyReactApplication.javaMyReactApplication.kt)。如果它是一个现有类,你可以在AndroidManifest.xml文件中找到这个主类。在<application />标签下,你应该能看到属性android:name,例如android:name=".MyReactApplication"。此值是要实现的类,并为其提供所需的方法。

确保主应用程序类实现 ReactApplication:

class MyReactApplication: Application(), ReactApplication {...}

重写所需的方法getUseDeveloperSupport, getPackages以及getReactNativeHost:

class MyReactApplication : Application(), ReactApplication {
override fun onCreate() {
super.onCreate()
SoLoader.init(this, false)
}
private val reactNativeHost =
object : DefaultReactNativeHost(this) {
override fun getUseDeveloperSupport() = BuildConfig.DEBUG
override fun getPackages(): List<ReactPackage> {
val packages = PackageList(this).getPackages().toMutableList()
// Packages that cannot be autolinked yet can be added manually here
return packages
}
}
override fun getReactNativeHost(): ReactNativeHost = reactNativeHost
}

如果你使用的是 Android Studio,请使用 Alt+Enter 在类中添加所有缺失的导入,或者手动导入:

import android.app.Application

import com.facebook.react.PackageList
import com.facebook.react.ReactApplication
import com.facebook.react.ReactNativeHost
import com.facebook.react.ReactPackage
import com.facebook.react.defaults.DefaultReactNativeHost
import com.facebook.soloader.SoLoader

执行"Sync Project files with Gradle"操作。

3. 为 React Native Fragment 添加 FrameLayout

现在可以把 React Native Fragment 添加到一个 Activity 中。对于一个新项目来说,这个 Activity 将是MainActivity,但它可以是任何 Activity,并且随着将更多 React Native 组件集成到应用程序中,你可以将更多 Fragments 添加到其他 Activity 中。

首先将 React Native Fragment 添加到 Activity 的布局中,例如res/layouts文件夹中的main_activity.xml

添加具有 id、宽度和高度的<FrameLayout>,React Native Fragment 会被渲染到此布局中。

<FrameLayout
android:id="@+id/reactNativeFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />

4. 将 React Native Fragment 添加到 FrameLayout

要将 React Native Fragment 添加到布局中,你需要有一个 Activity。正如在一个新项目中提到的那样,它就是 MainActivity。在这个 Activity 中添加一个按钮和一个事件监听器,单击按钮时,将会渲染 React Native Fragment。

修改 Activity 布局以添加按钮:

<Button
android:layout_margin="10dp"
android:id="@+id/button"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Show react fragment" />

现在在 Activity 类(例如MainActivity.javaMainActivity.kt)中,你需要为按钮添加一个OnClickListener,实例化ReactFragment并将其添加到框架布局中。

将按钮字段添加到 Activity 的顶部:

private lateinit var button: Button

更新 Activity 的onCreate方法,如下所示:

override fun onCreate(savedInstanceState: Bundle) {
super.onCreate(savedInstanceState)
setContentView(R.layout.main_activity)
button = findViewById<Button>(R.id.button)
button.setOnClickListener {
val reactNativeFragment = ReactFragment.Builder()
.setComponentName("HelloWorld")
.setLaunchOptions(getLaunchOptions("test message"))
.build()
getSupportFragmentManager()
.beginTransaction()
.add(R.id.reactNativeFragment, reactNativeFragment)
.commit()
}
}

在上面的代码中,Fragment reactNativeFragment = new ReactFragment.Builder()创建了 ReactFragment,getSupportFragmentManager().beginTransaction().add()将 Fragment 添加到框架布局中。

如果你使用了 React Native 的入门工具包,请将"HelloWorld"字符串替换为index.jsindex.android.js文件中的字符串(它是 AppRegistry.registerComponent()方法的第一个参数)。

添加getLaunchOptions方法,该方法允许你将属性传递到组件。这是可选的,如果不需要传递任何属性,可以删除setLaunchOptions

private fun getLaunchOptions(message: String) = Bundle().apply {
putString("message", message)
}

在 Activity 类中添加所有缺少的导入。谨慎使用你自己的包中的 BuildConfig 而不是 facebook 包!或者手动导入:

import android.app.Application

import com.facebook.react.ReactApplication
import com.facebook.react.ReactNativeHost
import com.facebook.react.ReactPackage
import com.facebook.react.shell.MainReactPackage
import com.facebook.soloader.SoLoader

执行"Sync Project files with Gradle"操作.

5. 测试你的集成

确保运行yarn来安装你的 react-native 依赖项并运行yarn native来启动 Metro 打包器。在 Android Studio 中运行你的 android 应用程序,它应该从开发服务器加载 JavaScript 代码并将其显示在 Activity 的 React Native Fragment 中。

6. 附加设置 - 原生模块

你可能需要从你的 react 组件调用现有的 Java/Kotlin 代码。原生模块允许你调用原生代码并在原生应用中运行方法。按照此处进行设置。