Distribuzione

Questa pagina è destinata a chi installa AFDIM sui computer di un’officina. AFDIM usa un unico programma di installazione Inno Setup, AFDIM_Setup_<version>.exe, disponibile nella pagina Download. Installa un pacchetto AutoCAD® Autoloader. Non occorre registrare nulla manualmente in AutoCAD: né NETLOAD né la registrazione COM. A ogni avvio, AutoCAD esamina le cartelle ApplicationPlugins e carica il pacchetto.

Posizione dei file installati

Ambito	Pacchetto del plugin	Programma di disinstallazione	Richiede elevazione
Per utente (predefinito)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	No
Tutti gli utenti (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Sì

Il programma di disinstallazione si trova volutamente fuori dalla cartella del pacchetto, perché AutoCAD esamina quella cartella. In un’installazione per tutti gli utenti rimane in %ProgramFiles%, così un utente standard non può sostituirlo. Usa solo il programma di disinstallazione del tipo di installazione indicato nella tabella. Non eseguire mai un programma di disinstallazione da %ProgramData%, anche se un vecchio messaggio rimanda lì. Se manca il programma di disinstallazione di un’installazione per tutti gli utenti, esegui il programma di installazione ufficiale dalla pagina Download con /ALLUSERS per riparare quell’installazione, poi disinstallala. Il programma di installazione rifiuta di installare sopra un’installazione dell’altro tipo. Esegui il programma di disinstallazione di un’installazione per utente senza diritti di amministratore.

Il pacchetto contiene PackageContents.xml (manifesto Autoloader), state.json (versione installata, canale degli aggiornamenti e ambito) e una cartella Contents con una sottocartella per versione. Un’installazione con /NOAUTOUPDATE aggiunge il file noautoupdate. Il programma aggiunge anche il collegamento nel menu Start AFDIM › AFDIM Help.

AFDIM scrive i dati seguenti durante l’esecuzione. Ogni account Windows ha la propria copia, tranne %ProgramData%\AFDIM\license, condivisa tra tutti gli account.

Posizione	Contenuto
%APPDATA%\AFDIM	Impostazioni e norme di disegno salvate
%LOCALAPPDATA%\AFDIM\logs	Registro di assistenza
%LOCALAPPDATA%\AFDIM\cache	Download degli aggiornamenti
%LOCALAPPDATA%\AFDIM\license	Licenza dell’account Windows corrente
%ProgramData%\AFDIM\license	Licenza per tutti gli account del computer, quando Windows ne consente la scrittura
HKCU\Software\AFDIM	ID di installazione e orario del controllo della licenza
%TEMP%\AFDIM	Esportazioni della geometria create con Esporta la geometria dell’ultima esecuzione… (scheda Informazioni delle impostazioni)

Il programma di disinstallazione conserva sempre le cartelle delle licenze e la chiave di registro. Consulta Disinstallazione.

I due ambiti non possono coesistere

Il programma rifiuta una nuova installazione se AFDIM è già installato nell’altro ambito. AutoCAD esamina entrambe le cartelle ApplicationPlugins, perciò caricherebbe entrambe le copie. Il comando AFDIM verrebbe registrato due volte e l’aggiornamento dall’app modificherebbe una sola copia. Il messaggio di rifiuto indica il preciso unins000.exe da eseguire prima. Un’installazione silenziosa non mostra il messaggio: si interrompe senza installare e scrive il motivo nel file /LOG.

Versioni di AutoCAD coperte

Un pacchetto serve tutte le postazioni. PackageContents.xml associa ogni serie di AutoCAD alla build corrispondente.

Build	Serie	Anni AutoCAD	Stato
net472	Da R19.0 a R23.1	Dal 2013 al 2020	Distribuita; 2014 e dal 2016 al 2018 sperimentali
net48	Da R24.0 a R24.3	2021, 2022, 2023, 2024	Distribuita
net8.0-windows	Da R25.0 a R25.1	2025, 2026	Distribuita
net10.0-windows	R26.0	2027	Distribuita, sperimentale

Una versione di AutoCAD installata in seguito, purché appartenente a una serie coperta, carica AFDIM senza reinstallarlo. AutoCAD Mechanical degli stessi anni carica la stessa build. AutoCAD LT non è supportato perché non ha un’API .NET. La pagina Detected AutoCAD della procedura guidata è soltanto informativa e non offre una casella per ciascuna versione.

Installare mentre AutoCAD è in esecuzione

È supportato. Ogni versione viene installata nella propria sottocartella, quindi un AutoCAD in esecuzione non blocca i file scritti dal programma di installazione. Questo mostra una nota e continua. Non occorre chiudere AutoCAD prima. Un AutoCAD già aperto caricherà AFDIM al successivo avvio.

Installazione silenziosa

AFDIM_Setup_<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

La procedura guidata e l’accordo di licenza sono in inglese. La pagina AFDIM Help si apre in vietnamita su un Windows configurato per il Vietnam e in inglese altrove.

Il plugin ha una lingua d’interfaccia propria. Una nuova installazione si avvia in inglese, oppure in vietnamita quando Windows è configurato per il Vietnam (lingua visualizzata, formato regionale o Paese). Ogni utente può cambiare lingua nell’elenco di 56 lingue nell’intestazione delle impostazioni. Le impostazioni si aprono con Settings nella scheda AFDIM della barra multifunzione. La lingua si applica alla finestra, agli avvisi e ai messaggi della riga di comando. I testi non ancora tradotti compaiono in inglese. La scelta viene salvata nelle impostazioni dell’utente.

Opzione	Effetto
/VERYSILENT	Nessuna interfaccia utente. Usala per la distribuzione tramite script.
/SILENT	Solo finestra di avanzamento, senza pagine della procedura guidata.
/SUPPRESSMSGBOXES	Sopprime le finestre di messaggio. Usala insieme a /VERYSILENT.
/NORESTART	Non riavvia mai. Il programma non richiede il riavvio, ma passa comunque l’opzione.
/LOG="C:\path\afdim.log"	Scrive un registro completo dell’installazione. Allegalo a una richiesta di assistenza relativa all’installazione.
/ALLUSERS	Installa per tutti gli utenti in %ProgramFiles%. Richiede elevazione. Registra l’ambito macchina in state.json, disattivando gli aggiornamenti dall’app.
/CURRENTUSER	Installa per l’utente corrente. È il valore predefinito.
/NOAUTOUPDATE	Disattiva gli aggiornamenti dall’app per questa installazione aggiungendo noautoupdate. Eseguire di nuovo il programma senza questa opzione li riattiva.
/EXCLUDESERIES=<series>	Esclude la build che copre la serie indicata, impedendo alle versioni AutoCAD di quella serie di caricare AFDIM. Separa più serie con virgole.
/NOICONS	Non crea il collegamento nel menu Start.
/DIR="C:\path"	Sostituisce la cartella di installazione. È raramente corretto, perché AutoCAD esamina soltanto le posizioni ApplicationPlugins standard.

/EXCLUDESERIES accetta una serie, non un anno: 2013 = R19.0, 2014 = R19.1, 2015 = R20.0, 2016 = R20.1, 2017 = R21.0, 2018 = R22.0, 2019 = R23.0, 2020 = R23.1, 2021 = R24.0, 2022 = R24.1, 2023 = R24.2, 2024 = R24.3, 2025 = R25.0, 2026 = R25.1, 2027 = R26.0. L’opzione elimina l’intera build che copre la serie. Escludere R23.0 impedisce il caricamento di AFDIM in tutte le versioni AutoCAD dal 2013 al 2020. Escludere R24.1 lo impedisce in tutte quelle dal 2021 al 2024. Escludere R25.0 o R25.1 lo impedisce sia nel 2025 sia nel 2026. Il programma ignora una serie sconosciuta.

Per utente o per tutti gli utenti

Implicazioni di sicurezza dell’installazione per utente

L’installazione predefinita inserisce la DLL del plugin in %APPDATA%. L’utente connesso può scrivere in questa cartella e AutoCAD carica la DLL nel proprio processo a ogni avvio. Un programma già eseguito con i diritti di quell’utente può sovrascrivere la DLL, per esempio malware o un componente aggiuntivo compromesso. Il suo codice verrà eseguito dentro AutoCAD agli avvii successivi, senza richiesta di conferma né elevazione. Questo vale per ogni plugin AutoCAD installato per utente, perché l’utente deve poter scrivere nella cartella affinché l’installazione funzioni senza diritti di amministratore.

Misure che riducono il rischio:

Misura	Effetto
Installare con /ALLUSERS	La DLL si trova in %ProgramFiles%, dove un utente standard non può scrivere. Per sostituirla servono diritti di amministratore.
Mantenere SECURELOAD al valore predefinito 1	AutoCAD rifiuta assembly .NET fuori dai percorsi attendibili. Non impedisce di sovrascrivere un file attendibile sul posto, ma blocca una nuova DLL collocata altrove.
Controllo delle applicazioni (WDAC o AppLocker)	Può bloccare una DLL modificata. Da 0.1.6 il programma di installazione e AFDIM.dll sono firmati digitalmente (editore TO VAN TIN).
Sorvegliare scritture inattese nella cartella del pacchetto	Nessun processo dovrebbe modificare Contents\<version>\ tranne il programma di installazione o un aggiornamento dall’app (Aggiorna ora nella scheda Informazioni).

Un’officina che vuole conservare la DLL in una posizione modificabile soltanto dagli amministratori dovrebbe installare con /ALLUSERS.

Officine con più postazioni e profili mobili

Usa /ALLUSERS per un’officina con più postazioni. %APPDATA% segue il profilo utente. Con profili mobili o reindirizzamento delle cartelle, un’installazione per utente copia il plugin sulla rete a ogni accesso. Due computer connessi con lo stesso utente possono anche contendersi la cartella.

AFDIM_Setup_<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /ALLUSERS

Esegui il comando da un contesto elevato, per esempio uno script di avvio SCCM, Intune o Criteri di gruppo. Ogni utente del computer avrà AFDIM e i file del plugin non saranno nel profilo mobile. Le impostazioni individuali in %APPDATA%\AFDIM continueranno a seguire il profilo.

Se devi mantenere un’installazione per utente con profili mobili, escludi %APPDATA%\Autodesk\ApplicationPlugins dal reindirizzamento delle cartelle.

Aggiornamenti delle installazioni per tutti gli utenti

Un’installazione per tutti gli utenti, detta anche installazione a livello di macchina, disattiva gli aggiornamenti dall’app perché un utente standard non può scrivere in %ProgramFiles%. Quando AFDIM trova una versione più recente, il gruppo Aggiornamenti della scheda Informazioni mostra il testo seguente al posto di Aggiorna ora:

Questa installazione non può aggiornarsi da sola: è stata installata per tutti gli utenti, gli aggiornamenti sono stati disattivati durante l’installazione oppure la cartella è di sola lettura.

Distribuisci le nuove versioni con lo stesso metodo della prima. Eseguire un programma di installazione più recente sopra quello esistente è una modalità di aggiornamento supportata. Conserva le impostazioni di ogni utente e la licenza di ogni computer. Le modifiche di ciascuna versione sono nelle Note di rilascio.

Un controllo degli aggiornamenti consiste in una richiesta HTTPS al feed firmato su update.afdim.com. Non blocca mai AutoCAD. AFDIM controlla:

• in background all’avvio di AutoCAD: al massimo una volta ogni 24 ore dopo un controllo riuscito e non prima di 2 ore dopo un controllo fallito
• una volta all’apertura delle impostazioni, se non ha ancora controllato durante la sessione AutoCAD corrente
• quando un utente sceglie Controlla ora nella scheda Informazioni

I primi due controlli avvengono soltanto se Controlla automaticamente gli aggiornamenti è selezionato nella scheda Informazioni e la variabile d’ambiente AFDIM_DISABLE_BACKGROUND_SERVICES=1 non è impostata. Questa variabile disattiva anche il file di registro AFDIM e il controllo della licenza in background che recupera un file di licenza o un rinnovo in attesa. Senza il registro, uno ZIP di assistenza non lo contiene.

Licenze sui computer distribuiti

Ogni computer richiede una licenza propria. Attivala nel gruppo Licenza della scheda Informazioni nelle impostazioni. Con una chiave, l’utente sceglie Inserisci chiave di licenza…. In quel momento il computer deve raggiungere api.afdim.com tramite HTTPS. Senza accesso alla rete da AutoCAD, l’utente sceglie invece Richiedi licenza. Il codice di richiesta visualizzato viene inviato tramite la Pagina Licenza. Il file di licenza ricevuto viene caricato con Carica licenza… nello stesso gruppo. Consulta Come funzionano le licenze.

Quando Windows lo consente, AFDIM scrive la licenza caricata anche in %ProgramData%\AFDIM\license. Gli altri account Windows dello stesso computer non devono quindi attivarla di nuovo.

Disinstallazione silenziosa

rem installazione per utente (predefinita)
"%APPDATA%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

rem installazione per tutti gli utenti, da un contesto elevato
"%ProgramFiles%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

Inno Setup registra il comando silenzioso anche nel valore QuietUninstallString della chiave Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. La chiave si trova in HKCU per un’installazione per utente e in HKLM per una per tutti gli utenti.

Il programma di disinstallazione conserva per impostazione predefinita le impostazioni dell’utente, quindi disinstallare e reinstallare può servire come riparazione. Per eliminare anche i dati, aggiungi /PURGEDATA:

"%APPDATA%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /PURGEDATA

/PURGEDATA elimina %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM e %TEMP%\AFDIM dell’account che esegue la disinstallazione. Gli altri account Windows conservano le proprie cartelle. Dentro %LOCALAPPDATA%\AFDIM, la cartella license viene sempre conservata. /PURGEDATA non elimina mai %ProgramData%\AFDIM\license o la chiave di registro HKCU\Software\AFDIM. La cache degli aggiornamenti viene sempre rimossa.

Se AutoCAD è in esecuzione durante la disinstallazione, il programma conserva i file occupati da AutoCAD. Una disinstallazione interattiva mostra una finestra che lo segnala: chiudere tutte le finestre CAD, quindi eseguire di nuovo il programma di disinstallazione. Una disinstallazione silenziosa elenca quei file nel proprio log. Non viene richiesto il riavvio. Vengono conservati anche i file di una cartella il cui percorso è cambiato. Chiudi tutte le finestre CAD e ripeti la disinstallazione o la reinstallazione, oppure controlla i percorsi nel registro prima di eliminare qualcosa a mano. All’accesso successivo non viene eliminato nulla.

Verifica dopo la distribuzione

1. Avvia AutoCAD. Nella barra multifunzione compare la scheda AFDIM con i pulsanti Dimension e Settings. Questi due nomi rimangono in inglese in ogni lingua.
2. Esegui AFDIM. Funziona senza NETLOAD. Su un computer senza licenza apre la finestra Welcome to AFDIM o AFDIM non è attivato. Entrambe dimostrano che il plugin è stato caricato.
3. Controlla che PackageContents.xml esista nella cartella del pacchetto e contenga un blocco Components con SeriesMin e SeriesMax che coprono la versione di AutoCAD installata.
4. Controlla che state.json mostri i valori previsti per activeVersion, channel e installScope.

Se AFDIM risulta un comando sconosciuto, riavvia AutoCAD perché cerca i plugin soltanto all’avvio. Se il problema persiste, controlla le impostazioni SECURELOAD e TRUSTEDPATHS. Poi invia il file /LOG e la versione di AutoCAD all’Assistenza.