Mise à jour des versions

Passer à une nouvelle version

Une mise à jour remplace le programme et rien d’autre. Vos paramètres, crédits, historique des fichiers partagés, téléchargements inachevés et fichiers terminés sont conservés dans un emplacement que la nouvelle version n’écrase pas ; sur la plupart des systèmes, mettre à jour revient donc à installer la nouvelle version par-dessus l’ancienne. Le ZIP Windows fait exception : vos données se trouvent dans le dossier du programme, lisez donc sa section avant de décompresser quoi que ce soit.

Où se trouvent vos données

Vous utilisez Programme Vos données
Installateur Windows C:\Program Files\eMule Qt %LOCALAPPDATA%\eMuleQt, avec Incoming et Temp à l’intérieur
ZIP Windows (portable) Le dossier eMule que vous avez décompressé Le même dossier : config, Incoming et Temp à côté de emuleqt.exe
macOS emuleqt.app dans Applications ~/eMuleQt/Config, ~/eMuleQt/Incoming, ~/eMuleQt/Temp
Linux Le dossier eMuleQt issu de l’archive tar ~/eMuleQt/Config, ~/eMuleQt/Incoming, ~/eMuleQt/Temp
Docker L’image Les volumes /config et /data

Si vous avez déplacé Incoming, Temp ou vos dossiers partagés ailleurs dans les Options, ils restent là où vous les avez mis. Aucune mise à jour n’y touche.

Avant chaque mise à jour

  1. Quittez eMule Qt et son cœur. La fenêtre et le cœur (emulecored) sont deux programmes. Si l’icône de chaîne dans la barre d’état est brisée, le cœur est détaché et continue de tourner après la fermeture de la fenêtre. Vérifiez qu’aucun emulecored ne reste dans le Gestionnaire des tâches, le Moniteur d’activité ou avec pgrep emulecored.
  2. Sauvegardez votre dossier de configuration. Il est petit, et une copie ne coûte rien. Les téléchargements inachevés dans Temp n’ont pas besoin de sauvegarde pour une mise à jour normale.

Installateur Windows

  1. Téléchargez le nouvel installateur (eMuleQt-vX.Y.Z-win64-setup.exe) depuis la page de téléchargement.
  2. Exécutez-le. Il détecte l’ancienne installation et place la nouvelle version dans le même dossier. Si eMule Qt et son cœur sont en cours d’exécution, ils sont fermés pour vous.
  3. Laissez « Importer les paramètres d’eMule » décoché. Lors d’une mise à jour, la case est décochée par défaut, car votre profil eMule Qt est déjà utilisé.
  4. Lancez eMule Qt.

Il n’est pas nécessaire de désinstaller au préalable. Même si vous le faites, le désinstallateur ne touche pas à %LOCALAPPDATA%\eMuleQt.

ZIP Windows (portable)

Dans la version portable, votre dossier config se trouve dans le dossier du programme, et le ZIP contient son propre dossier config. Voici ce que contient le dossier config du ZIP :

  • Fichiers du programme à remplacer : eMule.tmpl, le dossier webserver, nodes.ed3knod et GeoLite2-Country.mmdb.
  • Fichiers de départ dont vous devez conserver votre propre copie : server.met, nodes.dat, webservices.dat et FakeFileFilter.dat. Si le ZIP les écrase, votre liste de serveurs et vos contacts Kad reviennent à ceux fournis. Rien ne casse, mais vous perdez les listes que vous aviez constituées.

Aucun de vos fichiers personnels n’est dans le ZIP : preferences.yml, preferences.dat, cryptkey.dat, clients.met, known.met, les fichiers .part dans Temp et vos téléchargements terminés. La décompression ne peut pas les toucher.

Comment mettre à jour

  1. Quittez eMule Qt et son cœur (voir ci-dessus).
  2. Décompressez la nouvelle version dans un dossier temporaire, et non par-dessus votre installation.
  3. Dans le dossier temporaire eMule\config, supprimez server.met, nodes.dat, webservices.dat et FakeFileFilter.dat.
  4. Copiez tout le contenu du dossier temporaire eMule par-dessus votre dossier eMule existant et confirmez le remplacement des fichiers.
  5. Lancez eMule Qt, puis supprimez le dossier temporaire.
.:Mettez à jour sur place, ne déplacez pas
Il est tentant de décompresser dans un nouveau dossier et de ne copier que config. Ne le faites pas. Vos téléchargements inachevés sont dans Temp et vos fichiers terminés dans Incoming, tous deux dans l’ancien dossier, et preferences.yml en stocke les chemins complets. Un nouveau dossier démarre avec une liste de téléchargements vide, ou continue d’utiliser l’ancien dossier sans que vous vous en rendiez compte. Si vous tenez vraiment à déplacer l’installation, déplacez le dossier entier et vérifiez ensuite les répertoires dans les Options.

Si vous avez modifié les fichiers de l’interface web dans config\webserver, sauvegardez-les d’abord : la mise à jour les remplace.

macOS

  1. Quittez eMule Qt et son cœur (voir ci-dessus).
  2. Ouvrez la nouvelle image disque : eMuleQt-vX.Y.Z-macOS-arm64.dmg pour Apple silicon ou eMuleQt-vX.Y.Z-macOS-x86_64.dmg pour Intel.
  3. Glissez eMule Qt dans Applications et choisissez Remplacer.
  4. Lancez eMule Qt.

Vos données dans ~/eMuleQt sont en dehors de l’application et restent telles quelles.

Linux

  1. Quittez eMule Qt et son cœur (voir ci-dessus).
  2. Décompressez la nouvelle archive tar au même endroit que l’ancienne, afin qu’elle écrase l’ancien dossier eMuleQt : tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz
  3. Lancez eMule Qt. Votre entrée de menu et vos types de fichiers continuent de fonctionner, car le chemin n’a pas changé.
.:Ne supprimez pas d’abord l’ancien dossier
Si vous avez décompressé l’archive tar dans votre dossier personnel, le programme et vos données partagent un même dossier : le programme est ~/eMuleQt et vos données sont dans ~/eMuleQt/Config, Incoming et Temp. Supprimer l’ancien dossier du programme avant la mise à jour supprimerait tout cela aussi. Décompresser par-dessus est toujours sans risque, car l’archive tar ne contient pas de dossiers Config, Incoming ou Temp. Son dossier config en minuscules contient les valeurs par défaut fournies, et eMule Qt ne les copie jamais par-dessus des fichiers que vous avez modifiés.

Si vous décompressez la nouvelle version ailleurs, lancez-la une fois depuis cet emplacement et eMule Qt mettra à jour son entrée de menu avec le nouveau chemin.

Docker

Récupérez la nouvelle image et recréez le conteneur. Vos données se trouvent dans les volumes :

  • Docker Compose : docker compose pull && docker compose up -d
  • Docker seul : docker pull ghcr.io/moddermule/emuleqt:latest, puis supprimez l’ancien conteneur et démarrez-en un nouveau avec les mêmes options -v.

Comment être informé d’une nouvelle version

eMule Qt recherche seul les nouvelles versions et affiche une boîte indiquant ce qui a changé, avec un lien vers la page de téléchargement. Pour vérifier immédiatement, utilisez Outils → Liens → Vérifier la version. Si la boîte indique qu’une mise à jour est requise, votre version contient des bogues graves connus, et eMule Qt se ferme jusqu’à la mise à jour.

Un cœur qui fonctionne sans fenêtre, sur un serveur ou un NAS, peut installer les mises à jour tout seul : lancez-le avec emulecored --autoupdate. Il télécharge chaque nouvelle version, la vérifie, l’installe comme décrit sur cette page, en conservant aussi vos propres fichiers de configuration dans une installation portable, puis redémarre avec les mêmes options. Les conteneurs Docker ne se mettent pas à jour eux-mêmes : récupérez plutôt la nouvelle image.

 

Retour à l’aide