Descripción general
Cada archivo de PicoPixel tiene su propia biblioteca: los colores, fuentes, imágenes, imágenes animadas y componentes que utiliza, reunidos en el panel Assets. Por sí sola, esa biblioteca pertenece a ese único archivo. Publicar el archivo convierte su biblioteca en algo que tus compañeros de equipo pueden reutilizar: vincúlala desde otro archivo y sus recursos aparecerán junto a los de ese archivo.
Esta guía explica qué es una biblioteca, exactamente qué hace Publicar (y, igual de importante, qué no hace), cómo publicar y vincular bibliotecas y dónde encontrarlas. Lo más importante que debes recordar:
Publicar no hace tu trabajo público. Publicar hace que la biblioteca de un archivo sea reutilizable solo por tu equipo: las personas en tu espacio de trabajo de PicoPixel. Nunca se publica en internet, nunca aparece en listados públicos y nunca es visible para nadie fuera de tu equipo. Las únicas formas en que el contenido sale de tu equipo son acciones que tú tomas deliberadamente, explicadas al final de esta guía.
Qué es una biblioteca
Una biblioteca reúne los recursos reutilizables de un archivo. En el panel Assets verás los recursos propios de tu archivo bajo local library: siempre está ahí y se abre de forma predeterminada.
Cuando vinculas otra biblioteca de equipo a tu archivo, aparece como una segunda sección con nombre propio debajo de tu biblioteca local, encabezada por el nombre de archivo de esa biblioteca (por ejemplo, Animation Examples). Una vez vinculada la biblioteca, el panel Assets muestra tanto los recursos propios de tu archivo como los recursos de la biblioteca vinculada, uno al lado del otro, listos para arrastrar.
Imagínalo como dos estantes en el mismo armario: la biblioteca local contiene lo que has creado en este archivo, y cada biblioteca vinculada es un estante prestado de otro archivo de tu equipo. Puedes tomar de cualquiera sin salir de tu diseño.
Qué puede contener una biblioteca
Al publicar una biblioteca, compartes todos los recursos del panel Assets de ese archivo. PicoPixel agrupa los recursos en estas secciones:
- Images, gráficos estáticos que has añadido al archivo.
- Animated images, gráficos animados de múltiples fotogramas.
- Components, widgets LVGL reutilizables (ver más abajo).
- Colors, muestras de color guardadas.
- Fonts, fuentes que has añadido y convertido para su uso en el dispositivo.
Publica el archivo y todos estos recursos se vuelven reutilizables para tu equipo, sin copiar y pegar entre archivos.
Qué es un "componente"
Un componente reúne uno o más widgets para reutilizarlos como una unidad. Puede ser un botón o una etiqueta, o combinar varias capas: por ejemplo, una tarjeta con un título, un icono y un valor. Una vez creado, puedes insertar el conjunto en cualquier pantalla.
Cada componente tiene una instancia principal. Edita la instancia principal y el cambio se propaga a cada copia de ese componente, en todos los lugares donde se usa, incluso en otros archivos que vinculen tu biblioteca. Así mantienes una interfaz coherente: define un control una vez, reutilízalo donde lo necesites y actualízalo desde un único lugar.
Si te encuentras reconstruyendo el mismo pequeño grupo de widgets en varias pantallas —una barra de encabezado, una tarjeta con mediciones, un interruptor con etiqueta— conviene convertirlo en componente. Solo tendrás que crearlo una vez y podrás mantener todas las pantallas actualizadas.
Publicar un archivo como biblioteca
Al publicar un archivo, su biblioteca queda disponible para que otros archivos de tu equipo puedan vincularla.
- Abre el diálogo Libraries. Desde el panel Assets, usa el botón Add library (que pasa a llamarse Manage library una vez que el archivo ya tiene bibliotecas vinculadas o componentes).
- En la pestaña LIBRARIES, busca bajo LIBRARIES IN THIS FILE. Verás File library, que es la biblioteca del archivo actual, con un botón Publish al lado.
- Haz clic en Publish.
El botón cambia a Unpublish, lo que confirma que el archivo es ahora una biblioteca compartida que tu equipo puede vincular. PicoPixel también añade una pequeña insignia de biblioteca al archivo: la verás en la esquina superior derecha del encabezado del espacio de trabajo y en la tarjeta del archivo en el Dashboard, para que sea fácil identificar qué archivos están publicados.
Hacer clic en Unpublish más adelante te pedirá confirmación y luego desvinculará la biblioteca. PicoPixel primero copia los recursos de la biblioteca a todos los archivos que la estaban usando, para que los archivos que dependan de ella conserven sus recursos.
Encontrar las bibliotecas de tu equipo
Las bibliotecas publicadas están reunidas en un solo lugar para todo el equipo.
- Abre el Dashboard.
- En la barra lateral izquierda, bajo Sources, haz clic en Libraries.
Esta página muestra las bibliotecas del equipo que tienes seleccionado. Si cambias de equipo, verás las bibliotecas del nuevo equipo. Es el catálogo que tus compañeros de equipo consultan para ver qué está disponible para reutilizar.
Reutilizar una biblioteca en otro archivo
Una vez publicada una biblioteca, cualquier archivo del equipo puede incorporarla.
- Abre el archivo en el que quieres trabajar.
- En el panel Assets, haz clic en Add library (o Manage library) para abrir el diálogo Libraries.
- En la sección SHARED LIBRARIES, busca la biblioteca que quieres —el campo Search shared libraries ayuda cuando la lista es larga— y haz clic en el + junto a ella para vincularla.
La biblioteca vinculada aparece ahora en tu panel Assets como su propia sección con nombre, debajo de tu biblioteca local. Arrastra sus componentes, imágenes, colores y fuentes directamente a tu diseño.
Mantener una biblioteca vinculada actualizada
Cuando una biblioteca que has vinculado cambia —su propietario edita un componente o ajusta un color—, esas actualizaciones no se aplican automáticamente. La pestaña UPDATES del diálogo Libraries lista las bibliotecas vinculadas con cambios más recientes, y un botón Update los aplica a tu archivo cuando estés listo. Si no ha cambiado nada, la pestaña simplemente te indica que no hay nada que actualizar.
Privacidad de las bibliotecas
Conviene aclarar el significado de Publicar: en este caso, solo compartes la biblioteca con tu equipo.
Publicar una biblioteca la comparte con tu equipo y con nadie más. Para acceder hay que iniciar sesión y pertenecer a tu equipo: no hay enlace público, no hay listado público y no hay forma de que alguien fuera de tu equipo acceda a una biblioteca publicada. "Publicado" significa "disponible para mis compañeros de equipo", punto.
Hay exactamente dos formas en que algo que creas sale de tu equipo, y ambas son cosas que tú eliges hacer:
- Exportas y envías tú mismo un archivo
.picopixel. Desde el menú del espacio de trabajo puedes hacer Export.picopixel, lo que descarga un archivo a tu computadora. Lo que hagas con ese archivo —enviarlo por correo, compartirlo, entregárselo a alguien— es completamente tu decisión y ocurre fuera de PicoPixel. - Envías el contenido al equipo de PicoPixel para su revisión. Si quieres compartir tu diseño con la comunidad de PicoPixel en general, envíalo para revisión en
app.picopixel.io/#/settings/submit-template. El equipo revisa cada envío antes de que se publique algo en la galería de la comunidad. Consulta Cómo enviar una plantilla para saber qué necesita el formulario y los derechos que otorgas.
Al margen de esos dos pasos deliberados, tus archivos y bibliotecas permanecen dentro de tu equipo.
Plantillas de la comunidad y bibliotecas listas para usar
No tienes que empezar desde cero. La galería de plantillas de PicoPixel tiene una colección creciente de plantillas, kits de interfaz, ejemplos, sprites, imágenes animadas y archivos de aplicaciones completas creados por el equipo de PicoPixel y la comunidad en general. Cada uno es un archivo .picopixel normal que puedes abrir, personalizar y usar como punto de partida para tu propio proyecto.
Cualquier plantilla que abras también puede convertirse en biblioteca: publícala y tu equipo tendrá acceso a sus componentes, fuentes, colores e imágenes sin necesidad de reconstruirlos. Es la forma más rápida de iniciar un nuevo proyecto o añadir elementos ya diseñados a uno existente.
Para una guía completa sobre cómo encontrar, importar y personalizar plantillas, consulta Cómo usar plantillas, kits de interfaz y apps completas de PicoPixel.
Qué hacer a continuación
- Cómo enviar una plantilla, comparte un diseño con la comunidad de PicoPixel en general
- ¿Qué es un sprite?, crea widgets animados de múltiples estados que vale la pena convertir en componentes
- Trabajar con fuentes, añade y convierte las fuentes que lleva tu biblioteca
- Trabajar con el widget de imagen animada de LVGL, crea las imágenes animadas que puedes reutilizar entre archivos
