Implementare

Această pagină este pentru persoana care instalează AFDIM pe calculatoarele unui atelier. AFDIM este un singur program de instalare Inno Setup, AFDIM_Setup_<version>.exe, disponibil pe pagina Descărcare. Acesta instalează un pachet AutoCAD® Autoloader. Nu este necesară înregistrarea manuală în AutoCAD: nici NETLOAD, nici înregistrarea COM. La fiecare pornire, AutoCAD scanează directoarele ApplicationPlugins și încarcă pachetul.

Ce se instalează și unde

Domeniu	Pachetul pluginului	Program de dezinstalare	Necesită drepturi de administrator
Per utilizator (implicit)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Nu
Toți utilizatorii (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Da

Programul de dezinstalare se află intenționat în afara directorului pachetului, deoarece AutoCAD scanează acel director. La instalarea pentru toți utilizatorii, programul de dezinstalare rămâne în %ProgramFiles%, unde un utilizator standard nu îl poate înlocui. Folosiți doar programul de dezinstalare al tipului de instalare din tabel. Nu rulați niciodată un program de dezinstalare din %ProgramData%, chiar dacă un mesaj vechi trimite acolo. Dacă lipsește programul de dezinstalare al unei instalări pentru toți utilizatorii, rulați programul de instalare oficial de pe pagina Descărcare cu /ALLUSERS pentru a repara acea instalare, apoi dezinstalați-o. Programul de instalare refuză să instaleze peste o instalare de celălalt tip. Rulați programul de dezinstalare al unei instalări per utilizator fără drepturi de administrator.

Pachetul conține PackageContents.xml (manifestul Autoloader), state.json (versiunea instalată, canalul de actualizare și domeniul instalării) și directorul Contents, cu câte un subdirector pentru fiecare versiune. O instalare cu /NOAUTOUPDATE adaugă fișierul noautoupdate. Programul de instalare adaugă și o comandă rapidă în meniul Start: AFDIM › AFDIM Help.

La rulare, AFDIM scrie datele de mai jos. Fiecare cont Windows are propria copie, cu excepția %ProgramData%\AFDIM\license, partajată de toate conturile.

Locație	Conținut
%APPDATA%\AFDIM	Setările și standardele de cotare salvate
%LOCALAPPDATA%\AFDIM\logs	Jurnalul pentru asistență
%LOCALAPPDATA%\AFDIM\cache	Descărcările actualizărilor
%LOCALAPPDATA%\AFDIM\license	Licența acestui cont Windows
%ProgramData%\AFDIM\license	Licența tuturor conturilor de pe calculator, dacă Windows permite scrierea
HKCU\Software\AFDIM	ID-ul instalării și înregistrarea orei verificării licenței
%TEMP%\AFDIM	Exporturile geometriei create cu Exportă geometria ultimei rulări… (dialogul de setări, fila Despre)

Programul de dezinstalare păstrează întotdeauna directoarele licențelor și cheia de registry. Consultați Dezinstalare.

Cele două domenii nu pot coexista

Programul de instalare refuză să ruleze dacă AFDIM este deja instalat în celălalt domeniu. AutoCAD scanează ambele directoare-rădăcină ApplicationPlugins, deci ambele copii s-ar încărca. Comanda AFDIM s-ar înregistra de două ori, iar actualizatorul din aplicație ar actualiza doar o copie. Mesajul de refuz indică exact fișierul unins000.exe care trebuie rulat mai întâi. Instalarea silențioasă nu afișează un mesaj: se oprește fără instalare și scrie motivul în fișierul /LOG.

Versiuni AutoCAD acceptate

Un singur pachet deservește toate stațiile. PackageContents.xml direcționează fiecare serie AutoCAD către versiunea corespunzătoare a pluginului.

Versiune	Seria versiunilor	Anii AutoCAD	Stare
net472	R19.0–R23.1	2013–2020	Livrată; 2014 și 2016–2018 experimentale
net48	R24.0–R24.3	2021, 2022, 2023, 2024	Livrată
net8.0-windows	R25.0–R25.1	2025, 2026	Livrată
net10.0-windows	R26.0	2027	Livrată, experimentală

O versiune AutoCAD instalată ulterior în cadrul unei serii acceptate încarcă AFDIM fără reinstalare. AutoCAD Mechanical din aceiași ani încarcă aceeași versiune. AutoCAD LT nu este acceptat, deoarece nu are API-ul .NET. Pagina Detected AutoCAD din expert oferă doar informații. Nu are câte o casetă pentru fiecare versiune.

Instalarea în timp ce AutoCAD rulează

Această situație este acceptată. Fiecare versiune se instalează în propriul subdirector, astfel încât un AutoCAD în execuție nu blochează fișierele scrise de programul de instalare. Acesta afișează o notă și continuă. Nu este necesar să închideți mai întâi AutoCAD. O sesiune AutoCAD în curs va încărca AFDIM la următoarea pornire.

Instalare silențioasă

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

Expertul de instalare și acordul său de licență sunt în engleză. Pagina AFDIM Help se deschide în vietnameză pe Windows configurat pentru Vietnam și în engleză în celelalte cazuri.

Pluginul are propria limbă de interfață. O instalare nouă pornește în engleză sau în vietnameză când Windows este configurat pentru Vietnam (limba de afișare, formatul regional sau țara). Fiecare utilizator poate schimba limba din lista derulantă cu 56 de limbi din antetul dialogului de setări. Deschideți dialogul cu butonul Settings din fila de ribbon AFDIM. Limba se aplică dialogului, ferestrelor de notificare și mesajelor din linia de comandă. Textul încă netradus apare în engleză. Alegerea se salvează în setările acelui utilizator.

Opțiune	Efect
/VERYSILENT	Fără interfață. Folosiți-o pentru o instalare distribuită prin script.
/SILENT	Doar fereastra de progres, fără paginile expertului.
/SUPPRESSMSGBOXES	Suprimă casetele de mesaj. Folosiți-o împreună cu /VERYSILENT.
/NORESTART	Nu repornește niciodată. Programul de instalare nu are nevoie de repornire; transmiteți totuși opțiunea.
/LOG="C:\path\afdim.log"	Scrie un jurnal complet al instalării. Atașați-l solicitărilor de asistență privind instalarea.
/ALLUSERS	Instalează pentru toți utilizatorii în %ProgramFiles%. Necesită drepturi de administrator. Înregistrează domeniul calculatorului în state.json, dezactivând actualizările din aplicație.
/CURRENTUSER	Instalează pentru utilizatorul curent. Aceasta este opțiunea implicită.
/NOAUTOUPDATE	Dezactivează actualizările din aplicație prin adăugarea fișierului noautoupdate. O nouă rulare fără această opțiune reactivează actualizările.
/EXCLUDESERIES=<series>	Omite versiunea care acoperă seria respectivă, astfel încât AutoCAD din acea serie să nu încarce AFDIM. Separați mai multe serii cu virgule.
/NOICONS	Nu creează comanda rapidă din meniul Start.
/DIR="C:\path"	Înlocuiește directorul de instalare. Rareori este corect, deoarece AutoCAD scanează doar locațiile standard ApplicationPlugins.

/EXCLUDESERIES primește o serie de versiuni, nu un an: 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. Opțiunea elimină întreaga versiune care acoperă seria. Excluderea R23.0 împiedică încărcarea AFDIM în toate versiunile AutoCAD din 2013–2020. Excluderea R24.1 îl oprește în toate versiunile din 2021–2024. Excluderea R25.0 sau R25.1 îl oprește în versiunile 2025 și 2026. Programul de instalare ignoră seriile necunoscute.

Pentru un utilizator sau pentru toți utilizatorii

Compromisul de securitate al instalării pentru un utilizator

Instalarea implicită pune DLL-ul pluginului sub %APPDATA%. Utilizatorul conectat poate scrie în acest director, iar AutoCAD încarcă DLL-ul în propriul proces la fiecare pornire. Orice program care rulează deja cu drepturile acelui utilizator poate suprascrie DLL-ul, de exemplu un program malware sau un add-in compromis. Codul său rulează apoi în AutoCAD fără solicitare și fără drepturi de administrator. Acest lucru este valabil pentru toate pluginurile AutoCAD instalate per utilizator, deoarece utilizatorul trebuie să poată scrie în director pentru ca instalarea fără drepturi de administrator să funcționeze.

Măsuri de reducere a riscului:

Măsură	Efect
Instalați cu /ALLUSERS	DLL-ul se află în %ProgramFiles%, unde un utilizator standard nu poate scrie. Înlocuirea sa necesită drepturi de administrator.
Păstrați valoarea implicită 1 pentru SECURELOAD	AutoCAD refuză asamblările .NET din afara căilor de încredere. Nu împiedică suprascrierea unui fișier de încredere, dar împiedică adăugarea unui DLL nou în altă locație.
Controlul aplicațiilor (WDAC sau AppLocker)	Poate bloca o bibliotecă DLL modificată. Începând cu 0.1.6, programul de instalare și AFDIM.dll sunt semnate cu cod (editor TO VAN TIN).
Monitorizați scrierile neașteptate în directorul pachetului	Numai programul de instalare sau o actualizare din aplicație (Actualizează acum din fila Despre) ar trebui să modifice Contents\<version>\.

Un atelier care dorește DLL-ul într-o locație modificabilă doar de administratori trebuie să instaleze cu /ALLUSERS.

Ateliere cu mai multe stații și profiluri mobile

Folosiți /ALLUSERS într-un atelier cu mai multe stații. %APPDATA% este mobil. Cu profiluri mobile sau redirecționarea directoarelor, instalarea per utilizator copiază pluginul prin rețea la fiecare conectare. Două calculatoare conectate cu același utilizator pot, de asemenea, să concureze pentru același director.

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

Rulați instalarea dintr-un context cu drepturi de administrator, de exemplu dintr-un script de pornire SCCM, Intune sau Group Policy. Fiecare utilizator al calculatorului va avea AFDIM, iar fișierele pluginului nu vor fi în profilul mobil. Setările fiecărui utilizator din %APPDATA%\AFDIM urmează totuși profilul.

Dacă trebuie să păstrați instalarea per utilizator cu profiluri mobile, excludeți %APPDATA%\Autodesk\ApplicationPlugins de la redirecționarea directoarelor.

Actualizări în instalările la nivel de calculator

Instalarea pentru toți utilizatorii, numită și instalare la nivel de calculator, dezactivează actualizările din aplicație, deoarece un utilizator standard nu poate scrie în %ProgramFiles%. Când AFDIM găsește o versiune mai nouă, grupul Updates din fila Despre a dialogului de setări afișează textul de mai jos în locul opțiunii Actualizează acum:

Această instalare nu se poate actualiza singură: a fost instalată pentru toți utilizatorii, actualizările au fost dezactivate la instalare sau folderul este doar pentru citire.

Distribuiți versiunile noi la fel ca prima instalare. Suprascrierea unei instalări existente cu un program de instalare mai nou este o actualizare acceptată. Setările fiecărui utilizator și licența fiecărui calculator se păstrează. Modificările din fiecare versiune sunt descrise pe pagina Note de lansare.

Verificarea actualizărilor este o singură cerere HTTPS către fluxul de actualizare semnat de la update.afdim.com. Nu blochează niciodată AutoCAD. AFDIM verifică:

• în fundal, la pornirea AutoCAD: cel mult o dată la 24 de ore după o verificare reușită și nu mai devreme de 2 ore după una eșuată
• o dată la deschiderea dialogului de setări, dacă AFDIM nu a verificat deja în sesiunea AutoCAD curentă
• când utilizatorul alege Verifică acum din fila Despre

Primele două verificări au loc numai când opțiunea Verifică automat actualizările este bifată în fila Despre și variabila de mediu AFDIM_DISABLE_BACKGROUND_SERVICES=1 nu este setată. Setarea acestei variabile dezactivează și jurnalul AFDIM, precum și verificarea de fundal a licențelor care preia o licență în așteptare sau o reînnoire. Fără jurnal, arhiva de asistență nu conține niciun log.

Licențe pe calculatoarele instalate

Fiecare calculator are nevoie de propria licență. Activați-o din grupul Licence din fila Despre a dialogului de setări. Cu o cheie de licență, utilizatorul alege Introdu cheia de licență…. În acel moment, calculatorul trebuie să poată accesa api.afdim.com prin HTTPS. Fără acces la rețea din AutoCAD, utilizatorul alege Solicită licență. Codul de solicitare afișat se trimite prin pagina de licență. Fișierul de licență primit se încarcă folosind Încarcă licența… din același grup. Consultați Cum funcționează licențierea.

Când Windows permite acest lucru, AFDIM scrie licența încărcată și în %ProgramData%\AFDIM\license. Astfel, celelalte conturi Windows de pe același calculator nu trebuie să se activeze din nou.

Dezinstalare silențioasă

rem per-user install (default)
"%APPDATA%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

rem all-users install, from an elevated context
"%ProgramFiles%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

Inno Setup înregistrează și comanda silențioasă în valoarea QuietUninstallString a cheii de registry Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. Cheia se află în HKCU pentru instalarea per utilizator și în HKLM pentru instalarea pentru toți utilizatorii.

Programul de dezinstalare păstrează implicit setările utilizatorului, astfel încât dezinstalarea și reinstalarea pot repara instalarea. Pentru a șterge și datele, adăugați /PURGEDATA:

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

/PURGEDATA șterge %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM și %TEMP%\AFDIM pentru contul care rulează programul de dezinstalare. Celelalte conturi Windows își păstrează directoarele. În %LOCALAPPDATA%\AFDIM, directorul license se păstrează întotdeauna. /PURGEDATA nu șterge niciodată %ProgramData%\AFDIM\license sau cheia de registry HKCU\Software\AFDIM. Cache-ul actualizărilor este întotdeauna eliminat.

Dacă AutoCAD rulează în timpul dezinstalării, programul de dezinstalare păstrează fișierele pe care le blochează AutoCAD. O dezinstalare interactivă afișează o fereastră care spune acest lucru: închideți toate ferestrele CAD, apoi rulați din nou programul de dezinstalare. O dezinstalare silențioasă listează aceste fișiere în jurnal. Nu se solicită repornirea. Se păstrează și fișierele dintr-un folder a cărui cale s-a schimbat. Închideți toate ferestrele CAD și reîncercați dezinstalarea sau reinstalarea ori verificați căile din jurnal înainte să ștergeți ceva manual. La următoarea conectare nu se șterge nimic.

Verificare după implementare

1. Porniți AutoCAD. În fila de ribbon AFDIM apar două butoane, Dimension și Settings. Aceste două nume sunt în engleză în toate limbile.
2. Rulați AFDIM. Comanda funcționează fără NETLOAD. Pe un calculator fără licență se deschide fereastra Welcome to AFDIM sau AFDIM nu este activat. Oricare dintre ele confirmă că pluginul s-a încărcat.
3. Verificați că PackageContents.xml există în directorul pachetului și conține un bloc Components ale cărui SeriesMin și SeriesMax acoperă versiunea AutoCAD instalată.
4. Verificați că state.json indică valorile așteptate pentru activeVersion, channel și installScope.

Dacă AFDIM este o comandă necunoscută, reporniți AutoCAD o dată, deoarece AutoCAD scanează pluginurile doar la pornire. Dacă problema persistă, verificați politicile SECURELOAD și TRUSTEDPATHS. Apoi trimiteți fișierul /LOG și versiunea AutoCAD către Asistență.