Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Configuração Manual do Script Tarball2AppImage

Mauricio Ferrari edited this page May 19, 2025 · 3 revisions

🧮 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.

Clone this wiki locally

AltStyle によって変換されたページ (->オリジナル) /