O Gradience é uma ferramenta de customização avançada projetada para o ecossistema GNOME, permitindo que usuários alterem as cores e o estilo do tema Adwaita (GTK4/Libadwaita) de forma intuitiva. Este guia detalha três métodos distintos para implantar o aplicativo em seu sistema, abrangendo desde a facilidade do Flatpak até a compilação manual via Meson.

Método 1: Instalação via Flatpak (Recomendado)

O uso do Flatpak é a maneira mais estável e isolada de executar o Gradience, garantindo que todas as dependências necessárias estejam incluídas no pacote.

1. Configurar o Repositório Flathub

Caso o seu sistema ainda não possua o Flathub configurado, adicione-o com o seguinte comando no terminal:

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

2. Instalar o Aplicativo

Com o repositório ativo, execute a instalação do Gradience:

flatpak install flathub com.github.GradienceTeam.Gradience

3. Execução

Você pode iniciar o software através do menu de aplicativos da sua interface ou via linha de comando:

flatpak run com.github.GradienceTeam.Gradience

Método 2: Compilação via Flatpak Builder

Este método é ideal para quem deseja testar versões de desenvolvimento ou builds customizadas dentro de um ambiente isolado.

1. Preparar o Ambiente de Desenvolvimento

Instale os runtimes do GNOME necessários para a compilação:

flatpak install org.gnome.Sdk//44 org.gnome.Platform//44

2. Obter o Código-Fonte

Clone o repositório oficial e atualize os submódulos:

git clone https://github.com/GradienceTeam/Gradience.git
cd Gradience
git submodule update --init --recursive

3. Construir e Instalar

Para uma instalação a nível de usuário, utilize o comando abaixo:

flatpak-builder --install --user --force-clean build-dir build-aux/flatpak/com.github.GradienceTeam.Gradience.json

Método 3: Instalação Nativa via Meson e Ninja

Para usuários avançados que preferem uma instalação entegrada diretamente ao sistema, o Meson é a ferramenta de build padrão.

1. Requisitos do Sistema

Certifique-se de ter as seguintes dependências instaladas (nomes baseados em sistemas Debian/Ubuntu):

• Python 3 & PyGObject
• Blueprint Compiler
• GTK4 & Libadwaita (>= 1.2)
• Libsoup 3
• Meson & Ninja

No Ubuntu, o comando de instalação seria:

sudo apt install python3-gi blueprint-compiler libgtk-4-dev libadwaita-1-dev libsoup-3.0-dev meson ninja-build

2. Processo de Build

Após clonar o repositório e acessar a pasta, configure o diretório de compilação:

meson setup pasta_build
meson configure pasta_build -Dprefix=/usr/local
sudo ninja -C pasta_build install

3. Desenvolvimento Local (Opcional)

Se o objetivo for apenas testar o código sem instalar globalmente no sistema:

meson setup debug_build
meson configure debug_build -Dprefix="$(pwd)/debug_build"
ninja -C debug_build install
ninja -C debug_build run

Ao finalizar qualquer um desses métodos, o Gradiance estará pronto para ser utilizado, permitindo a criação de presets personalizados que transformam visualmente o ambiente GNOME.