Installazione e build desktop R47

La distribuzione R47 contiene l’applicazione web, i sorgenti desktop e le procedure per produrre installer nativi. Le procedure scaricano versioni fissate di Electron, Python e, se richiesto, Blender. I runtime pesanti sono separati dal pacchetto di aggiornamento. I progetti separati non sono inclusi.

1. Quale file utilizzare

EsigenzaProcedura
Aggiornare una distribuzione R43–R46Estrarre l’aggiornamento R47 sopra la cartella dell’applicazione conservando configurazioni private e progetti. Sul web aprire aggiornamento-r47.html.
Nuova installazione webEstrarre il pacchetto completo nella radice del sito. Seguire la configurazione account, cloud e worker nella guida principale.
Creare un installer desktopEstrarre il pacchetto completo in una cartella scrivibile sul sistema di destinazione e usare i comandi della sezione 3.
Aggiornare il desktop con runtime precedenteChiudere l’app; applicare i file R47 nella cartella resources/app conservando runtime e desktop-build.json. La dipendenza dal vecchio Blender resta finché non si ricostruisce con il builder R47.

2. Prerequisiti di compilazione

Servono Node.js con npm e Python 3.11.8 o successivo sulla macchina di compilazione. Su Windows il lanciatore usa Python 3.11 tramite py -3.11; installare quella versione oppure richiamare build.py con un altro Python compatibile. L’utente che installa il risultato non deve installare Python o Node.

Usare Windows x64 per gli EXE, macOS Intel per il DMG Intel, macOS Apple Silicon per il DMG arm64, Linux x64 per AppImage e DEB. La build Intel su Mac rifiuta Rosetta per evitare librerie di architettura diversa. I pacchetti macOS R47 impostano macOS 15 come versione minima. Su Linux usare una distribuzione con glibc 2.31 o successiva e le librerie GTK/NSS necessarie a Electron.

La prima build richiede Internet e spazio per sorgenti, download, dipendenze, cartella temporanea e risultati. Riservare almeno 12 GB liberi senza Blender e 20 GB con Blender. Verificare spazio aggiuntivo per progetti e rendering. Il codice dell’app proviene esclusivamente dal manifest della distribuzione; file modificati richiedono la rigenerazione consapevole del manifest.

3. Creare gli installer

Dalla radice della distribuzione completa:

SistemaComandoRisultati
Windows x64powershell -NoProfile -File desktop/build-r47/BUILD_WINDOWS.ps1Setup.exe con scelta cartella e Portable.exe
Mac Intelbash desktop/build-r47/BUILD_MAC_INTEL.commandDMG e ZIP con app x64
Mac Apple Siliconbash desktop/build-r47/BUILD_MAC_SILICON.commandDMG e ZIP con app arm64
Linux x64bash desktop/build-r47/BUILD_LINUX.shAppImage e DEB

È disponibile anche BUILD_DESKTOP_MAC.command nella radice: riconosce l’architettura del Mac. Le cartelle di uscita predefinite sono dentro desktop/build-r47, con nomi distinti per sistema. Non usare l’aggiornamento ridotto da solo come sorgente di una nuova build: contiene soltanto i file cambiati.

La procedura verifica il manifest, controlla gli SHA-256 degli archivi, installa le librerie scientifiche nel runtime isolato, importa i motori e produce gli installer. Se una fase fallisce termina con un errore; non dichiara prodotto un installer assente. In uscita sono presenti BUILD-<target>.json con dimensioni e impronte degli installer e DEPENDENCIES-<target>.json con le versioni effettivamente scaricate.

Build sui quattro sistemi con GitHub Actions

È incluso desktop/build-r47/github-actions.yml. In un proprio repository contenente la distribuzione completa copiarlo in .github/workflows/nexsoon-desktop.yml, conservando i file binari tramite Git LFS se necessario. Avviarlo manualmente da Actions. La matrice usa Windows 2022, Mac Intel, Mac arm64 e Ubuntu 22.04; non pubblica automaticamente una release.

Il workflow dispone delle opzioni Blender incorporato e firma. Configurare nei Secrets del repository le credenziali di firma richieste prima di abilitare la seconda opzione. Gli installer e i rapporti vengono raccolti in quattro artifact separati. Le dipendenze delle action sono fissate per commit. Il workflow è fornito come procedura; non è stato avviato su un account GitHub durante questo rilascio. Disponibilità, spazio e quote dei runner dipendono dall’account.

4. Blender incorporato oppure esterno

Nelle nuove build R47 Blender è facoltativo per avviare e utilizzare l’app. Python e le librerie di calcolo hanno un runtime proprio. Blender serve ancora al motore Cycles per immagini, sequenze e video. Il 3D interattivo web usa il renderer dell’app; Unreal è una destinazione separata.

Per includere Blender nell’installer Windows:

powershell -NoProfile -File desktop/build-r47/BUILD_WINDOWS.ps1 -WithBlender

Su Mac o Linux aggiungere --with-blender al rispettivo comando. L’installer risultante comprende Blender 4.5.3 della corretta architettura e diventa sensibilmente più grande. Non occorre affiancargli il precedente archivio Blender.

Senza questa opzione, installare Blender separatamente e selezionare il suo eseguibile dal comando desktop dedicato. Su macOS selezionare Blender.app; il programma risolve il binario interno. La scelta viene salvata nel profilo e vale per le successive richieste di rendering. Se l’installazione contiene Blender incorporato, viene usata quella copia.

Il vecchio pacchetto App + Blender usava il Python contenuto in Blender anche per altri motori: non eliminare Blender da quella installazione. La separazione completa richiede la ricostruzione con il builder R47. Un aggiornamento del solo codice non trasforma la struttura dei vecchi runtime.

5. Firma e distribuzione

Per una distribuzione firmata aggiungere -Signed su Windows oppure --signed su Mac. Il builder richiede la firma e fallisce se non può applicarla. Configurare le credenziali di firma nell’ambiente di compilazione previsto da electron-builder, senza inserirle nei sorgenti o negli ZIP.

Su macOS sono necessari identità Developer ID, certificato e notarizzazione Apple. Per la notarizzazione configurare Apple ID, password specifica dell’app e Team ID oppure le credenziali API supportate da electron-builder. Senza firma il comando produce un pacchetto non notarizzato, soggetto alle regole di sicurezza del sistema; non è una distribuzione pubblica firmata.

Gli installer non modificano servizi remoti, domini o account cloud. Account email, Nexsoon ID, Bigger ID e provider IA richiedono le configurazioni effettive del proprio servizio. Un installer non può incorporare automaticamente credenziali che non sono state configurate.

Il campo homepage dell’installer usa il sito Nexsoon. Per assegnare l’indirizzo della propria distribuzione impostare NEXSOON_APP_HOMEPAGE prima della build.

6. Installazione da parte dell’utente

Progetti, configurazione IA, cloud locale e risultati sono salvati nel profilo dell’utente o nelle destinazioni scelte, non nella cartella protetta dell’app. Salvare e chiudere i progetti prima di aggiornare. La disinstallazione NSIS conserva i dati dell’utente.

7. Cache, offline e riproducibilità

Il builder conserva archivi e wheel in ~/.cache/nexsoon-build, separati per architettura. Dopo una prima build riuscita sullo stesso sistema è disponibile --offline, purché siano ancora presenti anche le cache npm, Electron ed electron-builder. L’opzione non ricrea cache mancanti. Le wheel scaricate sono registrate con SHA-256; un cambiamento di requirements richiede una nuova cache delle dipendenze.

python3 desktop/build-r47/build.py --target linux-x64 --work /percorso/cartella-vuota --cache /percorso/cache --output /percorso/installer --offline

La directory --work deve essere vuota ed esterna ai sorgenti. Conservarla in caso di errore per esaminare il risultato intermedio; dopo una build riuscita può essere eliminata. Non inserire cartelle di compilazione o dipendenze scaricate nel pacchetto web.

8. Motori esterni e compatibilità

I runtime incorporati comprendono PyNite, IfcOpenShell, WNTR/EPANET, DXF, LAS e LAZ. Il lettore E57 pye57 è previsto per Windows, Linux e Mac Apple Silicon; non è incluso nel runtime Mac Intel perché la versione fissata non offre una wheel compatibile. Su quella piattaforma convertire E57 in LAS/LAZ con un convertitore appropriato prima dell’importazione.

Unreal richiede la compilazione separata del Viewer dai sorgenti inclusi e la selezione del risultato. Revit richiede il componente aggiuntivo installato su Revit; GSM richiede LP_XMLConverter per la modifica dei parametri. Questi programmi esterni e le relative licenze non sono contenuti nel runtime Python.

Configurazione completa dello streaming Unreal · Famiglie RFA e GSM · Compilazione e comandi del Viewer.

9. Stato della distribuzione

Questo archivio è una distribuzione di sorgenti e procedure di build, non una raccolta di EXE e DMG già compilati. Il rapporto di rilascio distingue controlli sul codice, esecuzione dei motori locali, confezionamento Linux ed esecuzione sui dispositivi finali. La qualificazione del motore strutturale, la geometria parametrica GSM e i lettori senza software esterno restano indicati nella scaletta tecnica; non sono resi completi dal solo installer.