Como compilar o Aseprite no Linux Mint

 Aprenda como compilar o Aseprite à partir do código fonte no Linux Mint

 

 

Nós vamos começar o ano de 2026 com mais um tutorial de Linux aqui no blog, e dessa vez será algo mais complexo, porque nós vamos aprender à compilar um software usando seu código fonte. Compilar, na programação, significa traduzir o código fonte de um software escrito em uma linguagem compreensível aos humanos (pense C++, Java, Rust etc) para uma linguagem de baixo nível compreendido somente pela CPU do computador. O Aseprite é uma ferramenta popular para criar e editar pixel art, bastante utilizado por artistas amadores e profissionais. 

 

O Aseprite é um programa pago, mas o seu código fonte está totalmente aberto e disponível ao público. Então, qualquer pessoa com o conhecimento pode pegar esse código e "construir" o instalador do Aseprite, completo e de graça. Neste tutorial eu vou te ensinar como fazer isso no sistema operacional Linux Mint. 

 

Eu passei alguns dias quebrando a minha cabeça aprendendo isso, porque o artigo oficial do Aseprite parece estar desatualizado ou faltando informações cruciais, que eventualmente geram erros inesperados durante a compilação. Assim sendo, eu escrevo este artigo para que não só eu não me esqueça de cada passo, como meus amigos da Internet também possan encontra-lo e ter uma luz, já que eu não encontrei tutoriais em português sobre esse assunto. Sem mais delongas, vamos começar.

 

Passo 0 - Atualize seu sistema

 

Sempre importante. Eu compilei o Aseprite no Linux Mint  22.2, na kernel 6.8.0-90-generic. Não se esqueça de antes de tudo verificar atualizações pendentes no Gerenciador de Atualizações do Linux Mint. Reinicie seu PC após isso.

 

Passo 1 - Baixe o código fonte do Aseprite

O método que deu certo pra mim envolve baixar o código fonte manualmente. Clique aqui para acessar a página do Github do projeto Aseprite e baixe a versão mais recente do código fonte (Latest). 

 

Clique nessa opção para baixar o código fonte

 

Você vai baixar o arquivo zipado Aseprite-v1.3....-Source.zip. Não baixe a versão Pre-Release no topo da página, baixe sempre a versão Latest, que é mais estável. 

 

Descompacte o conteúdo da pasta zipada para um outro diretório chamado aseprite. Você ficará com um diretório assim:

 

Todo o código fonte do Aseprite, descompactado. Crie uma pasta chamada build na raiz desse diretório

 Passo 2 - Baixe o Skia pré-compilado

O Skia é um componente essencial para compilar o Aseprite corretamente.  

 

Clique aqui para acessar a página do Github do Skia e baixe a versão Skia-m mais recente (Latest). Não baixe a versão Pré-release!

Em Assets, baixe a versão do Skia referente ao seu sistema operacional. Como neste tutorial estamos compilando o Aseprite no Linux Mint 64 bits, então vamos baixar o arquivo zipado Skia-Linux-Release-x64.zip.

 

Aviso para sistemas 32 bits: Caso você esteja rodando um sistema Linux 32 Bits, baixe a versão Skia-Linux-Release-x86.zip!

 

Essa parte é muito importante, então preste a atenção: descompacte o conteúdo da pasta zipada Skia-Linux-Release-x64.zip para /~/[usuário]/deps/skia. Conforme mostra na imagem abaixo:

 

Em /~/, crie uma pasta chamada deps, e dentro dela crie uma pasta chamada skia. Descompacte todo o conteúdo de Skia-Release-x64.zip dentro desse diretório, conforme mostra a imagem acima.

"Por que colocar o Skia-Release em /~/[usuário]/deps/skia?"

 

Porque se você seguir a recomendação do script automático do Github do Aseprite, ele vai baixar o Skia pré-compilado e guardá-lo dentro da pasta y dentro do diretório do código fonte do Aseprite, o que pode gerar falha na compilação mais tarde quando o compilador procurar pela localização do Skia em /~/[usuário]/.

 

Parte 3 - Instale todas as dependências do Linux

 

Para compilar o Aseprite no Linux Mint (e outros derivados do Ubuntu), é necessário a instalar algumas dependências. Você pode instalar  todas as dependências de uma vez com o seguinte comando no Terminal:

 

sudo apt-get install -y g++ clang cmake ninja-build libx11-dev libxcursor-dev libxi-dev libxrandr-dev libgl1-mesa-dev libfontconfig1-dev extra-cmake-modules libkf5kio-dev

 

Aguarde alguns minutos para concluir o download e instalação de todas as dependências. Recomendo reiniciar o seu PC após a instalação! 

 

Após instalar todas dependências, retorne à raiz do diretório do código fonte do Aseprite.  Crie uma pasta com o nome build:

 

mkdir build

Parte 4 -  Adicionando suporte à arquivos PSD do Photoshop ao Aseprite

 

Eu, sempre que possível, gosto de ter suporte à arquivos PSD em todos os meus programas de manipulação de imagem e arte. É possível adicionar esse suporte ao Aseprite, mas é preciso fazer algumas modificações no código fonte antes de compilar.

 

Dentro do diretório de código fonte do Aseprite, abra o arquivo src/psd/CMakeList.txt (imagem acima) em um editor de texto. Selecione e apague as linhas:

 

 if(CMAKE_CXX_COMPILER_ID MATCHES "Clang")
  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -stdlib=libc++")
endif()

 

 

Selecione essas três linhas e apague elas.

 

Salve as alterações no arquivo CMakeList.txt. Essas alterações evitam um erro de compilação caso você deixe suporte para arquivos PSD ativado e compile usando o clang.

 

Parte 5 - Compilando o Aseprite manualmente

 

Retorne à raiz do diretório do código fonte do aseprite, e abra a pasta build que você criou na Parte 3.

 

Abra o Terminal dentro de Aseprite-source/build/ e digite os comandos:

 

export CC=clang

 

Tecle Enter.

 

export CXX=clang++

 

Tecle Enter. 

 

Para começar à compilar o Aseprite, copie e cole esse comando no Terminal ainda aberto e tecle enter:

 

 cmake \
-DSKIA_DIR=$HOME/deps/skia \
-DSKIA_LIBRARY_DIR=$HOME/deps/skia/out/Release-x64 \
-DSKIA_LIBRARY=$HOME/deps/skia/out/Release-x64/libskia.a \
-DCMAKE_BUILD_TYPE=Release \
-DLAF_BACKEND=skia \
-DENABLE_PSD=ON \
-DENABLE_DESKTOP_INTEGRATION=ON \
-DENABLE_QT_THUMBNAILER=ON \
-G Ninja ..

 

Segundo aviso para sistemas 32 bits: se você baixou o Skia-Linux-Release-x86.zip no Passo 2, então use esse comando para compilar o Aseprite:

 

 cmake \
-DSKIA_DIR=$HOME/deps/skia \
-DSKIA_LIBRARY_DIR=$HOME/deps/skia/out/Release-x86 \
-DSKIA_LIBRARY=$HOME/deps/skia/out/Release-x86/libskia.a \
-DCMAKE_BUILD_TYPE=Release \
-DLAF_BACKEND=skia \
-DENABLE_PSD=ON \
-DENABLE_DESKTOP_INTEGRATION=ON \
-DENABLE_QT_THUMBNAILER=ON \
-G Ninja ..

 

Aguarde alguns minutos até o processo terminar e o Terminal permitir que você digite de novo. Você verá a seguinte mensagem no Terminal: Build files have been written to: /home/[usuário]/aseprite-source/build.

 

Ainda não terminamos. Ainda com o Terminal aberto dentro da pasta build, Digite ninja e tecle enter. Mais uma vez, aguarde alguns minutos para o processo terminar.

 

Quando o ninja encerrar, você verá uma frase Linking CXX executable bin/aseprite no Terminal e o novamente o Terminal ficará disponível. Agora vamos instalar o Aseprite no Linux Mint.

 

Parte 6 - Instalando o Aseprite compilado no Linux Mint

 

O Aseprite foi compilado, mas ainda precisamos instala-lo no nosso PC para usá-lo. Podemos instalar ele direto do Terminal. Digite o comando: 

sudo cmake --install . --prefix=usr/local 

 

Digite sua senha de usuário e aguarde uns instantes. Pronto! O Aseprite está instalado no seu Linux Mint! 

 

Parte 7 - Localizando o Aseprite instalado no seu sistema

 

O arquivo executável do Aseprite instalado está localizado dentro do diretório do código fonte do aseprite/build/bin/aseprite. Basta dar um clique duplo nesse ícone para abrir o programa.

 

Ele pode vir com um ícone genérico, dependendo de qual tema você esteja usando. Você pode customizar o ícone depois, para melhor identificar o Aseprite

 

Depois você pode adiciona extensões que mudam o tema, adiciona tradução em português, e adicionam novas funções ao programa

 

Se você quiser, você pode apagar todo o código fonte e o Skia e deixa apenas o conteúdo da pasta /bin/, é só isso que o Aseprite precisa para funcionar. Recomendo adicionar um atalho para o Aseprite no seu menu Iniciar do Linux. Ele deve aparecer automaticamente lá na aba Gráficos do Menu. 

 

Espero que este tutorial tenha te ajudado. Se você ainda tiver alguma dúvida, assista esse vídeo logo abaixo, ele me ajudou bastante à solucionar vários problemas que eu estava tendo e este tutorial não seria possível sem ele. Até a próxima e feliz ano novo!