原生模块生命周期

在 React Native 中，原生模块是单例。原生模块基础设施在第一次被访问时才懒加载创建一个原生模块，并且只要应用需要它，就会一直保留它。这是一种性能优化，可以避免在应用启动时急切创建原生模块的开销，并确保更快的启动时间。

在纯 React Native 应用中，原生模块只会创建一次，并且永远不会被销毁。然而，在更复杂的应用中，可能会有需要销毁并重新创建原生模块的场景。比如，设想一个 brownfield 应用，它将一些原生视图与一些 React Native 界面混合在一起，如与现有应用集成指南中所示。在这种情况下，当用户离开某个 React Native 界面时，销毁一个 React Native 实例，并在用户返回该界面时重新创建它，可能是合理的。

当这种情况发生时，无状态的原生模块不会引起任何问题。然而，对于有状态的原生模块，可能有必要正确地使原生模块失效，以确保状态被重置，并且资源被释放。

在本指南中，你将了解如何正确初始化和使一个原生模块失效。本指南假设你已经熟悉如何编写原生模块，并且能够熟练编写原生代码。如果你还不熟悉原生模块，请先阅读原生模块指南。

Android

在 Android 中，所有原生模块都已经实现了一个 TurboModule 接口，该接口定义了两个方法：initialize() 和 invalidate()。

initialize() 方法会在原生模块被创建时由原生模块基础设施调用。这是放置所有需要访问 ReactApplicationContext 的初始化代码的最佳位置。例如，以下是 core 中实现了 initialize() 方法的一些原生模块：BlobModule、NetworkingModule。

invalidate() 方法会在原生模块被销毁时由原生模块基础设施调用。这是放置所有清理代码的最佳位置，用于重置原生模块状态并释放不再需要的资源，例如内存和文件。以下是 core 中实现了 invalidate() 方法的一些原生模块：DeviceInfoModule、NetworkModule

iOS

在 iOS 上，原生模块符合 RCTTurboModule 协议。然而，该协议并不暴露 Android 的 TurboModule 类所暴露的 initialize 和 invalidate 方法。

取而代之的是，在 iOS 上有两个额外的协议：RCTInitializing 和 RCTInvalidating。这些协议分别用于定义 initialize 和 invalidate 方法。

如果你的模块需要运行一些初始化代码，那么你可以符合 RCTInitializing 协议并实现 initialize 方法。为此，你需要：

修改 NativeModule.h 文件，添加以下行：

NativeModule.h
+ #import <React/RCTInitializing.h>

//...

- @interface NativeModule : NSObject <NativeModuleSpec>
+ @interface NativeModule : NSObject <NativeModuleSpec, RCTInitializing>
//...
@end

在 NativeModule.mm 文件中实现 initialize 方法：

NativeModule.mm
// ...

@implementation NativeModule

+- (void)initialize {
+ // 在这里添加初始化代码
+}

@end

以下是 core 中实现了 initialize 方法的一些原生模块：RCTBlobManager、RCTTiming。

如果你的模块需要运行一些清理代码，那么你可以符合 RCTInvalidating 协议并实现 invalidate 方法。为此，你需要：

修改 NativeModule.h 文件，添加以下行：

NativeModule.h
+ #import <React/RCTInvalidating.h>

//...

- @interface NativeModule : NSObject <NativeModuleSpec>
+ @interface NativeModule : NSObject <NativeModuleSpec, RCTInvalidating>

//...

@end

在 NativeModule.mm 文件中实现 invalidate 方法：

NativeModule.mm

// ...

@implementation NativeModule

+- (void)invalidate {
+ // 在这里添加清理代码
+}

@end

以下是 core 中实现了 invalidate 方法的一些原生模块：RCTAppearance、RCTDeviceInfo。

Android​

iOS​

Android

iOS