Skip to content

Commit

Permalink
Expand @UnstableApi javadoc with how to request stable API additions
Browse files Browse the repository at this point in the history
Issue: androidx#503

#minor-release

PiperOrigin-RevId: 547143885
  • Loading branch information
icbaker authored and rohitjoins committed Jul 13, 2023
1 parent f657fa8 commit 2afcf99
Showing 1 changed file with 9 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,15 @@
* work during upgrades. However it is generally inadvisable for libraries (which get included on
* users' CLASSPATHs, outside the library developers' control) to do so.
*
* <h2>Requesting additions to the stable API</h2>
*
* The Media3 stable API (i.e. those public API symbols that are not annotated with this annotation)
* is designed to allow developers to achieve common media-related tasks. If you have a use-case
* that you are unable to achieve using the stable API, and think you should be able to, please file
* an issue on our <a href="https://github.com/androidx/media/issues">GitHub issue tracker</a> with
* the full context of what you're doing, and what symbols you would need to be part of the stable
* API. We will consider each request on a case-by-case basis.
*
* <h2>Opting in to use unstable APIs</h2>
*
* <p>By default usages of APIs annotated with this annotation generate lint errors in Gradle and
Expand Down

0 comments on commit 2afcf99

Please sign in to comment.