Este guia detalha a instalação da aplicação de ambiente de trabalho kDrive da Infomaniak num computador equipado com o sistema operativo Linux. Esta aplicação permite sincronizar automaticamente os ficheiros do seu computador com o seu espaço kDrive online.

Introdução

• Neste sistema operativo, algumas funcionalidades avançadas do kDrive não estão disponíveis, como a opção Lite Sync (que permite consultar os seus ficheiros sem os armazenar fisicamente no disco) ou o menu de contexto através do clique com o botão direito (para partilhar um link rapidamente, por exemplo).
• A aplicação kDrive é oficialmente suportada pela Infomaniak apenas nas seguintes configurações:
  • Ubuntu 22.04 LTS (e versões superiores)
  • Ambientes de desktop: GNOME ou KDE
• O aplicativo pode funcionar em outras distribuições Linux (Debian, Fedora, etc.) ou com outros ambientes de desktop, mas a Infomaniak não oferece suporte técnico para a instalação ou utilização fora das configurações mencionadas acima.

Instalação do kDrive no Linux

Pré-requisitos

• Descarregar a aplicação kDrive para Linux (é um ficheiro no formato .AppImage).
• D-Bus (sistema de comunicação interna presente na maioria das versões).
• Gnome-keyring ou KWallet (gestores de palavras-passe geralmente integrados, exceto nas versões muito simplificadas do Linux).

Em seguida:

1. Coloque o arquivo baixado em uma pasta de sua escolha, por exemplo, uma pasta chamada "Aplicativos" em seu diretório pessoal.
2. Clique com o botão direito no arquivo, escolha Propriedades e, em seguida, a guia Permissões.
3. Marque a caixa "Permitir a execução do arquivo como um programa".

Para que o kDrive seja iniciado automaticamente ao ligar o seu computador, adicione este ficheiro nas suas "Preferências de aplicações ao iniciar" (ou menu equivalente, dependendo do seu sistema).

Problemas conhecidos e soluções

Sincronização bloqueada ou erro "Inotify watches"

Se a sincronização parecer estar interrompida (por exemplo, na etapa 1/10) ou se os registos indicarem o erro Out of memory or limit number of inotify watches reached!, isso significa que o seu sistema está a limitar o número de ficheiros que pode monitorizar simultaneamente.

• Verificar o limite atual: digite o comando cat /proc/sys/fs/inotify/max_user_watches em um terminal.
• Aumentar o limite: para dobrar o valor (por exemplo, para 131072), execute:
  echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf
  Em seguida, aplique a alteração com: sudo sysctl -p

O aplicativo fecha ao abrir (AppArmor / Wayland)

Em algumas versões recentes do Ubuntu (24.04+) ou Debian, a segurança AppArmor pode impedir a abertura da janela de login.

• Solução AppArmor: instale as ferramentas necessárias: sudo apt install apparmor-utils. Em seguida, crie uma regra para o kDrive: sudo aa-autodep /path/to/kDrive.AppImage e reinicie o serviço: sudo service apparmor restart.
• Conflito com o Wayland: se o aplicativo apresentar falhas no Wayland, tente forçar a exibição clássica (X11) executando o aplicativo pelo terminal com o seguinte comando:
  export QT_QPA_PLATFORM=xcb && ./kDrive.AppImage

Problemas de exibição do ícone ou da janela

• Ícone invisível (Gnome): instale a extensão Suporte ao AppIndicator. Observe que a extensão Dash to Panel pode tornar os menus do aplicativo invisíveis e não é recomendada.
• Janela impossível de abrir: verifique se as bibliotecas de software libfuse2 e libdbus-1-dev estão instaladas no seu sistema.
• KDE Wayland: se a interface for exibida incorretamente, adicione estas linhas ao seu arquivo de configuração ~/.config/kdeglobals: 
  [QtQuickRendererSettings] 
RenderLoop=basic 
SceneGraphBackend=opengl

Erro ao armazenar as credenciais (Armazenamento de chaves)

Se o kDrive solicitar suas credenciais a cada inicialização ou exibir o erro Falha ao salvar as informações de autenticação no chaveiro:

• Certifique-se de que um gerenciador de senhas (Gnome Keyring ou KWallet) esteja instalado e desbloqueado ao abrir a sua sessão.
• Verifique se o serviço D-Bus org.freedesktop.secrets está configurado. Se estiver a usar o KWallet, o ficheiro /usr/share/dbus-1/services/org.freedesktop.secrets.service deve conter:
  [D-BUS Service]
Name=org.freedesktop.secrets
Exec=/usr/bin/kwalletd5

Utilização do AppImageLauncher

Se estiver a utilizar a ferramenta AppImageLauncher e a integração falhar, verifique se está a utilizar, no mínimo, a versão 3.0.0 (beta 2) para suportar o formato de compressão do kDrive.

Ajuda para diagnóstico em caso de falha

Se a aplicação fechar sem exibir uma mensagem de erro, pode gerar um relatório para análise técnica, extraindo as últimas atividades do seu sistema com este comando:
journalctl -r -n 1000 > kdrive_syslog.txt