Relatórios de Bugs e Funcionalidades

Todos os relatórios de bugs, pedidos de funcionalidades e discussões vão para o repositório GitHub da integração.

Verificar Atualizações

Verificar o HACS garante que a versão mais recente da integração está a correr antes de abrir um problema. Um bug reportado ou funcionalidade solicitada pode já existir numa versão recente.

Verifique primeiro o FAQ

Dispositivos não suportados, falhas de login/conexão e falhas ou falta de memória do Home Assistant já estão cobertos na página FAQ e não são considerados bugs.

Abrir um problema no GitHub

Solicitar uma Funcionalidade

Novas ideias de funcionalidades e melhorias são sempre bem-vindas.

É necessária uma descrição clara da ideia, a razão da sua utilidade e a funcionalidade imaginada. Mockups, esboços ou exemplos de outras apps, como a app oficial Dreame, facilitam pedidos de alterações visuais ou comportamentais.

Solicitar Suporte para Novo Modelo Opcional

O processo de adicionar suporte a novos modelos de dispositivos é semi-automático e incluído em cada nova versão de integração. Embora normalmente seja suficiente esperar pelas próximas versões, um pedido de Suporte a Novo Modelo pode ser aberto, se necessário.

Ao solicitar suporte para um novo dispositivo, as seguintes informações são necessárias:

• Versão do Home Assistant
• Número do Modelo do Dispositivo
• Registo de Dispositivo Não Suportado (Isto deve ser extraído dos registos do Home Assistant e fornecido na questão)

Antes de abrir o pedido, assegure-se de que a versão mais recente da integração está instalada, o Home Assistant foi reiniciado, e as listas de dispositivos suportados/não suportados na documentação foram verificadas.

Fazer uma Pergunta

Para dúvidas ou discussões gerais que não sejam erros ou pedidos de funcionalidades, uma questão do tipo Pergunta pode ser aberta para pedir ajuda ou esclarecimentos sobre o projeto.

Reportar um Erro

Fornecer informações claras e detalhadas quando ocorre um comportamento inesperado acelera o processo de resolução. Ao abrir um relatório de erro, são necessárias as seguintes informações:

• Nome do Modelo (por exemplo, dreame.vacuum.p2028)
• Versão do Firmware (por exemplo, 1156)
• Versão do Home Assistant
• Tipo de configuração
• Erros ou avisos dos registos do Home Assistant (se aplicável)

Obter Registos de Depuração

A resolução de problemas de ligação, entidades em falta ou estados inesperados requer a análise do que a integração realmente registou. Ativar o registo de depuração captura muito mais detalhes do que o nível de registo por defeito.

O registo de depuração pode agora ser facilmente ativado diretamente a partir da interface do utilizador do Home Assistant sem editar ficheiros de configuração. Para instruções detalhadas sobre como o ativar e descarregar os registos, consulte por favor o oficial Documentação de resolução de problemas do Home Assistant.

Proteger Dados Sensíveis

O ficheiro completo homeassistant.log contém informações sensíveis, como palavras-passe, tokens ou identificadores pessoais de outras integrações. Extrair e partilhar apenas as partes relacionadas com dreame_vacuum protege estes dados. Todo o ficheiro de registo não deve nunca ser enviado publicamente sem rever o seu conteúdo.