Home | History | Annotate | Download | only in tvremote
      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.