Configuração Manual do Script Tarball2AppImage

🧮 Script Tarball2AppImage

O arquivo APP-Tarball2AppImage em tools, pode ser configurado manualmente sem a interface de configuração. Para isso, você deve configurar as variáveis a seguir. Mas, primeiro você deve fazer uma cópia do script antes de editar.

cd ~/ArchAppImage
cp -a tools/APP-Tarball2AppImage ./anydesk-Tarball2AppImage

Aqui, estamos assumindo que você tem o diretório de projetos do AppImage em ~/ArchAppImage.

📦 Configuração do Pacote

pkgname=  

Essa variável é a única que deve ser preenchida obrigatoriamente, que é o nome do pacote. Note que o nome da variável é diferente do APP-ArchAppImage porque ele usa como referência os links do projeto AUR do ArchLinux para fazer a busca dos links.

aur_name=  # optional

Essa parte embora seja opcional pode ser bastante útil, pois no projeto AUR tem bastante pacotes em Tarball com a finalização "-bin" como por exemplo "anydesk-bin" e por isso, o uso dessa variável torna-se necessário.

version=   # optional

Aqui é definido a versão manualmente. Mas, geralmente o projeto tentará buscar pela versão automaticamente e se isso não for possível, ainda tem como optar por um link customizado para a busca pela versão, que será explicado a seguir.

#️⃣ Sudo Gráfico

enable_graphic_sudo=0                # 0 (false) or 1 (true)

Existem aplicações que precisam ser abertos como superusuário para funcionar perfeitamente. Então, essa variável pode ser configurada para ativar o uso do pkexec, que abrirá um interface para digitar a senha de superusuário para abrir o programa com privilégios elevados.

Note que o pkexec precisa estar instalado no sistema para poder funcionar perfeitamente. Caso contrário, o programa só funcionará como root via terminal com sudo.

🧩 Auto Integração com o Sistema

enable_auto_integration=0  # 0 (false) ou 1 (true)  

Útil para quem quer trabalhar com AppImage que faz a integração automática com a área de trabalho. Isso altera a variável AUTO_INTEGRATION no AppRun. Assim, toda vez que o AppImage inicia, ele vai verificar se ele já está integrado no sistema e se não estiver integrado, será feita a autointegração.

enable_auto_integration_autostart=0  # 0 (false) ou 1 (true)  

Você também pode configurar o AppImage de programas como por exemplo Telegram e Discord, para iniciarem na inicialização do sistema automaticamente usando essa opção. Isso altera a variável AUTOSTART no AppRun e dessa forma é feita a verificação se o arquivo Desktop do programa está presente em ~/.config/autostart/ para poder ser autoinicializável ao iniciar a sessão do usuário.

autostart_parms=  # opcional  

Alguns programas contam com parâmetros para a auto inicialização e que podem ser definidos nessa variável para que o AppRun os adicionem durante a integração.

Note que as opções de AppRun tentam atender ao máximo o padrão POSIX, porém ainda é necessário o coreutils, grep, sed e demais ferramentas do sistema para a integração funcionar perfeitamente. Se a integração falhar, o AppImage ainda irá abrir normalmente.

🎨 Arquivo Desktop e Ícone Personalizados

local_icon=     # optional
local_desktop=  # optional

Essa parte da configuração só será definida se você precisar definir um arquivo desktop e um ícone manualmente ou se quiser usar um ícone ou um arquivo desktop diferente do fornecido pelo pacote. Geralmente, a detecção desses arquivos é automática e se não for encontrado automaticamente, será gerado um arquivo desktop no lugar e baixado um ícone alternativo.

custom_desktop_link=  # optional
custom_icon_link=     # optional

Caso um arquivo desktop ou um ícone não seja encontrado, já que se trata de pacotes em Tarball, é só usar essas variáveis para definir um link para baixar o arquivo desktop e o ícone. Dessa forma, não há a necessidade de gerar um arquivo desktop ou baixar um ícone alternativo.

🏷️ Detecção Automática de Versão

custom_search_link=          # optional

Essa configuração é para usar um link personalizado para fazer a busca pela versão mais atualizada do programa. Mapear a última versão de um programa pode não ser tão fácil, por isso pode ser necessário um link que possibilite a busca pela versão do programa.

custom_search_link=          # optional

Já esse é para definir um link personalizado para baixar o pacote para a criaçao do AppImage sem depender necessariamente pela busca automática da versão ou do link.

reference_search=  # optional
custom_regex=      # optional

Essas configurações podem ser configuradas caso o método de busca pela versão do programa não funcione para mapear a versão. Por padrão, é usado expressão regular para mapear a versão do programa após uma busca pelo padrão pkgver presente no pkgbuild hospedado no repositório do AUR. Mas essa busca não é garantida e pode mudar. Além disso, o link customizado pode exigir um padrão de busca e uma regex diferente para mapear a versão corretamente.

⚙️ Configurações do AppRun

custom_apprun=    # optional

Aqui você pode configurar um AppRun customizado para o seu AppImage. O AppRun não segue um padrão universal e pode ser necessário uma intervenção manual para que o AppImage funcione corretamente. Essa configuração é justamente para apontar para um AppRun ajustado manualmente.

custom_command=   # optional - /$pkgname*/$pkgname.sh

Nessa parte é definido um comando personalizado para a execução do programa em AppImage. A detecção automática do possível script ou executável do programa tem que lidar com diversas possibilidades de programas empacotados em Tarball que podem ter diferentes métodos de execução e diferentes locais para os executáveis. Essa configuração resolve esse problema.

custom_parms=     # optional

Alguns programas podem iniciar com comandos personalizados e podem ser colocados nessa configuração.

🚀 Ajustes e Criação do AppImage

appimage_dest_dir=  # optional

Use essa configuração para definir um destino para a criação do AppImage, que por padrão é o diretório atual do projeto.

recreate_appdir=0    # 0 (false) ou 1 (true)  

Essa configuração serve para recriar o AppDir toda vez que o script é executado. Geralmente não há a necessidade de ativar essa opção a menos que você queira se certificar de que o AppDir vai ser gerado corretamente ao executar o script.

create_appimage=0    # 0 (false) ou 1 (true)  

Sim, essa opção é desativada por padrão, porque não faz sentido criar o AppImage sem saber se o programa vai funcionar ou não. O processo de empacotamento demanda bastante tempo e se após o empacotamento o AppImage não funcionar você terá que fazer os ajustes e empacotar de novo, o que significa ter que fazer isso até o AppImage funcionar e que provavelmente nunca será de primeira. Assim, você terá que esperar muito tempo para saber se o AppImage funcionou. Então, ao invés de testar o AppImage, você testa o AppRun dentro do AppDir e só depois que tudo estiver funcionando perfeitamente aí sim você ativa o empacotamento em AppImage.

Preferencialmente essa configuração deve ser mantida após a criação do AppImage ser bem sucedida, porque agora sim faz sentido a criação imediata do Appimage quando um usuário executar o script, pois tudo estará funcionando perfeitamente.