ESP Platform

Documentación oficial

Firmware Center · artifacts

Biblioteca de artefactos binarios

Documentación asociada a AEOS 0.7.0Revisión 1Actualizado 14/07/2026 03:36:28 CESTstable

Biblioteca de artefactos binarios

Un artifact es contenido binario independiente de cualquier firmware. Su identidad es el SHA-256 y puede ser compartido.

Relación

firmware 1 -> N firmware_segment N -> 1 artifact

La ficha describe producto y compatibilidad. El segmento describe cómo usar un archivo dentro de esa ficha. El artifact representa los bytes.

Deduplicación

Al subir un archivo se calcula SHA-256 antes de almacenarlo. Si existe, se reutiliza. Clonar firmware crea nuevas relaciones sin copiar bytes. Dos paquetes pueden compartir bootloader o tabla de particiones.

Sustitución

Editar un segmento no muta el artifact. Se crea o reutiliza otro artifact y la relación cambia de forma transaccional. Los demás firmwares continúan apuntando al contenido anterior.

Eliminación

Eliminar firmware borra ficha y segmentos. Nunca borra directamente el archivo compartido. Un artifact sin relaciones queda huérfano. La limpieza explícita verifica de nuevo referencias, elimina el archivo y luego su registro.

Riesgos evitados

Este modelo impide que borrar el original rompa clones, evita duplicación física, conserva checksums, permite trazabilidad y mantiene integridad referencial.

Información técnica del documento
Ruta lógica
artifacts/artifact-library.md
Commit Git
a83cef9e1ee0c5b0b22662fe3493139d77c23570
SHA-256
e39ea379c7a5487f247bf74a50b878d1d5ae220aa9f10ac1558219ad1a106e74
Regeneración
scripts/build-documentation.sh