Plugins que vienen instalados¶
Kino instala por su cuenta unos pocos plugins en cada aparato, sin que la persona pase por la tienda y sin llevarlos dentro
del APK. Hoy son Kino Social y Solo noticias. La lista es un archivo, default-plugins.json, que Kino mantiene en
el repositorio público kinotvapp/kino-plugins, junto a la lista de bloqueo de la comunidad. Esta página cuenta cómo es ese
archivo y qué hace la app con él; no es una forma de que tu plugin venga instalado: la lista la publica solo Kino.
Dónde se lee¶
La app lee el archivo de GitHub (raw.githubusercontent.com/kinotvapp/kino-plugins/main/default-plugins.json) y, si falla,
de la copia de jsDelivr (cdn.jsdelivr.net/gh/kinotvapp/kino-plugins@main/default-plugins.json). Los dos son destinos que
Kino ya usa: no hay un destino de red nuevo. Guarda una copia en el aparato y la refresca como mucho cada 12 horas, con una
espera de 3 horas tras un intento fallido.
Límites: 64 KB, 100 entradas y "schema": 1.
El formato¶
{
"schema": 1,
"plugins": [
{ "id": "kino-social", "repo": "kinotvapp/kino-social" },
{ "id": "news", "repo": "kinotvapp/kino-plugin-news", "required": false }
]
}
id(obligatorio): eliddel manifiesto del plugin (^[a-z0-9][a-z0-9-]{1,39}$, y no uno de los nombres reservados). Sirve para decidir sin red y antes de descargar nada si el plugin está instalado o la persona lo quitó; tras la vista previa, la instalación se rechaza si eliddel manifiesto es otro.repo(obligatorio): elowner/reposimple desde el que se instala (sin URL y sin@ref).required(opcional): contruese oculta Desinstalar y se rechaza toda desinstalación (la pantalla, el registro y la desinstalación sincronizada desde otro aparato); el plugin sí se puede apagar. Solo una entrada que diga"required": falselo quita de nuevo; una entrada sin el campo, o un plugin que ya no está en el archivo, nunca lo quita.- Los campos desconocidos se ignoran. Una entrada que rompe una regla de arriba (o repite un
idanterior) se salta y se reporta una vez. Un archivo que no es JSON, de otro esquema o sin un arreglopluginsse ignora entero y sigue usándose la copia guardada.
Qué hace Kino con la lista¶
En cada arranque (después de decidir si restaura, y sin retrasarlo) y en la ronda de actualización de 12 horas, para cada entrada y en orden:
- Un plugin con ese
idque ya está instalado (en cualquier estado) es de la persona: solo la marcarequiredsigue a la entrada (se pone cuando el repositorio listado trae el plugin firmado por Kino). - Uno que la persona quitó, en este aparato o en otro suyo (una desinstalación sincronizada), no se instala nunca más.
- Un repositorio que la lista de retiro de la comunidad da de baja se salta.
- El plugin tiene que estar firmado con la llave de autor de Kino (huella 07DA-B67F-2ACF-B4D3) y leerse de su repositorio de GitHub; cualquier otra cosa se rechaza. El archivo no va firmado a propósito, como la lista de retiro: un archivo manipulado solo puede instalar plugins que Kino firmó.
- Se instala en silencio (sin hoja de consentimiento ni aviso), con su manifiesto aprobado completo y la telemetría sin consentimiento, y queda registrado en la sincronización de plugins como cualquier instalación.
Quitar una entrada no desinstala nada. Un fallo (sin red, una vista previa rechazada) se reintenta en la ronda siguiente.
Las dos entradas de hoy¶
| Plugin | id |
repo |
|---|---|---|
| Kino Social | kino-social |
kinotvapp/kino-social |
| Noticias («Solo noticias» en el catálogo) | news |
kinotvapp/kino-plugin-news |
Los dos se pueden desinstalar y apagar (ninguno lleva required).
Publicarla (lo hace Kino)¶
- Se edita
default-plugins.jsonen la raíz dekinotvapp/kino-plugins(main) y se hace push. Todo plugin listado tiene que estar ya publicado y firmado con la llave de autor de Kino, o los aparatos lo rechazan. - jsDelivr puede servir la copia anterior un rato; GitHub se lee primero.
- Los aparatos la recogen en su próximo arranque o ronda de 12 horas. Para retirar uno de los plugins por defecto se quita su entrada: los aparatos que ya lo tienen lo conservan.
Para tu propio plugin, el camino es aparecer en Kino o una tienda de plugins.