部署
本頁適用於在工廠電腦上安裝 AFDIM 的人員。AFDIM 使用一個 Inno Setup 安裝程式 AFDIM_Setup_<version>.exe,可從下載頁面獲取。它會安裝 AutoCAD® Autoloader bundle。無需手動向 AutoCAD 註冊:不需要 NETLOAD 或 COM 註冊。AutoCAD 每次啟動時都會掃描 ApplicationPlugins 資料夾並載入 bundle。
安裝位置
標題為「安裝位置 」的章節| 範圍 | 外掛 bundle | 解除安裝程式 | 需要提升許可權 |
|---|---|---|---|
| 當前使用者(預設) | %APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle | %APPDATA%\AFDIM\uninstall\unins000.exe | 否 |
所有使用者(/ALLUSERS) | %ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle | %ProgramFiles%\AFDIM\uninstall\unins000.exe | 是 |
解除安裝程式特意放在 bundle 資料夾外,因為 AutoCAD 會掃描 bundle 資料夾。為所有使用者安裝時,解除安裝程式位於 %ProgramFiles% 下,標準使用者無法替換它。只使用表中對應安裝方式的解除安裝程式。即使舊訊息指向那裡,也絕不要執行 %ProgramData% 中的解除安裝程式。如果所有使用者安裝的解除安裝程式遺失,請從下載頁面執行官方安裝程式並加上 /ALLUSERS,修復該安裝後再解除安裝。安裝程式會拒絕覆蓋另一種安裝方式的安裝。請在不使用系統管理員權限的情況下執行依使用者安裝的解除安裝程式。
bundle 包含 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 | 安裝 ID 和授權檢查時間記錄 |
%TEMP%\AFDIM | 使用匯出上次執行的幾何資料…生成的幾何資料匯出檔案(設定對話方塊的關於選項卡) |
解除安裝程式始終保留授權資料夾和登錄檔項。請參閱解除安裝。
兩種安裝範圍不能共存
標題為「兩種安裝範圍不能共存 」的章節如果 AFDIM 已按另一種範圍安裝,安裝程式會拒絕執行。AutoCAD 會掃描兩個 ApplicationPlugins 根目錄,因此兩個副本都會載入。AFDIM 命令會註冊兩次,而應用內更新程式只會升級其中一個副本。拒絕訊息會指出必須先執行的確切 unins000.exe。靜默安裝不會顯示訊息:它會停止安裝,並將原因寫入 /LOG 檔案。
支援的 AutoCAD 版本
標題為「支援的 AutoCAD 版本 」的章節所有工作站共用一個 bundle。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。重新啟動 AutoCAD 後,執行中的 AutoCAD 才會載入 AFDIM。
靜默安裝
標題為「靜默安裝 」的章節AFDIM_Setup_<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART安裝嚮導和許可協議為英文。Windows 設定為越南地區時,AFDIM Help 頁面會以越南語開啟;其他情況使用英文。
外掛有自己的介面語言。新安裝預設使用英語;Windows 設定為越南地區(顯示語言、區域格式或國家/地區)時使用越南語。每位使用者都可以透過設定對話方塊標題欄中包含 56 種語言的下拉選單變更語言。點選 AFDIM 功能區選項卡上的 Settings 可開啟設定對話方塊。所選語言會應用於對話方塊、通知視窗和命令列訊息。尚未翻譯的文字會以英文顯示。所選語言儲存在該使用者的設定中。
| 開關 | 作用 |
|---|---|
/VERYSILENT | 不顯示使用者介面。用於指令碼批次部署。 |
/SILENT | 僅顯示進度視窗,不顯示嚮導頁面。 |
/SUPPRESSMSGBOXES | 禁止顯示訊息框。請與 /VERYSILENT 一起使用。 |
/NORESTART | 不自動重啟。安裝程式不需要重啟,但仍請傳入此開關。 |
/LOG="C:\path\afdim.log" | 寫入完整安裝日誌。提交安裝問題支援請求時請附上此日誌。 |
/ALLUSERS | 在 %ProgramFiles% 下為所有使用者安裝。需要提升許可權。此範圍會寫入 state.json 並關閉應用內更新。 |
/CURRENTUSER | 為當前使用者安裝,這是預設值。 |
/NOAUTOUPDATE | 建立 noautoupdate 檔案並關閉此安裝的應用內更新。之後不帶該開關再次執行安裝程式即可重新啟用更新。 |
/EXCLUDESERIES=<series> | 排除覆蓋指定發行系列的構建,因此該系列的 AutoCAD 不會載入 AFDIM。多個系列用逗號分隔。 |
/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 在 2013 至 2020 年的所有 AutoCAD 版本中載入;排除 R24.1 會阻止其在 2021 至 2024 年版本中載入;排除 R25.0 或 R25.1 會阻止其在 2025 和 2026 年版本中載入。安裝程式會忽略它不認識的系列。
按使用者安裝或為所有使用者安裝
標題為「按使用者安裝或為所有使用者安裝 」的章節按使用者安裝的安全權衡
標題為「按使用者安裝的安全權衡 」的章節預設安裝會將外掛 DLL 放在 %APPDATA% 下。已登入使用者可以寫入此資料夾,而 AutoCAD 每次啟動時都會將 DLL 載入到自己的程序中。任何以該使用者身份執行的程式(例如惡意軟體或已被入侵的載入項)都可以直接覆蓋 DLL。之後,它的程式碼就會在 AutoCAD 中執行,無需提示或提升許可權。所有按使用者安裝的 AutoCAD 外掛都有此特性,因為無需管理員許可權的安裝必須允許使用者寫入該資料夾。
以下措施可以降低風險:
| 措施 | 作用 |
|---|---|
使用 /ALLUSERS 安裝 | DLL 位於 %ProgramFiles% 下,標準使用者無法寫入。替換 DLL 需要管理員許可權。 |
將 SECURELOAD 保持為預設值 1 | AutoCAD 會拒絕載入來自可信路徑之外的 .NET 程式集。它無法阻止覆蓋可信路徑中的檔案,但會阻止從其他位置載入新 DLL。 |
| 應用程式控制(WDAC 或 AppLocker) | 可阻止被篡改的 DLL。自 0.1.6 起,安裝程式和 AFDIM.dll 均已進行程式碼簽名(發行者 TO VAN TIN)。 |
| 監視 bundle 資料夾中的意外寫入 | 除安裝程式或應用內更新(關於選項卡上的 立即更新)外,不應有其他內容修改 Contents\<version>\。 |
如果工廠要求 DLL 位於只有管理員可以更改的位置,請使用 /ALLUSERS 安裝。
多工位工廠和漫遊配置檔案
標題為「多工位工廠和漫遊配置檔案 」的章節多工位環境請使用 /ALLUSERS。%APPDATA% 會漫遊。使用漫遊配置檔案或資料夾重定向時,按使用者安裝會在每次登入時透過網路複製外掛。同一使用者在兩臺電腦上登入時,也可能爭用該資料夾。
AFDIM_Setup_<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /ALLUSERS請在提升許可權的環境中執行,例如 SCCM、Intune 或組策略啟動指令碼。這樣,電腦上的每位使用者都能使用 AFDIM,外掛檔案也不會放進漫遊配置檔案。每位使用者在 %APPDATA%\AFDIM 中的設定仍會隨配置檔案漫遊。
如果漫遊配置檔案必須按使用者安裝,請將 %APPDATA%\Autodesk\ApplicationPlugins 從資料夾重定向中排除。
電腦範圍安裝的更新
標題為「電腦範圍安裝的更新 」的章節為所有使用者安裝(也稱為電腦範圍安裝)會關閉應用內更新,因為標準使用者無法寫入 %ProgramFiles%。AFDIM 找到較新版本時,設定對話方塊關於選項卡的 更新 組會顯示以下文字,而不是 立即更新:
此安裝無法自行更新:它是為所有用戶安裝的、安裝時關閉了更新,或其資料夾為只讀。
像首次安裝一樣推送新版本。直接在現有安裝上執行較新的安裝程式是受支援的升級方式。升級會保留每位使用者的設定和每臺電腦的授權。每個版本的變更內容請參閱發行說明頁面。
更新檢查會向 update.afdim.com 上的已簽名更新源傳送一個 HTTPS 請求,不會阻塞 AutoCAD。AFDIM 會在以下情況下檢查:
- AutoCAD 啟動時在後臺檢查:成功後每 24 小時最多一次,失敗後至少間隔 2 小時
- 如果 AFDIM 在當前 AutoCAD 會話中尚未檢查,則在首次開啟設定對話方塊時檢查一次
- 使用者點選關於選項卡上的 立即檢查 時檢查
只有在關於選項卡上勾選自動檢查更新且未設定環境變數 AFDIM_DISABLE_BACKGROUND_SERVICES=1 時,才會執行前兩項檢查。設定此變數還會關閉 AFDIM 日誌檔案和後臺授權檢查(用於獲取待接收的授權檔案或續訂)。沒有日誌檔案時,支援 ZIP 中不含日誌。
已部署電腦上的授權
標題為「已部署電腦上的授權 」的章節每臺電腦都需要自己的授權。請在設定對話方塊關於選項卡的授權組中啟用。使用授權金鑰時,使用者選擇輸入授權金鑰…。此時電腦必須能夠透過 HTTPS 訪問 api.afdim.com。如果 AutoCAD 無法聯網,使用者應改為選擇申請授權。顯示的請求程式碼透過授權頁面傳送。收到的授權檔案在同一組中透過載入授權…載入。請參閱授權工作方式。
Windows 允許時,AFDIM 還會將已載入的授權寫入 %ProgramData%\AFDIM\license。同一電腦上的其他 Windows 帳戶無需再次啟用。
靜默解除安裝
標題為「靜默解除安裝 」的章節rem 按使用者安裝(預設)"%APPDATA%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
rem 為所有使用者安裝;在提升許可權的環境中執行"%ProgramFiles%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTARTInno Setup 也會將靜默命令記錄在登錄檔項 Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1 的 QuietUninstallString 值中。按使用者安裝時,該項位於 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 視窗,然後重試解除安裝或重新安裝,或者在手動刪除任何內容之前先查看記錄檔中的路徑。下次登入時不會刪除任何內容。
部署後檢查
標題為「部署後檢查 」的章節- 啟動 AutoCAD。功能區上會出現 AFDIM 選項卡,含 Dimension 和 Settings 兩個按鈕。這兩個按鈕名稱在所有語言中均為英文。
- 執行
AFDIM。無需使用NETLOAD。沒有授權的電腦上會開啟歡迎使用 AFDIM或 AFDIM 尚未激活視窗。任一視窗都表示外掛已載入。 - 檢查 bundle 資料夾中是否存在
PackageContents.xml,且其中的Components塊的SeriesMin和SeriesMax覆蓋已安裝的 AutoCAD。 - 檢查
state.json中的activeVersion、channel和installScope是否符合預期。
如果 AutoCAD 將 AFDIM 識別為未知命令,請重新啟動一次 AutoCAD,因為它只在啟動時掃描外掛。如果問題仍然存在,請檢查 SECURELOAD 和 TRUSTEDPATHS 策略,然後將 /LOG 檔案和 AutoCAD 版本傳送給支援。