For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/desktop/signing.md (or send Accept: text/markdown).
Firma del codice
Firma gli installer così macOS e Windows smettono di avvisare i tuoi utenti.
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 buildConfigura 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 buildVerificare il programma di installazione sul sistema operativo di destinazione
Controlla l'installazione pulita, l'avvio, la raggiungibilità del backend, l'autenticazione, i menu/vassoio, la registrazione dei tasti di scelta rapida, la seconda istanza, i collegamenti diretti, il nuovo tentativo offline e la disinstallazione. Verificare separatamente ciascun sistema operativo supportato. Una costruzione locale non dimostra una distribuzione commerciale firmata o autenticata; la configurazione della firma, un feed di aggiornamento e l'automazione del rilascio non sono inclusi.
Installazione e configurazione
1. Gli installer non firmati si installano senza problemi sulla tua macchina ma attivano gli avvisi Gatekeeper e SmartScreen per tutti gli altri — firma prima di distribuire.
2. Su macOS, iscriviti all'Apple Developer Program per un certificato Developer ID, poi aggiungi la configurazione di firma e notarizzazione nella sezione bundle di src-tauri/tauri.conf.json e fornisci a Tauri il suo env di firma documentato (APPLE_CERTIFICATE, APPLE_CERTIFICATE_PASSWORD, APPLE_SIGNING_IDENTITY, più le credenziali di notarizzazione APPLE_API_KEY / APPLE_API_ISSUER) dal tuo secret store CI.
3. Su Windows, configura la firma Windows del bundle — un thumbprint di certificato o un comando signtool personalizzato — con il certificato consegnato anch'esso tramite il secret store del tuo runner.
# tauri.conf.json ships unsigned today:
# "bundle": { "active": true, "targets": "all", "icon": [...] }
# Add signing under bundle > macOS / bundle > windows
# and keep every certificate and password in your secret store,
# never in the repo.
# Auto-updater & release channels (stable / beta via {{channel}}):
# SUPASTACK_UPDATER_ENDPOINT=https://releases.example.com/{{channel}}/{{target}}/{{arch}}/{{current_version}}
# SUPASTACK_UPDATER_PUBKEY=…
# SUPASTACK_UPDATE_CHANNEL=stableFlusso di implementazione
Fornisci i certificati tramite il tuo secret store e iniettali come variabili d'ambiente al momento del build — un certificato committato nel repo è un certificato da revocare.
Incorpora la SUPASTACK_APP_URL di produzione nello stesso build di release così le shell installate puntano all'app distribuita.
Verifica e risoluzione dei problemi
Verifica installando l'artefatto prodotto su una macchina che non è la tua: nessun avviso Gatekeeper o SmartScreen, l'app si avvia e il sign-in persiste. Un tauri build verde senza il test di installazione firmata non è evidenza di release.
Prossimo passo: la checklist Deployment della scheda Web copre i cancelli di rilascio lato server.