פריסה

דף זה מיועד למי שמתקין את 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. המתקין מוסיף גם קיצור דרך בתפריט התחלה, 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	ייצואי גאומטריה שנוצרו באמצעות Export the last run’s geometry… (חלון הגדרות, כרטיסיית About)

תוכנית ההסרה תמיד משאירה את תיקיות הרישיון ואת מפתח הרישום. ראו הסרה.

אי אפשר להתקין את שני ההיקפים יחד

המתקין מסרב לפעול כאשר 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 שפועל יטען את 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	אינו יוצר קיצור דרך בתפריט התחלה.
/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 לתהליך שלו בכל הפעלה. כל תוכנית שכבר פועלת בשם המשתמש הזה יכולה לדרוס את הקובץ, למשל תוכנה זדונית או תוסף שנפרץ. הקוד שלה יפעל מעתה בתוך AutoCAD ללא הודעה וללא הרשאות מוגברות. הדבר נכון לכל תוסף AutoCAD שמותקן למשתמש יחיד, מפני שהמשתמש חייב להיות מסוגל לכתוב לתיקייה כדי שהתקנה ללא הרשאות מנהל תפעל.

האמצעים הבאים מצמצמים את הסיכון:

אמצעי	השפעה
התקנה עם /ALLUSERS	קובץ ה-DLL נשמר תחת %ProgramFiles%, שמשתמש רגיל אינו יכול לכתוב אליו. החלפתו דורשת הרשאות מנהל.
השארת SECURELOAD בערך ברירת המחדל 1	AutoCAD מסרב לטעון מכלולי ‎.NET ממיקומים שאינם מהימנים. הוא אינו מונע דריסה של קובץ מהימן במקומו, אך מונע טעינת DLL חדש שהונח במקום אחר.
בקרת יישומים (WDAC או AppLocker)	יכולה לחסום DLL ששונה. מגרסה 0.1.6 המתקין ו-AFDIM.dll חתומים דיגיטלית (המפרסם TO VAN TIN).
מעקב אחר כתיבות חריגות בתיקיית החבילה	שום דבר אינו אמור לשנות את Contents\<version>\, למעט המתקין או עדכון בתוך התוכנה (לחצן עדכון כעת בכרטיסיית About).

סדנה שרוצה לשמור את קובץ ה-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 בכרטיסייה About בחלון ההגדרות מציגה את הטקסט הבא במקום עדכון כעת:

התקנה זו אינה יכולה לעדכן את עצמה: היא הותקנה לכל המשתמשים, העדכונים כובו בזמן ההתקנה או שהתיקייה שלה מוגנת לכתיבה.

הפיצו גרסאות חדשות באותה דרך כמו הגרסה הראשונה. הפעלת מתקין חדש מעל התקנה קיימת היא שדרוג נתמך. היא שומרת את ההגדרות של כל משתמש ואת הרישיון של כל מחשב. השינויים בכל גרסה מופיעים בדף הערות גרסה.

בדיקת עדכון היא בקשת HTTPS אחת לערוץ העדכונים החתום ב-update.afdim.com. היא לעולם אינה חוסמת את AutoCAD. AFDIM בודק:

• ברקע בעת הפעלת AutoCAD: לכל היותר פעם ב-24 שעות לאחר בדיקה מוצלחת, ולא לפני שעתיים לאחר בדיקה שנכשלה
• פעם אחת בעת פתיחת חלון ההגדרות, אם AFDIM עדיין לא בדק במהלך הפעלת AutoCAD הנוכחית
• כאשר משתמש בוחר בדיקה כעת בכרטיסייה About

שתי הבדיקות הראשונות מתקיימות רק כאשר בדיקה אוטומטית של עדכונים מסומן בכרטיסייה About וכאשר משתנה הסביבה AFDIM_DISABLE_BACKGROUND_SERVICES=1 אינו מוגדר. הגדרת המשתנה הזה מכבה גם את קובץ היומן של AFDIM ואת בדיקת הרישיון ברקע, שמקבלת קובץ רישיון או חידוש ממתינים. ללא קובץ היומן, חבילת התמיכה אינה כוללת יומן.

רישיונות במחשבים שנפרסו

כל מחשב זקוק לרישיון משלו. הפעילו אותו בקבוצת Licence בכרטיסייה About בחלון ההגדרות. עם מפתח רישיון, המשתמש בוחר הזנת מפתח רישיון…. באותו זמן המחשב צריך להגיע אל api.afdim.com באמצעות HTTPS. אם אין חיבור רשת מ-AutoCAD, המשתמש בוחר Request licence. קוד הבקשה מוצג ונשלח באמצעות דף הרישיון. טוענים את קובץ הרישיון שמתקבל באמצעות טעינת רישיון… באותה קבוצה. ראו איך הרישיונות פועלים.

כאשר 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. במחשב ללא רישיון, נפתח החלון Welcome to AFDIM או AFDIM לא הופעל. כל אחד מהם מאשר שהתוסף נטען.
3. בדקו שקובץ PackageContents.xml קיים בתיקיית החבילה ושיש בו בלוק Components שערכי SeriesMin ו-SeriesMax שלו כוללים את גרסת AutoCAD המותקנת.
4. בדקו ש-state.json מציג את activeVersion, את channel ואת installScope הצפויים.

אם AutoCAD אינו מזהה את AFDIM כפקודה, הפעילו מחדש את AutoCAD פעם אחת, מפני שהוא סורק תוספים רק בזמן ההפעלה. אם הבעיה נמשכת, בדקו את מדיניות SECURELOAD ו-TRUSTEDPATHS. לאחר מכן שלחו לתמיכה את קובץ /LOG ואת גרסת AutoCAD דרך תמיכה.