AppImage

From FreeCAD Documentation
Revision as of 06:51, 27 August 2023 by Simone.b (talk | contribs) (Created page with "== Download tramite Bittorrent ==")
A partire dal 7 luglio 2019, la comunità di FreeCAD ha segnalato che il download di AppImages da Github sembra terminare prima del completamento. Non sappiamo perché accade questo. In questo caso, provare a scaricare di nuovo. Potrebbero essere necessari alcuni tentativi. Una pratica consigliata è quella di utilizzare la funzione di aggiornamento automatico di AppImage, che ripristina il download dal punto in cui si è interrotto.

Che cos'è una AppImage?

Impacchetta una volta ed esegui ovunque. Raggiungi gli utenti su tutte le principali distribuzioni desktop Linux.

AppImage è un "pacchetto binario universale" destinato a distribuire un'applicazione a qualsiasi distribuzione Linux. Maggiori informazioni al riguardo su Appimage homepage e Wikipedia.

Per eseguirlo, renderlo prima eseguibile, quindi digitare il percorso relativo o completo.

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

Per altri tipi di installazione vedere Download.

AppImages di FreeCAD

Available FreeCAD AppImages
Stable Development
v0.20.2 Weekly build

Note importanti:

  • Lo sviluppo avviene quotidianamente e rapidamente, il link di aggiornamento di AppImage è un obiettivo mobile.
  • Il link alla versione di sviluppo indicato sopra dovrebbe essere aggiornato perché viene aggiornato tramite uno script.
  • Molti utenti del forum utilizzano la versione di sviluppo.
  • Può essere eseguito sullo stesso sistema in parallelo con un'altra versione di FreeCAD.
  • Gli utenti usano la versione dev per sfruttare le ultime funzionalità e correzioni di errori (poiché FreeCAD ha un lungo ciclo di rilascio). La usano anche per aiutare a testare e trovare i bug per stimolare lo sviluppo e il miglioramento di FreeCAD.

Avviso di cautela obbligatorio

Per la maggior parte la versione di sviluppo è stabile ma ovviamente è importante aggiungere un obbligatorio avviso di cautela utilizzarla a proprio rischio. Anche se la maggior parte delle persone che utilizzano backup e "salvano spesso" fanno abbastanza bene.

Aggiornamento automatico

AppImage ha un modo intelligente ed economico di aggiornamento. Calcola la differenza tra il nuovo AppImage e quello vecchio e scaricherà solo le modifiche tra le loro versioni. In teoria l'utente finisce per scaricare circa il 15% ogni volta invece di un AppImage completamente nuovo.

L'aggiornamento automatico viene eseguito tramite diversi metodi opzionali. Attualmente ci sono 4 metodi, 2 attraverso l'interfaccia grafica (GUI) e 2 attraverso l'interfaccia a riga di comando / terminale (CLI).

Aggiornamento sperimentale in-app

Grazie agli sforzi di diversi sviluppatori chiave, c'è uno sforzo in corso per integrare una funzionalità che consenta auto-aggiornamento dell'AppImage all'interno FreeCAD stesso. A partire da FC 0.19.21514 ora esiste una sezione AppImage trovata tramite Modifica → Preferenze → AppImage. Prova questa funzionalità e segnala la tua esperienza al forum di discussione.

Metodo GUI 1 (ufficiale)

Questa è l'applicazione GUI ufficiale di AppImageUpdate.

  1. Scaricare AppImageUpdate-x86_64.AppImage.
  2. Renderlo eseguibile facendo clic con il pulsante destro del mouse sul file, accedendo alle proprietà e selezionando "Eseguibile".
  3. Fare doppio clic sull'icona AppImage, verrà visualizzata una finestra di dialogo e verrà richiesto di specificare quale AppImage desideri aggiornare.
  4. Specificare il percorso della tua AppImage esistente.
  5. Una volta aggiornata l'AppImage, premere il pulsante Eseguire l'AppImage aggiornata.

Metodo GUI 2 (non ufficiale)

Questa è una versione non ufficiale di terze parti più elegante di AppImageUpdate denominata: AppImageUpdater. È ancora in fase di sviluppo (al momento di questa modifica della wiki) ma è comunque abbastanza piacevole da usare.

  1. Scarica AppImageUpdater-*-x86_64.AppImage
  2. Rendilo eseguibile:
    chmod +x AppImageUpdater*-x86_64.AppImage
    
  3. Eseguilo:
    source AppImageUpdater*-x86_64.AppImage
    
  4. Trova la tua AppImage di FreeCAD corrente e trascinala su AppImageUpdater

Risultato: segui le istruzioni di AppImageUpdater

Metodo CLI 1 (ufficiale)

Eseguire le seguenti istruzioni nel terminale

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

Appunti:

  • I nomi dei file saranno univoci perché le informazioni sulla versione sono incorporate in essi. Le istruzioni sopra riportate sono semplificate per comodità.
  • Eseguire ./appimageupdatetool-x86_64.AppImage --help per conoscere funzionalità come --remove-old, --overwrite e - -autoaggiornamento.
  • Esiste anche una versione i386; vedere la pagina Versione di AppImageUpdate.

Da fare: condividere uno script che può essere aggiunto come alias o job di cron.

Metodo CLI 2 (non ufficiale)

Analogamente ai metodi grafici che hanno un approccio ufficiale e non ufficiale per scaricare AppImages, lo stesso vale per la riga di comando. Questa è un'opzione della riga di comando di terze parti più elegante per scaricare AppImages.

  1. Scaricare appimageupdater-*-x86_64.AppImage
  2. Renderlo eseguibile:
    chmod +x appimageupdater*-x86_64.AppImage
    
  3. Eseguirlo:
    source appimageupdater*-x86_64.AppImage /path/to/old/FreeCAD-AppImage.AppImage
    

Risultato: Aggiornare il file AppImage specificato se l'aggiornamento esiste


Sperimentale

Riparare l'AppImage zsync

Può succedere che un'AppImage non si aggiorni perché il file di destinazione è cambiato in qualche modo. Invece di scaricare un'AppImage completamente nuova, è possibile riscrivere il file zsync utilizzato da AppImage per scaricare il delta. Maggiori informazioni sono disponibili su https://github.com/antony-jr/appimage-update-info-writer.

Questa sezione necessita di maggiori dettagli.

Download tramite Bittorrent

An experimental feature that the FreeCAD packaging team is exploring (thanks to the work of Antony-jr) is being able to download an appimage delta of FreeCAD via bittorrent. The repository issue is at https://github.com/FreeCAD/FreeCAD-Bundle/issues/49

Developer Section

Note: the following sections are intended for developers

Unpacking AppImages

A very convenient aspect of FreeCAD is that a majority of it is built in Python, which doesn't need to be manually compiled like C++. Essentially, a Python file can be modified, and upon restarting FreeCAD those changes will be integrated into the application. A developer can quickly work on the latest FreeCAD release using this technique and an AppImage. Moreover, using an AppImage doesn't modify your system's environment in any way, that is, nothing is installed and no environmental variables are modified.

Modifying AppImages

An AppImage embeds a file system in it with everything that is required to run the application. In order to modify it, the file system needs to be extracted.

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

Now open the required Python source files in your preferred code editor, modify them, and save them. Then run the application.

./AppRun

Repackaging AppImages

If you've modified the code, and now want to re-package the AppImage with your latest changes, use the appimagetool-x86_64 tool on the extracted file system.

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 personalizzate

Thanks to the work of realthunder, author of App Link and Assembly3 Workbench, it is possible to build custom AppImages using a set of scripts.

This makes it very convenient to release images for a specific branch of the source code for others to test. Although AppImages only work on Linux, realthunder's scripts make it possible to generate AppImages also on Windows and MacOS.

Il repository per questi script è su realthunder/FreeCADMakeImage. Si prega di leggere il Readme.md per maggiori dettagli.

Correlati