Distribuye tu app

Cuando tu app funciona en tu equipo, pyzed build (o Archivo → Exportar aplicación… en Pyzed Design) la empaqueta con PyInstaller o Nuitka: Python, Pyzed, tus dependencias, tu código y tus formularios van a una carpeta (o un archivo) que funciona por sí sola. Quien la use no necesita Python, pip ni nada más. Ejecútalo desde la raíz de tu proyecto:

uv

Windows, macOS y Linux

uv run pyzed build

pip

macOS y Linux

source .venv/bin/activate
pyzed build          # o: python -m pyzed build

Windows (PowerShell)

.venv\Scripts\Activate.ps1
pyzed build          # o: py -m pyzed build

Compilas en	Obtienes	La gente la ejecuta
Windows	dist\Shop\Shop.exe	Con doble clic, desde un zip o un instalador
macOS	dist/Shop.app	Abriéndola (fírmala y notarízala para compartirla)
Linux	dist/Shop/Shop	Con ./Shop, o desde el menú de aplicaciones

De tu proyecto a tus usuarios

flowchart LR
    P["Tu proyecto<br/>pyproject.toml · ui/ · src/"] --> B["pyzed build<br/>(PyInstaller o Nuitka)"]
    B --> W["Windows<br/>Shop.exe"]
    B --> M["macOS<br/>Shop.app"]
    B --> L["Linux<br/>Shop/Shop"]
    W --> S["Firmar · comprimir · instalador"]
    M --> S
    L --> S
    S --> R["GitHub Release"]
    R -. "pyzed.updater" .-> U["Apps instaladas<br/>se actualizan solas"]

Una compilación por plataforma

Una compilación solo funciona en el sistema donde se hizo: compila la app de Windows en Windows, la de macOS en macOS y la de Linux en Linux. Un flujo de CI puede hacer las tres por ti.

En esta sección

Empieza aquíCómo funciona la compilación→Qué se incluye, cada opción de pyproject.toml, PyInstaller o Nuitka, archivos de datos y la pantalla de inicio.Exportar desde el diseñador→Archivo → Exportar aplicación… en Pyzed Design: plataformas, empaquetador, icono y pantalla de inicio en un solo diálogo.Windows→El .exe, carpeta o archivo único, un zip o un instalador de Inno Setup, y firma para SmartScreen.macOS→El paquete .app, identificador de paquete, firma, notarización y un .dmg.Linux→En qué distribución compilar, archivos comprimidos, entradas de menú, y AppImage o .deb.Iconos y metadatos→Nombre, versión, editor, los iconos creados a partir de un PNG y el identificador de paquete de macOS.CI con GitHub Actions→Compila los tres sistemas en cada etiqueta, publica una versión y firma con secretos.Apps que se actualizan solas→Busca en GitHub Releases, descarga con suma de verificación y cambia la app al reiniciar.Solución de problemas→Módulos que faltan, ventanas en blanco, apps bloqueadas, errores de glibc y mensajes de actualización.Referencia de la CLI→Todas las opciones de pyzed build y de los demás comandos.

Qué está soportado hoy

	Windows	macOS	Linux
Carpeta de la app (pyzed build)	✅ .exe	✅ .app	✅ ejecutable
Archivo único (--onefile)	✅	✅	✅
PyInstaller o Nuitka (--backend)	✅	✅	✅
x64 y ARM	✅	✅	✅
Icono a partir de un PNG (icon =)	✅ .ico + ventana	✅ .icns	✅ ventana; menú con un archivo .desktop
Datos del archivo (versión, editor…)	✅	✅ Info.plist	-
Pantalla de inicio	✅	✅	✅
Flujo de CI (--workflow) y archivos comprimidos para releases	✅	✅	✅
Autoactualización (pyzed.updater)	✅	✅	✅
Firma	Con signtool	Con codesign + notarización	No hace falta
Instalador	El tuyo (Inno Setup, WiX)	Tu propio .dmg (hdiutil)	El tuyo (archivo, script, AppImage…)
Compilación cruzada	❌	❌	❌

Estado de esta sección

El empaquetado para escritorio está listo para usarse hoy. Los instaladores, la firma y los canales de actualización se documentan con las herramientas que usa el propio Pyzed Design, pero pyzed build todavía no las ejecuta por ti. Las plataformas móvil y web están planificadas para el futuro y aún no están disponibles.