AppImage/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
(45 intermediate revisions by 3 users not shown)
Line 4: Line 4:
{{TOCright}}
{{TOCright}}


== Qu'est ce que AppImage? ==
== Qu'est ce que AppImage ? ==


[[Image:AppImage-logo.png|link=https://appimage.org]]
[[Image:AppImage-logo.png|link=https://appimage.org]]
{{Emphasis|Packager une fois et jouer partout. Permet d'être utiliser sur les principales distributions Linux.}}
{{Emphasis|Packager une fois et l'exécuter partout. Permet d'être utilisé sur les principales distributions 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 [https://appimage.org page d'accueil Appimage] et [https://fr.wikipedia.org/wiki/AppImage AppImage sur Wikipédia]
AppImage est un "paquet binaire universel" destiné à distribuer une application quel que soit la distribution Linux. En savoir plus à ce sujet en lisant la [https://appimage.org page d'accueil Appimage] et [https://fr.wikipedia.org/wiki/AppImage AppImage sur Wikipédia]
Line 19: Line 19:
Pour les autres types d'installation, voir [[Download/fr|Téléchargements]].
Pour les autres types d'installation, voir [[Download/fr|Téléchargements]].


== FreeCAD AppImages ==
== AppImages de FreeCAD ==


{{Emphasis|Remarque:}} si les liens ci-dessous ne fonctionnent pas, veuillez les télécharger le fichier manuellement depuis la section "Actifs" de la [https://github.com/FreeCAD/FreeCAD/releases release page].
{{VeryImportantMessage|Si les liens ci-dessous ne fonctionnent pas, veuillez les télécharger manuellement depuis la section "Assets" de [https://github.com/FreeCAD/FreeCAD/releases '''FreeCAD Github Releases''']}}


{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
=== Version stable ===
|+ style="text-align: center; font-size: 150%; | les AppImages disponibles de FreeCAD
|+
! style="text-align: center; font-size: 200%;" | Stable
! style="text-align: center; font-size: 200%;" | Développement
|-
| style="text-align: center;" | [[Image:AppImage-logo.png|link=https://github.com/FreeCAD/FreeCAD/releases/download/{{:Template:Stable-Major-and-Minor-Version}}/FreeCAD_{{:Template:Stable-Version}}-Linux-Conda_Py3Qt5_glibc2.12-x86_64.AppImage]] [https://github.com/FreeCAD/FreeCAD/releases/download/{{:Template:Stable-Major-and-Minor-Version}}/FreeCAD_{{:Template:Stable-Version}}-Linux-Conda_Py3Qt5_glibc2.12-x86_64.AppImage {{:Template:Stable-Version}}] ([https://github.com/FreeCAD/FreeCAD/releases/download/{{:Template:Stable-Major-and-Minor-Version}}/FreeCAD_{{:Template:Stable-Version}}-Linux-Conda_Py3Qt5_glibc2.12-x86_64.AppImage-SHA256.txt SHA256])
| style="text-align: center;" | [[Image:AppImage-logo.png|link=https://github.com/FreeCAD/FreeCAD/releases/download/0.19_pre/FreeCAD_{{:Template:Development-Version}}-Linux-Conda_glibc2.12-x86_64.AppImage]] [https://github.com/FreeCAD/FreeCAD/releases/download/0.19_pre/FreeCAD_{{:Template:Development-Version}}-Linux-Conda_glibc2.12-x86_64.AppImage {{:Template:Development-Version}}] ([https://github.com/FreeCAD/FreeCAD/releases/download/0.19_pre/FreeCAD_{{:Template:Development-Version}}-Linux-Conda_glibc2.12-x86_64.AppImage-SHA256.txt SHA256])
|}


'''Remarques importantes :'''
La version stable actuelle est la suivante: [https://github.com/FreeCAD/FreeCAD/releases/download/{{:Template:Stable-Major-and-Minor-Version}}/FreeCAD_{{:Template:Stable-Version}}-Linux-Conda_Py3Qt5_glibc2.12-x86_64.AppImage FreeCAD_{{:Template:Stable-Version}}] ([https://github.com/FreeCAD/FreeCAD/releases/download/{{:Template:Stable-Major-and-Minor-Version}}/FreeCAD_{{:Template:Stable-Version}}-Linux-Conda_Py3Qt5_glibc2.12-x86_64.AppImage-SHA256.txt SHA256])

=== Version de développement ===

La version de développement actuelle est la suivante : [https://github.com/FreeCAD/FreeCAD/releases/download/0.19_pre/FreeCAD_{{:Template:Development-Version}}-Linux-Conda_Py3Qt5_glibc2.12-x86_64.AppImage FreeCAD_{{:Template:Development-Version}}] ([https://github.com/FreeCAD/FreeCAD/releases/download/0.19_pre/FreeCAD_{{:Template:Development-Version}}-Linux-Conda_Py3Qt5_glibc2.12-x86_64.AppImage-SHA256.txt SHA256])

'''Remarques importantes:'''
* Le développement se fait quotidiennement et rapidement, le lien de mise à jour d'AppImage est une cible en mouvement.
* Le développement se fait quotidiennement et rapidement, le lien de mise à jour d'AppImage est une cible en mouvement.
* Le lien de développement ci-dessus devrait être à jour car il est mis à jour via un script.
* Le lien de développement ci-dessus devrait être à jour car il est mis à jour via un script.
Line 38: Line 40:
* 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.


==== Mot de mise en garde obligatoire ====
==== Mot de mise en garde obligatoire ====

Pour l'essentiel, la version de développement est stable mais il est bien sûr important d'ajouter la déclaration obligatoire pour pouvoir l'utiliser à vos risques et périls. Bien que la plupart des gens qui utilisent des sauvegardes et «sauvegardent souvent» s'en sortent plutôt bien.
Pour l'essentiel, la version de développement est stable mais il est bien sûr important d'ajouter la déclaration obligatoire pour pouvoir l'utiliser à vos risques et périls. Bien que la plupart des gens qui utilisent des sauvegardes et « sauvegardent souvent » s'en sortent plutôt bien.


== Mise à jour automatique ==
== Mise à jour automatique ==
Line 46: Line 49:


La mise à jour automatique s'effectue via plusieurs méthodes optionnelles. 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 optionnelles. 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 [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].


=== Méthode graphique 1 (officielle) ===
=== Méthode graphique 1 (officielle) ===
Line 65: Line 72:
Résultat: suivez les invites AppImageUpdater.
Résultat: suivez les invites AppImageUpdater.


=== CLI méthode 1 (officielle) ===
=== Méthode 1 par lignes de commande (officielle) ===


Exécutez les instructions suivantes dans votre terminal :
Exécutez les instructions suivantes dans votre terminal :
Line 79: Line 86:
Remarques:
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é.
* 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 {{incode|./appimageupdatetool-x86_64.AppImage --help}} pour en savoir plus sur les fonctionnalités telles que {{incode|-r}} and {{incode|--self-update}}.
* Exécutez {{incode|./appimageupdatetool-x86_64.AppImage --help}} pour en savoir plus sur les fonctionnalités telles que {{incode|-r}} et {{incode|--self-update}}.
* Il existe également une version i386. Voir la page [https://github.com/AppImage/AppImageUpdate/releases Version d'AppImageUpdate].
* Il existe également une version i386. Voir la page [https://github.com/AppImage/AppImageUpdate/releases Version d'AppImageUpdate].


A faire: partager un script qui peut être ajouté comme alias ou travail cron.
A faire: partager un script qui peut être ajouté comme un alias ou un tâche Cron.


=== CLI méthode 2 (non officielle) ===
=== 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 AppImages.
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 AppImages.
Line 93: Line 100:
'''Resultat''' : Met à jour le fichier AppImage spécifié s'il existe une mise à jour.
'''Resultat''' : Met à jour le fichier AppImage spécifié s'il existe une mise à jour.


= Section pour les développeurs =
== Dépaqueter AppImages ==


{{Emphasis|Remarque:}} cette section est destinée aux développeurs.
{{Emphasis|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/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.
Line 104: Line 113:


{{Code|code=
{{Code|code=
FreeCAD.AppImage --appimage-extract
./FreeCAD_xxx.AppImage --appimage-extract
cd squashfs-root/
cd squashfs-root/
}}
}}
Line 116: Line 125:
=== Rempaqueter AppImages ===
=== Rempaqueter AppImages ===


Si vous avez modifié le code et souhaitez maintenant repackager AppImage avec vos dernières modifications, utilisez la commande [https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage appimagetool-x86_64] sur le système de fichiers extrait.
Si vous avez modifié le code et souhaitez maintenant repackager AppImage avec vos dernières modifications, utilisez la commande [https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage appimagetool-x86_64] sur le système de fichiers extraits.


{{Code|code=
{{Code|code=
Line 124: Line 133:
./appimagetool-x86_64.AppImage squashfs-root
./appimagetool-x86_64.AppImage squashfs-root
}}
}}
[[Category:Packaging/fr]]


== AppImages personnalisées ==
[[Category:Developer Documentation/fr]]

Grâce au travail de {{Emphasis|realthunder}}, auteur de [[App_Link/fr|App Link]] et [[Assembly3_Workbench/fr|Atelier Assembly3]], il est possible de créer des AppImages personnalisées à l'aide d'un ensemble de scripts.

Cela rend très pratique la publication d'images pour une branche spécifique du code source que d'autres peuvent tester. Bien que AppImages ne fonctionne 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 à [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.
[[Category:Testing]]


[[Category:Packaging{{#translation:}}]]
{{Userdocnavi/fr}}
[[Category:Developer Documentation{{#translation:}}]]
[[Category:Testing{{#translation:}}]]
{{Userdocnavi{{#translation:}}}}

Revision as of 19:05, 6 July 2020

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 ?

Packager une fois et l'exécuter partout. Permet d'être utilisé sur les principales distributions 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 l'exécuter, commencez par le rendre exécutable, puis tapez le chemin d'accès relatif ou complet.

chmod +x FreeCAD_x86_64.AppImage
./FreeCAD_x86_64.AppImage

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

AppImages de FreeCAD

Si les liens ci-dessous ne fonctionnent pas, veuillez les télécharger manuellement depuis la section "Assets" de FreeCAD Github Releases
les AppImages disponibles de FreeCAD
Stable Développement
0.20.2.29603 (SHA256) 28810 (SHA256)

Remarques importantes :

  • Le développement se fait quotidiennement et rapidement, le lien de mise à jour d'AppImage est une cible en mouvement.
  • 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

Pour l'essentiel, la version de développement est stable mais il est bien sûr important d'ajouter la déclaration obligatoire pour pouvoir l'utiliser à vos risques et périls. Bien que 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 optionnelles. 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)

Ceci est l'application officielle de l'interface graphique AppImageUpdate.

  1. Télécharger 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écharger AppImageUpdater-*-x86_64.AppImage
  2. Le rendre exécutable:
    chmod +x AppImageUpdater*-x86_64.AppImage
    
  3. Exécutez-le:
    source AppImageUpdater*-x86_64.AppImage
    
  4. Trouvez votre FreeCAD AppImage actuelle et faites-la glisser sur AppImageUpdater

Résultat: suivez les invites 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 -r 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 Cron.

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 AppImages.

  1. Télécharger appimageupdater-*-x86_64.AppImage
  2. Rendez le exécutable :
    chmod +x appimageupdater*-x86_64.AppImage
    
  3. Lancer 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.

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 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 source Python requis dans votre éditeur de code, modifiez-les et enregistrez-les. Puis éxecutez l'application.

./AppRun

Rempaqueter AppImages

Si vous avez modifié le code et souhaitez maintenant repackager AppImage avec vos dernières modifications, utilisez la commande appimagetool-x86_64 sur le système de fichiers extraits.

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

AppImages personnalisées

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

Cela rend très pratique la publication d'images pour une branche spécifique du code source que d'autres peuvent tester. Bien que AppImages ne fonctionne 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.