| Jeff Brown | f3c99e8 | 2013-11-05 16:29:21 -0800 | [diff] [blame] | 1 | This library (com.android.media.remotedisplay.jar) is a shared java library |
| 2 | containing classes required by unbundled remote display providers. |
| 3 | |
| 4 | --- Rules of this library --- |
| 5 | o This library is effectively a PUBLIC API for unbundled remote display providers |
| 6 | that may be distributed outside the system image. So it MUST BE API STABLE. |
| 7 | You can add but not remove. The rules are the same as for the |
| 8 | public platform SDK API. |
| 9 | o This library can see and instantiate internal platform classes, but it must not |
| 10 | expose them in any public method (or by extending them via inheritance). This would |
| 11 | break clients of the library because they cannot see the internal platform classes. |
| 12 | |
| 13 | This library is distributed in the system image, and loaded as |
| 14 | a shared library. So you can change the implementation, but not |
| 15 | the interface. In this way it is like framework.jar. |
| 16 | |
| 17 | --- Why does this library exists? --- |
| 18 | |
| 19 | Unbundled remote display providers (such as Cast) cannot use internal |
| 20 | platform classes. |
| 21 | |
| 22 | This library will eventually be replaced when the media route provider |
| 23 | infrastructure that is currently defined in the support library is reintegrated |
| 24 | with the framework in a new API. That API isn't ready yet so this |
| 25 | library is a compromise to make new capabilities available to the system |
| 26 | without exposing the full surface area of the support library media |
| 27 | route provider protocol. |
| 28 | |