AppReviewX Entrar

Teste de notarização e Gatekeeper antes do lançamento

Como verificar se seu app para Mac abre em um Mac limpo sem avisos. O que testar e o que as documentações oficiais dizem, com fontes.

Neste guia

Se você distribui um app para Mac fora da Mac App Store, a primeira coisa que o usuário encontra é se ele abre sem problemas. Seu próprio Mac é um teste ruim, porque ele já confia nos seus builds.

Fontes, consultadas em 2026-10-22: Apple Developer ID e Apple Platform Security: Gatekeeper and runtime protection. A Apple diz: "Gatekeeper on macOS helps protect users from downloading and installing malicious software by checking for a Developer ID certificate from apps distributed outside the Mac App Store." (O Gatekeeper no macOS ajuda a proteger os usuários contra o download e a instalação de software malicioso, verificando se há um certificado Developer ID em apps distribuídos fora da Mac App Store.) Sobre a notarização: "Give people even more confidence in your software by submitting it to Apple to be notarized." (Dê às pessoas ainda mais confiança no seu software enviando-o à Apple para ser notarizado.) O guia de segurança diz que o Gatekeeper "requests user approval before opening downloaded software for the first time." (pede aprovação do usuário antes de abrir pela primeira vez um software baixado.) O comportamento varia entre versões do macOS, então confira as páginas atuais da Apple para os detalhes.

Um teste em máquina limpa

  1. Use um Mac que nunca rodou suas ferramentas de build. Um segundo Mac, uma conta de usuário nova ou uma VM macOS limpa.
  2. Entregue o build da forma como os usuários o recebem. Envie-o para seu local de download e baixe-o em um navegador. Copiar por USB ou compartilhamento de rede pula a etapa que você quer testar.
  3. Abra com duplo clique. Registre exatamente o que aparece: nenhuma mensagem, um aviso ou um bloqueio.
  4. Se houver um aviso, anote-o palavra por palavra, com a versão do macOS. Decida se é esperado ou um problema de assinatura ou notarização. A página Developer ID da Apple diz que o software é enviado para notarização com a ferramenta de linha de comando "xcrun notarytool"; para verificar o status de assinatura e notarização, veja a documentação atual de notarização da Apple.
  5. Teste cada contêiner. Imagem de disco, zip ou pacote de instalação podem se comportar de forma diferente. Teste o que você entrega.
  6. Teste a primeira abertura e uma abertura posterior, e também depois de mover o app para a pasta Aplicativos.
  7. Teste o caminho de atualização. Uma atualização entregue a um app já instalado não pode disparar novos avisos.
  8. Teste de novo a cada mudança no build ou na configuração de assinatura. Um novo certificado ou um script de build pode quebrar um build que funcionava.

Registre os resultados

Versão do macOS Entrega Contêiner Resultado
Exemplo: uma versão recente Download pelo navegador Imagem de disco Abre, sem aviso

(A linha é um exemplo do formato, não um resultado real.)

Peça ajuda aos testadores

Peça a algumas pessoas em versões diferentes do macOS que baixem e abram o build, e que relatem a mensagem exata, com um modelo de relatório de bug.

O AppReviewX aceita apps pelo link da loja do Google Play, da App Store da Apple, da Mac App Store e da Microsoft Store. Apps Windows e Mac precisam já estar publicados na respectiva loja, e o AppReviewX não distribui builds nem instaladores. O feedback é privado e estruturado, um feedback aceito = um crédito, e avaliações na loja são voluntárias, não pagas e nunca obrigatórias. Voltar ao hub de apps Windows e Mac. Relacionados: teste de instalador e atualização no Windows, teste beta de um app Windows. Se você também publica no celular, comece grátis.