Configurazione e download
Installa KatanA
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.
- 01
Supporto Homebrew e Winget
- 02
Download diretti disponibili
- 03
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
macOS + Homebrew
Il modo più rapido per installare KatanA su macOS.
- Metodo consigliato nel README ufficiale.
- Pronto all'uso subito dopo l'installazione.
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopDownload manuale macOS
- 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.appWindows x86_64
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-desktopLinux x86_64
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-desktopAggiornamenti
- 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.
Configurazione diagrammi opzionale
Mermaid e ZenUML non richiedono configurazione aggiuntiva; solo PlantUML può richiedere un runtime aggiuntivo.
Mermaid
Nessuna configurazione
I diagrammi Mermaid vengono renderizzati nel flusso documento attuale.
PlantUML
Installa Java Runtime
Usa `brew install openjdk@25` e scarica `plantuml.jar` al primo avvio di un doc PlantUML.
Draw.io
Nessuna configurazione
I diagrammi Draw.io funzionano nativamente nel flusso attuale.
dopo installazione
Dopo installazione (3 verifiche)
- 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
FAQ
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.