Configuration et téléchargement

Utilisez les gestionnaires de paquets pour la rapidité ou les téléchargements directs via GitHub Releases.

Options d'installation pour macOS, Windows x86_64 et Linux x86_64.

Cette page est maintenue en synchronisation avec le dépôt pour garantir la cohérence avec les derniers artefacts de distribution.

Support Homebrew et Winget

Téléchargements directs disponibles

Notes par plateforme incluses

Support actuel

macOS / Windows x86_64 / Linux x86_64

Inclut Homebrew et DMG pour macOS, Winget et MSI pour Windows, ainsi que Homebrew et tar.gz pour Linux x86_64.

macOS

Voie recommandée pour une installation ultra-rapide sur macOS.

brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktop

Téléchargez le dernier `KatanA-Desktop-x.y.z.dmg` depuis GitHub Releases.
Déplacez `KatanA Desktop.app` dans votre dossier Applications.
Exécutez la commande Gatekeeper si nécessaire avant le premier démarrage.
Sur macOS Sequoia (15.x), cela peut être requis pour les builds non notarisés. Sinon, autorisez via Réglages Système > Confidentialité et sécurité.

xattr -cr /Applications/KatanA\ Desktop.app

Winget est le chemin le plus court sous Windows. MSI également disponible sur GitHub Releases.

Installez via Winget ou téléchargez `KatanA-windows-x86_64.msi` sur GitHub Releases.
Double-cliquez pour installer.
Les raccourcis Menu Démarrer et Bureau sont créés automatiquement.

winget install HiroyukiFuruno.katana-desktop

Homebrew est recommandé si disponible. tar.gz également présent sur GitHub.

Installez via Homebrew ou téléchargez `KatanA-linux-x86_64.tar.gz` sur GitHub Releases.
Extrayez l'archive.
Lancez le binaire directement.

brew tap HiroyukiFuruno/KatanA && brew install katana-desktop

KatanA offre une fonction d'auto-mise à jour intégrée.
Sur macOS, utilisez le bouton "Update & Restart" dans l'application.
Sur Windows/Linux, la boîte de dialogue renvoie vers la dernière version.
Si installé via Homebrew sur macOS, la première mise à jour gérée par l'app détache Homebrew pour éviter les conflits.

Seul PlantUML peut nécessiter un runtime additionnel.

Mermaid

Les diagrammes Mermaid s'affichent dans le flux documentaire actuel.

PlantUML

Lancer `brew install openjdk@25` et téléchargez `plantuml.jar` lors de la première ouverture d'un doc PlantUML.

Draw.io

Les diagrammes Draw.io fonctionnent nativement dans le flux actuel.

apres installation

Ouvrir workspace: verifier README et specs dans l arbre.
Confirmer les diagrammes: ouvrir Mermaid, ZenUML inclus, ou PlantUML et verifier le rendu.
Verifier les updates: lancer une verification d update dans l app.

support

PlantUML ne s affiche pas

Installez Java runtime puis autorisez plantuml.jar.

macOS bloque l application

Utilisez Open Anyway dans Privacy & Security ou xattr une fois.