commit 27fd7fd7bacbb9b9620404bde7c7412f27b35ddb
author Jiyong Park <jiyong@google.com> Thu Aug 27 16:25:09 2020 +0900
committer Treehugger Robot <treehugger-gerrit@google.com> Mon Aug 31 06:05:25 2020 +0000
tree 236d1ae585543b561853ac6f1f869e9490c61160
parent 693e673dcb05b9c205f25b691bdad265f9831c7c

Descriptor annotation is added

The descriptor annotation allows the author of an AIDL interface to
override the interface descriptor token which by default is set to the
fully qualified name of the interface. For example,

package android.foo;

@Descriptor(value="android.bar.IWorld")
interface IHello {...}

The descriptor of the above interface is "android.bar.IWorld". If the
Descriptor annotation was missing, it would have been
"android.foo.IHello".

This would be useful when an already published interface has to be
renamed. By making the descriptor of the renamed interface to be the
descriptor of the interface before the renaiming, the interfaces -
before and after the renaming - can talk to each other.

Bug: 165712106
Test: atest aidl_unittests
Test: atest aidl_integration_test
Change-Id: I9cee8d883925f4d53adde4a131af450fb689b269

aidl_language.h

diff --git a/aidl_language.h b/aidl_language.h
index 74ef07d..64a8a0f 100644
--- a/aidl_language.h
+++ b/aidl_language.h
@@ -168,6 +168,7 @@
     JAVA_DEBUG,
     JAVA_ONLY_IMMUTABLE,
     FIXED_SIZE,
+    DESCRIPTOR,
   };
   static std::string TypeToString(Type type);
 
@@ -236,6 +237,7 @@
   bool IsStableApiParcelable(Options::Language lang) const;
   bool IsHide() const;
   bool IsJavaDebug() const;
+  std::string GetDescriptor() const;
 
   void DumpAnnotations(CodeWriter* writer) const;
 
@@ -872,6 +874,8 @@
   bool LanguageSpecificCheckValid(const AidlTypenames& typenames,
                                   Options::Language lang) const override;
 
+  std::string GetDescriptor() const;
+
  private:
   std::vector<std::unique_ptr<AidlMethod>> methods_;
   std::vector<std::unique_ptr<AidlConstantDeclaration>> constants_;