Como impedir que o Element Desktop trave no Wayland com Xwayland
Teste o Element Desktop através do Xwayland, preserve seus dados locais e isole problemas gráficos ou de pacotes quando o Linux Wayland trava o aplicativo.
Se o Element Desktop começou a apresentar falhas ou parou de abrir após uma atualização do Linux ou do aplicativo, primeiro teste-o usando o Xwayland: feche todos os processos do Element e, em seguida, inicie-o element-desktop --ozone-platform=x11a partir de um terminal. O Electron 38 alterou seu padrão para usar o Wayland nativo em uma sessão Wayland, e o Electron documenta a flag Xwayland como a maneira de retornar ao caminho de compatibilidade com o X11. Se isso estabilizar o Element, você terá uma solução alternativa prática enquanto verifica se há um pacote atualizado ou um problema específico do compositor.
Isso não prova que o Wayland seja a causa em todos os casos. O Element é um aplicativo Electron, mas as falhas também podem ser causadas por um pacote desatualizado, drivers gráficos, extensões ou configuração local. Siga os passos abaixo para isolar o problema sem excluir os dados da conta.
Wayland é o protocolo de exibição usado por muitos desktops Linux atuais. Xwayland é uma camada de compatibilidade que permite que aplicativos X11 tradicionais sejam executados dentro de uma sessão Wayland. O Electron 38 alterou o padrão da plataforma Ozone para auto; quando XDG_SESSION_TYPE=wayland, o Electron agora é executado nativamente no Wayland por padrão. O Electron também removeu a antiga ELECTRON_OZONE_PLATFORM_HINTvariável de ambiente . A opção documentada para forçar o uso do Xwayland é --ozone-platform=x11. Consulte a documentação de alterações significativas do Electron .
O Element Desktop executa o Element Web dentro do Electron. Seu código para desktop agora reside no repositório do Element Web, e o projeto documenta o aplicativo desktop como um aplicativo "encapsulado em Electron". A página de downloads do Element atualmente fornece o caminho oficial de instalação para Linux (Debian e Ubuntu) e links para pacotes mantidos pela comunidade para outras distribuições. O comportamento dos pacotes pode variar de acordo com a distribuição e o formato do pacote.
Abra um terminal e verifique qual sessão de exibição está ativa:
echo "$XDG_SESSION_TYPE"
element-desktop --version
Se o primeiro comando imprimir `<nome_da_sessão>` wayland, a sessão é Wayland. Se imprimir ` x11<nome_da_sessão>`, é menos provável que a alteração para o padrão Wayland do Electron explique a falha. O comando `version` pode não estar disponível para alguns formatos de pacote; nesse caso, verifique a tela "Sobre" do aplicativo ou o seu gerenciador de pacotes.
Inicie o Element a partir desse mesmo terminal e mantenha a saída visível:
element-desktop
Registre o primeiro erro exibido antes do fechamento da janela, juntamente com sua distribuição Linux, ambiente de desktop, driver gráfico, versão do Element e tipo de instalação (por exemplo, pacote APT do Element, Flatpak ou pacote da comunidade). Não publique tokens de acesso, conteúdo de mensagens ou dados privados da conta ao compartilhar registros.
Feche o Element completamente antes de iniciar o teste. Verifique se há processos restantes e encerre apenas os processos do Element, se necessário.
pgrep -a element
Se o processo estiver travado, feche-o pelo monitor do sistema do seu computador ou, pkill element-desktopapós confirmar que o processo listado é o Element, execute o seguinte comando:
element-desktop --ozone-platform=x11
Para o pacote oficial do Debian/Ubuntu, o executável normalmente é ` element-desktop. Outros pacotes podem usar um inicializador diferente. Para o Flatpak, tente passar a opção `--flatpak` após o ID do aplicativo:
flatpak run im.riot.Riot --ozone-platform=x11
Se esse ID de aplicativo não estiver instalado no seu sistema, use-o flatpak listpara encontrar o ID do aplicativo Element e substitua-o. Não adicione a flag a um comando wrapper aleatório sem verificar a sintaxe de inicialização do pacote.
Experimente o aplicativo por alguns minutos e repita a ação que causou a falha anteriormente. Se ele permanecer aberto, use a inicialização via Xwayland como uma solução alternativa temporária. O Electron observa que alguns comportamentos de janela diferem entre o Wayland nativo e o Xwayland; por exemplo, certas operações programáticas de redimensionamento e posicionamento de janela são restritas no Wayland. A documentação do Electron BrowserWindow descreve essa limitação e a opção de alternar para o Xwayland.
Para um teste único, o comando no terminal é o mais seguro, pois não altera nenhum arquivo. Se ele resolver o problema de forma consistente, você pode adicionar o argumento ao seu iniciador de aplicativos na área de trabalho. O método exato depende de como o Element foi instalado:
Exec= copie o iniciador do sistema para o diretório de aplicativos do usuário e, em seguida, edite a linha do iniciador copiado para adicionar ` --ozone-platform=x11. Não edite o arquivo vendor em /usr/share/applications; atualizações de pacotes podem substituí-lo.flatpak run im.riot.Riot --ozone-platform=x11. Confirme primeiro o ID do aplicativo instalado.Mantenha o comando original do inicializador e adicione a flag após o ID do executável ou do aplicativo Flatpak. Evite alterações drásticas no shell, como exportar uma variável obsoleta ELECTRON_OZONE_PLATFORM_HINT; o Electron 38 removeu essa variável. Você pode remover o argumento adicionado posteriormente para retornar ao Wayland nativo.
Atualize o Element a partir da fonte de pacotes que você usou originalmente e, em seguida, teste novamente com o inicializador normal e com a flag Xwayland. A página oficial de download do Element lista as instruções atuais para Linux. Evite misturar pacotes de fontes diferentes, pois instalações duplicadas podem deixar vários inicializadores e versões no mesmo sistema.
Se o problema persistir, teste se o problema está no caminho gráfico executando o programa uma vez com a aceleração da GPU desativada:
element-desktop --disable-gpu
Este é um teste de diagnóstico, não uma configuração permanente recomendada. Se o comportamento for alterado, atualize o driver da sua placa gráfica através do método suportado pela sua distribuição e verifique se há problemas conhecidos com o compositor ou o driver da GPU. Não combine várias opções do Chromium de uma só vez; uma alteração por teste torna o resultado útil.
Você também pode verificar se o problema está limitado ao perfil local atual. Não exclua ~/.config/Elemento diretório de dados do Flatpak como primeiro passo: eles podem conter o estado local do aplicativo e removê-los pode encerrar sua sessão ou descartar dados não sincronizados. Uma verificação inicial mais segura é iniciar um perfil temporário separado, caso sua compilação suporte --user-data-dira opção do Electron, apontando-o para um novo diretório em `/etc/applications` /tmp. Considere isso apenas como um diagnóstico e não faça login se não precisar testar o comportamento da conta. Se um perfil limpo alterar o resultado, preserve o diretório original e investigue o estado local em vez de apagá-lo.
Após a alteração, inicie o Element várias vezes, abra a conversa ou visualização que anteriormente causava a falha e deixe-a em execução tempo suficiente para reproduzir a condição original. Confirme se o terminal não reporta mais o mesmo erro fatal. Em seguida, teste o inicializador normal novamente após a atualização: se a falha retornar apenas no modo Wayland nativo, mantenha a solução alternativa documentada para Xwayland e relate os detalhes ao Element, incluindo sua versão, distribuição, compositor, driver de GPU, comando de inicialização e logs anonimizados.
O rastreador de problemas do Element inclui um relato de um usuário do Ubuntu 24.04 que descreveu a falha na abertura do aplicativo no Wayland e relatou erros de exportação do buffer GBM. Esse problema demonstra uma falha relatada no caminho gráfico, não um diagnóstico universal ou uma solução confirmada para todos os sistemas. Consulte o relato no projeto Element . Se o Xwayland e uma atualização limpa dos pacotes não resolverem o problema, a saída do seu terminal e os detalhes do sistema serão mais úteis do que alterar repetidamente configurações irrelevantes.
Teste o Element Desktop através do Xwayland, preserve seus dados locais e isole problemas gráficos ou de pacotes quando o Linux Wayland trava o aplicativo.
Configure o Element Android com UnifiedPush e ntfy e, em seguida, verifique o gateway Matrix auto-hospedado e as configurações em segundo plano do Android quando os alertas falharem.
Restaure a detecção de fotos em segundo plano verificando as configurações de upload do Nextcloud, as permissões do iOS, o modo de bateria e os limites de agendamento em segundo plano do iPhone.
Compare os modos de sugestão de fontes do ONLYOFFICE, verifique o zoom e a disponibilidade de fontes para Linux e confirme se o desfoque se limita ao editor ou afeta toda a área de trabalho.
Converta um PDF localmente nos editores de desktop do ONLYOFFICE e, em seguida, revise o arquivo DOCX para verificar alterações de layout, páginas digitalizadas e texto que precisa de correção.
Adicione sua conta ownCloud aos Editores de Desktop ONLYOFFICE, entenda o que a conexão permite e escolha entre acesso direto, sincronização e edição pelo navegador.
Use o portal ou endereço WebDAV correto, teste a acessibilidade HTTPS a partir do seu telefone e identifique problemas relacionados a redes privadas, TLS e login.
Crie e teste um plugin personalizado para o ONLYOFFICE Desktop Editors, instale o arquivo .plugin e ative as ferramentas de desenvolvedor para depuração.
Disponibilize uma função Python no Calc, execute-a na planilha aberta e solucione problemas de macros ou importações ausentes sem misturar o LibreOffice com o Python do sistema.
Bloqueie uma passagem específica contra edições de rotina, mantendo o restante do documento do Writer utilizável, e aprenda quando a criptografia de arquivos é a melhor opção.