Minerador 4.0 — Instalação e distribuição no Windows
Índice multiplataforma: Instalação multiplataforma.
Pré-requisitos no PC do utilizador
- WebView2 Runtime — O Minerador 4.0 usa
pywebview, que no Windows depende do motor Microsoft Edge WebView2. Na maior parte dos sistemas recentes já vem instalado ou é actualizado pelo Edge/Windows Update. Se a janela não abrir ou aparecer erro de controlo WebView2, instale o runtime na Distribuição do Microsoft Edge WebView2. - Antivírus e SmartScreen — Executáveis gerados com PyInstaller não são assinados por defeito. O Windows Defender SmartScreen pode bloquear ou pedir «Mais informações → Executar na mesma». Isto é esperado até existir assinatura de código (certificado EV/OV).
- Rede — O servidor Flask corre em localhost (por exemplo
127.0.0.1). Não é necessário abrir portas na firewall para uso normal.
Dados da aplicação
- Estado da licença e ficheiros da app: tipicamente
%APPDATA%\Minerador40(C:\Users\<utilizador>\AppData\Roaming\Minerador40). - Desinstalar/apagar manualmente essa pasta remove dados locais da app (faça cópia se precisar).
Tipos de artefacto
| Modo | Descrição | Notas |
|---|---|---|
| Onefile | Um único Minerador40.exe |
Extração temporária ao arranque; primeiro arranque mais lento; maior probabilidade de falsos positivos em antivírus |
| Onedir (pasta) | Pasta Minerador40\ com .exe + _internal\ |
Na loja: Minerador40-windows-x64.zip. Extrair e executar o .exe dentro da pasta |
Na loja saem os dois: Minerador40-windows-x64.exe (onefile autónomo, dezenas de MB) e Minerador40-windows-x64.zip (pasta completa). Um .exe de ~5 MB é o launcher sem _internal — não usar.
Para gerar localmente (na raiz do repositório fonte):
python scripts/build_dist_local.py --deps desktop
python scripts/build_dist_local.py --deps desktop --onedir --zip
Integridade
Os ficheiros checksum.md5 e checksum.sha256 junto ao .exe referem-se ao executável principal. Após extrair um .zip, volte a verificar checksums no destino se distribuir ficheiros alterados.
Feedback
Para reportar evolução ou suporte, ver Canal de feedback e a secção «Reportar Evolução» na interface (com servidor HTTP local).