Instalação

Instalação

Opção 1 — Binário pré-compilado (recomendado)

Acesse a página de Releases do repositório e baixe o arquivo correspondente ao seu sistema operacional.

Sem arquivos na página de Releases? Ainda não há binários publicados. Use a instalação a partir do código-fonte.

Windows

1. Baixe o arquivo spsvalidator-windows.zip (ou .exe) na página de Releases.
2. Extraia o conteúdo em uma pasta de sua escolha.
3. Execute o arquivo spsvalidator.exe.
   • Se o Windows exibir um aviso de segurança ("Windows protegeu seu PC"), clique em Mais informações → Executar assim mesmo.

macOS

1. Baixe o arquivo spsvalidator-macos.zip na página de Releases.
2. Extraia e mova spsvalidator.app para a pasta Aplicativos.
3. Na primeira execução, clique com o botão direito no ícone → Abrir → Abrir (necessário apenas na primeira vez, pois o app não é assinado pela App Store).

Se o app não abrir ao clicar duas vezes, abra o Terminal e execute:

/Applications/spsvalidator.app/Contents/MacOS/spsvalidator

O terminal exibirá a mensagem de erro, se houver.

Linux

1. Baixe o arquivo spsvalidator-linux.AppImage na página de Releases.
2. Torne o arquivo executável:

   chmod +x spsvalidator-linux.AppImage

3. Execute:

   ./spsvalidator-linux.AppImage

Dependência no Linux: a aplicação usa WebKitGTK. Caso apareça erro de biblioteca, instale:

# Ubuntu/Debian
sudo apt install libwebkit2gtk-4.0

# Fedora
sudo dnf install webkit2gtk4.0

---

Opção 2 — Instalação a partir do código-fonte (desenvolvedores)

Pré-requisito: Python 3.11 ou superior.

git clone https://github.com/scieloorg/spsvalidator.git
cd spsvalidator/spsvalidator
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -e ".[dev]"