Neste tutorial, vou te ensinar como adicionar um AppImage à barra de aplicativos no Linux. Usarei o Cursor como exemplo, mas esse processo pode ser aplicado a qualquer AppImage.

Por que algumas empresas distribuem apenas AppImages?

Muitas empresas optam por distribuir seus aplicativos como AppImages porque esse formato oferece:

• Portabilidade: Um único arquivo que pode ser executado em qualquer distribuição Linux sem precisar de instalação.

• Isolamento: O AppImage inclui todas as dependências necessárias, reduzindo conflitos com pacotes do sistema.

• Facilidade para desenvolvedores: Eles não precisam manter pacotes específicos para diferentes distribuições (como .deb para Debian/Ubuntu e .rpm para Fedora/CentOS).

Apesar dessas vantagens, a falta de integração automática pode ser um problema para usuários que preferem acessar os aplicativos pela interface gráfica (eu).

1. Mover o arquivo AppImage para um local adequado

Por padrão, os arquivos AppImage são baixados para a pasta ~/Downloads, mas é recomendável movê-los para um diretório centralizado, como /opt/nome-do-app/.

sudo mv ~/Downloads/Cursor-0.47.8.deb.glibc2.25-x86_64.AppImage /opt/cursor/

Lembre-se de substituir o arquivo .Appimage pela versão e nome correta do seu arquivo.

2. Dar permissão de execução ao AppImage

Para que o AppImage possa ser executado corretamente, conceda a permissão necessária:

sudo chmod +x /opt/cursor/Cursor-0.47.8.deb.glibc2.25-x86_64.AppImage

Ou você também pode fazer isso manualmente clicando com o botão direito, indo em propriedades e habilitar a opção de “Permitir a execução do arquivo como programa“:

3. Criar um atalho para o aplicativo

Agora, crie um arquivo .desktop na pasta /usr/share/applications/:

sudo nano /usr/share/applications/cursor.desktop

Dentro desse arquivo, adicione o seguinte conteúdo:

[Desktop Entry]
Name=Cursor
Exec=/opt/cursor/Cursor-0.47.8.deb.glibc2.25-x86_64.AppImage
Icon=/opt/cursor/cursor.png
Type=Application
Categories=Development;

Obs: O campo Icon= precisa apontar para um arquivo de imagem válido. Você pode mover o ícone para o mesmo diretório onde o .AppImage está.

4. Atualizar o cache do menu

Após criar o arquivo .desktop, atualize o cache do menu para garantir que o aplicativo apareça na barra de aplicativos:

update-desktop-database ~/.local/share/applications/

Agora, ao pesquisar pelo Aplicativo no menu de aplicativos, ele deve aparecer corretamente!

Como atualizar o AppImage

Se você precisar atualizar a versão do AppImage, siga estes passos:

1. Baixe a nova versão do site oficial

2. Mova o novo arquivo para /opt/, substituindo o antigo

    sudo mv ~/Downloads/opt/cursor/Cursor-0.50.17.deb.glibc2.25-x86_64.AppImage /opt/cursor/
   

3. Garanta que o novo arquivo tenha permissão de execução

    sudo chmod +x /opt/cursor/Cursor-0.50.17.deb.glibc2.25-x86_64.AppImage
   

   Obs: Também pode ser feito manualmente clicando com o botão direito e habilitando a opção “Permitir a execução do arquivo como programa”.

4. Verifique se o aplicativo funciona normalmente procurando ele nos seus aplicativos e executando

Isso garantirá que você sempre tenha a versão mais recente do aplicativo sem precisar reconfigurar nada!

Isso pode ser útil, por exemplo, para utilizar configurações específicas do VueDevTools, usar variáveis de ambiente diferentes, entre outras personalizações sem afetar os outros ambientes.

Criando um arquivo de configuração local

Por padrão, o Vite usa o arquivo vite.config.ts, mas podemos definir um arquivo diferente para iniciar o projeto localmente. Para isso, siga estes passos:

1. Crie um novo arquivo de configuração, por exemplo: my.config.ts.

2. Copie o conteúdo de vite.config.ts para esse novo arquivo e faça as modificações necessárias.

3. Ao iniciar o servidor de desenvolvimento, utilize a flag --config para indicar o novo arquivo:

    yarn dev --config my.config.ts
   

4. Para evitar que esse arquivo seja enviado ao repositório, adicione-o ao .gitignore:

    echo "my.config.ts" >> .gitignore
   

Conclusão

Dessa forma, você pode personalizar sua configuração do Vite exclusivamente para o ambiente local, sem impactar a versão usada por outros desenvolvedores ou nos ambientes de produção.

Desabilite o Corepack

corepack disable

Desinstale qualquer versão existente do yarn

npm uninstall -g yarn

Verifique se realmente está desinstalado, utilize alguns desses comandos

which yarn
yarn --version

Habilite o corepack

corepack enable

Agora vamos indicar qual versão do yarn queremos, assim o Corepack vai utilizar a versão 1.22.22 no seu projeto

yarn set version 1.22.22

Verifique a versão do yarn

yarn --version

Nesse momento deve aparecer no seu terminal 1.22.22 e deve ser possível instalar as dependências no seu projetocaso ainda tenha problemas, siga para a próxima possível solução.

Nesse caso vamos apenas cortar o mal pela raiz. Mudamos a versão do Node.js para alguma diferente da quele estamos utilizando no NVM

nvm install 20

Remover a versão com problema e instalar novamente

nvm uninstall 22.12
nvm install 22.12

Habilitar o corepack

corepack enable

Indicar qual a versão desejada do yarn

yarn set version 1.22.22

Verificar a versão do yarn

yarn --version

Agora você deve estar com a versão do yarn que deseja utilizar.