Download e Configuração
Instalar KatanA
Instale via gerenciador de pacotes ou download direto do GitHub.
Caminhos de instalação oficiais para os principais sistemas operacionais.
Esta página segue o repositório oficial para garantir acesso às versões mais recentes em todas as plataformas.
- 01
Homebrew & Winget disponíveis
- 02
Downloads diretos
- 03
Notas por plataforma
Plataformas Suportadas
macOS / Windows / Linux
Suporte completo para macOS (Intel/Silicon), Windows x86_64 e Linux x86_64.
macOS
macOS + Homebrew
O caminho mais rápido e recomendado para usuários de macOS.
- Método oficialmente recomendado no README.
- O app fica pronto para uso imediatamente.
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopDownload Manual no macOS
- Obtenha o `KatanA-Desktop-x.y.z.dmg` mais recente no GitHub Releases.
- Arraste o `KatanA Desktop.app` para a pasta Aplicativos.
- Caso encontre restrições do Gatekeeper no macOS Sequoia, você pode permitir em Preferências do Sistema > Segurança.
xattr -cr /Applications/KatanA\ Desktop.appWindows x86_64
No Windows, o Winget é a opção mais veloz, com MSI disponível para download direto.
- Instale via Winget ou baixe o `KatanA-windows-x86_64.msi`.
- Execute o MSI para concluir a instalação.
- Atalhos automáticos no Menu Iniciar e Área de Trabalho.
winget install HiroyukiFuruno.katana-desktopLinux x86_64
Homebrew é recomendado para Linux, com opção de arquivo tar.gz.
- Instale via Homebrew ou baixe o `KatanA-linux-x86_64.tar.gz`.
- Extraia o arquivo e execute o binário diretamente.
brew tap HiroyukiFuruno/KatanA && brew install katana-desktopMantendo-se Atualizado
- O KatanA possui um sistema inteligente de atualização integrado.
- No macOS, use o botão "Update & Restart" dentro do app.
- Windows e Linux recebem notificações que levam ao último lançamento.
- Instalações via Homebrew no macOS migram automaticamente para o atualizador nativo após o primeiro update para evitar conflitos.
Configuração Opcional de Diagramas
Mermaid e ZenUML não exigem configuração extra; somente PlantUML pode exigir ferramenta adicional.
Mermaid
Sem setup extra
Diagramas Mermaid, incluindo diagramas de sequência ZenUML, renderizam no fluxo atual do documento.
PlantUML
Runtime Java
Instale o Java (`brew install openjdk@25`) e baixe o `plantuml.jar` quando solicitado pelo app.
Draw.io
Nativa
Renderização integrada, sem necessidade de configuração extra.
apos instalar
Apos instalar (3 verificacoes)
- Abrir workspace: confirme README e specs na arvore.
- Confirmar diagramas: abra Mermaid, incluindo ZenUML, ou PlantUML e valide renderizacao.
- Verificar updates: execute a verificacao de update no app uma vez.
suporte
FAQ
PlantUML nao renderiza
Instale Java runtime e permita baixar plantuml.jar.
macOS bloqueia o app
Use Open Anyway em Privacy & Security ou execute xattr uma vez.