Atualizar para uma nova versão

Uma atualização substitui o programa e mais nada. As suas definições, créditos, histórico de ficheiros partilhados, transferências por concluir e ficheiros concluídos ficam num local onde a nova versão não escreve, pelo que, na maioria dos sistemas, atualizar significa instalar a nova versão por cima da antiga. O ZIP do Windows é a única exceção: aí os seus dados ficam dentro da pasta do programa, por isso leia a respetiva secção antes de descompactar o que quer que seja.

Onde ficam os seus dados

Se moveu Incoming, Temp ou as suas pastas partilhadas para outro local em Opções, ficam onde as colocou. Nenhuma atualização lhes toca.

Antes de cada atualização

1. Feche o eMule Qt e o seu core. A janela e o core (emulecored) são dois programas. Se o ícone da corrente na barra de estado estiver partido, o core está desligado da janela e continua a correr depois de a fechar. Verifique que nenhum emulecored fica ativo no Gestor de Tarefas, no Monitor de Atividade ou com pgrep emulecored.
2. Faça uma cópia de segurança da pasta config. É pequena e uma cópia não custa nada. As transferências por concluir em Temp não precisam de cópia de segurança numa atualização normal.

Instalador do Windows

1. Transfira o novo instalador (eMuleQt-vX.Y.Z-win64-setup.exe) na página de transferências.
2. Execute-o. Ele encontra a instalação antiga e coloca a nova versão na mesma pasta. Um eMule Qt e o seu core que estejam em execução são fechados por si.
3. Deixe “Importar definições do eMule” desmarcado. Numa atualização começa desmarcado, porque o seu perfil do eMule Qt já está em uso.
4. Inicie o eMule Qt.

Não é necessário desinstalar primeiro. Mesmo que o faça, o desinstalador não toca em %LOCALAPPDATA%\eMuleQt.

ZIP do Windows (portátil)

Na versão portátil, a sua pasta config está dentro da pasta do programa, e o ZIP traz uma pasta config própria. Eis o que a pasta config do ZIP contém:

• Ficheiros do programa que devem ser substituídos: eMule.tmpl, a pasta webserver, nodes.ed3knod e GeoLite2-Country.mmdb.
• Ficheiros iniciais dos quais deve manter a sua própria cópia: server.met, nodes.dat, webservices.dat e FakeFileFilter.dat. Se o ZIP os sobrescrever, a sua lista de servidores e os contactos Kad voltam aos que vêm de origem. Nada deixa de funcionar, mas perde as listas que construiu.

Nenhum dos seus ficheiros pessoais está no ZIP: preferences.yml, preferences.dat, cryptkey.dat, clients.met, known.met, os ficheiros .part em Temp e as suas transferências concluídas. Descompactar não lhes pode tocar.

Como atualizar

1. Feche o eMule Qt e o seu core (ver acima).
2. Descompacte a nova versão para uma pasta temporária, não por cima da sua instalação.
3. Na pasta temporária eMule\config, elimine server.met, nodes.dat, webservices.dat e FakeFileFilter.dat.
4. Copie tudo o que está na pasta temporária eMule por cima da sua pasta eMule existente e confirme a substituição dos ficheiros.
5. Inicie o eMule Qt e depois elimine a pasta temporária.

Se alterou os ficheiros da interface web em config\webserver, faça primeiro uma cópia de segurança: a atualização substitui-os.

macOS

1. Feche o eMule Qt e o seu core (ver acima).
2. Abra a nova imagem de disco: eMuleQt-vX.Y.Z-macOS-arm64.dmg para Apple silicon ou eMuleQt-vX.Y.Z-macOS-x86_64.dmg para Intel.
3. Arraste o eMule Qt para Aplicações e escolha Substituir.
4. Inicie o eMule Qt.

Os seus dados em ~/eMuleQt estão fora da aplicação e ficam como estão.

Linux

1. Feche o eMule Qt e o seu core (ver acima).
2. Extraia o novo tarball no mesmo local do antigo, para que sobrescreva a antiga pasta eMuleQt: tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz
3. Inicie o eMule Qt. A sua entrada de menu e os tipos de ficheiro continuam a funcionar porque o caminho não mudou.

Se extrair a nova versão para outro local, inicie-a uma vez a partir daí e o eMule Qt atualiza a entrada de menu para o novo caminho.

Docker

Obtenha a nova imagem e recrie o contentor. Os seus dados ficam nos volumes:

• Docker Compose: docker compose pull && docker compose up -d
• Docker simples: docker pull ghcr.io/moddermule/emuleqt:latest, depois remova o contentor antigo e inicie um novo com as mesmas opções -v.

Como saber que há uma nova versão

O eMule Qt verifica por si só se há novas versões e mostra uma caixa com o que mudou e uma ligação para a página de transferências. Para verificar de imediato, use Ferramentas → Ligações → Verificação de versão. Se a caixa indicar que uma atualização é obrigatória, a sua versão tem erros graves conhecidos e o eMule Qt fecha até que atualize.

Um core que corre sem janela, num servidor ou NAS, pode instalar atualizações sozinho: inicie-o como emulecored --autoupdate. Ele transfere cada nova versão, verifica-a, instala-a como esta página descreve, mantendo também os seus ficheiros de configuração numa instalação portátil, e reinicia com as mesmas opções. Os contentores Docker não se atualizam sozinhos: obtenha antes a nova imagem.

Voltar à Ajuda