| Sujith Ramakrishnan | b5b86c1 | 2016-01-28 16:53:16 -0800 | [diff] [blame] | 1 | This library (com.android.media.tv.remoteprovider.jar) is a shared java library |
| 2 | containing classes required by unbundled atv remote providers. |
| 3 | |
| 4 | --- Rules of this library --- |
| 5 | o This library is effectively a System API for unbundled emote service provider |
| 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 exist? --- |
| 18 | |
| 19 | Unbundled atv remote providers (such as Emote app) cannot use internal |
| 20 | platform classes. |
| 21 | |
| 22 | This library will eventually be replaced when the inputmanager |
| 23 | infrastructure is ready with APIs allowing unbundled system apps to |
| 24 | inject events into uhid. |
| 25 | That API isn't ready yet so this library is a compromise to |
| 26 | make new capabilities available to the system. |