Instalação

Todos os downloads estão em ultra-gx.com. Ao lado de cada arquivo é publicado o seu hash SHA-256, caso você queira verificar se o download chegou íntegro.

Requisitos

Não é preciso instalar Python, Node nem .NET: o motor e o aplicativo já vêm compilados.

Para ler uma KB ao vivo (sem exportá-la antes) é preciso Windows com o GeneXus X Evolution 1 a 18 instalado na mesma máquina. Para qualquer outro caso basta um export XPZ/XML ou um export de texto, e aí o sistema operacional não importa.

Espaço em disco: uma KB de 700 objetos gera cerca de 100 MB de documentação; uma de 5.000 objetos, em torno de 1 GB.

Windows

Com o instalador (recomendado)

1. Baixe UltraGX-<versão>-win-x64-setup.exe.
2. Execute-o. Se o Windows mostrar "O Windows protegeu o computador" (SmartScreen), clique em Mais informações e depois em Executar assim mesmo. O aviso aparece porque o instalador ainda é novo para o SmartScreen, não porque haja um problema com o arquivo.
3. Idioma: escolha English, Español ou Português. Esse idioma é usado no assistente, no contrato de licença exibido e como idioma inicial do aplicativo e dos documentos que ele gera. Os dois podem ser alterados depois.
4. Contrato de licença: leia e aceite para continuar.
5. Pasta de destino: por padrão C:\Users\<usuário>\AppData\Local\Programs\UltraGX. A instalação é por usuário e não pede permissões de administrador.
6. Tarefas adicionais (ambas opcionais):
   • Criar um ícone na Área de Trabalho.
   • Abrir exports do GeneXus (.xpz) com o UltraGX: com esta opção, ao dar um clique duplo em um .xpz, o UltraGX abre com a aba Executar pipeline pronta para documentá-lo.
7. Instalar. Se faltar o WebView2 no computador, o instalador o baixa e instala nesta etapa (é preciso conexão com a internet).
8. Ao terminar, deixe marcada a opção Executar UltraGX para abri-lo e continue em Primeiro início e licença.

No Windows, o instalador também inclui o conector do GeneXus, que permite ler uma KB ao vivo. Se não houver GeneXus instalado na máquina, o conector fica inativo e não atrapalha.

Linux

Escolha o formato adequado à sua distribuição:

# Debian / Ubuntu
sudo apt install ./ultragx_<versão>_amd64.deb

# Fedora / RHEL
sudo dnf install ./ultragx-<versão>-1.x86_64.rpm

Os pacotes instalam o aplicativo em /opt/ultragx, o comando ultragx e a entrada no menu de aplicativos, e declaram as dependências do WebKitGTK, então o gerenciador de pacotes as instala automaticamente.

AppImage (sem instalar): dê permissão de execução e abra-o. Nesse caso as dependências precisam estar presentes no sistema:

sudo apt install libwebkit2gtk-4.1-0     # Debian / Ubuntu
chmod +x UltraGX-<versão>-x86_64.AppImage
./UltraGX-<versão>-x86_64.AppImage

No Linux a fonte "KB ao vivo" não está disponível (o conector precisa do GeneXus, que é para Windows): exporte a KB para XPZ ou para texto na máquina onde está o GeneXus e documente-a aqui.

macOS

1. Baixe o .dmg adequado ao seu Mac: osx-arm64 para Apple Silicon (M1 em diante), osx-x64 para Intel.
2. Abra-o e arraste o UltraGX para Aplicativos.
3. A versão para macOS não é assinada com um Developer ID da Apple, por isso o macOS a bloqueia na primeira vez. Dê dois cliques em Allow UltraGX.command na imagem de disco (ou execute xattr -cr /Applications/UltraGX.app no Terminal) e abra o UltraGX. Se o macOS insistir, vá em Ajustes do Sistema → Privacidade e Segurança e clique em Abrir Mesmo Assim ao lado da mensagem do UltraGX.

Assim como no Linux, no macOS se trabalha com exports XPZ ou de texto.

Atualizar

Baixe a nova versão e instale-a por cima da anterior (no Windows, o instalador substitui os arquivos na mesma pasta). As configurações, as conexões de narrativa, a licença e as saídas geradas são preservadas.

As saídas geradas com uma versão anterior continuam podendo ser abertas. Para aproveitar as melhorias do novo motor, execute novamente o pipeline sobre a mesma KB: as notas do usuário e a narrativa já gerada são mantidas.

Desinstalar

• Windows: Configurações → Aplicativos → Aplicativos instalados → UltraGX → Desinstalar.
• Linux: sudo apt remove ultragx ou sudo dnf remove ultragx; a AppImage basta apagar.
• macOS: arraste o UltraGX de Aplicativos para o Lixo.

Desinstalar não apaga os seus dados:

Se quiser remover tudo, apague também a pasta de configurações e a sua pasta de saída. Lembre-se de que as configurações guardam as suas API keys.