Problemas frequentes
A instalação para depois de conferir os arquivos
Se os arquivos mostram OK ou SUCESSO e a mensagem seguinte informa que falta libwebkit2gtk-4.1.so.0, o pacote passou na verificação e falta uma dependência do sistema. Veja problemas de instalação para a mensagem completa e os comandos para instalar o runtime e tentar novamente.
O aplicativo não abre
Confira a arquitetura e as bibliotecas GTK/WebKit indicadas na instalação. Execute o binário no terminal para obter a mensagem do sistema. Pacotes oficiais Linux usam WebKitGTK 4.1.
Docker não é encontrado
Inicie Docker Desktop ou o serviço Docker e confira docker info e docker context show no terminal. O aplicativo precisa usar o mesmo contexto e ter acesso ao socket. Não execute o aplicativo inteiro como root.
Um binding fica vermelho
Confira os parâmetros e o código informado. Cada ação aceita uma quantidade e tipos específicos: um código de tecla não é um texto arbitrário. Aliases personalizados devem existir em um header ou define do projeto. Corrija o rascunho ou descarte-o.
A importação falha
Confira teclado/variante e o número de teclas. Inclua headers locais ao lado do keymap. Includes .dtsi, condicionais e macros de pré-processador com parâmetros no próprio keymap não são expandidos pelo importador. Uma falha mantém a edição anterior.
Um aviso de gravação final aparece durante o flash
Se o flash informar sync …: input/output error ou Envio não confirmado, consulte reinicialização e avisos de gravação final. Uma reinicialização pode causar esse aviso mesmo quando o novo layout funciona, mas uma falha real pode ter a mesma mensagem. Teste o teclado antes de confirmar ou repetir o envio.
A atualização não aparece ou falha
A consulta usa releases públicas estáveis e precisa de internet. Pré-releases são ignoradas. Um repositório privado, limite da API, ausência de pacote para sua arquitetura ou instalação sem permissão de escrita pode impedir a atualização. Use o pacote oficial instalado na pasta do usuário e tente novamente pelo cabeçalho.
Se a nova versão iniciar e apresentar um problema, feche o app e restaure z-mapflow.previous na pasta de instalação ou reinstale uma release anterior. Preserve uma exportação do seu projeto antes de voltar a uma versão com esquema de dados diferente.
Reportar um problema
Abra uma issue com versão, sistema, teclado/variante, passos e logs. Remova informações pessoais antes de anexar sua configuração. Veja como contribuir.
Instalação e atualização no Windows
Use o setup x64 e mantenha o Microsoft WebView2 instalado. Feche uma instância aberta antes de reinstalar. Veja a instalação Windows.
Para compilar, o Docker Desktop precisa usar contêineres Linux. O comando abaixo deve retornar linux:
docker info --format '{{.OSType}}'Se acabou de instalar o Docker, reabra o Z-MapFlow para atualizar o ambiente. O app também verifica os diretórios padrão do Docker Desktop quando o menu Iniciar tem um PATH antigo.
A atualização aguarda o processo anterior encerrar e mantém z-mapflow.exe.previous. Em caso de problema após reiniciar, feche o app, preserve uma cópia do executável com falha e copie o backup de volta para z-mapflow.exe, ou reinstale um setup oficial anterior. Exporte o projeto antes de voltar para uma versão com outro schema de dados.