Minerador 4.0 — Instalação multiplataforma

Distribuição oficial por release na loja caracore-ete-releases.

Artefactos por plataforma

Plataforma	Ficheiro	Notas
Windows (onefile)	`Minerador40-windows-x64.exe`	Executável único e autónomo (dezenas de MB). Duplo clique. WebView2 Runtime pode ser necessário.
Windows (pasta)	`Minerador40-windows-x64.zip`	Extrair; correr `Minerador40\Minerador40.exe` dentro da pasta (inclui `_internal\`).
Linux	`Minerador40-linux-x86_64.tar.gz`	Extrair; executar `Minerador40/Minerador40`. Requer GTK/WebKitGTK para pywebview.
macOS	`Minerador40-macos-universal.dmg`	Montar; usar a pasta `Minerador40` (inclui `_internal/`). Gatekeeper pode exigir confirmação.

Também são publicados checksums.sha256, checksums.md5 e o guia multiplataforma na própria release.

Guias detalhados (HTML)

Windows Linux macOS

Integridade

Valide sempre os hashes antes de executar:

# Linux (tar.gz ou qualquer ficheiro)
sha256sum Minerador40-linux-x86_64.tar.gz

# Windows (PowerShell)
Get-FileHash -Path .\Minerador40-windows-x64.exe -Algorithm SHA256

# macOS
shasum -a 256 Minerador40-macos-universal.dmg

Compare com checksums.sha256 incluído na release.

Modo Free × Premium

O mesmo binário corre em modo Free (paywall na interface) e Premium após ativação. Estado da licença é guardado localmente no sistema.

Gerar instaladores localmente (desenvolvimento)

Windows (na raiz do repo, Python 3.10 recomendado):

python scripts/build_dist_local.py --deps desktop --require-python-310
python scripts/build_dist_local.py --deps desktop --onedir --zip --require-python-310

O primeiro comando gera o .exe onefile (igual ao da loja). O segundo gera a pasta dist/Minerador40/ + ZIP com _internal.

Linux ou macOS (bash, na raiz do repo):

chmod +x scripts/build_dist_local_unix.sh
./scripts/build_dist_local_unix.sh

Linux: dist/Minerador40-linux-x86_64.tar.gz (+ checksums desse ficheiro).
macOS: dist/Minerador40-macos-universal.dmg (+ checksums).

Em Linux instale dependências GTK/WebKit para a janela nativa (ver guia Linux). Num PC Windows, este bash não corre nativamente; para .tar.gz / .dmg use WSL2, VM Linux, um Mac, ou o CI do GitHub.

Três plataformas sem máquinas mistas: GitHub → Actions → Build Minerador 4.0 (test + exe + release) → Run workflow. Para pacotes iguais aos da loja pública, crie uma tag vX.Y.Z e siga library/DELIVERY_ETE_RELEASES.md no repositório fonte.