Bundelen en releasen

Walkthrough voor beginners

Vereisten: Voltooi de lokale installatie van het bureaublad, inclusief Rust en de bouwtools voor het besturingssysteem. Stop het Tauri-ontwikkelingsproces voordat u een installatieprogramma bouwt; laat de web-backend actief. Voer elke onderstaande controle uit vanuit de root van de repository en wacht tot deze is voltooid voordat u de volgende uitvoert. De gefilterde pakketopdrachten werken bij kassa's voor alleen desktop en voor alle platforms.

Korte termen: een werkruimte bestaat uit de afzonderlijke gebruikers, gegevens en instellingen van één team. De server is de vertrouwde backend; houd providersleutels uit de browser- en telefooncode. Een migratie is een versiebeheer van de database, waarbij tabellen worden gemaakt of bijgewerkt. Een AI-model is de motor die antwoord geeft; de modelcatalogus is de serverlijst met beschikbare model-ID's en prijzen. Een provider is een externe service, zoals een AI-, e-mail- of factureringsservice. Een recht is een subsidie ​​waarmee een werkruimte een functie kan gebruiken. Een webhook is een bericht dat de ene service naar de URL van een andere service verzendt.

1. Vraag uw codeeragent in een lokale vestiging om apps/desktop/src-tauri/tauri.conf.json te inspecteren en de product-ID, app-naam, pictogrammen en backend URL in te stellen op waarden die u bezit. Gebruik een openbare HTTPS-backend URL voor releasebuilds.

2. Voer vanuit de root van de repository de onderstaande Desktop-pakketcontroles uit. Voordat u check:release-config instelt, stelt u SUPASTACK_APP_URL in deze terminal in met behulp van de besturingssysteemopdracht in de lokale Desktop Setup; de openbare HTTPS-backend moet actief zijn en de app-ID moet van u zijn.

3. Een succesvolle build betekent niet dat er een installatieprogramma wordt ondertekend, notarieel bekrachtigd of gepubliceerd; als Rust of een systeembibliotheek ontbreekt, voltooi dan de lokale Desktop-installatie.

Voor aangepaste code begint u met de meegeleverde prompts/README.md en kopieert u de dichtstbijzijnde prompt: prompts/new-app-screen.md voor een app-scherm of prompts/new-landing-page.md voor een openbare pagina. Voor server-, database- of providerwerk geeft u uw codeeragent de taak van deze handleiding en vraagt ​​u hem om AGENTS.md, .ai/PROJECT_CONTEXT.md en overeenkomende .ai/-mirrors te lezen; inspecteer de exacte bronbestanden die hier worden genoemd; maak een lijst van bestanden en controleer deze voordat u deze bewerkt; behoud van het eigendom van de werkruimte en geheimen voor de server; en laat je het verschil zien. Vertel het gewenste gedrag, invoer- en uitvoervelden, toegestane rollen, verwacht succes en fouten, en het testaccount, de provider of het apparaat. Gebruik voorbeeldwaarden; plak nooit een echt geheim.

• Voordat u begint
• Basisbeginselen van de terminal
• Lokale installatie op het bureaublad
• Agentprompts en projectgeheugen

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

Configureer de productshell

Bekijk src-tauri/tauri.conf.json, Cargo-metagegevens, mogelijkheden en platform-ID's. Vervang app-pictogrammen via het gedeelde activaproces en stel de beoogde backend URL in op build/runtime. De gehoste web-app moet al zijn geïmplementeerd en bereikbaar zijn.

Voer de native build-poort uit

Deze pakketopdrachten voeren Rust-typecheck en -tests uit, valideren de release-instellingen en bouwen het Tauri-installatieprogramma. De ondertekenings- en distributieconfiguratie is afhankelijk van het doelplatform en uw account/certificaten; bewaar geen signeermateriaal in de bron.

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

Controleer het installatieprogramma op het doelbesturingssysteem

Controleer schone installatie, starten, bereikbaarheid van de backend, authenticatie, menu's/tray, sneltoetsregistratie, tweede exemplaar, deep links, offline opnieuw proberen en verwijderen. Controleer elk ondersteund besturingssysteem afzonderlijk. Een lokale build bewijst geen ondertekende of genotariseerde commerciële distributie; de ondertekeningsconfiguratie blijft voor u om te provisioneren, en de meegeleverde releaseworkflow plus updaterfeed worden behandeld in Automatische updates.

• Native acceptatiechecklist
• Automatische updates en releasekanalen
• De gedeelde backend implementeren

Setup en configuratie

Voer corepack pnpm --filter @supastack/desktop check:release-config uit voordat u een installatieprogramma voorbereidt. Het controleert of SUPASTACK_APP_URL HTTPS zonder inloggegevens op een openbare host is en dat de Tauri-identifier productspecifiek is; de controle is opt-in en blokkeert lokale ontwikkeling niet.

corepack pnpm --filter @supastack/desktop build voert tauri build uit. De bundeldoelen in tauri.conf.json produceren de installatieformaten die beschikbaar zijn op het hostbesturingssysteem — bouw op elk besturingssysteem dat u levert. Artefacten landen onder apps/desktop/src-tauri/target/release/bundle/.

productName, version en identifier staan in tauri.conf.json — verhoog de versie daar voordat u een release uitbrengt. Genereer pictogrammen opnieuw met corepack pnpm --filter @supastack/desktop icons, dat src-tauri/placeholder-icons herschrijft vanuit 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/

Implementatieworkflow

Ongesigneerde installers kunnen lokaal worden geïnstalleerd, maar tonen vertrouwenswaarschuwingen van het OS. Configureer codesigning en Apple-notarisatie zelf; bewaar certificaten in je secret store, nooit in de repository.

Neem de productie-SUPASTACK_APP_URL op in releasebuilds, zodat geïnstalleerde shells naar de gedeployde Web-app wijzen in plaats van localhost.

Verificatie en probleemoplossing

Installeer de bundle op elk doel-OS en noteer build, OS en gebruikte app-URL. Controleer starten, de geladen deployment, tray, sneltoets en sessiebehoud. Een voltooide tauri build alleen is geen releasebewijs.