Empaqueta y publica

Guía paso a paso para principiantes

Requisitos previos: Finalice la configuración local del escritorio, incluidos Rust y las herramientas de compilación del sistema operativo. Detenga el proceso de desarrollo Tauri antes de crear un instalador; deje el backend web ejecutándose. Ejecute cada verificación a continuación desde la raíz del repositorio y espere a que finalice antes de ejecutar la siguiente. Los comandos de paquetes filtrados funcionan en pagos solo de escritorio y en todas las plataformas.

Términos breves: un espacio de trabajo son los usuarios, datos y configuraciones separados de un equipo. El servidor es el backend confiable; Mantenga las claves del proveedor fuera del código del navegador y del teléfono. Una migración es un cambio de base de datos versionada que crea o actualiza tablas. Un modelo de IA es el motor que responde; el catálogo de modelos es la lista del servidor de ID de modelos disponibles y precios. Un proveedor es un servicio externo, como inteligencia artificial, correo electrónico o servicio de facturación. Un derecho es una concesión que permite que un espacio de trabajo utilice una función. Un webhook es un mensaje que un servicio envía al URL de otro servicio.

1. En una sucursal local, solicite a su agente de codificación que inspeccione apps/desktop/src-tauri/tauri.conf.json y configure el identificador del producto, el nombre de la aplicación, los íconos y el backend URL con los valores que posee. Utilice un backend público HTTPS URL para las versiones de lanzamiento.

2. Desde la raíz del repositorio, ejecute las comprobaciones del paquete de escritorio a continuación. Antes de verificar: liberación-config, configure SUPASTACK_APP_URL en esta terminal usando el comando del sistema operativo en la configuración local del escritorio; el backend público HTTPS debe estar ejecutándose y el identificador de la aplicación debe ser el suyo.

3. Una compilación exitosa no firma, certifica ante notario ni publica un instalador; Si falta Rust o una biblioteca del sistema, finalice la configuración local del escritorio.

Para obtener código personalizado, comience con el prompts/README.md proporcionado y copie el mensaje más cercano: prompts/new-app-screen.md para una pantalla de aplicación o prompts/new-landing-page.md para una página pública. Para trabajos de servidor, base de datos o proveedor, asigne a su agente de codificación la tarea de esta guía y pídale que lea AGENTS.md, .ai/PROJECT_CONTEXT.md y los espejos .ai/ correspondientes; inspeccionar los archivos fuente exactos nombrados aquí; enumerar archivos y verificaciones antes de editarlos; preservar la propiedad del espacio de trabajo y los secretos exclusivos del servidor; y mostrarte la diferencia. Dígale el comportamiento que desea, los campos de entrada y salida, los roles permitidos, los éxitos y errores esperados y la cuenta, proveedor o dispositivo de prueba. Utilice valores de muestra; Nunca pegues un verdadero secreto.

• Antes de comenzar
• Conceptos básicos de terminales
• Configuración local de escritorio
• Mensajes del agente y memoria del proyecto

corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build

Configura el shell del producto

Revisa src-tauri/tauri.conf.json, los metadatos de Cargo, las capacidades y los identificadores de plataforma. Sustituye los iconos de la aplicación mediante el proceso de recursos compartidos y configura la URL del backend prevista en compilación/runtime. La aplicación web alojada ya debe estar desplegada y ser accesible.

Ejecuta la comprobación de compilación nativa

Estos comandos de paquete ejecutan pruebas y comprobaciones de tipos de Rust, validan la configuración de la versión y crean el instalador Tauri. La configuración de firma y distribución depende de la plataforma de destino y de su cuenta/certificados; No almacene material para firmar en la fuente.

corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build

Verifica el instalador en el sistema operativo de destino

Compruebe la instalación limpia, el inicio, el acceso al backend, la autenticación, los menús/bandeja, el registro del atajo, la segunda instancia, los enlaces profundos, el reintento sin conexión y la desinstalación. Verifique cada sistema operativo compatible por separado. Una compilación local no demuestra una distribución comercial firmada o notarizada; no se incluyen la configuración de firma, un canal de actualizaciones ni la automatización de versiones.

• Lista de verificación de aceptación nativa
• Implementar el backend compartido

Configuración y ajustes

Ejecute corepack pnpm --filter @supastack/desktop check:release-config antes de preparar un instalador. Comprueba que SUPASTACK_APP_URL sea un HTTPS sin credenciales en un host público y que el identificador Tauri sea específico del producto; el cheque es voluntario y no bloquea el desarrollo local.

corepack pnpm --filter @supastack/desktop build ejecuta la compilación tauri. Los destinos del paquete en tauri.conf.json producen los formatos de instalación disponibles en el sistema operativo host; se crean en cada sistema operativo que se envía. Los artefactos aterrizan bajo apps/desktop/src-tauri/target/release/bundle/.

El nombre del producto, la versión y el identificador se encuentran en tauri.conf.json: actualice la versión allí antes de realizar una versión. Regenere íconos con corepack pnpm --filter @supastack/desktop icons, que reescribe src-tauri/icons desde icon-source.png.

corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop icons
corepack pnpm --filter @supastack/desktop build
# artifacts: apps/desktop/src-tauri/target/release/bundle/

Flujo de implementación

Los builds sin firmar se pueden instalar localmente, pero muestran advertencias de confianza del sistema operativo. La firma de código y la notarización de Apple forman parte de tu configuración de publicación; guarda los certificados en un almacén de secretos propio, nunca en el repositorio.

Incluye la URL de producción SUPASTACK_APP_URL en los builds de publicación para que la shell instalada cargue la app web desplegada, no localhost.

Verificación y solución de problemas

Instala el paquete generado en cada sistema operativo objetivo y registra el build, el sistema operativo y la URL de la app usados para la aceptación. Comprueba el inicio, la app web cargada, la bandeja, el atajo y la persistencia de la sesión tras reiniciar; completar tauri build no basta como evidencia de publicación.