Instalação e Empacotamento Nativo

Guia de Distribuição com Runtime Embutido (jpackage), Instaladores MSI e Implantação Corporativa

O CyberCore Signer foi projetado para distribuição nativa através da ferramenta jpackage (introduzida no JDK 14 e consolidada nas versões LTS 21/25). Isso significa que o usuário final não precisa instalar o Java ou configurar variáveis de ambiente (JRE/JDK) em sua máquina. O aplicativo carrega um runtime Java reduzido e isolado exclusivamente para sua execução.

1. Requisitos de Sistema

Sistema Operacional Alvo: Windows 10 (64-bit) ou Windows 11 (64-bit).
Compatibilidade Adicional: Distribuições Linux modernas x86_64 (Ubuntu 20.04+, Debian 11+, Fedora 38+, RHEL 9+).
Memória RAM: Mínimo de 4 GB (Recomendado: 8 GB).
Espaço em Disco: 180 MB livres para os arquivos da aplicação e runtime embutido.
Rede Local: A porta TCP 21325 deve estar livre no endereço de loopback 127.0.0.1.

2. Geração do Instalador Windows (MSI / EXE) com `jpackage`

2.1 Pré-requisitos para a Máquina de Build

Para compilar e gerar o pacote de instalação no Windows:

JDK 25 LTS: Com a variável JAVA_HOME devidamente configurada.
WiX Toolset (v3.11+): Necessário pelo jpackage para gerar instaladores .msi. Baixe em wixtoolset.org e adicione a pasta bin ao PATH.

2.2 Execução do Script de Empacotamento

Na raiz do projeto, execute o script em lote:

scripts\package-windows.bat

Ou execute manualmente os comandos do pipeline:

:: 1. Compilação do projeto e geração do Fat JAR consolidado
mvnw clean package -DskipTests

:: 2. Geração do instalador nativo via jpackage
jpackage ^
  --type msi ^
  --name "CyberCore Signer" ^
  --app-version 0.1.0 ^
  --vendor "CyberCore Systems" ^
  --input modules\cybercore-app\target ^
  --main-jar cybercore-signer.jar ^
  --main-class br.com.cybercore.signer.app.CyberCoreApp ^
  --icon assets\cybercore.ico ^
  --win-menu ^
  --win-shortcut ^
  --win-dir-chooser ^
  --dest dist

O instalador CyberCore Signer-0.1.0.msi será gerado dentro da pasta dist/.

3. Empacotamento para Linux (DEB / RPM / AppImage)

No ambiente Linux x86_64:

# Executar o script nativo:
./scripts/package-jpackage.sh

O script utiliza o jpackage com o parâmetro --type deb ou --type app-image, empacotando os binários nativos e dependências do JavaFX com suporte ao subsistema gráfico X11/Wayland.

4. Implantação Corporativa e Instalação Silenciosa

Para administradores de rede (AD / GPO / SCCM / Intune) que precisam instalar o agente em centenas de estações de trabalho de forma automatizada:

Instalação Silenciosa via Linha de Comando (MSI):

msiexec /i "CyberCore Signer-0.1.0.msi" /qn /norestart

Instalação com Registro de Log de Auditoria:

msiexec /i "CyberCore Signer-0.1.0.msi" /qn /l*v "C:\Temp\cybercore_install.log"

Desinstalação Silenciosa:

msiexec /x "CyberCore Signer-0.1.0.msi" /qn /norestart

5. Inicialização com o Sistema e Área de Notificação (System Tray)

Atalhos Criados: O instalador cria automaticamente atalhos no Menu Iniciar e na Área de Trabalho.
Inicialização Automática: Durante a instalação, pode ser adicionada uma entrada no registro do Windows: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run Chave: CyberCoreSigner -> Caminho: "C:\Program Files\CyberCore Systems\CyberCore Signer\CyberCore Signer.exe" --minimized
Área de Notificação: Quando iniciado, o agente minimiza para a bandeja do sistema (System Tray) ao lado do relógio do Windows, garantindo que o servidor local 127.0.0.1:21325 esteja sempre pronto para atender as solicitações das aplicações web homologadas.

3.8 KiB Raw Blame History