Tutorial de Instalação do GstarCAD 2026 no BigLinux (base Manjaro)

📋 Pré-requisitos

BigLinux (base Manjaro/Arch Linux)
Conexão com internet (para baixar dependências)
Arquivo do instalador GstarCAD2026_linux_amd64.deb (obtido do site oficial)

🔧 Passo 1: Preparação do Sistema

1.1 Atualize o sistema

sudo pacman -Syu

1.2 Instale um helper AUR (se não tiver)

O script usa yay ou paru para instalar dependências do AUR.

Para instalar o yay:

sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
cd ..
rm -rf yay

📥 Passo 2: Obter o GstarCAD

2.1 Baixe o instalador

Acesse: https://gstarcad.pt/gstarcad-linux/

Preencha o formulário e baixe o arquivo GstarCAD2026_linux_amd64.deb

2.2 Organize os arquivos

Coloque o script install.sh e o arquivo .deb na mesma pasta:

#!/usr/bin/env bash
# =============================================================================
# install.sh — Instalador do GstarCAD 2026 para Linux (x86_64)
# Compatível com: Manjaro / BigLinux / Arch Linux
# Ambiente: KDE Plasma (X11 e Wayland)
# Versão: 7.0 — EDIÇÃO DEFINITIVA: Auto-Bundling de libs legadas (libxml2 e ICU)
# =============================================================================

set -euo pipefail

# ---------------------------------------------------------------------------
# Cores e formatação
# ---------------------------------------------------------------------------
BOLD='\033[1m'
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
CYAN='\033[0;36m'
NC='\033[0m'

# ---------------------------------------------------------------------------
# Variáveis do pacote
# ---------------------------------------------------------------------------
PKGNAME="gstarcad"
PKGVER="2026"
DEB_FILE="GstarCAD2026_linux_amd64.deb"
INSTALL_PREFIX="/opt/gstarcad2026"
DESKTOP_DIR="/usr/share/applications"
ICON_DIR="/usr/share/pixmaps"
DOWNLOAD_PAGE="https://gstarcad.pt/gstarcad-linux/"

# ---------------------------------------------------------------------------
# Funções auxiliares
# ---------------------------------------------------------------------------
info()      { echo -e "${CYAN}${BOLD}[INFO]${NC}  $*"; }
ok()        { echo -e "${GREEN}${BOLD}[ OK ]${NC}  $*"; }
warn()      { echo -e "${YELLOW}${BOLD}[AVISO]${NC} $*"; }
erro()      { echo -e "${RED}${BOLD}[ERRO]${NC}  $*" >&2; }
separador() { echo -e "${CYAN}─────────────────────────────────────────────────────${NC}"; }

checar_root() {
    if [[ $EUID -ne 0 ]]; then
        erro "Este script precisa ser executado como root."
        echo -e "       Execute: ${BOLD}sudo bash install.sh${NC}"
        exit 1
    fi
}

checar_arch() {
    local arch
    arch=$(uname -m)
    if [[ "$arch" != "x86_64" ]]; then
        erro "Arquitetura não suportada: $arch"
        erro "Este instalador suporta apenas x86_64 (amd64)."
        exit 1
    fi
}

checar_dependencias() {
    info "Verificando e instalando dependências..."

    info "Instalando ferramentas de sistema..."
    pacman -S --noconfirm --needed \
        libarchive binutils curl \
        bison flex gperf python wget \
        base-devel 2>/dev/null || true

    info "Verificando dependências de runtime..."
    local pkgs_todos=(
        qt5-base qt5-svg qt5-webengine qt5-webchannel qt5-wayland
        curl sqlite nss nspr alsa-lib lcms2 libxss
        libxslt libxcomposite libpng gtest
        libxcb xcb-util-image xcb-util-keysyms xcb-util-renderutil xcb-util-wm
        libglvnd mesa openssl-1.1
    )

    local faltam_aur=()

    for pkg in "${pkgs_todos[@]}"; do
        if pacman -Q "$pkg" &>/dev/null; then
            continue
        fi
        if pacman -S --noconfirm --needed "$pkg" &>/dev/null 2>&1; then
            ok "Instalado via pacman: ${pkg}"
        else
            faltam_aur+=("$pkg")
        fi
    done

    if [[ ${#faltam_aur[@]} -gt 0 ]]; then
        separador
        warn "Pacotes necessários via AUR:"
        echo ""
        for pkg in "${faltam_aur[@]}"; do
            echo -e "    ${YELLOW}▸ ${pkg}${NC}"
        done
        echo ""

        local aur_helper=""
        for helper in yay paru trizen pikaur; do
            if command -v "$helper" &>/dev/null; then
                aur_helper="$helper"
                break
            fi
        done

        if [[ -n "$aur_helper" ]]; then
            echo -e "  ${GREEN}Helper AUR detectado: ${BOLD}${aur_helper}${NC}"
            read -r -p "$(echo -e "${CYAN}Instalar automaticamente com ${aur_helper}? [S/n]: ${NC}")" resp_aur
            resp_aur="${resp_aur:-s}"
            if [[ "${resp_aur,,}" != "n" ]]; then
                local aur_user="${SUDO_USER:-$USER}"
                info "Instalando via ${aur_helper} como ${aur_user}..."
                if sudo -u "$aur_user" "$aur_helper" -S --noconfirm --overwrite '*' "${faltam_aur[@]}"; then
                    ok "Todos os pacotes AUR instalados."
                else
                    warn "Falha no AUR. Tente instalar manualmente."
                    read -r -p "$(echo -e "${YELLOW}Continuar mesmo assim? [s/N]: ${NC}")" resp_cont
                    [[ "${resp_cont,,}" != "s" ]] && exit 1
                fi
            fi
        fi
    fi

    ok "Dependências nativas verificadas."
}

verificar_deb() {
    separador
    info "Procurando arquivo: ${BOLD}${DEB_FILE}${NC}"

    local SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
    
    if [[ -f "${SCRIPT_DIR}/${DEB_FILE}" ]]; then
        DEB_PATH="${SCRIPT_DIR}/${DEB_FILE}"
        ok "Arquivo localizado: ${DEB_PATH}"
    elif [[ -f "$(pwd)/${DEB_FILE}" ]]; then
        DEB_PATH="$(pwd)/${DEB_FILE}"
        ok "Arquivo localizado: ${DEB_PATH}"
    else
        warn "Arquivo ${BOLD}${DEB_FILE}${NC} não encontrado localmente."
        read -r -p "$(echo -e "${CYAN}Deseja tentar baixar o instalador automaticamente agora? [S/n]: ${NC}")" resp_dl
        resp_dl="${resp_dl:-s}"
        
        if [[ "${resp_dl,,}" != "n" ]]; then
            info "Iniciando tentativas de download..."
            
            local urls=(
                "https://gstarcad.pt/downloads/GstarCAD2026_linux_amd64.deb"
                "https://ovsdownload.gstarcad.net/software/GstarCAD/2026/EN/GstarCAD2026EN_V2511.deb"
                "https://file.e-disti.com/GstarCAD2026EN_V2511.deb"
                "https://drive.google.com/uc?export=download&id=11LoAbNwJ0BYO1qjr1lECTXeafyFaXT4S"
            )
            
            local baixou=false
            for url in "${urls[@]}"; do
                info "Tentando baixar de: ${url}"
                if curl -L "$url" -o "${SCRIPT_DIR}/${DEB_FILE}" --progress-bar; then
                    if head -c 8 "${SCRIPT_DIR}/${DEB_FILE}" | grep -q "!<arch>"; then
                        ok "Download concluído e renomeado com sucesso!"
                        DEB_PATH="${SCRIPT_DIR}/${DEB_FILE}"
                        baixou=true
                        break
                    else
                        warn "O arquivo retornado não é um pacote válido. Tentando o próximo link..."
                        rm -f "${SCRIPT_DIR}/${DEB_FILE}"
                    fi
                else
                    warn "Falha ao baixar. Tentando o próximo..."
                fi
            done
            
            if [[ "$baixou" != true ]]; then
                erro "Não foi possível baixar o arquivo automaticamente através dos links fornecidos."
                info "Por favor, acesse a página: ${BOLD}${DOWNLOAD_PAGE}${NC}"
                info "IMPORTANTE: Após baixar, renomeie o arquivo para ${BOLD}${DEB_FILE}${NC} e coloque na mesma pasta deste script."
                exit 1
            fi
        else
            erro "Operação cancelada pelo usuário."
            exit 1
        fi
    fi

    export DEB_PATH
}

extrair_deb() {
    separador
    info "Extraindo pacote .deb..."

    WORK_DIR=$(mktemp -d /tmp/gstarcad_install.XXXXXX)
    trap 'rm -rf "${WORK_DIR}"' EXIT

    cd "${WORK_DIR}"
    ar x "${DEB_PATH}"

    local data_tar
    data_tar=$(ls data.tar.* 2>/dev/null | head -n1)
    bsdtar -xf "${data_tar}" -C "${WORK_DIR}"
    ok "Extração concluída."
}

detectar_appname() {
    APP_INTERNAL_DIR=$(find "${WORK_DIR}/opt/apps/" -maxdepth 1 -mindepth 1 -type d 2>/dev/null | head -n1)
    APP_INTERNAL_NAME=$(basename "${APP_INTERNAL_DIR}")
    info "Aplicativo detectado: ${APP_INTERNAL_NAME}"
}

instalar_arquivos() {
    separador
    info "Instalando GstarCAD ${PKGVER}..."
    
    if [[ -d "${INSTALL_PREFIX}" ]]; then
        info "Limpando arquivos da instalação anterior..."
        rm -rf "${INSTALL_PREFIX}"
    fi

    mkdir -p "${INSTALL_PREFIX}"
    cp -Pr --no-preserve=ownership "${APP_INTERNAL_DIR}/files/"* "${INSTALL_PREFIX}/"
    
    if [[ -f "${APP_INTERNAL_DIR}/files/ImageRes/gcad.png" ]]; then
        install -Dm644 "${APP_INTERNAL_DIR}/files/ImageRes/gcad.png" "${ICON_DIR}/gstarcad.png"
    fi
    
    chmod +x "${INSTALL_PREFIX}/gcad" 2>/dev/null || true
    ok "Arquivos instalados em ${INSTALL_PREFIX}"
}

corrigir_pak_resources() {
    separador
    info "Corrigindo dependências locais e locales..."

    # 1. Remover libcurl conflitante
    info "Removendo libcurl empacotado para evitar conflito com libproxy..."
    rm -f "${INSTALL_PREFIX}/libcurl.so"* 2>/dev/null || true
    rm -f "${INSTALL_PREFIX}/libs/libcurl.so"* 2>/dev/null || true

    # 2. Corrigir o erro do Locale rodando como root
    info "Criando fallback de locales de UI..."
    mkdir -p "${INSTALL_PREFIX}/resources/qtwebengine_locales"
    if [[ -f "${INSTALL_PREFIX}/resources/qtwebengine_locales/en-US.pak" ]]; then
        ln -sf "en-US.pak" "${INSTALL_PREFIX}/resources/qtwebengine_locales/pt-BR.pak"
        ln -sf "en-US.pak" "${INSTALL_PREFIX}/resources/qtwebengine_locales/pt-PT.pak"
    fi

    ok "Recursos QtWebEngine organizados."
}

corrigir_bibliotecas_vitais() {
    separador
    info "Aplicando blindagem de bibliotecas (Auto-Bundling do Arch Linux Archive)..."
    
    # Cria diretório de libs locais do GstarCAD
    mkdir -p "${INSTALL_PREFIX}/libs"

    # Pasta de trabalho temporária
    local BUNDLE_DIR=$(mktemp -d /tmp/gcad_bundle.XXXXXX)
    cd "${BUNDLE_DIR}"

    # 1. Injeção da libxml2 legada (2.9.14)
    info "Baixando libxml2 legada (v2.9.14)..."
    if wget -q https://archive.archlinux.org/packages/l/libxml2/libxml2-2.9.14-1-x86_64.pkg.tar.zst -O libxml2.pkg.tar.zst; then
        bsdtar -xf libxml2.pkg.tar.zst
        cp usr/lib/libxml2.so.2.9.14 "${INSTALL_PREFIX}/libs/libxml2.so.2"
        chmod 755 "${INSTALL_PREFIX}/libs/libxml2.so.2"
        ok "libxml2 injetada."
    else
        warn "Falha ao baixar libxml2 legada do ALA."
    fi

    # 2. Injeção das bibliotecas ICU legadas (71.1)
    info "Baixando libicu legada (v71.1)..."
    if wget -q https://archive.archlinux.org/packages/i/icu/icu-71.1-1-x86_64.pkg.tar.zst -O icu.pkg.tar.zst; then
        bsdtar -xf icu.pkg.tar.zst
        cp usr/lib/libicu*.so.71* "${INSTALL_PREFIX}/libs/"
        chmod 755 "${INSTALL_PREFIX}"/libs/libicu*.so.71*
        ok "Bibliotecas ICU injetadas."
    else
        warn "Falha ao baixar libicu legada do ALA."
    fi

    # Limpeza
    cd - > /dev/null
    rm -rf "${BUNDLE_DIR}"
    
    ok "Processo de Auto-Bundling finalizado."
}

criar_launcher() {
    separador
    info "Criando lançadores isolados..."

    # Lançador Normal
    cat > /usr/local/bin/gstarcad << 'LAUNCHER_NORMAL'
#!/usr/bin/env bash
# ─────────────────────────────────────────────────────────────
# Launcher do GstarCAD 2026
# KDE Plasma · Wayland/X11 · Manjaro/BigLinux/Arch
# ─────────────────────────────────────────────────────────────

INSTALL_DIR="/opt/gstarcad2026"
EXEC="${INSTALL_DIR}/gcad"

if [[ ! -x "${EXEC}" ]]; then
    echo "Erro: GstarCAD não encontrado em ${EXEC}" >&2
    exit 1
fi

if [[ "${XDG_SESSION_TYPE:-x11}" == "wayland" ]]; then
    export QT_QPA_PLATFORM="xcb"
    export GDK_BACKEND="x11"
else
    export QT_QPA_PLATFORM="xcb"
fi

export QTWEBENGINE_DISABLE_SANDBOX=1
export QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox --disable-gpu --disable-gpu-compositing --disable-software-rasterizer --disable-dev-shm-usage --in-process-gpu --disable-extensions"

# ── LD_LIBRARY_PATH: ISOLAMENTO TOTAL ──
# Lê primeiro a pasta 'libs' particular (onde colocamos ICU e libxml2)
export LD_LIBRARY_PATH="${INSTALL_DIR}:${INSTALL_DIR}/libs:${INSTALL_DIR}/systemlibs:/usr/lib:/usr/lib/x86_64-linux-gnu:\${LD_LIBRARY_PATH:-}"

export QT_OPENGL="desktop"
export LIBGL_ALWAYS_SOFTWARE=0

export QT_AUTO_SCREEN_SCALE_FACTOR=1
export QT_ENABLE_HIGHDPI_SCALING=1

# Forçar leitura na própria pasta do app
export QTWEBENGINE_RESOURCES_PATH="${INSTALL_DIR}/resources"
export QTWEBENGINE_LOCALES_PATH="${INSTALL_DIR}/resources/qtwebengine_locales"

export LANG="${LANG:-pt_BR.UTF-8}"
export LC_ALL="${LANG}"

cd "${INSTALL_DIR}" || exit 1
exec "${EXEC}" "$@"
LAUNCHER_NORMAL

    # Lançador Modo Software
    cat > /usr/local/bin/gstarcad-software << 'LAUNCHER_SOFTWARE'
#!/usr/bin/env bash
# GstarCAD 2026 — Modo software (fallback para GPUs problemáticas)

INSTALL_DIR="/opt/gstarcad2026"
EXEC="${INSTALL_DIR}/gcad"

[[ ! -x "${EXEC}" ]] && { echo "Erro: ${EXEC} não encontrado" >&2; exit 1; }

export QT_QPA_PLATFORM="xcb"
export QT_OPENGL="software"
export LIBGL_ALWAYS_SOFTWARE=1

export QTWEBENGINE_DISABLE_SANDBOX=1
export QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox --disable-gpu --disable-gpu-compositing --in-process-gpu --disable-dev-shm-usage --disable-extensions"

# ── LD_LIBRARY_PATH: ISOLAMENTO TOTAL ──
export LD_LIBRARY_PATH="${INSTALL_DIR}:${INSTALL_DIR}/libs:${INSTALL_DIR}/systemlibs:/usr/lib:/usr/lib/x86_64-linux-gnu:\${LD_LIBRARY_PATH:-}"

export QTWEBENGINE_RESOURCES_PATH="${INSTALL_DIR}/resources"
export QTWEBENGINE_LOCALES_PATH="${INSTALL_DIR}/resources/qtwebengine_locales"

[[ "${XDG_SESSION_TYPE:-x11}" == "wayland" ]] && export GDK_BACKEND="x11"

cd "${INSTALL_DIR}" || exit 1
exec "${EXEC}" "$@"
LAUNCHER_SOFTWARE

    chmod +x /usr/local/bin/gstarcad /usr/local/bin/gstarcad-software
    ok "Lançadores criados em /usr/local/bin/"
}

criar_desktop() {
    separador
    info "Criando atalhos de aplicativo..."
    
    cat > "${DESKTOP_DIR}/gstarcad.desktop" << DESKTOP
[Desktop Entry]
Type=Application
Name=GstarCAD 2026
Exec=/usr/local/bin/gstarcad %F
Icon=gstarcad
Categories=Graphics;Engineering;
DESKTOP

    cat > "${DESKTOP_DIR}/gstarcad-software.desktop" << DESKTOP
[Desktop Entry]
Type=Application
Name=GstarCAD 2026 (Modo Software)
Exec=/usr/local/bin/gstarcad-software %F
Icon=gstarcad
Categories=Graphics;Engineering;
DESKTOP

    update-desktop-database "${DESKTOP_DIR}" 2>/dev/null || true
    ok "Atalhos criados em ${DESKTOP_DIR}."
}

main() {
    if [[ "${1:-}" == "--uninstall" ]]; then
        checar_root
        rm -rf "${INSTALL_PREFIX}" /usr/local/bin/gstarcad /usr/local/bin/gstarcad-software "${DESKTOP_DIR}/gstarcad.desktop" "${DESKTOP_DIR}/gstarcad-software.desktop"
        ok "Desinstalado."
        exit 0
    fi

    clear
    separador
    echo -e "  ${BOLD}${CYAN}Instalador — GstarCAD ${PKGVER} para Linux${NC}"
    separador

    checar_root
    checar_arch
    checar_dependencias
    verificar_deb
    extrair_deb
    detectar_appname
    instalar_arquivos
    corrigir_pak_resources
    corrigir_bibliotecas_vitais
    criar_launcher
    criar_desktop
    
    separador
    ok "Instalação concluída!"
    echo -e "  Use o comando ${BOLD}gstarcad${NC} no seu terminal para iniciar o modo normal."
    echo -e "  Use o comando ${BOLD}gstarcad-software${NC} caso tenha problemas gráficos."
}

main "$@"

🚀 Passo 3: Executar o Instalador

3.1 Torne o script executável

chmod +x install.sh

3.2 Execute como root

sudo bash install.sh

3.3 Acompanhe o processo

O script irá automaticamente:

Verificar arquitetura (x86_64)
Instalar dependências:
- Pacotes do repositório oficial via pacman
- Pacotes do AUR via yay/paru (incluindo libpng12, openssl-1.1, qt5-webengine)
Extrair o .deb
Instalar arquivos em /opt/gstarcad2026/
Configurar ícones e atalhos de menu
Corrigir recursos QtWebEngine (arquivos .pak)
Criar launchers

⚠️ Pontos de Atenção Durante a Instalação

Dependências AUR (especialmente qt5-webengine)

O qt5-webengine pode levar 30 a 90 minutos para compilar
O script perguntará se deseja instalar automaticamente via AUR helper
Resposta recomendada: S (sim)

Os seguintes pacotes não estão no repositório oficial
e precisam ser compilados/instalados pelo AUR:
    ▸ libpng12
    ▸ openssl-1.1
    ▸ qt5-webengine

⚠ ATENÇÃO: qt5-webengine precisa ser compilado do zero.
  Isso pode levar de 30 a 90 minutos dependendo do hardware.

Instalar automaticamente com yay? [S/n]: S

Remoção de links falsos

O script automaticamente remove links simbólicos problemáticos criados por versões anteriores, evitando conflitos com pacotes do AUR.

▶️ Passo 4: Executar o GstarCAD

Métodos de execução:

Método	Comando	Uso
Terminal (normal)	`gstarcad`	Uso diário
Terminal (modo software)	`gstarcad-software`	GPU problemática
Menu KDE	Aplicativos → Gráficos → GstarCAD 2026	Interface gráfica

Primeira execução:

gstarcad

🐛 Solução de Problemas Comuns

Problema 1: “undefined symbol: valuePush, version LIBXML2_2.4.30”

Solução: O script já verifica e corrige automaticamente. Se ocorrer:

sudo pacman -S libxml2
sudo ldconfig

Problema 2: Segfault ao iniciar

Use o launcher de modo software:

gstarcad-software

Problema 3: “Arquivo .deb não encontrado”

Verifique se o arquivo está na mesma pasta:

ls -la GstarCAD2026_linux_amd64.deb

Problema 4: Falha na instalação de pacotes AUR

Instale manualmente:

yay -S libpng12 openssl-1.1 qt5-webengine
# ou
paru -S libpng12 openssl-1.1 qt5-webengine

🗑️ Desinstalação

Para remover completamente o GstarCAD:

sudo bash install.sh --uninstall

📁 Estrutura da Instalação

Caminho	Conteúdo
`/opt/gstarcad2026/`	Arquivos principais do programa
`/usr/local/bin/gstarcad`	Launcher principal
`/usr/local/bin/gstarcad-software`	Launcher (modo software)
`/usr/share/applications/gstarcad*.desktop`	Atalhos do menu
`/usr/share/pixmaps/gstarcad.png`	Ícone

✅ Verificação da Instalação

Teste se tudo está correto:

# Verificar se o launcher existe
which gstarcad
# Deve retornar: /usr/local/bin/gstarcad

# Verificar diretório de instalação
ls /opt/gstarcad2026/
# Deve mostrar: gcad, libs/, resources/, etc.

# Verificar ícone
ls /usr/share/pixmaps/gstarcad.png

💡 Dicas

Wayland: O launcher já força uso de XWayland automaticamente
HiDPI: Configurado automaticamente via variáveis QT_AUTO_SCREEN_SCALE_FACTOR
Locale português: O script vincula pt-BR.pak automaticamente
GPU integrada Intel/NVIDIA: Use o launcher normal; se travar, use o modo software

🔗 Links Úteis

Compatível com: BigLinux, Manjaro, Arch Linux
Ambiente: KDE Plasma (X11 e Wayland)