Code-ondertekening

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/lade, sneltoetsregistratie, tweede exemplaar, deep links, offline opnieuw proberen en verwijderen. Controleer elk ondersteund besturingssysteem afzonderlijk. Een lokale build bewijst geen ondertekende of notariële commerciële distributie; ondertekeningsconfiguratie, een updaterfeed en release-automatisering zijn niet inbegrepen.

• Native acceptatiechecklist
• De gedeelde backend implementeren

Setup en configuratie

1. Ongesigneerde installers installeren prima op je eigen machine, maar triggeren Gatekeeper- en SmartScreen-waarschuwingen voor alle anderen — onderteken voordat je shipt.

2. Schrijf je op macOS in voor het Apple Developer Program voor een Developer ID-certificaat, voeg daarna de signing- en notarisatieconfiguratie toe onder de bundle-sectie van src-tauri/tauri.conf.json en voed Tauri de gedocumenteerde signing-env (APPLE_CERTIFICATE, APPLE_CERTIFICATE_PASSWORD, APPLE_SIGNING_IDENTITY, plus de APPLE_API_KEY / APPLE_API_ISSUER-notarisatiecredentials) vanuit de secret store van je CI.

3. Configureer op Windows de Windows-signing van de bundle — een certificaat-thumbprint of een custom signtool-commando — met het certificaat eveneens geleverd via de secret store van je 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=stable

Implementatieworkflow

Provisioneer certificaten via je eigen secret store en injecteer ze als environment-variabelen op build-tijd — een certificaat dat in de repo is gecommit is een certificaat om in te trekken.

Bak de productie-SUPASTACK_APP_URL in dezelfde release-build zodat geïnstalleerde shells naar de gedeployde app wijzen.

Verificatie en probleemoplossing

Verifieer door het geproduceerde artefact op een machine te installeren die niet van jou is: geen Gatekeeper- of SmartScreen-waarschuwing, de app start en inloggen persisteert. Een groene tauri-build zonder de getekende installatietest is geen release-bewijs.

Vervolgstap: de Deploymentchecklist op de Web-tab behandelt de server-side launchgates.