Skip to content

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:

powershell
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.

Distribuído sob a licença MIT.