Saltar al contenido

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.

  1. 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.
  2. 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.
  3. 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.
NotaLas versiones anteriores de Deska abren un correo desde Pedir permiso para publicar. Escribir a [email protected] contando qué estás construyendo sigue funcionando.

Publicar una versión

  1. Carga la carpeta en Crear un panel y asegúrate de que pase, en los dos temas.
  2. Abre la página de la carpeta y pulsa Publicar.
  3. 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.
  4. 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 version en 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ímiteValor
Paquete5 MB comprimido, 20 MB y 500 archivos desempacado
Publicaciones10 por minuto y 50 al día por cuenta
Versiones100 por panel
Qué cambió1,000 caracteres, con saltos de línea
NombresNinguna 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ódigoSignificadoQué hacer
invalid_packageEl 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_existsEsta versión ya está publicada, o no es mayor que la última.Sube la versión en panel.json.
not_ownerOtra cuenta publica un panel con este id.Elige otro id.
publishing_closedTu cuenta todavía no puede publicar.Haz tu solicitud en deska.dev/panels/apply.
signed_outDeska no tiene sesión iniciada.Inicia sesión y vuelve a intentar.
too_largeEl zip pasa de 5 MB.Deja fuera lo que el panel no carga.
rate_limitedDemasiadas publicaciones en poco tiempo.Espera unos minutos.
version_limitEl panel tiene 100 versiones.Escribe a [email protected] para limpiar las viejas.
suspendedDeska retiró este panel, así que no acepta versiones nuevas.Escribe a [email protected].
server_errordeska.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.