Merge "Add rules about documenting JNI exceptions." into main
diff --git a/api-guidelines/ndk.md b/api-guidelines/ndk.md
index 66fb6e0..873e36a 100644
--- a/api-guidelines/ndk.md
+++ b/api-guidelines/ndk.md
@@ -313,6 +313,11 @@
number instead of the codename since that's what users need to know for
their build.gradle files. Non-NDK APIs should consider doing this as well.
+8. Potential pending exceptions should be limited to runtime issues such as
+ `OutOfMemory``or`ClassCastException`` unless clearly documented what the
+ other potential exceptions are and why they may occur (see also:
+ go/android-api-guidelines#throws )
+
## ABI stability guidelines <a name="abi-stability"></a>
### Prefer opaque structs <a name="opaque-structs"></a>
@@ -563,6 +568,12 @@
This helps apps to keep a clean JNI layer in their own code.
+### JNI interop APIs should not clear pending exceptions
+
+Any exceptions thrown should be left pending for the caller to handle. Most
+potential pending exceptions types must be documented. See
+go/android-ndk-api-guidelines#well-documented.
+
## Inlines <a name="inlines"></a>
### Inline functions may be used for simple wrappers <a name="inline-wrappers"></a>
