Nathan Virgílio's Blog
Criando e Configurando WebApps com Nativefier no Linux (Debian 12)

Photo by Alexander Shatov on Unsplash

Criando e Configurando WebApps com Nativefier no Linux (Debian 12)

Nathan Virgílio's photo
Nathan Virgílio
·

3 min read

Este tutorial guia você desde a instalação do Nativefier até a configuração completa da WebApp, garantindo que ela apareça no menu de aplicativos com ícone e funcionalidade corretos.

1. Instalar o Nativefier

Nativefier é uma ferramenta Node.js que transforma sites em aplicativos desktop.

  1. Instale o Node.js e npm (gerenciador de pacotes):

     sudo apt update
 sudo apt install nodejs npm -y

  2. Instale o Nativefier globalmente:

     sudo npm install -g nativefier

  3. Verifique a instalação:

     nativefier --version

    Você deve ver a versão instalada como saída.

2. Criar a WebApp

  1. Escolha o site para converter. Por exemplo, para criar uma WebApp do Office 365:

     nativefier "https://www.office.com" --name "Office365"

    • O que o comando faz:

      • Converte o site em um aplicativo desktop.

      • Cria uma pasta chamada Office365-linux-x64 no diretório onde o comando foi executado.

    • Parâmetros úteis do Nativefier:

      • --name: Nome da aplicação.

      • --icon: Caminho para um ícone personalizado (opcional).

      • --single-instance: Impede que várias instâncias sejam abertas.

  2. Verifique a pasta criada: A pasta estará no mesmo diretório onde você executou o comando:

     ls Office365-linux-x64

    Certifique-se de que o arquivo principal do aplicativo, como Office365, está presente.

    A pasta será criada na pasta home, mas você pode criar uma pasta só para seus webapps.

3. Criar o Arquivo .desktop

Para adicionar a WebApp ao menu de aplicativos, precisamos criar um atalho .desktop.

  1. Crie o arquivo:

     nano ~/.local/share/applications/Office365.desktop

  2. Adicione o seguinte conteúdo:

     [Desktop Entry]
 Version=1.0
 Type=Application
 Name=Office365
 Comment=Office 365 Web App
 Exec=/home/nathan/webapps/Office365-linux-x64/Office365
 Icon=/home/nathan/webapps/Office365-linux-x64/Microsoft_365_(2022).svg.png
 Terminal=false
 Categories=Office;X-Internet;

    Substitua:

    • Exec pelo caminho completo do executável da WebApp.

    • Icon pelo caminho absoluto de um ícone válido. Pode ser baixado da web ou selecionado entre ícones existentes.

  3. Salve o arquivo e saia do editor.

4. Garantir Permissões

  1. Marque o arquivo .desktop como executável:

     chmod +x ~/.local/share/applications/Office365.desktop

  2. Verifique o arquivo executável da WebApp: Certifique-se de que o binário gerado (Office365) também tenha permissões executáveis:

     chmod +x /home/nathan/webapps/Office365-linux-x64/Office365

5. Atualizar o Menu de Aplicativos

  1. Atualize a base de dados de atalhos:

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

  2. Teste o atalho no terminal:

     gtk-launch Office365

  3. Reinicie a sessão do GNOME (logout/login) para carregar o novo atalho.

6. Solução de Problemas Comuns

  • Ícone não aparece: Certifique-se de que o caminho do ícone em Icon seja absoluto e que o arquivo exista:

      ls /home/nathan/webapps/Office365-linux-x64/Microsoft_365_(2022).svg.png

  • Atalho não aparece no menu: Revalide o arquivo .desktop:

      desktop-file-validate ~/.local/share/applications/Office365.desktop

7. Resultado Final

Agora, a WebApp deve:

  • Aparecer no menu de aplicativos com o nome "Office365".

  • Ter um ícone personalizado.

  • Funcionar sem precisar navegar até o diretório do aplicativo.

webappsdebian