Bundle e rilascio

Procedura dettagliata per principianti

Prerequisiti: completare la configurazione locale del desktop, inclusi Rust e gli strumenti di creazione del sistema operativo. Interrompere il processo di sviluppo Tauri prima di creare un programma di installazione; lasciare il backend Web in esecuzione. Esegui ciascun controllo di seguito dalla root del repository e attendi che finisca prima di eseguire quello successivo. I comandi del pacchetto filtrato funzionano nei checkout solo desktop e su tutte le piattaforme.

Termini rapidi: uno spazio di lavoro è costituito da utenti, dati e impostazioni separati di un team. Il server è il backend affidabile; mantenere le chiavi del provider fuori dal browser e dal codice del telefono. Una migrazione è una modifica del database con versione che crea o aggiorna tabelle. Un modello AI è il motore che risponde; il catalogo dei modelli è l'elenco del server degli ID e dei prezzi dei modelli disponibili. Un fornitore è un servizio esterno come un servizio di intelligenza artificiale, posta elettronica o fatturazione. Un diritto è una concessione che consente a un'area di lavoro di utilizzare una funzionalità. Un webhook è un messaggio che un servizio invia allo URL di un altro servizio.

1. In una filiale locale, chiedi al tuo agente di codifica di ispezionare apps/desktop/src-tauri/tauri.conf.json e impostare l'identificatore del prodotto, il nome dell'app, le icone e il backend URL sui valori di tua proprietà. Utilizza un backend HTTPS pubblico URL per le build di rilascio.

2. Dalla root del repository, esegui i controlli del pacchetto Desktop di seguito. Prima di check:release-config, imposta SUPASTACK_APP_URL in questo terminale utilizzando il comando del sistema operativo nella configurazione locale del desktop; il backend pubblico HTTPS deve essere in esecuzione e l'identificatore dell'app deve essere il tuo.

3. Una build riuscita non firma, autentica o pubblica un programma di installazione; se manca Rust o una libreria di sistema, completa la configurazione locale del desktop.

Per il codice personalizzato, inizia con prompts/README.md in dotazione e copia il prompt più vicino: prompts/new-app-screen.md per la schermata di un'app o prompts/new-landing-page.md per una pagina pubblica. Per il lavoro su server, database o provider, assegna al tuo agente di codifica il compito di questa guida e chiedigli di leggere AGENTS.md, .ai/PROJECT_CONTEXT.md e i mirror .ai/ corrispondenti; controllare gli esatti file sorgente nominati qui; elencare file e controlli prima della modifica; preservare la proprietà dello spazio di lavoro e i segreti solo del server; e mostrarti la differenza. Indicagli il comportamento desiderato, i campi di input e output, i ruoli consentiti, i successi e gli errori previsti e l'account, il fornitore o il dispositivo di prova. Utilizzare valori campione; non incollare mai un vero segreto.

• Prima di iniziare
• Nozioni di base sui terminali
• Configurazione locale del desktop
• Messaggi dell'agente e memoria del progetto

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 la shell del prodotto

Esamina src-tauri/tauri.conf.json, metadati del carico, funzionalità e identificatori della piattaforma. Sostituisci le icone delle app tramite il processo delle risorse condivise e imposta il backend previsto URL in fase di compilazione/runtime. L'app Web ospitata deve essere già distribuita e raggiungibile.

Esegui il gate di build nativo

Questi comandi del pacchetto eseguono il controllo e i test del tipo Rust, convalidano le impostazioni di rilascio e creano il programma di installazione Tauri. La configurazione della firma e della distribuzione dipende dalla piattaforma di destinazione e dal tuo account/certificati; non archiviare il materiale per la firma nel sorgente.

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

Verificare il programma di installazione sul sistema operativo di destinazione

Controlla installazione pulita, avvio, raggiungibilità del backend, auth, menu/tray, registrazione della scorciatoia, seconda istanza, deep link, retry offline e disinstallazione. Verifica separatamente ogni sistema operativo supportato. Una build locale non dimostra una distribuzione commerciale firmata o notarizzata; la configurazione della firma resta a tuo carico, e il workflow di rilascio incluso più il feed updater sono coperti in Aggiornamenti automatici.

• Elenco di controllo per l'accettazione nativa
• Aggiornamenti automatici e canali di rilascio
• Distribuisci il backend condiviso

Installazione e configurazione

Esegui corepack pnpm --filter @supastack/desktop check:release-config prima di preparare un programma di installazione. Verifica che SUPASTACK_APP_URL sia HTTPS senza credenziali su un host pubblico e che l'identificatore Tauri sia specifico del prodotto; il controllo è opzionale e non blocca lo sviluppo locale.

corepack pnpm --filter @supastack/desktop build esegue tauri build. I target del bundle in tauri.conf.json producono i formati di installer disponibili sul sistema operativo host — compila su ogni sistema operativo che distribuisci. Gli artefatti finiscono sotto apps/desktop/src-tauri/target/release/bundle/.

productName, version e identifier vivono in tauri.conf.json — incrementa lì la versione prima di tagliare una release. Rigenera le icone con corepack pnpm --filter @supastack/desktop icons, che riscrive src-tauri/placeholder-icons a partire da placeholder-icon.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/

Flusso di implementazione

Gli installer non firmati si installano localmente ma mostrano avvisi di attendibilità del sistema operativo. Firma del codice e notarizzazione Apple richiedono una configurazione release propria; conserva i certificati in un secret store, mai nel repository.

Inserisci SUPASTACK_APP_URL di produzione nella build di release affinché la shell installata punti all’app Web distribuita e non a localhost.

Verifica e risoluzione dei problemi

Installa il bundle su ogni OS target e registra build, sistema e URL app usati per l’accettazione. Verifica avvio, deployment caricato, tray, scorciatoia e persistenza dell’accesso; tauri build completato da solo non è una prova di rilascio.