Skip to content

Instalação Linux

Jump to bottom
Rossi-Luciano edited this page Jun 29, 2026 · 1 revision

Instalação no Linux

Pré-requisitos

  • Distribuição Linux de 64 bits com suporte a GTK (Ubuntu 20.04+, Fedora 36+, Debian 11+ ou equivalentes)
  • Biblioteca WebKitGTK instalada (detalhes abaixo)
  • Nenhuma instalação de Python é necessária

Passo a passo

1. Baixar o AppImage

Acesse a página de Releases do repositório e localize a versão mais recente. Baixe o arquivo spsvalidator-linux.AppImage.

2. Tornar o arquivo executável

Abra o Terminal na pasta onde o arquivo foi baixado e execute:

chmod +x spsvalidator-linux.AppImage

Esse comando concede permissão de execução ao arquivo. É necessário fazer isso apenas uma vez.

3. Instalar a dependência WebKitGTK

O SPSValidator utiliza o motor WebKitGTK para renderizar a interface. Caso ainda não esteja instalado no sistema, instale com o gerenciador de pacotes da sua distribuição:

Ubuntu / Debian:

sudo apt install libwebkit2gtk-4.0

Fedora:

sudo dnf install webkit2gtk4.0

Arch Linux:

sudo pacman -S webkit2gtk

Se não tiver certeza se a biblioteca já está presente, pule essa etapa e instale apenas se o aplicativo não abrir na etapa seguinte.

4. Executar o aplicativo

./spsvalidator-linux.AppImage

Também é possível executar com duplo clique no gerenciador de arquivos, desde que o arquivo tenha permissão de execução (passo 2).

Como verificar que a instalação funcionou

Após a execução, uma janela do SPSValidator será aberta. A instalação está correta se:

  • A janela abre sem mensagens de erro no Terminal
  • A tela principal exibe o formulário "Validar pacote SPS" com o botão de upload
  • A tabela "Pacotes validados" aparece abaixo do formulário (inicialmente vazia)

Se o aplicativo não abrir e o Terminal exibir um erro relacionado a bibliotecas GTK ou WebKit, certifique-se de que a dependência do passo 3 foi instalada corretamente e tente novamente.

Próximo passo: Como executar

Clone this wiki locally