Deprecate NativeModule.onCatalystInstanceDestroy()

Summary:
## Rationale
The CatalystInstance is going away after we delete the bridge. So, we should migrate away from onCatalystInstanceDestroy() to something else: invalidate().

## Changes
- Introduce the NativeModule.invalidate() cleanup hook.
- Both the NativeModule and TurboModule infra now call this invalidate() method, **as opposed to** onCatalystInstanceDestroy(), to perform NativeModule cleanup.
- **Is this safe?** All our NativeModules extend BaseJavaModule. BaseJavaModule.invalidate() delegates to NativeModule.onCatalystInstanceDestroy(), so NativeModules that implement onCatalystInstanceDestroy(), but not invalidate(), still have their onCatalystInstanceDestroy() method called.

Changelog: [Android][Deprecated] - Deprecate NativeModule.onCatalystInstanceDestroy() for NativeModule.invalidate()

Reviewed By: JoshuaGross

Differential Revision: D26871001

fbshipit-source-id: e3bdfa0cf653ecbfe42791631bc6229af62f4817

ReactAndroid/src/main/java/com/facebook/react/bridge/BaseJavaModule.java

@@ -61,16 +61,18 @@ public boolean canOverrideExistingModule() {
   }
 
   @Override
-  public void onCatalystInstanceDestroy() {
-    // do nothing
-  }
+  public void onCatalystInstanceDestroy() {}
 
   public boolean hasConstants() {
     return false;
   }
 
-  // Cleanup Logic for TurboModules
+  /**
+   * The CatalystInstance is going away with Venice. Therefore, the TurboModule infra introduces the
+   * invalidate() method to allow NativeModules to clean up after themselves.
+   */
+  @Override
   public void invalidate() {
-    // Do nothing
+    onCatalystInstanceDestroy();
   }
 }

ReactAndroid/src/main/java/com/facebook/react/bridge/CxxModuleWrapperBase.java

@@ -38,7 +38,10 @@ public boolean canOverrideExistingModule() {
   }
 
   @Override
-  public void onCatalystInstanceDestroy() {
+  public void onCatalystInstanceDestroy() {}
+
+  @Override
+  public void invalidate() {
     mHybridData.resetNative();
   }
 

ReactAndroid/src/main/java/com/facebook/react/bridge/ModuleHolder.java

@@ -107,7 +107,7 @@ public ModuleHolder(NativeModule nativeModule) {
 
   public synchronized void destroy() {
     if (mModule != null) {
-      mModule.onCatalystInstanceDestroy();
+      mModule.invalidate();
     }
   }
 

ReactAndroid/src/main/java/com/facebook/react/bridge/NativeModule.java

@@ -47,6 +47,13 @@ interface NativeMethod {
    */
   boolean canOverrideExistingModule();
 
-  /** Called before {CatalystInstance#onHostDestroy} */
+  /**
+   * Allow NativeModule to clean up. Called before {CatalystInstance#onHostDestroy}
+   *
+   * @deprecated use {@link #invalidate()} instead.
+   */
   void onCatalystInstanceDestroy();
+
+  /** Allow NativeModule to clean up. Called before {CatalystInstance#onHostDestroy} */
+  void invalidate();
 }

ReactAndroid/src/main/java/com/facebook/react/turbomodule/core/TurboModuleManager.java

@@ -326,8 +326,7 @@ public void onCatalystInstanceDestroy() {
       final TurboModule turboModule = getModule(moduleName, moduleHolder, false);
 
       if (turboModule != null) {
-        // TODO(T48014458): Rename this to invalidate()
-        ((NativeModule) turboModule).onCatalystInstanceDestroy();
+        turboModule.invalidate();
       }
     }