Troubleshooting

Solução de problemas

O programa não aparece no menu

Se instalou o pacote user-local:

• encerre e abra novamente a sessão gráfica;
• confirme se o desktop entry foi instalado em $XDG_DATA_HOME ou ~/.local/share/applications;
• se necessário, atualize o cache do desktop conforme seu ambiente.

O shell não encontra o comando

Confira:

${XDG_BIN_HOME:-$HOME/.local/bin}

e o seu PATH.

Você ainda pode iniciar pelo menu do desktop quando a integração estiver disponível.

Biblioteca compartilhada ausente

No pacote extraído:

ldd bin/digital-ham-radio-logbook

Procure linhas com not found.

Use uma release compatível com sua distribuição ou instale a dependência nativa fornecida pela distribuição.

AppImage não inicia por FUSE

Tente:

APPIMAGE_EXTRACT_AND_RUN=1 ./digital-ham-radio-logbook-*.AppImage

Backup/export informa que o destino existe

O aplicativo evita sobrescrita silenciosa.

Escolha um novo nome de arquivo.

Backup/export não consegue gravar

Verifique:

• se o diretório pai existe;
• se é um diretório;
• se o usuário possui permissão de escrita;
• se existe espaço livre;
• se o destino final ainda não existe.

Configuração inválida

Preserve config.toml.

Com o aplicativo fechado, você pode movê-lo para outro nome e iniciar novamente para recriar defaults.

Banco e configuração são independentes.

Banco com schema mais novo

Não tente downgrade forçado.

Atualize o aplicativo ou restaure um backup compatível.

Veja Recuperação de dados.

Banco reporta corrupção

Pare de editar.

Preserve:

• banco;
• -wal;
• -shm.

Depois verifique backups e siga Recuperação de dados.

ADIF não importa tudo

Abra o preview.

O aplicativo separa:

• novos;
• duplicados;
• inválidos.

Registros inválidos não são gravados e duplicados são ignorados pela regra documentada.

Veja Importar ADIF.

A aparência não segue o sistema

Confira Settings → Appearance.

Para acompanhar o desktop, escolha System.

Consulta de callsign/grid não abre

Veja Consultas externas.

Ainda com problema?

Consulte:

• Ambientes suportados
• Perguntas frequentes
• o repositório do projeto para issues e código.