La struttura del progetto software

L'intero progetto software è incluso in una solution per Microsoft Visual Studio (Nuova pagina) (è necessaria la versione 2022 o superiore) riportata nel Listato 1 (Nuova pagina).

Della solution fanno parte 7 progetti C#, un progetto Wix Installer (Nuova pagina), ed alcune cartelle contenenti script e documenti vari.

I progetti C# comprendono i 5 tool a linea di comando:

• MontaggioDorsi che effettua l'assemblaggio di immagini full-size generalmente utilizzate per i dorsi
• MontaggioFoto che effettua l'assemblaggio di immagini in varie dimensioni e bordature su cartoline 10x15
• Scatola che prepara un kit per la costruzione di un astuccio a scatola
• Cartella che prepara un kit per la costruzione di un astuccio a cartellina
• CreditCard che prepara un kit per la costruzione di una tessera formato carta di credito

C'è inoltre una interfaccia grafica (solo per Windows) che permette di realizzare le stesse funzioni dei tool appena elencati

L'ultimo, non certo in ordine di importanza è la libreria che contiene tutte le funzioni utilizzate dagli altri eseguibili (che hanno solo funzione di interfaccia. La libreria è distribuita anche come pacchetto NuGet (Nuova pagina).

Le cartelle sono:

• build_tools che contiene gli script per la compilazione e la creazione dei pacchetti di distribuzione
• docs che contiene i file di documentazione generati dai programmi e dal compilatore
• test che contiene file di esempio da utilizzare per i test
• lib che contiene alcune librerie esterne utilizzate dai programmi

Gli unici files che vale la pena di analizzare sono gli script inclusi in build_tools.

publish.cmd, riportato nel Listato 2 (Nuova pagina) effettua il publish di tutti i progetti C# (ad eccezione della GUI) ed inserisce gli eseguibili ottenuti in pacchetto .rar

Poi aggiunge le manpages Unix in una apposita cartella e chiama lo script pack.sh (Listato 2a (Nuova pagina))che crea un pacchetto .tar.bz2

Questo è uno script per la shell Unix Bash e viene lanciato attraverso il WSL (Windows Subsystem for Linux) (Nuova pagina) di Windows 10.

Immediatamente dopo viene lanciato, con lo stesso sistema, un altro script Bash, builddeb.sh (Listato 2b (Nuova pagina)), che crea i pacchetti .deb (x64 e arm64) per Debian e Ubuntu.

Viene quindi compilata l'interfaccia grafica, rimosse tutte le librerie native relative a sistemi diversi da Windows e quindi creato un nuovo pacchetto .rar

Infine viene creato l'installer per Windows utilizzando il progetto Wix Installer.