Google Git
Sign in
fuchsia / third_party / android / platform / system / tools / aidl / a01f479ef076d104d191e2fd985eaa6437abda14
commita01f479ef076d104d191e2fd985eaa6437abda14[log] [tgz]
authorSteven Moreland <smoreland@google.com>Tue Apr 18 16:28:47 2023 +0000
committerTreehugger Robot <android-test-infra-autosubmit@system.gserviceaccount.com>Wed Apr 19 21:08:09 2023 +0000
tree7455c097f3ca9f69e83c5cb6a6cd450e326dc960
parent2c596b002883265dae2b51caf87e83a087d400a0 [diff]
AIDL: restrict visibility of internals

Using these APIs would freeze the internal
structure of the AIDL compiler, which would
restrict development here and is strictly not
required to do anything. It's always possible
not to do this and use the other surfaces
AIDL maintains instead.

The API surfaces that AIDL maintains are:
- (squishy) the .aidl files themselves
- (squishy) the backend generated runtime APIs
- (absolute) backcompat over the wire for stable
  AIDL interfaces, or for unchanged AIDL interfaces

The first two there are listed as 'squishy'. It means
that these can be changed without breaking any real
Android systems (only requiring client code to
be updated). We typically do keep these constant,
but in some cases, especially where there are few
known clients, we can make minor changes. One example
(perhaps the most extreme example I can recall) of
this was switching unique_fd to be an rr-value in
the C++ backend for performance reasons.

Bug: N/A
Test: N/A
Change-Id: I94f218cbd5b7fbeb3dc1c487ccf3b3e9697d2854
1 file changed
tree: 7455c097f3ca9f69e83c5cb6a6cd450e326dc960
  1. aidl_api/
  2. analyzer/
  3. build/
  4. metadata/
  5. scripts/
  6. tests/
  7. trace/
  8. .clang-format ⇨ ../../../build/soong/scripts/system-clang-format-2
  9. rustfmt.toml ⇨ ../../../build/soong/scripts/rustfmt.toml
  10. aidl-format.sh
  11. aidl.cpp
  12. aidl.h
  13. aidl_checkapi.cpp
  14. aidl_checkapi.h
  15. aidl_const_expressions.cpp
  16. aidl_dumpapi.cpp
  17. aidl_dumpapi.h
  18. aidl_language.cpp
  19. aidl_language.h
  20. aidl_language_l.ll
  21. aidl_language_y.yy
  22. aidl_to_cpp.cpp
  23. aidl_to_cpp.h
  24. aidl_to_cpp_common.cpp
  25. aidl_to_cpp_common.h
  26. aidl_to_java.cpp
  27. aidl_to_java.h
  28. aidl_to_ndk.cpp
  29. aidl_to_ndk.h
  30. aidl_to_rust.cpp
  31. aidl_to_rust.h
  32. aidl_typenames.cpp
  33. aidl_typenames.h
  34. aidl_unittest.cpp
  35. Android.bp
  36. ast_java.cpp
  37. ast_java.h
  38. ast_java_unittest.cpp
  39. check_valid.cpp
  40. check_valid.h
  41. code_writer.cpp
  42. code_writer.h
  43. code_writer_unittest.cpp
  44. comments.cpp
  45. comments.h
  46. diagnostics.cpp
  47. diagnostics.h
  48. diagnostics.inc
  49. diagnostics_unittest.cpp
  50. generate_aidl_mappings.cpp
  51. generate_aidl_mappings.h
  52. generate_cpp.cpp
  53. generate_cpp.h
  54. generate_cpp_analyzer.cpp
  55. generate_cpp_analyzer.h
  56. generate_cpp_unittest.cpp
  57. generate_java.cpp
  58. generate_java.h
  59. generate_java_binder.cpp
  60. generate_ndk.cpp
  61. generate_ndk.h
  62. generate_rust.cpp
  63. generate_rust.h
  64. hiddenapi-greylist
  65. import_resolver.cpp
  66. import_resolver.h
  67. io_delegate.cpp
  68. io_delegate.h
  69. io_delegate_unittest.cpp
  70. location.cpp
  71. location.h
  72. logging.cpp
  73. logging.h
  74. main.cpp
  75. NOTICE
  76. options.cpp
  77. options.h
  78. options_unittest.cpp
  79. os.h
  80. OWNERS
  81. parser.cpp
  82. parser.h
  83. permission.cpp
  84. permission.h
  85. preprocess.cpp
  86. preprocess.h
  87. PREUPLOAD.cfg
  88. README.md
  89. run_integration_tests.sh
  90. TEST_MAPPING
README.md

Documentation for this project is currently maintained here:

https://source.android.com/devices/architecture/aidl/overview