commit bbcefaede8100dfef243192f504fac0ee3e511fe
author Treehugger Robot <treehugger-gerrit@google.com> Fri Apr 22 01:30:45 2022 +0000
committer Gerrit Code Review <noreply-gerritcodereview@google.com> Fri Apr 22 01:30:45 2022 +0000
tree 1a0e5cf15371cb8aa5b458ab23efe53e5380a066
parent 06fc13cd9946a9476b2be9eaa034fec202723bfd
parent 8d17c4547a43580d96713111622fe0f341dd34e9

Merge "javaObjectForIBinder: warn rets global and local"

libs/binder/ndk/include_ndk/android/binder_ibinder_jni.h

diff --git a/libs/binder/ndk/include_ndk/android/binder_ibinder_jni.h b/libs/binder/ndk/include_ndk/android/binder_ibinder_jni.h
index 6880d86..8e288b3 100644
--- a/libs/binder/ndk/include_ndk/android/binder_ibinder_jni.h
+++ b/libs/binder/ndk/include_ndk/android/binder_ibinder_jni.h
@@ -56,6 +56,12 @@
  * If the binder is null, null is returned. If this binder object was originally an IBinder object,
  * the original java object will be returned.
  *
+ * WARNING: this function returns global and local references. This can be
+ * figured out using GetObjectRefType. Though, when this function is called
+ * from within a Java context, the local ref will automatically be cleaned
+ * up. If this is called outside of a Java frame,
+ * PushObjectFrame/PopObjectFrame can simulate this automatic cleanup.
+ *
  * Available since API level 29.
  *
  * \param env Java environment. Must not be null.