Развёртывание

Эта страница предназначена для специалиста, который устанавливает 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. Кроме того, установщик создаёт ярлык в меню «Пуск»: 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	Идентификатор установки и время проверки лицензии
%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 не поддерживается, потому что в нём нет API .NET. Страница мастера Detected AutoCAD содержит только справочную информацию. Отдельных флажков для версий нет.

Установка при запущенном 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>	Не устанавливать сборку для указанной серии выпусков, поэтому AFDIM не будет загружаться в версиях AutoCAD этой серии. Несколько серий разделяйте запятыми.
/NOICONS	Не создавать ярлык в меню «Пуск».
/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 в месте, которое может изменять только администратор, установите AFDIM с параметром /ALLUSERS.

Несколько рабочих мест и перемещаемые профили

Для организации с несколькими рабочими местами используйте /ALLUSERS. Содержимое %APPDATA% перемещается вместе с профилем. При перемещаемых профилях или перенаправлении папок установка для одного пользователя передаёт файлы плагина по сети при каждом входе. Кроме того, два компьютера, на которых один пользователь вошёл в систему, могут одновременно использовать эту папку.

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

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

Если требуется установка для одного пользователя с перемещаемыми профилями, исключите %APPDATA%\Autodesk\ApplicationPlugins из перенаправления папок.

Обновления при установке для всего компьютера

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

Эта установка не может обновить себя: она установлена для всех пользователей, обновления были отключены при установке или её папка доступна только для чтения.

Распространяйте новые версии так же, как первоначальную. Установка поверх существующей поддерживается. Настройки каждого пользователя и лицензия каждого компьютера сохраняются. Список изменений каждой версии доступен на странице История версий.

Проверка обновлений выполняет один HTTPS-запрос для получения подписанного списка с update.afdim.com. Она никогда не блокирует AutoCAD. AFDIM проверяет:

• в фоновом режиме при запуске AutoCAD: не чаще одного раза в 24 часа после успешной проверки и не раньше чем через 2 часа после неудачной;
• один раз при открытии окна настроек, если в этом сеансе AutoCAD проверка ещё не выполнялась;
• когда пользователь нажимает Проверить сейчас на вкладке О программе.

Первые две проверки выполняются, только если на вкладке О программе установлен флажок Автоматически проверять наличие обновлений, а переменная среды AFDIM_DISABLE_BACKGROUND_SERVICES=1 не задана. Эта переменная также отключает журнал AFDIM и фоновую проверку лицензий, которая загружает ожидающий файл лицензии или продление. Если журнал не ведётся, в архиве поддержки журнала не будет.

Лицензии на компьютерах организации

Для каждого компьютера нужна отдельная лицензия. Активируйте её в группе Лицензия на вкладке О программе окна настроек. Для ключа лицензии пользователь нажимает Ввести ключ лицензии…. В этот момент компьютер должен иметь доступ к api.afdim.com через HTTPS. Если 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 сохраняются. В %LOCALAPPDATA%\AFDIM папка license сохраняется всегда. /PURGEDATA никогда не удаляет %ProgramData%\AFDIM\license или ключ реестра HKCU\Software\AFDIM. Кэш обновлений удаляется в любом случае.

Если во время удаления AutoCAD работает, средство удаления сохраняет файлы, которые занимает AutoCAD. При интерактивном удалении появляется окно с таким сообщением: закройте все окна CAD и запустите средство удаления снова. При тихом удалении эти файлы перечисляются в журнале. Перезагрузка не требуется. Файлы в папке, путь к которой изменился, тоже остаются. Закройте все окна CAD и повторите удаление или переустановку либо просмотрите пути в журнале, прежде чем что-либо удалять вручную. При следующем входе ничего не удаляется.

Проверка после установки

1. Запустите AutoCAD. На вкладке ленты AFDIM появятся две кнопки: Dimension и Settings. В этих названиях кнопок всегда используется английский язык.
2. Запустите AFDIM. Команда работает без NETLOAD. На компьютере без лицензии появится окно Добро пожаловать в AFDIM или AFDIM не активирован. Оба окна подтверждают, что плагин загружен.
3. Убедитесь, что в папке пакета есть PackageContents.xml и его блок Components содержит SeriesMin и SeriesMax, подходящие для установленной версии AutoCAD.
4. Убедитесь, что в state.json указаны ожидаемые значения activeVersion, channel и installScope.

Если AutoCAD не знает команду AFDIM, один раз перезапустите его: он ищет плагины только при запуске. Если это не помогло, проверьте политику для SECURELOAD и TRUSTEDPATHS. Затем отправьте файл /LOG и версию AutoCAD в службу поддержки.