Skip to content

Instalação macOS

Rossi-Luciano edited this page Jun 29, 2026 · 2 revisions

Instalação no macOS

Pré-requisitos

  • macOS 12 (Monterey) ou superior
  • Nenhuma instalação adicional de Python ou dependências é necessária

Passo a passo

1. Baixar o arquivo

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

2. Extrair e mover para Aplicativos

Dê um duplo clique no .zip para extraí-lo. Em seguida, arraste o arquivo spsvalidator.app para a pasta Aplicativos (/Applications).

3. Abrir pela primeira vez

Como o aplicativo não é distribuído pela Mac App Store nem possui assinatura da Apple, o macOS bloqueará a execução ao dar um duplo clique. Para contornar isso apenas na primeira vez:

  1. Clique com o botão direito (ou Control + clique) no ícone do spsvalidator.app na pasta Aplicativos.
  2. Selecione Abrir no menu de contexto.
  3. Na janela de confirmação que aparecer, clique novamente em Abrir.

Após esse procedimento, nas execuções seguintes o aplicativo poderá ser aberto normalmente com duplo clique.

Alternativa via Terminal: caso a janela de contexto não apareça ou o aplicativo não abra, abra o Terminal e execute:

open /Applications/spsvalidator.app

Se ainda assim não funcionar, execute diretamente o binário interno para visualizar a mensagem de erro:

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

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 aparecer a mensagem "spsvalidator está danificado e não pode ser aberto", abra o Terminal e execute o comando abaixo para remover o atributo de quarentena do macOS:

xattr -cr /Applications/spsvalidator.app

Em seguida, tente abrir o aplicativo novamente.


Próximo passo: Como executar

Clone this wiki locally