Home | History | Annotate | Download | only in signer
      1 This library (com.android.mediadrm.signer.jar) is a shared java library
      2 containing classes required by unbundled apps running on devices that use
      3 the certficate provisioning and private key signing capabilities provided
      4 by the MediaDrm API.
      5 
      6 --- Rules of this library ---
      7 o This library is effectively a PUBLIC API for unbundled CAST receivers
      8   that may be distributed outside the system image. So it MUST BE API STABLE.
      9   You can add but not remove. The rules are the same as for the
     10   public platform SDK API.
     11 o This library can see and instantiate internal platform classes, but it must not
     12   expose them in any public method (or by extending them via inheritance). This would
     13   break clients of the library because they cannot see the internal platform classes.
     14 
     15 This library is distributed in the system image, and loaded as
     16 a shared library. So you can change the implementation, but not
     17 the interface. In this way it is like framework.jar.
     18 
     19 --- Why does this library exist? ---
     20 
     21 Unbundled apps cannot use internal platform classes.
     22 
     23 This library will eventually be replaced when the provisioned certificate-
     24 based signing infrastructure that is currently defined in the support library
     25 is reintegrated with the framework in a new API.  That API isn't ready yet so
     26 this library is a compromise to make new capabilities available to the system
     27 without exposing the full surface area of the support library.
     28 
     29