Configuration et téléchargement
Installer KatanA
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.
- 01
Support Homebrew et Winget
- 02
Téléchargements directs disponibles
- 03
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
macOS + Homebrew
Voie recommandée pour une installation ultra-rapide sur macOS.
- Méthode préférée selon le README officiel.
- Prêt à l'emploi immédiatement après l'installation.
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopTéléchargement manuel macOS
- 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.appWindows x86_64
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-desktopLinux x86_64
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-desktopMise à jour
- 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.
Configuration optionnelle des diagrammes
Seul PlantUML peut nécessiter un runtime additionnel.
Mermaid
Aucune config requise
Les diagrammes Mermaid s'affichent dans le flux documentaire actuel.
PlantUML
Installer le runtime Java
Lancer `brew install openjdk@25` et téléchargez `plantuml.jar` lors de la première ouverture d'un doc PlantUML.
Draw.io
Aucune config requise
Les diagrammes Draw.io fonctionnent nativement dans le flux actuel.
apres installation
Apres installation (3 verifications)
- 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
FAQ
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.