Instalación

Todas las descargas están en ultra-gx.com. Al lado de cada archivo se publica su huella SHA-256, por si querés verificar que la descarga llegó entera.

Requisitos

No hace falta instalar Python, Node ni .NET: el motor y la aplicación vienen compilados.

Para leer una KB en vivo (sin exportarla antes) hace falta Windows con GeneXus X Evolution 1 a 18 instalado en la misma máquina. Para cualquier otro caso alcanza con un export XPZ/XML o un export de texto, y ahí da igual el sistema operativo.

Espacio en disco: una KB de 700 objetos genera unos 100 MB de documentación; una de 5.000 objetos, alrededor de 1 GB.

Windows

Con el instalador (recomendado)

1. Descargá UltraGX-<versión>-win-x64-setup.exe.
2. Ejecutalo. Si Windows muestra "Windows protegió su PC" (SmartScreen), hacé clic en Más información y después en Ejecutar de todas formas. El aviso aparece porque el instalador todavía es nuevo para SmartScreen, no porque haya un problema con el archivo.
3. Idioma: elegí English, Español o Português. Ese idioma se usa para el asistente, para el contrato de licencia que se muestra y como idioma inicial de la aplicación y de los documentos que genera. Los dos se pueden cambiar después.
4. Contrato de licencia: leelo y aceptalo para continuar.
5. Carpeta de destino: por defecto C:\Users\<usuario>\AppData\Local\Programs\UltraGX. La instalación es por usuario y no pide permisos de administrador.
6. Tareas adicionales (las dos opcionales):
   • Crear un acceso directo en el escritorio.
   • Abrir exports de GeneXus (.xpz) con UltraGX: con esta opción, al hacer doble clic en un .xpz se abre UltraGX con la pestaña Ejecutar pipeline lista para documentarlo.
7. Instalar. Si al equipo le falta WebView2, el instalador lo descarga e instala en este paso (hace falta conexión a internet).
8. Al terminar, dejá marcada Ejecutar UltraGX para abrirlo y seguí con Primer inicio y licencia.

En Windows el instalador incluye también el conector de GeneXus, que permite leer una KB en vivo. Si en la máquina no hay GeneXus instalado, el conector queda inactivo y no molesta.

Linux

Elegí el formato que corresponda a tu distribución:

# Debian / Ubuntu
sudo apt install ./ultragx_<versión>_amd64.deb

# Fedora / RHEL
sudo dnf install ./ultragx-<versión>-1.x86_64.rpm

Los paquetes instalan la aplicación en /opt/ultragx, el comando ultragx y la entrada en el menú de aplicaciones, y declaran las dependencias de WebKitGTK, así que el gestor de paquetes las instala solo.

AppImage (sin instalar): dale permiso de ejecución y abrila. En este caso las dependencias tienen que estar presentes en el sistema:

sudo apt install libwebkit2gtk-4.1-0     # Debian / Ubuntu
chmod +x UltraGX-<versión>-x86_64.AppImage
./UltraGX-<versión>-x86_64.AppImage

En Linux la fuente "KB en vivo" no está disponible (el conector necesita GeneXus, que es de Windows): exportá la KB a XPZ o a texto en la máquina donde está GeneXus y documentala acá.

macOS

1. Descargá el .dmg que corresponda a tu Mac: osx-arm64 para Apple Silicon (M1 en adelante), osx-x64 para Intel.
2. Abrilo y arrastrá UltraGX a Aplicaciones.
3. La versión de macOS no está firmada con un Developer ID de Apple, por eso macOS la bloquea la primera vez. Hacé doble clic en Allow UltraGX.command de la imagen de disco (o ejecutá xattr -cr /Applications/UltraGX.app en Terminal) y abrí UltraGX. Si macOS insiste, andá a Configuración del Sistema → Privacidad y seguridad y hacé clic en Abrir igualmente junto al mensaje de UltraGX.

Igual que en Linux, en macOS se trabaja con exports XPZ o de texto.

Actualizar

Descargá la versión nueva e instalala encima de la anterior (en Windows, el instalador reemplaza los archivos en la misma carpeta). La configuración, las conexiones de narrativa, la licencia y las salidas generadas se conservan.

Las salidas generadas con una versión anterior se pueden seguir abriendo. Para aprovechar las mejoras del motor nuevo, volvé a ejecutar el pipeline sobre la misma KB: las notas del usuario y la narrativa ya generada se mantienen.

Desinstalar

• Windows: Configuración → Aplicaciones → Aplicaciones instaladas → UltraGX → Desinstalar.
• Linux: sudo apt remove ultragx o sudo dnf remove ultragx; la AppImage se borra y listo.
• macOS: arrastrá UltraGX desde Aplicaciones a la papelera.

Desinstalar no borra tus datos:

Si querés quitar todo, borrá también la carpeta de configuración y tu carpeta de salida. Recordá que la configuración guarda tus API keys.