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 /fr/docs/desktop/ship-in-5-minutes.md (or send Accept: text/markdown).

Lancer l’application de bureau en 5 minutes

Préparez Rust et les outils de construction de votre système d'exploitation, démarrez un backend Web accessible, lancez la fenêtre Tauri et vérifiez le comportement de la barre d'état système, des raccourcis et des tâches locales.

Poser une question sur ce guide

1. Installez les outils généraux et natifs

Terminer Avant de commencer, clonez votre référentiel Desktop ou votre monorepo Toutes Plateformes et ouvrez-le dans l'éditeur. Desktop est une fenêtre native autour de la même application Web. Il n'inclut pas une seconde implémentation de comptes ou de chat. Le lancement de cinq minutes commence après l'installation des dépendances et des outils natifs ; la première installation et la compilation de Rust prennent souvent plus de temps.

Sous Windows, installez Microsoft C++ Build Tools à l’aide du lien des conditions préalables Tauri ci-dessous. Dans son programme d'installation, sélectionnez Développement de bureau avec C++, conservez Windows SDK sélectionné et terminez l'installation. Assurez-vous que le runtime Microsoft Edge WebView2 est installé. Installez Rust à partir de rustup.rs à l'aide de rustup-init.exe ; conserver la chaîne d'outils MSVC par défaut. Rouvrez votre terminal après l'installation.

Sur macOS, exécutez xcode-select --install dans Terminal et complétez la boîte de dialogue des outils de ligne de commande s'ils ne sont pas installés. Installez Rust à l'aide de la commande macOS de rustup.rs. Sous Linux, suivez la page des prérequis Tauri pour connaître les packages WebKitGTK, compilateur, plateau et bibliothèque système de votre distribution exacte, puis installez Rust. Les noms des packages Linux varient ; n'exécutez pas les commandes d'une autre distribution.

Ouvrez un terminal à la racine du référentiel et exécutez les vérifications de version ci-dessous. rustc et cargo doivent imprimer des versions ; cargo est l'outil de construction de Rust. Si l’un ou l’autre est manquant, terminez l’installation et rouvrez le terminal avant de continuer.

rustc --version
cargo --version
corepack pnpm install

2. Démarrez ou choisissez le backend Web

Si votre extraction contient apps/web, suivez le didacticiel Web, créez apps/web/.env.local, exécutez le serveur Web dans un terminal séparé à l'aide de la commande ci-dessous et laissez-le fonctionner. Vérifiez d’abord http://localhost:3000 dans votre navigateur. Vous pouvez utiliser la démonstration /dashboard sans base de données ; la connexion réelle à /auth nécessite une migration Postgres.

Une extraction sur ordinateur uniquement ne contient pas apps/web.. Utilisez le backend Web exécuté séparément fourni pour votre produit et ouvrez son URL dans votre navigateur pour confirmer qu'il fonctionne. Le shell du bureau ne peut pas créer le backend pour vous. N'essayez pas la commande Web ci-dessous si ce dossier est absent. L'étape 3 montre comment choisir une adresse backend fournie.

# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev

3. Lancez la fenêtre du bureau

Ouvrez un deuxième terminal à la racine du référentiel pendant que le backend reste en cours d'exécution. Pour le backend local par défaut sur http://localhost:3000,, exécutez la première commande ci-dessous. Cargo peut télécharger des bibliothèques et compiler le shell ; attendez que la fenêtre Supastack s'ouvre. Des messages du compilateur lors de la première build sont attendus.

Pour un backend fourni, remplacez https://app.example.com dans le bloc de système d'exploitation approprié ci-dessous par son URL réel. Exécutez uniquement le bloc de votre plateforme. SUPASTACK_APP_URL est un paramètre d'environnement de terminal, lu au démarrage du processus natif. Le mettre uniquement dans root .env ne configurera pas le shell. Gardez le backend URL exempt de noms d'utilisateur ou de mots de passe intégrés.

Dans le monorepo Toutes plates-formes, le corepack pnpm dev:desktop peut démarrer Web et Tauri ensemble une fois que pnpm est sur PATH, comme expliqué dans Avant de commencer. La commande filtrée ci-dessous fonctionne également dans les extractions sur ordinateur uniquement, le backend s'exécutant séparément.

# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev

# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev

# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev

4. Vérifiez la fenêtre, la barre d'état et le raccourci

Le succès signifie que la fenêtre affiche la même page d'accueil que votre backend dans le navigateur. La fenêtre du bureau n'a pas de barre d'adresse du navigateur. Pour ouvrir la démonstration sans informations d'identification, quittez le shell à l'aide de l'action Quitter de la barre d'état système, puis exécutez le bloc de votre système d'exploitation ci-dessous dans le terminal de bureau pendant que le serveur Web reste en cours d'exécution. Cela charge directement /dashboard ; suivez les étapes de la tâche locale du didacticiel Web. La connexion au compte réel utilise la base de données du backend, tout comme dans le navigateur.

Fermez la fenêtre à l'aide de son bouton de fermeture : l'application doit se cacher dans la barre d'état plutôt que de quitter. Cliquez sur l'icône de la barre d'état Supastack ou appuyez sur Ctrl + Maj + Espace sous Windows/Linux, ou Commande + Maj + Espace sur macOS, pour l'afficher à nouveau. Utilisez l'action Quitter du bac pour quitter. Pour terminer complètement le développement, appuyez également sur Ctrl + C dans le terminal de bureau, puis arrêtez le terminal backend.

Si la fenêtre est vide ou affiche un problème de connexion, ouvrez d'abord le URL configuré dans un navigateur. Démarrez le backend ou corrigez le URL, puis redémarrez Tauri. Si Rust signale que linker.exe est introuvable, installez la charge de travail Windows C++ et rouvrez le terminal. Si Linux signale une bibliothèque système manquante, suivez les conditions préalables spécifiques à la distribution. Si le raccourci clavier est déjà utilisé, utilisez la barre d'état et suivez le comportement natif pour le modifier.

Cela lance une fenêtre de développement local ; il ne produit pas d'installateur signé et ne publie pas d'application. Suivez la distribution Desktop pour les versions du programme d'installation, la signature de la plate-forme et les tests sur une autre machine. La compilation Windows ne vérifie pas le comportement de macOS ou Linux.

# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev

# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop dev

Utiliser l’URL locale de l’application

Sans remplacement, Tauri charge http://localhost:3000. Définissez SUPASTACK_APP_URL uniquement si votre application Next.js locale utilise une autre origine HTTP(S) accessible. Les URL contenant des identifiants ou n’utilisant pas le Web sont refusées.

L’identifiant du bundle de développement et la configuration de publication ne sont pas encore prêts pour la production. La vérification préalable à la publication et la signature de la plateforme sont décrites dans le guide de publication séparé.