AppImage/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 5: Line 5:
{{TOCright}}
{{TOCright}}


<span id="What_is_an_AppImage?"></span>
== Qu'est ce que AppImage ? ==
== Qu'est ce que AppImage ? ==


Line 20: Line 21:
Pour les autres types d'installation, voir [[Download/fr|Téléchargements]].
Pour les autres types d'installation, voir [[Download/fr|Téléchargements]].


<span id="FreeCAD_AppImages"></span>
== AppImages de FreeCAD ==
== AppImages de FreeCAD ==

{{VeryImportantMessage|'''Remarque :''' Les builds de développement sont maintenant hébergés sur le dépôt github [https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds '''FreeCAD-Bundle'''].<br/>Si les liens de téléchargement ci-dessous ne fonctionnent pas, veuillez télécharger manuellement les fichiers à partir du précédent lien, la section "Assets".}}


{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
Line 30: Line 30:
! style="text-align: center; font-size: 200%;" | Development
! style="text-align: center; font-size: 200%;" | Development
|-
|-
| style="text-align: center;" | [[Image:AppImage-logo.png|link=https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/0.20.2]] <!-- [https://github.com/FreeCAD/FreeCAD/releases/download/0.19.3/FreeCAD_0.19.3-Linux-Conda_glibc2.12-x86_64.AppImage 0.19.3] ([https://github.com/FreeCAD/FreeCAD/releases/download/0.19.3/FreeCAD_0.19.3-Linux-Conda_glibc2.12-x86_64.AppImage-SHA256.txt SHA256]) --> [https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/0.20.2 v0.20.2]
| style="text-align: center;" | [[Image:AppImage-logo.png|link=https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/0.20.2]] [https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/0.20.2 v0.20.2]
| style="text-align: center;" | <!-- [[Image:AppImage-logo.png|link=https://github.com/FreeCAD/FreeCAD-Bundle/releases/download/weekly-builds/FreeCAD_weekly-builds-{{:Template:Development-Version}}-Linux-Conda_glibc2.12-x86_64.AppImage]] [https://github.com/FreeCAD/FreeCAD-Bundle/releases/download/weekly-builds/FreeCAD_weekly-builds-{{:Template:Development-Version}}-Linux-Conda_glibc2.12-x86_64.AppImage {{:Template:Development-Version}}] ([https://github.com/FreeCAD/FreeCAD-Bundle/releases/download/weekly-builds/FreeCAD_weekly-builds-{{:Template:Development-Version}}-Linux-Conda_glibc2.12-x86_64.AppImage-SHA256.txt SHA256]) --> [[Image:AppImage-logo.png|link=https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds Weekly build]] [https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds Weekly build]
| style="text-align: center;" | [[Image:AppImage-logo.png|link=https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds]] [https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds Weekly build]
|}
|}


<div class="mw-translate-fuzzy">
'''Remarques importantes :'''
'''Remarques importantes :'''
* Le développement se fait quotidiennement et rapidement, le lien de mise à jour d'AppImage change constamment.
* Le développement se fait quotidiennement et rapidement, le lien de mise à jour d'AppImage change constamment.
Line 39: Line 40:
* De nombreux utilisateurs du forum utilisent la version de développement.
* De nombreux utilisateurs du forum utilisent la version de développement.
* Il peut être exécuté sur le même système en parallèle avec une autre version de FreeCAD.
* Il peut être exécuté sur le même système en parallèle avec une autre version de FreeCAD.
* Les utilisateurs utilisent la version en cours de développement pour tirer parti des dernières fonctionnalités et corrections de bugs (FreeCAD ayant un cycle de publication long). Ils l'utilisent également pour tester et trouver des bugs susceptibles d'améliorer le développement de FreeCAD.
* Les utilisateurs utilisent la version en cours de développement pour tirer parti des dernières fonctionnalités et corrections de bugs (FreeCAD ayant un cycle de publication long). Ils l'utilisent également pour tester et trouver des bugs susceptibles d'améliorer le développement de FreeCAD.
</div>


<span id="Obligatory_Word_of_Caution"></span>
==== Mot de mise en garde obligatoire ====
==== Mot de mise en garde obligatoire ====


Dans l'ensemble, la version de développement est stable, mais il est bien sûr important d'ajouter la déclaration obligatoire selon laquelle vous l'utilisez à vos propres risques. Cependant, la plupart des gens qui utilisent des sauvegardes et "sauvegardent souvent" s'en sortent plutôt bien.
Dans l'ensemble, la version de développement est stable, mais il est bien sûr important d'ajouter la déclaration obligatoire selon laquelle vous l'utilisez à vos propres risques. Cependant, la plupart des gens qui utilisent des sauvegardes et "sauvegardent souvent" s'en sortent plutôt bien.


<span id="Automatic_updating"></span>
== Mise à jour automatique ==
== Mise à jour automatique ==


Line 51: Line 55:
La mise à jour automatique s'effectue via plusieurs méthodes. Il existe actuellement 4 méthodes, 2 via l'interface graphique (GUI) et 2 via l'interface en ligne-de-commande/terminal (CLI).
La mise à jour automatique s'effectue via plusieurs méthodes. Il existe actuellement 4 méthodes, 2 via l'interface graphique (GUI) et 2 via l'interface en ligne-de-commande/terminal (CLI).


<span id="Experimental_in-app_updating"></span>
=== Mise à jour expérimentale ===
=== Mise à jour expérimentale ===


Grâce aux efforts de plusieurs développeurs clés, il y a un [https://forum.freecadweb.org/viewtopic.php?f=8&t=44324 effort continu] pour intégrer une fonctionnalité permettant une '''mise à jour automatique de l'AppImage dans FreeCAD'''. À partir de FC 0.19.21514, il existe maintenant une section AppImage trouvée via {{MenuCommand|Edition → Préférences → AppImage}}. Veuillez tester cette fonctionnalité et faire part de votre expérience par la [https://forum.freecadweb.org/viewtopic.php?f=8&t=44324 discussion du forum].
Grâce aux efforts de plusieurs développeurs clés, il y a un [https://forum.freecadweb.org/viewtopic.php?f=8&t=44324 effort continu] pour intégrer une fonctionnalité permettant une '''mise à jour automatique de l'AppImage dans FreeCAD'''. À partir de FC 0.19.21514, il existe maintenant une section AppImage trouvée via {{MenuCommand|Edition → Préférences → AppImage}}. Veuillez tester cette fonctionnalité et faire part de votre expérience par la [https://forum.freecadweb.org/viewtopic.php?f=8&t=44324 discussion du forum].


<span id="GUI_method_1_(official)"></span>
=== Méthode graphique 1 (officielle) ===
=== Méthode graphique 1 (officielle) ===


Line 64: Line 70:
# Une fois que AppImage est mis à jour, appuyez sur le bouton {{Button|Run updated AppImage}}.
# Une fois que AppImage est mis à jour, appuyez sur le bouton {{Button|Run updated AppImage}}.


<span id="GUI_method_2_(unofficial)"></span>
=== Méthode graphique 2 (non officielle) ===
=== Méthode graphique 2 (non officielle) ===


Line 73: Line 80:
Résultat : Suivez les instructions de l'AppImageUpdater.
Résultat : Suivez les instructions de l'AppImageUpdater.


<span id="CLI_method_1_(official)"></span>
=== Méthode 1 par lignes de commande (officielle) ===
=== Méthode 1 par lignes de commande (officielle) ===


Line 92: Line 100:
A faire : partager un script qui peut être ajouté comme un alias ou un tâche [https://fr.wikipedia.org/wiki/Cron|cron].
A faire : partager un script qui peut être ajouté comme un alias ou un tâche [https://fr.wikipedia.org/wiki/Cron|cron].


<span id="CLI_method_2_(unofficial)"></span>
=== Méthode 2 par lignes de commande (non officielle) ===
=== Méthode 2 par lignes de commande (non officielle) ===


Line 102: Line 111:




<span id="Experimental"></span>
= Expérimental =
= Expérimental =


<span id="Fixing_AppImage_zsync"></span>
== Correction du fichier zsync AppImage ==
== Correction du fichier zsync AppImage ==


Line 110: Line 121:
Cette section nécessite plus de détails.
Cette section nécessite plus de détails.


<span id="Downloading_via_Bittorrent"></span>
== Téléchargement via Bittorrent ==
== Téléchargement via Bittorrent ==


L'équipe chargée du packaging de FreeCAD est en train d'être explorée (grâce au travail d'Antony-jr) la possibilité de télécharger un delta d'appimage de FreeCAD via bittorrent. La question du dépôt se trouve sur https://github.com/FreeCAD/FreeCAD-Bundle/issues/49
L'équipe chargée du packaging de FreeCAD est en train d'être explorée (grâce au travail d'Antony-jr) la possibilité de télécharger un delta d'appimage de FreeCAD via bittorrent. La question du dépôt se trouve sur https://github.com/FreeCAD/FreeCAD-Bundle/issues/49


<span id="Developer_Section"></span>
= Section pour les développeurs =
= Section pour les développeurs =


{{Emphasis|Remarque :}} cette section est destinée aux développeurs.
{{Emphasis|Remarque :}} cette section est destinée aux développeurs.


<span id="Unpacking_AppImages"></span>
== Dépaqueter AppImages ==
== Dépaqueter AppImages ==


Un aspect très pratique de FreeCAD est qu’une grande partie est programmé en [[Python/fr|Python]] ce qui n’a pas besoin d’être compilée manuellement comme en C++. En gros, un fichier Python peut être modifié et, au redémarrage de FreeCAD, ces modifications seront intégrées à l'application. Un développeur peut rapidement travailler sur la dernière version de FreeCAD en utilisant cette technique et une AppImage. De plus, utiliser AppImage ne modifie en aucune façon l'environnement de votre système, c'est-à-dire que rien n'est installé et aucune variable d'environnement n'est modifiée.
Un aspect très pratique de FreeCAD est qu’une grande partie est programmé en [[Python/fr|Python]] ce qui n’a pas besoin d’être compilée manuellement comme en C++. En gros, un fichier Python peut être modifié et, au redémarrage de FreeCAD, ces modifications seront intégrées à l'application. Un développeur peut rapidement travailler sur la dernière version de FreeCAD en utilisant cette technique et une AppImage. De plus, utiliser AppImage ne modifie en aucune façon l'environnement de votre système, c'est-à-dire que rien n'est installé et aucune variable d'environnement n'est modifiée.


<span id="Modifying_AppImages"></span>
=== Modifier des AppImages ===
=== Modifier des AppImages ===


Line 137: Line 152:
}}
}}


<span id="Repackaging_AppImages"></span>
=== Rempaqueter des AppImages ===
=== Rempaqueter des AppImages ===


Line 148: Line 164:
}}
}}


<span id="Personalized_AppImages"></span>
== Des AppImages personnalisées ==
== Des AppImages personnalisées ==


Line 156: Line 173:
Le dépôt de ces scripts se trouve à [https://github.com/realthunder/FreeCADMakeImage realthunder/FreeCADMakeImage]. Veuillez lire le [https://github.com/realthunder/FreeCADMakeImage/blob/master/Readme.md Readme.md] pour plus de détails.
Le dépôt de ces scripts se trouve à [https://github.com/realthunder/FreeCADMakeImage realthunder/FreeCADMakeImage]. Veuillez lire le [https://github.com/realthunder/FreeCADMakeImage/blob/master/Readme.md Readme.md] pour plus de détails.


<span id="Related"></span>
== En relation ==
== En relation ==



Revision as of 20:40, 7 January 2023

Depuis le 7 juillet 2019, la communauté FreeCAD observe que le téléchargement d'AppImages à partir de Github semble s'arrêter avant la fin du téléchargement. Nous ne savons pas pourquoi cela se produit. Si cela se produit pour vous, essayez de télécharger à nouveau. Il se pourrait que vous deviez faire plusieurs essais. Une pratique recommandée consiste à utiliser la fonction de mise à jour automatique AppImage, qui restaurera le téléchargement à partir de l'endroit où il a échoué.

Qu'est ce que AppImage ?

Un seul paquetage et exécuté partout. Atteindre les utilisateurs sur toutes les principales distributions de bureau Linux.

AppImage est un "paquet binaire universel" destiné à distribuer une application quel que soit la distribution Linux. En savoir plus à ce sujet en lisant la page d'accueil Appimage et AppImage sur Wikipédia

Pour le lancer, il faut d'abord le rendre exécutable, puis taper le chemin relatif ou complet.

chmod +x FreeCAD_xxx-x86_64.AppImage
./FreeCAD_xxx-x86_64.AppImage

Pour les autres types d'installation, voir Téléchargements.

AppImages de FreeCAD

Available FreeCAD AppImages
Stable Development
v0.20.2 Weekly build

Remarques importantes :

  • Le développement se fait quotidiennement et rapidement, le lien de mise à jour d'AppImage change constamment.
  • Le lien de développement ci-dessus devrait être à jour car il est mis à jour via un script.
  • De nombreux utilisateurs du forum utilisent la version de développement.
  • Il peut être exécuté sur le même système en parallèle avec une autre version de FreeCAD.
  • Les utilisateurs utilisent la version en cours de développement pour tirer parti des dernières fonctionnalités et corrections de bugs (FreeCAD ayant un cycle de publication long). Ils l'utilisent également pour tester et trouver des bugs susceptibles d'améliorer le développement de FreeCAD.

Mot de mise en garde obligatoire

Dans l'ensemble, la version de développement est stable, mais il est bien sûr important d'ajouter la déclaration obligatoire selon laquelle vous l'utilisez à vos propres risques. Cependant, la plupart des gens qui utilisent des sauvegardes et "sauvegardent souvent" s'en sortent plutôt bien.

Mise à jour automatique

AppImage dispose d'un moyen intelligent et économique de mise à jour. Il calcule la différence entre la nouvelle AppImage et l'ancienne et ne téléchargera que les modifications entre leurs versions. En théorie, l'utilisateur ne téléchargera qu'environ 15% à la fois par rapport à une AppImage entièrement nouvelle.

La mise à jour automatique s'effectue via plusieurs méthodes. Il existe actuellement 4 méthodes, 2 via l'interface graphique (GUI) et 2 via l'interface en ligne-de-commande/terminal (CLI).

Mise à jour expérimentale

Grâce aux efforts de plusieurs développeurs clés, il y a un effort continu pour intégrer une fonctionnalité permettant une mise à jour automatique de l'AppImage dans FreeCAD. À partir de FC 0.19.21514, il existe maintenant une section AppImage trouvée via Edition → Préférences → AppImage. Veuillez tester cette fonctionnalité et faire part de votre expérience par la discussion du forum.

Méthode graphique 1 (officielle)

Application officielle AppImageUpdate par l'interface graphique.

  1. Téléchargez AppImageUpdate-x86_64.AppImage.
  2. Rendez-le exécutable en faisant un clic droit sur le fichier en allant dans les propriétés et "Exécuter en tant qu'exécutable".
  3. Double-cliquez sur l'icône AppImage. Une boîte de dialogue apparaîtra et vous serez invité à spécifier quelle AppImage vous souhaitez mettre à jour.
  4. Spécifiez le chemin d'accès à votre AppImage existante.
  5. Une fois que AppImage est mis à jour, appuyez sur le bouton Run updated AppImage.

Méthode graphique 2 (non officielle)

Il s'agit d'une version non officielle de l'AppImageUpdate nommée: AppImageUpdater. Elle est encore en développement (au moment de l'édition de ce wiki) mais néanmoins très agréable à utiliser.

  1. Téléchargez AppImageUpdater-*-x86_64.AppImage
  2. Rendez le paquet exécutable :
    chmod +x AppImageUpdater*-x86_64.AppImage
    
  3. Exécutez-le :
    source AppImageUpdater*-x86_64.AppImage
    
  4. Trouvez votre AppImage FreeCAD et glissez-la sur l'AppImageUpdater.

Résultat : Suivez les instructions de l'AppImageUpdater.

Méthode 1 par lignes de commande (officielle)

Exécutez les instructions suivantes dans votre terminal :

wget https://github.com/AppImage/AppImageUpdate/releases/download/continuous/appimageupdatetool-x86_64.AppImage
chmod +x ./appimageupdatetool-x86_64.AppImage
./appimageupdatetool.AppImage path/to/old/FreeCAD.AppImage
chmod +x path/to/updated/FreeCAD.AppImage
./path/to/updated/FreeCAD.AppImage

Remarques :

  • Les noms de fichiers seront uniques car les informations de version y sont incorporées. Les instructions ci-dessus sont simplifiées pour plus de commodité.
  • Exécutez ./appimageupdatetool-x86_64.AppImage --help pour en savoir plus sur les fonctionnalités telles que --remove-old, --overwrite et --self-update.
  • Il existe également une version i386. Voir la page Version d'AppImageUpdate.

A faire : partager un script qui peut être ajouté comme un alias ou un tâche [1].

Méthode 2 par lignes de commande (non officielle)

De la même manière que les méthodes graphiques ayant une approche officielle et non officielle pour télécharger AppImages, il en va de même pour la ligne de commande. Il s'agit d'une option de ligne de commande tierce plus élégante pour télécharger des AppImages.

  1. Téléchargez appimageupdater-*-x86_64.AppImage
  2. Rendez le exécutable :
    chmod +x appimageupdater*-x86_64.AppImage
    
  3. Lancez le :
    source appimageupdater*-x86_64.AppImage /path/to/old/FreeCAD-AppImage.AppImage
    

Resultat : met à jour le fichier AppImage spécifié s'il existe une mise à jour.


Expérimental

Correction du fichier zsync AppImage

Il peut arriver qu'une AppImage ne se mette pas à jour parce que son fichier cible a changé d'une manière ou d'une autre. Au lieu de télécharger une toute nouvelle AppImage, il est possible de réécrire le fichier zsync qui est utilisé par l'AppImage pour télécharger la différence. Plus d'informations sont disponibles sur https://github.com/antony-jr/appimage-update-info-writer.

Cette section nécessite plus de détails.

Téléchargement via Bittorrent

L'équipe chargée du packaging de FreeCAD est en train d'être explorée (grâce au travail d'Antony-jr) la possibilité de télécharger un delta d'appimage de FreeCAD via bittorrent. La question du dépôt se trouve sur https://github.com/FreeCAD/FreeCAD-Bundle/issues/49

Section pour les développeurs

Remarque : cette section est destinée aux développeurs.

Dépaqueter AppImages

Un aspect très pratique de FreeCAD est qu’une grande partie est programmé en Python ce qui n’a pas besoin d’être compilée manuellement comme en C++. En gros, un fichier Python peut être modifié et, au redémarrage de FreeCAD, ces modifications seront intégrées à l'application. Un développeur peut rapidement travailler sur la dernière version de FreeCAD en utilisant cette technique et une AppImage. De plus, utiliser AppImage ne modifie en aucune façon l'environnement de votre système, c'est-à-dire que rien n'est installé et aucune variable d'environnement n'est modifiée.

Modifier des AppImages

Une AppImage incorpore un système de fichiers dans celui-ci avec tout le nécessaire pour exécuter l'application. Pour le modifier, le système de fichiers doit être extrait.

./FreeCAD_xxx.AppImage --appimage-extract
cd squashfs-root/

Ouvrez maintenant les fichiers sources Python requis dans votre éditeur de code préféré, modifiez-les et enregistrez-les. Exécutez ensuite l'application.

./AppRun

Rempaqueter des AppImages

Si vous avez modifié le code et que vous souhaitez maintenant ré-emballer l'AppImage avec vos dernières modifications, utilisez l'outil appimagetool-x86_64 sur le système de fichiers extrait.

cd ..
wget "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage"
chmod +x appimagetool-x86_64.AppImage
./appimagetool-x86_64.AppImage squashfs-root

Des AppImages personnalisées

Grâce au travail de realthunder, auteur de App Link et de l'Atelier Assembly3, il est possible de créer des AppImages personnalisées à l'aide d'un ensemble de scripts.

Cela permet de publier des images pour une branche spécifique du code source afin que d'autres puissent les tester. Bien que les AppImages ne fonctionnent que sur Linux, les scripts de realthunder permettent de générer des AppImages également sur Windows et MacOS.

Le dépôt de ces scripts se trouve à realthunder/FreeCADMakeImage. Veuillez lire le Readme.md pour plus de détails.

En relation