Assembler et publier

Parcours pas à pas pour débuter

Conditions préalables : Terminez la configuration locale du bureau, y compris Rust et les outils de construction du système d'exploitation. Arrêtez le processus de développement Tauri avant de créer un programme d'installation ; laissez le backend Web fonctionner. Exécutez chaque vérification ci-dessous à partir de la racine du référentiel et attendez qu'elle se termine avant d'exécuter la suivante. Les commandes du package filtré fonctionnent dans les extractions de bureau uniquement et toutes les plateformes.

Termes rapides : un espace de travail est constitué des utilisateurs, des données et des paramètres distincts d'une équipe. Le serveur est le backend de confiance ; gardez les clés du fournisseur hors du code du navigateur et du téléphone. Une migration est une modification de base de données versionnée qui crée ou met à jour des tables. Un modèle d'IA est le moteur qui répond ; le catalogue de modèles est la liste du serveur des identifiants de modèles et des prix disponibles. Un fournisseur est un service externe tel qu'un service d'IA, de messagerie ou de facturation. Un droit est une subvention qui permet à un espace de travail d'utiliser une fonctionnalité. Un webhook est un message qu'un service envoie au URL d'un autre service.

1. Dans une succursale locale, demandez à votre agent de codage d'inspecter apps/desktop/src-tauri/tauri.conf.json et de définir l'identifiant du produit, le nom de l'application, les icônes et le backend URL sur les valeurs que vous possédez. Utilisez un backend public HTTPS URL pour les versions release.

2. À partir de la racine du référentiel, exécutez les vérifications du package Desktop ci-dessous. Avant de vérifier : release-config, définissez SUPASTACK_APP_URL dans ce terminal à l'aide de la commande du système d'exploitation dans la configuration locale du bureau ; le backend public HTTPS doit être en cours d'exécution et l'identifiant de l'application doit être le vôtre.

3. Une build réussie ne signe, ne légalise ni ne publie un programme d'installation ; si Rust ou une bibliothèque système est manquant, terminez la configuration locale du bureau.

Pour le code personnalisé, commencez par le prompts/README.md fourni et copiez l'invite la plus proche : prompts/new-app-screen.md pour un écran d'application ou prompts/new-landing-page.md pour une page publique. Pour le travail sur un serveur, une base de données ou un fournisseur, confiez à votre agent de codage la tâche de ce guide et demandez-lui de lire les miroirs AGENTS.md, .ai/PROJECT_CONTEXT.md et .ai/ correspondants ; inspectez les fichiers sources exacts nommés ici ; lister les fichiers et les vérifications avant de les modifier ; préserver la propriété de l'espace de travail et les secrets du serveur ; et je vous montre la différence. Indiquez-lui le comportement souhaité, les champs d'entrée et de sortie, les rôles autorisés, les succès et erreurs attendus, ainsi que le compte, le fournisseur ou l'appareil de test. Utilisez des exemples de valeurs ; ne collez jamais un vrai secret.

• Avant de commencer
• Bases du terminal
• Configuration locale du bureau
• Invites de l'agent et mémoire du projet

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

Configurer le shell produit

Examinez src-tauri/tauri.conf.json, les métadonnées Cargo, les capacités et les identifiants de plateforme. Remplacez les icônes via le processus de ressources partagé et définissez l’URL backend visée à la compilation ou à l’exécution. L’application web hébergée doit déjà être déployée et accessible.

Exécuter la vérification de compilation native

Ces commandes de package exécutent la vérification et les tests de type Rust, valident les paramètres de version et créent le programme d'installation de Tauri. La configuration de la signature et de la distribution dépend de la plateforme cible et de votre compte/certificats ; ne stockez pas de matériel de signature dans la source.

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

Vérifier l’installateur sur le système cible

Vérifiez l'installation propre, le lancement, la joignabilité du backend, l'authentification, les menus et la zone de notification, l'enregistrement du raccourci, la seconde instance, les liens profonds, la reprise hors ligne et la désinstallation. Vérifiez chaque système d'exploitation pris en charge séparément. Une build locale ne prouve pas une distribution commerciale signée ou notarisée ; la configuration de signature reste à provisionner par vos soins, et le workflow de publication livré ainsi que le flux de l'updater sont couverts dans le guide des mises à jour automatiques.

• Liste de contrôle d'acceptation native
• Mises à jour automatiques et canaux de publication
• Déployer le backend partagé

Configuration et paramètres

Exécutez corepack pnpm --filter @supastack/desktop check:release-config avant de préparer un installateur. Il vérifie que SUPASTACK_APP_URL est une URL HTTPS sans identifiants sur un hôte public et que l'identifiant Tauri est spécifique au produit ; la vérification est optionnelle et ne bloque pas le développement local.

corepack pnpm --filter @supastack/desktop build exécute tauri build. Les cibles de bundle dans tauri.conf.json produisent les formats d'installateur disponibles sur le système d'exploitation hôte — buildez sur chaque système que vous livrez. Les artefacts atterrissent sous apps/desktop/src-tauri/target/release/bundle/.

productName, version et identifier vivent dans tauri.conf.json — incrémentez la version à cet endroit avant de publier une version. Régénérez les icônes avec corepack pnpm --filter @supastack/desktop icons, qui réécrit src-tauri/placeholder-icons à partir de 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/

Processus d’implémentation

Les builds non signés s’installent localement, mais déclenchent les avertissements de confiance du système. La signature du code et la notarisation Apple relèvent de votre configuration de publication ; stockez les certificats dans un gestionnaire de secrets dédié, jamais dans le dépôt.

Intégrez l’URL de production SUPASTACK_APP_URL aux builds publiés pour que l’enveloppe installée charge l’application Web déployée plutôt que localhost.

Vérification et dépannage

Installez le bundle produit sur chaque système ciblé et consignez le build, le système et l’URL d’application utilisés pour la validation. Vérifiez le démarrage, le déploiement chargé, la zone de notification, le raccourci et la persistance de connexion après redémarrage ; un tauri build réussi ne suffit pas comme preuve de publication.