cybercore-signer/docs/installation.md

Instalação e Empacotamento Nativo

O CyberCore Signer foi projetado para distribuição sem exigir que o usuário final tenha o Java ou JRE instalado em seu computador.

---

1. Requisitos de Sistema

• Sistema Operacional Homologado: Windows 10 (64-bit) ou Windows 11 (64-bit).
• Compatibilidade Adicional: Linux x86_64 e macOS (arquitetura preparada).
• Hardware: Mínimo de 4 GB RAM, 150 MB de espaço em disco.
• Porta de Rede Local: A porta TCP 21325 deve estar livre em 127.0.0.1.

---

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

O empacotamento utiliza a ferramenta nativa jpackage incluída no JDK 21/25.

No Windows:

Execute o script em lote localizado na raiz:

scripts\package-windows.bat

O que o script realiza:

1. Compila o projeto em modo release:

   mvnw clean package -DskipTests
   

2. Invoca o jpackage criando o instalador Windows:
   • Extrai um runtime mínimo customizado contendo apenas os módulos necessários (java.base, java.desktop, java.smartcardio, jdk.crypto.cryptoki, etc.).
   • Cria atalhos na Área de Trabalho e no Menu Iniciar.
   • Gera um instalador padrão MSI ou EXE em dist/.

---

3. Instalação e Inicialização com o Sistema

1. Execute o instalador CyberCore-Signer-0.1.0.msi.
2. Siga as instruções do assistente de instalação.
3. Ao concluir, o ícone do CyberCore Signer aparecerá na Área de Notificação (System Tray) ao lado do relógio do Windows.
4. O serviço local http://127.0.0.1:21325 estará imediatamente disponível para atender as aplicações web autorizadas.