Bündeln und veröffentlichen

Schritt-für-Schritt für Einsteiger

Voraussetzungen: Schließen Sie die lokale Desktop-Einrichtung ab, einschließlich Rust und der Betriebssystem-Build-Tools. Stoppen Sie den Tauri-Entwicklungsprozess, bevor Sie ein Installationsprogramm erstellen. Lassen Sie das Web-Backend laufen. Führen Sie jede Prüfung unten im Repository-Stammverzeichnis aus und warten Sie, bis sie abgeschlossen ist, bevor Sie die nächste ausführen. Die gefilterten Paketbefehle funktionieren beim Checkout nur für Desktops und für alle Plattformen.

Kurze Begriffe: Ein Arbeitsbereich umfasst die einzelnen Benutzer, Daten und Einstellungen eines Teams. Der Server ist das vertrauenswürdige Backend; Halten Sie Anbieterschlüssel aus Browser- und Telefoncodes fern. Eine Migration ist eine versionierte Datenbankänderung, die Tabellen erstellt oder aktualisiert. Ein KI-Modell ist der Motor, der antwortet; Der Modellkatalog ist die Liste der verfügbaren Modell-IDs und Preise des Servers. Ein Anbieter ist ein externer Dienst wie ein KI-, E-Mail- oder Abrechnungsdienst. Eine Berechtigung ist eine Bewilligung, die einem Arbeitsbereich die Nutzung einer Funktion ermöglicht. Ein Webhook ist eine Nachricht, die ein Dienst an den URL eines anderen Dienstes sendet.

1. Bitten Sie Ihren Codierungsagenten in einer lokalen Zweigstelle, apps/desktop/src-tauri/tauri.conf.json zu überprüfen und die Produktkennung, den App-Namen, die Symbole und das Backend URL auf Werte festzulegen, die Ihnen gehören. Verwenden Sie für Release-Builds ein öffentliches HTTPS-Backend URL.

2. Führen Sie im Repository-Stammverzeichnis die folgenden Desktop-Paketprüfungen aus. Legen Sie vor check:release-config SUPASTACK_APP_URL in diesem Terminal mithilfe des Betriebssystembefehls im lokalen Desktop-Setup fest. Das öffentliche HTTPS-Backend muss ausgeführt werden und die App-ID muss Ihre eigene sein.

3. Bei einem erfolgreichen Build wird kein Installationsprogramm signiert, notariell beglaubigt oder veröffentlicht. Wenn Rust oder eine Systembibliothek fehlt, beenden Sie die lokale Desktop-Einrichtung.

Beginnen Sie für benutzerdefinierten Code mit dem bereitgestellten prompts/README.md und kopieren Sie die nächstgelegene Eingabeaufforderung: prompts/new-app-screen.md für einen App-Bildschirm oder prompts/new-landing-page.md für eine öffentliche Seite. Geben Sie Ihrem Programmieragenten für Server-, Datenbank- oder Anbieterarbeiten die Aufgabe dieses Handbuchs und bitten Sie ihn, AGENTS.md, .ai/PROJECT_CONTEXT.md und passende .ai/-Spiegel zu lesen; Überprüfen Sie die hier genannten genauen Quelldateien. Listen Sie Dateien auf und prüfen Sie sie vor der Bearbeitung. Bewahren Sie den Arbeitsbereichseigentum und die Nur-Server-Geheimnisse. und zeige dir den Unterschied. Teilen Sie ihm das gewünschte Verhalten, Eingabe- und Ausgabefelder, zulässige Rollen, erwartete Erfolge und Fehler sowie das Testkonto, den Anbieter oder das Gerät mit. Beispielwerte verwenden; Fügen Sie niemals ein echtes Geheimnis ein.

• Bevor Sie beginnen
• Terminal-Grundlagen
• Lokales Desktop-Setup
• Agentenaufforderungen und Projektspeicher

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

Produktshell konfigurieren

Prüfe src-tauri/tauri.conf.json, Cargo-Metadaten, Capabilities und Plattformkennungen. Ersetze App-Symbole im gemeinsamen Asset-Prozess und setze die gewünschte Backend-URL zur Build-Zeit oder zur Laufzeit. Die gehostete Web-App muss bereits bereitgestellt und erreichbar sein.

Prüfschranke für den nativen Build ausführen

Diese Paketbefehle führen Rust-Typprüfungen und -Tests durch, validieren Release-Einstellungen und erstellen das Tauri-Installationsprogramm. Die Konfiguration der Signatur und Verteilung hängt von der Zielplattform und Ihrem Konto/Ihren Zertifikaten ab. Speichern Sie das Signaturmaterial nicht in der Quelle.

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

Installer auf dem Zielbetriebssystem prüfen

Prüfen Sie saubere Installation, Start, Erreichbarkeit des Backends, Anmeldung, Menüs/Tray, Hotkey-Registrierung, zweite Instanz, Deep Links, Offline-Wiederholung und Deinstallation. Prüfen Sie jedes unterstützte Betriebssystem separat. Ein lokaler Build belegt keine signierte oder notarisierte kommerzielle Verteilung; Signaturkonfiguration, Update-Feed und Release-Automatisierung sind nicht enthalten.

• Checkliste für die native Akzeptanz
• Das gemeinsame Backend bereitstellen

Einrichtung und Konfiguration

Führen Sie corepack pnpm --filter @supastack/desktop check:release-config aus, bevor Sie ein Installationsprogramm vorbereiten. Es prüft, ob SUPASTACK_APP_URL auf einem öffentlichen Host ein HTTPS ohne Anmeldeinformationen ist und ob die Tauri-Kennung produktspezifisch ist. Die Prüfung erfolgt optional und blockiert die lokale Entwicklung nicht.

corepack pnpm --filter @supastack/desktop build führt tauri build aus. Die Bundle-Ziele in tauri.conf.json erzeugen die auf dem Host-Betriebssystem verfügbaren Installationsformate – erstellen Sie auf jedem von Ihnen gelieferten Betriebssystem. Artefakte landen unter apps/desktop/src-tauri/target/release/bundle/.

Produktname, Version und Kennung befinden sich in tauri.conf.json – erhöhen Sie die Version dort, bevor Sie eine Version ausschneiden. Generieren Sie Symbole mit corepack pnpm --filter @supastack/desktop icons neu, wodurch src-tauri/icons aus icon-source.png neu geschrieben wird.

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/

Implementierungsablauf

Nicht signierte Builds lassen sich lokal installieren, lösen aber Warnungen des Betriebssystems aus. Codesignatur und Apple-Notarisierung gehören in deine eigene Release-Konfiguration. Bewahre Zertifikate in einem dedizierten Secret Store auf und niemals im Repository.

Hinterlege in Release-Builds die Produktionsadresse SUPASTACK_APP_URL, damit installierte Shells die bereitgestellte Web-App statt localhost laden.

Überprüfung und Fehlerbehebung

Installiere das erstellte Paket auf jedem Zielbetriebssystem und notiere Build, Betriebssystem und verwendete App-Adresse. Prüfe Start, geladene Bereitstellung, Tray, Tastenkürzel und die Anmeldung nach einem Neustart. Ein erfolgreiches tauri build allein ist kein Release-Nachweis.