Configurazione e download

Usa i package manager per la velocità o i download diretti via GitHub Releases.

Opzioni di installazione per macOS, Windows x86_64 e Linux x86_64.

Questa pagina è mantenuta sincronizzata con il repository per garantire coerenza con gli ultimi artefatti di distribuzione.

Supporto Homebrew e Winget

Download diretti disponibili

Note per piattaforma incluse

Supporto attuale

macOS / Windows x86_64 / Linux x86_64

Include Homebrew e DMG per macOS, Winget e MSI per Windows e Homebrew/tar.gz per Linux.

macOS

Il modo più rapido per installare KatanA su macOS.

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

Scarica l'ultimo `KatanA-Desktop-x.y.z.dmg` da GitHub Releases.
Trascina `KatanA Desktop.app` nella cartella Applicazioni.
Se necessario, esegui il comando Gatekeeper prima del primo avvio.
Su macOS Sequoia (15.x), potrebbe essere richiesto per i build non notarizzati. In alternativa, autorizza tramite Impostazioni di Sistema > Privacy e Sicurezza.

xattr -cr /Applications/KatanA\ Desktop.app

Winget è il percorso più breve su Windows. MSI disponibile anche su GitHub Releases.

Installa tramite Winget o scarica `KatanA-windows-x86_64.msi` da GitHub Releases.
Doppio clic per installare.
I collegamenti al Menu Start e al Desktop vengono creati automaticamente.

winget install HiroyukiFuruno.katana-desktop

Homebrew consigliato se disponibile. tar.gz presente anche su GitHub.

Installa via Homebrew o scarica `KatanA-linux-x86_64.tar.gz` da GitHub Releases.
Estrai l'archivio.
Avvia direttamente l'eseguibile.

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

KatanA offre una funzione di auto-update integrata.
Su macOS, usa il pulsante "Update & Restart" nell'app.
Su Windows/Linux, la finestra di dialogo rimanda all'ultima release.
Se installato con Homebrew su macOS, il primo update gestito dall'app scollega Homebrew per evitare conflitti.

Mermaid e ZenUML non richiedono configurazione aggiuntiva; solo PlantUML può richiedere un runtime aggiuntivo.

Mermaid

I diagrammi Mermaid vengono renderizzati nel flusso documento attuale.

PlantUML

Usa `brew install openjdk@25` e scarica `plantuml.jar` al primo avvio di un doc PlantUML.

Draw.io

I diagrammi Draw.io funzionano nativamente nel flusso attuale.

dopo installazione

Apri workspace: verifica README e spec nell albero.
Conferma diagrammi: apri Mermaid, incluso ZenUML, o PlantUML e verifica il rendering.
Controlla updates: esegui una verifica update nell app.

supporto

PlantUML non renderizza

Installa Java runtime e consenti il download di plantuml.jar.

macOS blocca l app

Usa Open Anyway in Privacy & Security o esegui xattr una volta.