Розгортання

Ця сторінка призначена для фахівця, який встановлює AFDIM на комп’ютери в майстерні. AFDIM постачається одним інсталятором Inno Setup — AFDIM_Setup_<version>.exe зі сторінки Завантаження. Він установлює пакет AutoCAD® Autoloader. Не потрібно вручну реєструвати його в AutoCAD: ні через NETLOAD, ні реєстрацією COM. Під час кожного запуску AutoCAD сканує папки ApplicationPlugins і завантажує пакет.

Що й де встановлюється

Обсяг	Пакет плагіна	Деінсталятор	Потрібні підвищені права
Для одного користувача (за замовчуванням)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Ні
Для всіх користувачів (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Так

Деінсталятор навмисно розташовано за межами папки пакета, яку сканує AutoCAD. Для інсталяції всіх користувачів він міститься під %ProgramFiles%, щоб звичайний користувач не міг його замінити. Використовуйте лише деінсталятор того типу інсталяції, що вказаний у таблиці. Ніколи не запускайте деінсталятор із %ProgramData%, навіть якщо туди вказує старе повідомлення. Якщо деінсталятора інсталяції для всіх користувачів немає, запустіть офіційний інсталятор зі сторінки Завантаження з /ALLUSERS, щоб відновити цю інсталяцію, а потім видаліть її. Інсталятор відмовляється встановлювати поверх інсталяції іншого типу. Деінсталятор інсталяції для одного користувача запускайте без прав адміністратора.

Пакет містить PackageContents.xml (маніфест Autoloader), state.json (встановлена версія, канал оновлення й обсяг інсталяції) та папку Contents з окремою підпапкою для кожної версії. Під час інсталяції з /NOAUTOUPDATE додається файл noautoupdate. Інсталятор також додає ярлик меню Start: AFDIM › AFDIM Help.

Під час роботи AFDIM створює такі файли. Кожен обліковий запис Windows має власну копію, окрім %ProgramData%\AFDIM\license, спільної для всіх облікових записів.

Розташування	Вміст
%APPDATA%\AFDIM	Налаштування та збережені стандарти креслення
%LOCALAPPDATA%\AFDIM\logs	Журнал підтримки
%LOCALAPPDATA%\AFDIM\cache	Завантаження оновлень
%LOCALAPPDATA%\AFDIM\license	Ліцензія цього облікового запису Windows
%ProgramData%\AFDIM\license	Ліцензія для всіх облікових записів комп’ютера, якщо Windows дозволяє запис
HKCU\Software\AFDIM	ID інсталяції та часова позначка перевірки ліцензії
%TEMP%\AFDIM	Експорт геометрії через Експортувати геометрію останнього запуску… (діалогове вікно налаштувань, вкладка Про програму)

Під час видалення папки з ліцензіями та ключ реєстру завжди зберігаються. Див. Видалення.

Два обсяги не можуть співіснувати

Інсталятор відмовляється запускатися, якщо AFDIM уже встановлено в іншому обсязі. AutoCAD сканує обидва корені ApplicationPlugins, тому завантажилися б обидві копії. Команда AFDIM зареєструвалася б двічі, а вбудований засіб оновлення оновив би лише одну копію. У повідомленні про відмову наведено точний шлях до unins000.exe, який потрібно запустити спочатку. За тихого встановлення повідомлення не показується: інсталяція припиняється, а причину записано у файл /LOG.

Версії AutoCAD, які підтримуються

Один пакет підходить для всіх робочих місць. PackageContents.xml призначає кожній серії AutoCAD відповідну збірку.

Збірка	Серія випуску	Роки AutoCAD	Стан
net472	R19.0–R23.1	2013–2020	Випущено; версії 2014 і 2016–2018 експериментальні
net48	R24.0–R24.3	2021, 2022, 2023, 2024	Випущено
net8.0-windows	R25.0–R25.1	2025, 2026	Випущено
net10.0-windows	R26.0	2027	Випущено, експериментальна

Пізніше встановлена версія AutoCAD із підтримуваної серії завантажить AFDIM без повторної інсталяції. AutoCAD Mechanical тих самих років використовує ту саму збірку. AutoCAD LT не підтримується, оскільки не має .NET API. Сторінка майстра Detected AutoCAD лише надає інформацію. Для окремих версій немає прапорців вибору.

Інсталяція під час роботи AutoCAD

Це підтримується. Кожна версія встановлюється в окрему підпапку, тому запущений AutoCAD не блокує файли, які записує інсталятор. Інсталятор показує примітку й продовжує роботу. Спершу закривати AutoCAD не потрібно. Запущений AutoCAD завантажить AFDIM під час наступного запуску.

Тихе встановлення

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

Майстер інсталяції та ліцензійна угода англійською. Сторінка AFDIM Help відкривається в’єтнамською, якщо Windows налаштовано для В’єтнаму, та англійською в інших випадках.

Плагін має власну мову інтерфейсу. Нова інсталяція запускається англійською або в’єтнамською, якщо Windows налаштовано для В’єтнаму (мова інтерфейсу, регіональний формат або країна). Кожен користувач може вибрати одну з 56 мов у списку в заголовку діалогового вікна налаштувань. Вікно відкривається кнопкою Settings на стрічці AFDIM. Вибір мови застосовується до діалогового вікна, повідомлень-вікон і тексту командного рядка. Неперекладені рядки відображаються англійською. Вибір зберігається в налаштуваннях користувача.

Параметр	Дія
/VERYSILENT	Без інтерфейсу користувача. Використовуйте для сценарію автоматичного розгортання.
/SILENT	Показує лише індикатор перебігу, без сторінок майстра.
/SUPPRESSMSGBOXES	Приховує вікна повідомлень. Використовуйте разом із /VERYSILENT.
/NORESTART	Не перезапускає комп’ютер. Інсталятор не потребує перезапуску, однак передавайте цей параметр.
/LOG="C:\path\afdim.log"	Записує повний журнал інсталяції. Додайте його до звернення в підтримку щодо інсталяції.
/ALLUSERS	Установлює програму для всіх користувачів у %ProgramFiles%. Потрібні підвищені права. Обсяг комп’ютера записується в state.json і вимикає оновлення в застосунку.
/CURRENTUSER	Установлює для поточного користувача. Це значення за замовчуванням.
/NOAUTOUPDATE	Вимикає оновлення в застосунку для цієї інсталяції, додаючи файл noautoupdate. Якщо повторно запустити інсталятор без цього параметра, оновлення знову ввімкнуться.
/EXCLUDESERIES=<series>	Пропускає збірку для відповідної серії випуску, тож версії AutoCAD цієї серії не завантажуватимуть AFDIM. Кілька серій розділяйте комами.
/NOICONS	Не створює ярлик у меню Start.
/DIR="C:\path"	Вказує іншу папку інсталяції. Це рідко правильно, оскільки AutoCAD сканує лише стандартні розташування ApplicationPlugins.

/EXCLUDESERIES приймає серію випуску, а не рік: 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. Параметр пропускає всю збірку, що охоплює серію. Виключення R23.0 зупиняє AFDIM у всіх AutoCAD 2013–2020. Виключення R24.1 зупиняє її у всіх AutoCAD 2021–2024. Виключення R25.0 або R25.1 зупиняє її в обох версіях 2025 і 2026. Невідому серію інсталятор ігнорує.

Для одного чи всіх користувачів

Компроміс безпеки інсталяції для одного користувача

За замовчуванням DLL плагіна встановлюється в %APPDATA%. Користувач, який увійшов до системи, може записувати в цю папку, а AutoCAD під час кожного запуску завантажує DLL у власний процес. Будь-яка програма, що вже працює від імені користувача, наприклад зловмисне програмне забезпечення чи скомпрометоване доповнення, може замінити DLL на місці. Після цього її код виконуватиметься в AutoCAD без запиту й без підвищення прав. Це стосується будь-яких плагінів AutoCAD, установлених для одного користувача: користувач повинен мати право запису в папку, інакше встановлення без прав адміністратора неможливе.

Що знижує ризик:

Захід	Ефект
Установлення з /ALLUSERS	DLL міститься в %ProgramFiles%, куди звичайний користувач не має права запису. Для її заміни потрібні права адміністратора.
Залишити стандартне значення SECURELOAD — 1	AutoCAD відхиляє .NET-збірки поза довіреними шляхами. Це не запобігає заміні довіреного файла на місці, але блокує нову DLL, розміщену деінде.
Контроль програм (WDAC або AppLocker)	Може блокувати змінену DLL. Починаючи з 0.1.6 інсталятор і AFDIM.dll підписані цифровим підписом (видавець TO VAN TIN).
Контроль неочікуваних записів у папці пакета	У Contents\<version>\ файли мають змінюватися лише інсталятором або оновленням у застосунку (Оновити зараз на вкладці Про програму).

Якщо майстерні потрібно зберігати DLL у місці, яке можуть змінювати лише адміністратори, установлюйте з /ALLUSERS.

Багатоверстатні майстерні та роумінг-профілі

Для майстерні з кількома робочими місцями використовуйте /ALLUSERS. %APPDATA% переміщується разом із профілем. За роумінг-профілів чи перенаправлення папок інсталяція для одного користувача копіює плагін мережею під час кожного входу. Два комп’ютери, на яких одночасно ввійшов той самий користувач, також можуть конфліктувати через цю папку.

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

Запускайте команду з підвищеними правами, наприклад зі сценарію запуску SCCM, Intune або Group Policy. Тоді AFDIM буде доступна всім користувачам комп’ютера, а файли плагіна не зберігатимуться в роумінг-профілі. Налаштування кожного користувача в %APPDATA%\AFDIM і далі переміщуються разом із профілем.

Якщо на роумінг-профілях обов’язково потрібна інсталяція для одного користувача, виключіть %APPDATA%\Autodesk\ApplicationPlugins із перенаправлення папок.

Оновлення інсталяцій для всієї машини

Інсталяція для всіх користувачів (також звана інсталяцією для всієї машини) вимикає оновлення в застосунку, оскільки звичайний користувач не може записувати в %ProgramFiles%. Коли AFDIM знаходить новішу версію, у групі Updates вкладки Про програму діалогового вікна налаштувань замість Оновити зараз відображається:

Ця інсталяція не може оновити себе: її встановлено для всіх користувачів, під час інсталяції вимкнено оновлення або папка доступна лише для читання.

Нові версії розгортайте так само, як першу. Запуск новішого інсталятора поверх поточної інсталяції є підтримуваним оновленням. Налаштування користувачів і ліцензія комп’ютера зберігаються. Зміни кожної версії наведено на сторінці Примітки до випусків.

Перевірка оновлень — це один HTTPS-запит до підписаного каналу на update.afdim.com. Вона ніколи не блокує AutoCAD. AFDIM перевіряє:

• у фоновому режимі під час запуску AutoCAD: не частіше ніж раз на 24 години після успішної перевірки й не раніше ніж через 2 години після невдалої;
• один раз під час відкриття діалогового вікна налаштувань, якщо AFDIM ще не перевіряла оновлення в цьому сеансі AutoCAD;
• коли користувач натискає Перевірити зараз на вкладці Про програму.

Перші дві перевірки виконуються лише тоді, коли на вкладці Про програму позначено Автоматично перевіряти наявність оновлень, а змінну середовища AFDIM_DISABLE_BACKGROUND_SERVICES=1 не задано. Ця змінна також вимикає файл журналу AFDIM і фонову перевірку ліцензії, що отримує файл ліцензії чи поновлення, які очікують на видачу. Без файла журналу ZIP підтримки не містить журналу.

Ліцензії на розгорнутих комп’ютерах

Для кожного комп’ютера потрібна окрема ліцензія. Активуйте її в групі Licence на вкладці Про програму діалогового вікна налаштувань. Якщо є ліцензійний ключ, користувач натискає Ввести ключ ліцензії…. У цей момент комп’ютеру потрібен HTTPS-доступ до api.afdim.com. Якщо AutoCAD не має доступу до мережі, користувач натискає Запросити ліцензію. Код запиту можна надіслати через сторінку ліцензій. Отриманий файл завантажте кнопкою Завантажити ліцензію… у тій самій групі. Див. Як працює ліцензування.

Якщо Windows дозволяє, AFDIM також записує завантажену ліцензію в %ProgramData%\AFDIM\license. Іншим обліковим записам Windows на цьому комп’ютері тоді не потрібно активувати її повторно.

Тихе видалення

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 також записує тиху команду в значення QuietUninstallString ключа реєстру Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. Для інсталяції одного користувача ключ міститься в HKCU, а для всіх користувачів — у HKLM.

За замовчуванням деінсталятор зберігає налаштування користувача, тому видалення та повторне встановлення можна використовувати для відновлення. Щоб видалити також дані, додайте /PURGEDATA:

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

/PURGEDATA видаляє %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM і %TEMP%\AFDIM облікового запису, з якого запущено деінсталятор. Папки інших користувачів Windows залишаються. Папка license у %LOCALAPPDATA%\AFDIM завжди зберігається. /PURGEDATA ніколи не видаляє %ProgramData%\AFDIM\license або ключ реєстру HKCU\Software\AFDIM. Кеш оновлень видаляється завжди.

Якщо AutoCAD відкритий під час видалення, деінсталятор залишає файли, які утримує AutoCAD. Інтерактивне видалення показує вікно з таким повідомленням: закрийте всі вікна CAD і знову запустіть деінсталятор. Тихе видалення записує ці файли в журнал. Перезапуск не потрібен. Файли в папці, шлях до якої змінився, теж залишаються. Закрийте всі вікна CAD і повторіть видалення або перевстановлення чи перегляньте шляхи в журналі, перш ніж щось видаляти вручну. Під час наступного входу нічого не видаляється.

Перевірка після розгортання

1. Запустіть AutoCAD. На стрічці має з’явитися вкладка AFDIM із двома кнопками — Dimension і Settings. Їхні назви завжди англійською.
2. Запустіть AFDIM. Команда працює без NETLOAD. На комп’ютері без ліцензії відкриється вікно Welcome to AFDIM або AFDIM не активовано. Обидва підтверджують завантаження плагіна.
3. Переконайтеся, що в папці пакета є PackageContents.xml із блоком Components, де SeriesMin і SeriesMax охоплюють інстальовану версію AutoCAD.
4. Перевірте, що state.json містить очікувані activeVersion, channel та installScope.

Якщо AFDIM — невідома команда, перезапустіть AutoCAD: він шукає плагіни лише під час запуску. Якщо це не допоможе, перевірте правила SECURELOAD і TRUSTEDPATHS. Потім надішліть файл /LOG і версію AutoCAD до Підтримки.