summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTreehugger Robot <android-test-infra-autosubmit@system.gserviceaccount.com>2024-05-16 12:03:08 +0000
committerGerrit Code Review <noreply-gerritcodereview@google.com>2024-05-16 12:03:08 +0000
commit8e31b1f60bba9ab9e63d0b9c17a879c0e8fab76a (patch)
tree01062dd7d76d7b68fa10a9c8fd2e804da674933e
parentb4d06097a6ce837e9a34fe9a1b31327136736efa (diff)
parentfc92125dd4086eec5733a9e7b26a7fc9d6a1d5da (diff)
downloaddocs-master.tar.gz
Merge "Libraries don't use @hide anymore" into mainHEADmastermain
-rw-r--r--api-guidelines/framework.md11
1 files changed, 5 insertions, 6 deletions
diff --git a/api-guidelines/framework.md b/api-guidelines/framework.md
index 5464a53..6e879fb 100644
--- a/api-guidelines/framework.md
+++ b/api-guidelines/framework.md
@@ -182,13 +182,12 @@ APIs themselves, the compiler inlines the constants and only the (now useless)
values remain in the annotation's API stub (for the platform) or JAR (for
libraries).
-As such, usages of these annotations must be marked `@hide` in the platform or
-`@hide` and `RestrictTo.Scope.LIBRARY)` in libraries. They must be marked
-`@Retention(RetentionPolicy.SOURCE)` in both cases to ensure they do not appear
-in API stubs or JARs.
+As such, usages of these annotations must be marked with the `@hide` docs
+annotation in the platform or `@RestrictTo.Scope.LIBRARY)` code annotation in
+libraries. They must be marked `@Retention(RetentionPolicy.SOURCE)` in both
+cases to ensure they do not appear in API stubs or JARs.
```java
-/** @hide */
@RestrictTo(RestrictTo.Scope.LIBRARY)
@Retention(RetentionPolicy.SOURCE)
@IntDef({
@@ -346,4 +345,4 @@ best-practices that should be considered:
`ACTION_MEDIA_BUTTON` uses this design to focus on the current app handling
playback controls.
* If possible, define your broadcast as a `<protected-broadcast>` to ensure
- that malicious apps can't impersonate the OS. \ No newline at end of file
+ that malicious apps can't impersonate the OS.