Como fazer capturas de ecrã úteis para reportar erros no Mac

Uma captura de um ecrã com problemas deixa algumas perguntas por responder: que ação causou o problema, o que deveria ter acontecido e se acontece sempre. Acompanhe uma captura focada com uma explicação breve para que a pessoa que investiga consiga reproduzir o problema.

Este é um fluxo prático para reportar um problema numa aplicação para Mac ou num site, com um modelo que pode copiar para um sistema de gestão de erros ou uma mensagem ao suporte.

1. Inclua contexto suficiente na imagem

Sempre que possível, capture o controlo que falha e o resultado ao mesmo tempo. Se o botão Guardar gerar um erro, inclua o botão, o erro e a parte relevante do formulário. Um ecrã inteiro dificulta encontrar detalhes pequenos; uma mensagem de erro isolada pode ocultar o ecrã que a gerou.

Use conteúdo de exemplo para reproduzir o problema. Recorte os separadores sem relação e os dados da conta. É melhor remover as credenciais e os dados privados na origem antes de capturar; uma ligeira desfocagem não é uma forma fiável de ocultar texto.

A captura de região do Floatie mantém o resultado a flutuar enquanto regressa à aplicação e verifica os passos. Faça outra captura se precisar de um estado diferente para explicar a sequência.

2. Assinale o que observou e depois explique

Uma seta para o controlo que falha costuma ser suficiente. Use chamadas numeradas quando o leitor precisar de seguir uma ordem e coloque a explicação junto ao anexo. Não desenhe sobre o texto exato do erro nem sobre o valor que demonstra o problema.

Com uma captura ativa no Floatie, ⌘E abre o editor Pro para adicionar setas, texto e indicações numeradas. A página da funcionalidade de edição apresenta as ferramentas.

Se o erro só existir como imagem, o OCR pode ajudar a copiar o texto (em inglês). Compare o resultado copiado com o original, sobretudo a pontuação e os caracteres parecidos. Inclua também o texto pesquisável do erro no relatório, além da imagem.

3. Adicione este modelo de reprodução

O exemplo abaixo é fictício; substitua-o pelas suas observações reais.

Título: Guardar continua desativado depois de introduzir o nome do projeto

Ambiente:
- Aplicação e versão:
- Versão do macOS:
- Navegador e versão, se relevante:

Passos:
1. Abra um projeto novo.
2. Introduza um nome.
3. Tente selecionar Guardar.

Esperado: Guardar fica disponível depois de introduzir um nome válido.
Obtido: Guardar continua desativado.
Frequência: Reproduzido em 3 de 3 tentativas.
Anexo: guardar-projeto-desativado.png

No campo da frequência, indique o que testou realmente. Se só aconteceu uma vez, diga-o. Para um problema de disposição num site, inclua as dimensões da janela ou o nível de zoom se afetarem o resultado.

4. Escolha entre uma captura e uma gravação

Uma captura serve para mostrar um valor incorreto, uma etiqueta em falta ou uma disposição quebrada. Uma gravação curta é mais útil se um menu desaparecer, houver uma deslocação inesperada ou for necessário mostrar uma sequência de cliques. Grave apenas a parte relevante do ecrã (em inglês) e pare assim que o comportamento ficar visível.

Anexe o ficheiro ao erro se tiver de continuar disponível junto ao relatório. Antes de o enviar, abra o anexo e confirme que o texto importante é legível. Se o limite de tamanho for um problema, reduza o tamanho da captura sem perder esse detalhe.

Experimente o Floatie no seu próximo relatório de erros