Crear paneles
Publicar
Pide acceso, publica una versión desde Deska y cuídala: versiones que nunca cambian, permisos que se vuelven a preguntar, ocultar un panel, retiros y límites.
Quién puede publicar
Cualquiera puede construir y cargar un panel. Publicarlo, para que otras personas lo encuentren en Descubrir y en deska.dev/panels, por ahora está abierto a autores invitados.
- Haz tu solicitud. Inicia sesión y llena el formulario en deska.dev/panels/apply: qué quieres construir, un enlace a un repositorio o un prototipo si lo tienes, los permisos y sitios que necesita y por qué, y tu usuario de GitHub si quieres. Pedir permiso para publicar en Crear un panel lleva al mismo lugar.
- Espera la respuesta. Respondemos en unos días. Tu página de cuenta muestra que la solicitud se envió y cuándo. Hay una solicitud abierta a la vez; después de una respuesta puedes volver a solicitar.
- Publica desde Deska. Cuando aprueben tu cuenta, puedes publicar desde cualquier Deska con esa cuenta. Deska lee el cambio al iniciar, al iniciar sesión y cuando su ventana recibe el foco.
Publicar una versión
- Carga la carpeta en Crear un panel y asegúrate de que pase, en los dos temas.
- Abre la página de la carpeta y pulsa Publicar.
- Escribe qué cambió, hasta 1,000 caracteres, y revisa lo que se va a publicar: la versión, el nombre que la gente ve como autor, los permisos y los sitios.
- Confirma. Deska comprime la carpeta (siempre en los mismos bytes para los mismos archivos) y la revisa, y deska.dev la vuelve a revisar cuando llega. Cuando queda publicada, Deska ofrece abrir la página del panel.
Al publicar, confirmas que tienes derecho a compartir el panel, y dejas que Deska lo guarde, se lo envíe a quienes lo instalan y lo retire.
Versiones
- La primera versión reserva el id del panel para tu cuenta. Solo tú puedes publicar más versiones con él.
- Una versión publicada nunca cambia. Para cambiar algo, sube
versionen panel.json y publica otra vez. Cada versión nueva debe ser mayor que la anterior. - El nombre, la descripción, el autor, la categoría, el color y el ícono que ve la gente salen del panel.json de la versión más nueva. No hay otra forma de cambiarlos.
- Quienes instalaron el panel ven Actualizar a la versión nueva. Actualizar recarga las copias abiertas, y el panel conserva lo que guardó.
- Una versión que pide un SDK más nuevo que el Deska de alguien aparece como que necesita un Deska más nuevo y nunca se le ofrece.
Permisos y sitios, preguntados de nuevo
Los permisos y los sitios pertenecen a cada versión. A quien instaló una anterior se le vuelve a preguntar antes de una actualización que pida un permiso o un sitio que no había permitido, y la pregunta nombra cada sitio nuevo. Hasta que acepte, conserva la versión que tiene.
Así que pide lo mínimo que funcione desde la primera versión, y agrega un permiso solo con una función que lo necesite. Explica por qué en las notas de la versión.
Ocultar y administrar
La sección Paneles de la comunidad de tu página de cuenta muestra cada panel que publicaste, con sus versiones y cuántas cuentas lo instalaron.
- Ocultar saca un panel de Descubrir y de deska.dev. Las computadoras que lo instalaron lo conservan y siguen recibiendo sus actualizaciones. Volver a mostrarlo requiere una cuenta que pueda publicar.
- Si tu cuenta deja de poder publicar, lo que publicaste sigue en la lista y todavía puedes ocultarlo.
- Si borras tu cuenta, tus paneles salen de Descubrir. Las computadoras que los instalaron los conservan.
Deska revisa cada versión cuando llega y puede retirar un panel, o una versión, que rompa las reglas. Un panel retirado deja de cargar en cada computadora que lo tiene y dice que Deska lo quitó; las computadoras buscan retiros al iniciar Deska y cada seis horas.
Límites
| Límite | Valor |
|---|---|
| Paquete | 5 MB comprimido, 20 MB y 500 archivos desempacado |
| Publicaciones | 10 por minuto y 50 al día por cuenta |
| Versiones | 100 por panel |
| Qué cambió | 1,000 caracteres, con saltos de línea |
| Nombres | Ninguna palabra que se lea como Deska o Dex en el nombre, el autor o el título de Extras |
Cuando publicar falla
No se publica nada si una revisión falla. Deska muestra uno de estos códigos, con los problemas:
| Código | Significado | Qué hacer |
|---|---|---|
invalid_package | El paquete no pasa las revisiones, o un nombre se lee como Deska. | Corrige cada problema de la lista; consulta la referencia de panel.json. |
version_exists | Esta versión ya está publicada, o no es mayor que la última. | Sube la versión en panel.json. |
not_owner | Otra cuenta publica un panel con este id. | Elige otro id. |
publishing_closed | Tu cuenta todavía no puede publicar. | Haz tu solicitud en deska.dev/panels/apply. |
signed_out | Deska no tiene sesión iniciada. | Inicia sesión y vuelve a intentar. |
too_large | El zip pasa de 5 MB. | Deja fuera lo que el panel no carga. |
rate_limited | Demasiadas publicaciones en poco tiempo. | Espera unos minutos. |
version_limit | El panel tiene 100 versiones. | Escribe a [email protected] para limpiar las viejas. |
suspended | Deska retiró este panel, así que no acepta versiones nuevas. | Escribe a [email protected]. |
server_error | deska.dev no pudo recibir el paquete en este momento. | Vuelve a intentar en un momento. |
Antes de publicar
- La carpeta pasa en Deska sin problemas, no solo en la vista previa.
- Se ve bien en un tema oscuro y en uno claro, y con otro acento.
- Maneja la falta de conexión, un host lento, el primer uso vacío y el almacenamiento lleno.
- Detiene su trabajo mientras está oculto y vuelve bien después de una recarga.
- Pide solo los permisos y sitios que usa.
- Da crédito a los datos y medios que muestra, según sus licencias.
- El nombre, la descripción y el autor dicen con claridad qué es y quién lo hizo.