Fix: [Android] Flipper Leakcanary plugin's OnHeapAnalyzedListener has been deprecated (#3923)

Summary:
Flipper Leakcanary plugin's OnHeapAnalyzedListener has been deprecated.

Flipper Leakcanary plugin's OnHeapAnalyzedListener has been deprecated change to EventListener implement.

## Changelog

1. add FlipperLeakEventListener.kt to implement EventListener.
2. update doc

Pull Request resolved: https://github.com/facebook/flipper/pull/3923

Test Plan:
Setup the  Leakcanary plugin use FlipperLeakEventListener, test if it works.

**Static Docs Preview: flipper**
|[Full Site](https://our.intern.facebook.com/intern/staticdocs/eph/D39652084/V4/flipper/)|

|**Modified Pages**|

Reviewed By: antonk52

Differential Revision: D39652084

Pulled By: antonk52

fbshipit-source-id: 0afeb52dce6c1749a894a15dbb7921580c094ae6

android/plugins/leakcanary2/src/main/java/com/facebook/flipper/plugins/leakcanary2/FlipperLeakEventListener.kt

@@ -0,0 +1,45 @@
+/*
+ * 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.flipper.plugins.leakcanary2
+
+import com.facebook.flipper.android.AndroidFlipperClient
+import leakcanary.EventListener
+import shark.HeapAnalysis
+import shark.HeapAnalysisSuccess
+
+class FlipperLeakEventListener : EventListener {
+  private val leaks: MutableList<Leak> = mutableListOf()
+
+  override fun onEvent(event: EventListener.Event) {
+    if (event is EventListener.Event.HeapAnalysisDone.HeapAnalysisSucceeded) {
+      val heapAnalysis = event.heapAnalysis
+      leaks.addAll(heapAnalysis.toLeakList())
+
+      AndroidFlipperClient.getInstanceIfInitialized()?.let { client ->
+        (client.getPlugin(LeakCanary2FlipperPlugin.ID) as? LeakCanary2FlipperPlugin)?.reportLeaks(
+            leaks)
+      }
+    }
+  }
+
+  private fun HeapAnalysis.toLeakList(): List<Leak> {
+    return if (this is HeapAnalysisSuccess) {
+      allLeaks
+          .mapNotNull {
+            if (it.leakTraces.isNotEmpty()) {
+              it.leakTraces[0].toLeak(it.shortDescription)
+            } else {
+              null
+            }
+          }
+          .toList()
+    } else {
+      emptyList()
+    }
+  }
+}

android/plugins/leakcanary2/src/main/java/com/facebook/flipper/plugins/leakcanary2/FlipperLeakListener.kt

@@ -13,6 +13,7 @@ import leakcanary.OnHeapAnalyzedListener
 import shark.HeapAnalysis
 import shark.HeapAnalysisSuccess
 
+@Deprecated("Use FlipperLeakEventListener add to LeakCanary.config.eventListeners instead")
 class FlipperLeakListener : OnHeapAnalyzedListener {
   private val leaks: MutableList<Leak> = mutableListOf()