libbinder_ndk: warn on AIBinder_markVintfStability

This API should simply not be called by someone in Android - it's called
by the AIDL compiler, and it is not exposed to apps (it is only for
platform developers).

Bug: N/A
Test: N/A
Change-Id: Ib2c597e6bdcf125781fecd34cdd490e8e5c4e195

1 files changed, 6 insertions, 0 deletions

diff --git a/libs/binder/ndk/include_platform/android/binder_stability.h b/libs/binder/ndk/include_platform/android/binder_stability.h
index ce7255e174..c23716c778 100644
--- a/libs/binder/ndk/include_platform/android/binder_stability.h
+++ b/libs/binder/ndk/include_platform/android/binder_stability.h
@@ -65,6 +65,12 @@ static inline void AIBinder_markCompilationUnitStability(AIBinder* binder) {
 #endif  // defined(__ANDROID_VENDOR__)
 
 /**
+ * WARNING: this is not expected to be used manually. When the build system has
+ * versioned checks in place for an interface that prevent it being changed year
+ * over year (specifically like those for @VintfStability stable AIDL
+ * interfaces), this could be called. Calling this without this or equivalent
+ * infrastructure will lead to de facto frozen APIs or GSI test failures.
+ *
  * This interface has system<->vendor stability
  */
 void AIBinder_markVintfStability(AIBinder* binder);