功能说明
Quando você precisa disso
Se o Primuse fecha sozinho, para de responder, deixa músicas de fora na varredura, não consegue se conectar a uma fonte de música ou interrompe a reprodução, o desenvolvedor geralmente precisa de um registro do momento exato do problema. Os diagnósticos ficam no seu aparelho e nunca são enviados automaticamente; só saem dele quando você mesmo os envia.
Antes de começar
- Confira a versão do app: em Ajustes → Sobre aparecem Versão e Construir. Informe os dois no seu relato.
- Para enviar é preciso estar conectado à internet. Cada aparelho pode enviar até 5 vezes por dia, com até 8 MB por pacote.
Passo 1: ative o modo de diagnóstico (recomendado)
- Abra Ajustes → Sobre → “Relatórios de Diagnóstico”.
- Mac: Ajustes → Sobre → “Registros de diagnóstico…” e clique em “Relatórios de Diagnóstico” na janela que abrir.
- Apple TV: abra “Relatórios de Diagnóstico” em Ajustes.
- Ative “Gravar registros detalhados”. Nas próximas 24 horas o app registra detalhes extras para a solução de problemas e depois desliga a opção sozinho.
- Faça o problema acontecer de novo (por exemplo, refaça a varredura, toque a música de novo ou reconecte a fonte) e anote o horário aproximado.
O que aconteceu antes de ativar o modo fica só no registro básico, que pode ter poucos detalhes; por isso é melhor reproduzir o problema uma vez com o modo ativado.
Passo 2: envie ao desenvolvedor
- Na tela “Relatórios de Diagnóstico”, toque em “Enviar ao autor” na barra de ferramentas.
- Em “Anexos (opcional)”, escolha o que incluir: “Relatórios de Diagnóstico” (relatórios de falha e travamento, métricas de execução) e “Registros”.
- Se quiser, adicione capturas de tela em “Imagens (opcional)” (até 6, reduzidas automaticamente) e descreva em “Pedidos ou sugestões” o que você fez, o que esperava, o que realmente aconteceu e por volta de que horas.
- Toque em “Fazer upload para o autor” na parte de baixo. Aparecem, em sequência, “Empacotando…”, “Enviando …%” e “Confirmando…”.
- Quando aparecer “Enviado ao autor”, toque em “Copiar código” e cite o código no GitHub ou no seu e-mail.
Resultado esperado: um código de relatório é exibido. Depois de um envio bem-sucedido, os relatórios e registros enviados são removidos do aparelho.
A Apple TV não tem relatórios de falha do sistema, então só o registro e sua mensagem são enviados; depois que o código aparecer, use “Enviar outro” para mandar outro.
Se não der para enviar: e-mail ou Compartilhar
- Abaixo do botão de envio ficam “Enviar por e-mail em vez disso” ou “Compartilhar em vez disso”. O e-mail anexa os relatórios ou registros escolhidos, e você o revisa antes de mandar.
- Se o serviço de envio estiver indisponível, o botão não aparece; a barra de ferramentas mostra “Abrir e-mail” ou “Compartilhar” e o e-mail do desenvolvedor é exibido.
- Versões anteriores à 1.12.2 não têm envio direto; use “Enviar ao autor” para mandar por e-mail ou Compartilhar.
Compartilhar um único relatório
Toque em um relatório em “Relatórios de Diagnóstico” para compartilhar só ele. No Mac, “Exportar registros” mostra o arquivo de registro no Finder.
O que cada opção significa
| Opção | Significado |
|---|---|
| Relatórios de falhas e travamentos | Relatórios que o sistema deixa quando o app fecha sozinho ou trava por muito tempo; costumam aparecer depois que você abre o app de novo |
| Métricas de execução | Dados periódicos de execução do sistema, como pico de memória e motivos de encerramento |
| Registros | Registro do próprio app sobre reprodução, varredura e sincronização recentes; envios e compartilhamentos incluem só a parte mais recente |
| Gravar registros detalhados | Registra mais detalhes por 24 horas e depois desliga |
| Limpar logs | Apaga os registros deste aparelho; não dá para desfazer |
Privacidade
Os registros contêm títulos de músicas e caminhos de arquivos; endereços e contas das fontes de música são reduzidos a etiquetas curtas. Senhas, tokens e outras credenciais são removidos antes da gravação. O que você envia é usado só para resolver problemas e é apagado do servidor do desenvolvedor após 30 dias (antes, se faltar espaço). Antes de enviar, você pode desmarcar “Registros” ou deixar as capturas de fora.
Limites
- Cada envio tem no máximo 8 MB depois de empacotado; 5 envios por aparelho por dia, e tentativas não concluídas também contam.
- Relatórios e registros ficam guardados no aparelho por cerca de 7 dias.
- A Apple TV não tem relatórios de falha nem de travamento; o Apple Watch não tem tela de diagnóstico, então relate pelo iPhone emparelhado.