Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Add <p> to UnsupportedAppUsage javadoc."

Browse Source
This commit is contained in:
Treehugger Robot
2018-08-28 15:30:29 +00:00
committed by Gerrit Code Review
parent 0589adc790 8ea8654bae
commit dfd7bc77c3
1 changed files with 8 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
core/java/android/annotation/UnsupportedAppUsage.java
View File

@@ -27,15 +27,15 @@ import java.lang.annotation.Target;
* Indicates that a class member, that is not part of the SDK, is used by apps. * Indicates that a class member, that is not part of the SDK, is used by apps.
* Since the member is not part of the SDK, such use is not supported. * Since the member is not part of the SDK, such use is not supported.
* *
* This annotation acts as a heads up that changing a given method or field * <p>This annotation acts as a heads up that changing a given method or field
* may affect apps, potentially breaking them when the next Android version is * may affect apps, potentially breaking them when the next Android version is
* released. In some cases, for members that are heavily used, this annotation * released. In some cases, for members that are heavily used, this annotation
* may imply restrictions on changes to the member. * may imply restrictions on changes to the member.
* *
* This annotation also results in access to the member being permitted by the * <p>This annotation also results in access to the member being permitted by the
* runtime, with a warning being generated in debug builds. * runtime, with a warning being generated in debug builds.
* *
* For more details, see go/UnsupportedAppUsage. * <p>For more details, see go/UnsupportedAppUsage.
* *
* {@hide} * {@hide}
*/ */
@@ -53,15 +53,15 @@ public @interface UnsupportedAppUsage {
/** /**
* Indicates that usage of this API is limited to apps based on their target SDK version. * Indicates that usage of this API is limited to apps based on their target SDK version.
* *
* Access to the API is allowed if the targetSdkVersion in the apps manifest is no greater than * <p>Access to the API is allowed if the targetSdkVersion in the apps manifest is no greater
* this value. Access checks are performed at runtime. * than this value. Access checks are performed at runtime.
* *
* This is used to give app developers a grace period to migrate off a non-SDK interface. When * <p>This is used to give app developers a grace period to migrate off a non-SDK interface.
* making Android version N, existing APIs can have a maxTargetSdk of N-1 added to them. * When making Android version N, existing APIs can have a maxTargetSdk of N-1 added to them.
* Developers must then migrate off the API when their app is updated in future, but it will * Developers must then migrate off the API when their app is updated in future, but it will
* continue working in the meantime. * continue working in the meantime.
* *
* Possible values are: * <p>Possible values are:
* <ul> * <ul>
* <li> * <li>
* {@link android.os.Build.VERSION_CODES#O} or {@link android.os.Build.VERSION_CODES#P}, * {@link android.os.Build.VERSION_CODES#O} or {@link android.os.Build.VERSION_CODES#P},