Bereitstellung

Diese Seite richtet sich an Personen, die AFDIM auf den Computern eines Betriebs installieren. AFDIM wird mit einem Inno-Setup-Installationsprogramm verteilt: AFDIM_Setup_<version>.exe von der Seite Download. Es installiert ein AutoCAD®-Autoloader-Bundle. Sie müssen nichts manuell bei AutoCAD registrieren: weder NETLOAD noch eine COM-Registrierung. AutoCAD durchsucht bei jedem Start seine ApplicationPlugins-Ordner und lädt das Bundle.

Installationsorte

Umfang	Plugin-Bundle	Deinstallationsprogramm	Erfordert erhöhte Rechte
Pro Benutzer (Standard)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Nein
Alle Benutzer (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Ja

Das Deinstallationsprogramm befindet sich absichtlich außerhalb des Bundle-Ordners, da AutoCAD den Bundle-Ordner durchsucht. Bei einer Installation für alle Benutzer bleibt das Deinstallationsprogramm unter %ProgramFiles%, sodass normale Benutzer es nicht ersetzen können. Verwenden Sie nur das Deinstallationsprogramm der Installationsart aus der Tabelle. Führen Sie nie ein Deinstallationsprogramm aus %ProgramData% aus, auch wenn eine alte Meldung dorthin verweist. Fehlt das Deinstallationsprogramm einer Installation für alle Benutzer, führen Sie das offizielle Installationsprogramm von der Seite Download mit /ALLUSERS aus, um diese Installation zu reparieren, und deinstallieren Sie sie danach. Das Installationsprogramm verweigert die Installation über eine Installation der anderen Art. Führen Sie das Deinstallationsprogramm einer Installation pro Benutzer ohne Administratorrechte aus.

Das Bundle enthält PackageContents.xml (das Autoloader-Manifest), state.json (installierte Version, Updatekanal und Installationsumfang) und einen Ordner Contents mit je einem Unterordner pro Version. Bei einer Installation mit /NOAUTOUPDATE wird eine Datei namens noautoupdate hinzugefügt. Außerdem fügt das Installationsprogramm eine Verknüpfung zum Startmenü hinzu: AFDIM › AFDIM Help.

Zur Laufzeit schreibt AFDIM folgende Dateien. Jedes Windows-Konto hat eine eigene Kopie, außer %ProgramData%\AFDIM\license, die von allen Konten gemeinsam genutzt wird.

Speicherort	Inhalt
%APPDATA%\AFDIM	Einstellungen und gespeicherte Zeichnungsnormen
%LOCALAPPDATA%\AFDIM\logs	Supportprotokoll
%LOCALAPPDATA%\AFDIM\cache	Update-Downloads
%LOCALAPPDATA%\AFDIM\license	Lizenz dieses Windows-Kontos
%ProgramData%\AFDIM\license	Lizenz für alle Konten des Computers, sofern Windows das Schreiben zulässt
HKCU\Software\AFDIM	Installations-ID und Zeitaufzeichnung der Lizenzprüfung
%TEMP%\AFDIM	Mit Geometrie des letzten Laufs exportieren… erstellte Geometrieexporte (Einstellungsdialog, Registerkarte Über AFDIM)

Das Deinstallationsprogramm behält immer die Lizenzordner und den Registrierungsschlüssel. Siehe Deinstallieren.

Die beiden Installationsumfänge können nicht gleichzeitig bestehen

Das Installationsprogramm verweigert die Ausführung, wenn AFDIM bereits im anderen Umfang installiert ist. AutoCAD durchsucht beide ApplicationPlugins-Stammordner, sodass beide Kopien geladen würden. Der Befehl AFDIM würde zweimal registriert, und der In-App-Updater würde nur eine Kopie aktualisieren. Die Ablehnungsmeldung nennt die genaue unins000.exe, die zuerst auszuführen ist. Bei einer unbeaufsichtigten Installation wird keine Meldung angezeigt: Die Installation wird abgebrochen und der Grund in die /LOG-Datei geschrieben.

Abgedeckte AutoCAD-Versionen

Ein Bundle bedient alle Installationen. PackageContents.xml leitet jede AutoCAD-Release-Reihe zum passenden Build.

Build	Release-Reihe	AutoCAD-Jahre	Status
net472	R19.0 bis R23.1	2013 bis 2020	Veröffentlicht; 2014 und 2016 bis 2018 experimentell
net48	R24.0 bis R24.3	2021, 2022, 2023, 2024	Veröffentlicht
net8.0-windows	R25.0 bis R25.1	2025, 2026	Veröffentlicht
net10.0-windows	R26.0	2027	Veröffentlicht, experimentell

Eine später installierte AutoCAD-Version innerhalb einer abgedeckten Reihe lädt AFDIM ohne Neuinstallation. AutoCAD Mechanical desselben Jahres lädt denselben Build. AutoCAD LT wird nicht unterstützt, weil es keine .NET-API hat. Die Seite Detected AutoCAD des Assistenten dient nur der Information. Sie enthält kein Kontrollkästchen pro Version.

Installation bei laufendem AutoCAD

Dies wird unterstützt. Jede Version wird in ihrem eigenen Unterordner installiert. Ein laufendes AutoCAD sperrt daher keine Datei, die das Installationsprogramm schreibt. Das Installationsprogramm zeigt einen Hinweis und fährt fort. Es verlangt nicht, dass jemand AutoCAD vorher schließt. Ein laufendes AutoCAD lädt AFDIM beim nächsten Start.

Unbeaufsichtigte Installation

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

Der Installationsassistent und die Lizenzvereinbarung sind auf Englisch. Die Seite AFDIM Help wird unter Windows für Vietnam auf Vietnamesisch und sonst auf Englisch geöffnet.

Das Plugin hat eine eigene Oberflächensprache. Eine neue Installation startet auf Englisch oder auf Vietnamesisch, wenn Windows für Vietnam eingerichtet ist (Anzeigesprache, Regionalformat oder Land). Jeder Benutzer kann die Sprache über die Auswahlliste mit 56 Sprachen im Kopf des Einstellungsdialogs ändern. Der Einstellungsdialog wird über die Schaltfläche Settings auf der Registerkarte AFDIM im Menüband geöffnet. Die Sprache gilt für den Dialog, Hinweisfenster und Meldungen der Befehlszeile. Noch nicht übersetzte Texte erscheinen auf Englisch. Die Auswahl wird in den Einstellungen des jeweiligen Benutzers gespeichert.

Schalter	Wirkung
/VERYSILENT	Keine Benutzeroberfläche. Für eine Skriptinstallation verwenden.
/SILENT	Nur Fortschrittsfenster, keine Assistentenseiten.
/SUPPRESSMSGBOXES	Unterdrückt Meldungsfenster. Zusammen mit /VERYSILENT verwenden.
/NORESTART	Kein Neustart. Das Installationsprogramm benötigt keinen Neustart. Geben Sie den Schalter trotzdem an.
/LOG="C:\path\afdim.log"	Schreibt ein vollständiges Installationsprotokoll. Fügen Sie es jeder Supportanfrage zur Installation bei.
/ALLUSERS	Installiert für alle Benutzer unter %ProgramFiles%. Erfordert erhöhte Rechte. Speichert den Computerumfang in state.json und deaktiviert dadurch In-App-Updates.
/CURRENTUSER	Installiert für den aktuellen Benutzer. Dies ist die Standardeinstellung.
/NOAUTOUPDATE	Deaktiviert In-App-Updates für diese Installation, indem die Datei noautoupdate hinzugefügt wird. Wird das Installationsprogramm erneut ohne den Schalter ausgeführt, werden Updates wieder aktiviert.
/EXCLUDESERIES=<series>	Lässt den Build für diese Release-Reihe aus, sodass AutoCAD-Versionen dieser Reihe AFDIM nicht laden. Mehrere Reihen durch Kommas trennen.
/NOICONS	Erstellt keine Verknüpfung im Startmenü.
/DIR="C:\path"	Überschreibt den Installationsordner. Das ist selten richtig, da AutoCAD nur die Standardordner ApplicationPlugins durchsucht.

/EXCLUDESERIES erwartet eine Release-Reihe, kein Jahr: 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. Der Schalter lässt den gesamten Build aus, der diese Reihe abdeckt. Wenn Sie R23.0 ausschließen, wird AFDIM in allen AutoCAD-Versionen von 2013 bis 2020 nicht geladen. Mit R24.1 wird es in allen AutoCAD-Versionen von 2021 bis 2024 nicht geladen. Mit R25.0 oder R25.1 wird es 2025 und 2026 nicht geladen. Das Installationsprogramm ignoriert unbekannte Reihen.

Pro Benutzer oder für alle Benutzer

Sicherheitsabwägung bei einer Installation pro Benutzer

Bei der Standardinstallation liegt die Plugin-DLL unter %APPDATA%. Der angemeldete Benutzer kann in diesen Ordner schreiben und AutoCAD lädt die DLL bei jedem Start in den eigenen Prozess. Jedes Programm, das bereits unter diesem Benutzer läuft, kann die DLL direkt überschreiben, zum Beispiel Schadsoftware oder ein kompromittiertes Add-In. Dessen Code wird danach bei jedem Start ohne Nachfrage und ohne erhöhte Rechte innerhalb von AutoCAD ausgeführt. Das gilt für jedes AutoCAD-Plugin pro Benutzer, denn der Benutzer muss in den Ordner schreiben können, damit eine Installation ohne Administratorrechte möglich ist.

Maßnahmen zur Risikominderung:

Maßnahme	Wirkung
Mit /ALLUSERS installieren	Die DLL liegt unter %ProgramFiles%, in das normale Benutzer nicht schreiben können. Zum Ersetzen sind Administratorrechte nötig.
SECURELOAD auf dem Standardwert 1 belassen	AutoCAD verweigert .NET-Assemblys außerhalb vertrauenswürdiger Pfade. Ein direktes Überschreiben einer vertrauenswürdigen Datei wird nicht verhindert, eine neue DLL an einem anderen Speicherort aber schon.
Anwendungskontrolle (WDAC oder AppLocker)	Kann eine veränderte DLL blockieren. Ab 0.1.6 sind das Installationsprogramm und AFDIM.dll digital signiert (Herausgeber TO VAN TIN).
Unerwartete Schreibvorgänge im Bundle-Ordner überwachen	Nur das Installationsprogramm oder ein In-App-Update (Jetzt aktualisieren auf der Registerkarte Über AFDIM) sollte Contents\<version>\ ändern.

Ein Betrieb, der die DLL an einem nur von Administratoren änderbaren Speicherort ablegen möchte, sollte mit /ALLUSERS installieren.

Betriebe mit mehreren Arbeitsplätzen und servergespeicherte Profile

Verwenden Sie /ALLUSERS für einen Betrieb mit mehreren Arbeitsplätzen. %APPDATA% wird synchronisiert. Bei servergespeicherten Profilen oder Ordnerumleitung kopiert eine Installation pro Benutzer das Plugin bei jeder Anmeldung über das Netzwerk. Außerdem können zwei Computer, auf denen derselbe Benutzer angemeldet ist, gleichzeitig auf den Ordner zugreifen.

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

Führen Sie es mit erhöhten Rechten aus, zum Beispiel über ein SCCM-, Intune- oder Gruppenrichtlinien-Startskript. AFDIM ist dann für jeden Benutzer auf dem Computer verfügbar, und die Plugin-Dateien befinden sich nicht im servergespeicherten Profil. Die Einstellungen jedes Benutzers unter %APPDATA%\AFDIM bleiben weiterhin Teil des Profils.

Wenn Sie bei servergespeicherten Profilen pro Benutzer installieren müssen, schließen Sie %APPDATA%\Autodesk\ApplicationPlugins von der Ordnerumleitung aus.

Updates bei computerweiten Installationen

Eine Installation für alle Benutzer, auch computerweite Installation genannt, deaktiviert In-App-Updates, weil normale Benutzer nicht nach %ProgramFiles% schreiben können. Wenn AFDIM eine neue Version findet, zeigt die Gruppe Updates auf der Registerkarte Über AFDIM des Einstellungsdialogs statt Jetzt aktualisieren den folgenden Text an:

Diese Installation kann sich nicht selbst aktualisieren: Sie wurde für alle Benutzer installiert, Updates wurden bei der Installation deaktiviert oder der Installationsordner ist schreibgeschützt.

Verteilen Sie neue Versionen auf dieselbe Weise wie die erste Version. Das Ausführen eines neueren Installationsprogramms über einer vorhandenen Installation ist ein unterstütztes Upgrade. Die Einstellungen jedes Benutzers und die Lizenz jedes Computers bleiben erhalten. Änderungen der einzelnen Versionen finden Sie auf der Seite Versionshinweise.

Eine Updateprüfung ist eine HTTPS-Anfrage an den signierten Update-Feed unter update.afdim.com. Sie blockiert AutoCAD nie. AFDIM prüft:

• im Hintergrund beim Start von AutoCAD: nach einer erfolgreichen Prüfung höchstens einmal innerhalb von 24 Stunden und nach einer fehlgeschlagenen Prüfung nicht früher als nach 2 Stunden
• einmal beim Öffnen des Einstellungsdialogs, sofern AFDIM in dieser AutoCAD-Sitzung noch nicht geprüft hat
• wenn ein Benutzer auf der Registerkarte Über AFDIM Jetzt suchen auswählt

Die ersten beiden Prüfungen finden nur statt, wenn auf der Registerkarte Über AFDIM Automatisch nach Updates suchen markiert und die Umgebungsvariable AFDIM_DISABLE_BACKGROUND_SERVICES=1 nicht gesetzt ist. Wenn Sie diese Variable setzen, werden auch die AFDIM-Protokolldatei und die Hintergrund-Lizenzprüfung deaktiviert, die eine wartende Lizenzdatei oder Verlängerung abruft. Ohne Protokolldatei enthält ein Supportpaket keine Protokolle.

Lizenzen auf bereitgestellten Computern

Jeder Computer benötigt eine eigene Lizenz. Aktivieren Sie sie in der Gruppe Lizenz auf der Registerkarte Über AFDIM des Einstellungsdialogs. Bei einem Lizenzschlüssel wählt der Benutzer Lizenzschlüssel eingeben…. Der Computer muss in diesem Moment api.afdim.com über HTTPS erreichen können. Wenn AutoCAD keinen Netzwerkzugriff hat, wählt der Benutzer stattdessen Lizenz anfordern. Der angezeigte Anforderungscode wird über die Lizenzseite gesendet. Die zurückgesendete Lizenzdatei wird in derselben Gruppe mit Lizenz laden… geladen. Siehe So funktioniert die Lizenzierung.

Wenn Windows es zulässt, schreibt AFDIM die geladene Lizenz zusätzlich nach %ProgramData%\AFDIM\license. Andere Windows-Konten auf demselben Computer müssen sie dann nicht erneut aktivieren.

Unbeaufsichtigte Deinstallation

rem Installation pro Benutzer (Standard)
"%APPDATA%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

rem Installation für alle Benutzer, mit erhöhten Rechten
"%ProgramFiles%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

Inno Setup speichert den Befehl zur stillen Deinstallation außerdem im Registrierungswert QuietUninstallString unter dem Schlüssel Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. Bei einer Installation pro Benutzer befindet sich der Schlüssel unter HKCU, bei einer Installation für alle Benutzer unter HKLM.

Das Deinstallationsprogramm behält standardmäßig die Benutzereinstellungen bei. Dadurch kann Deinstallation plus Neuinstallation als Reparatur dienen. Um auch Daten zu löschen, fügen Sie /PURGEDATA hinzu:

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

/PURGEDATA löscht %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM und %TEMP%\AFDIM des Kontos, das die Deinstallation ausführt. Ordner anderer Windows-Konten bleiben erhalten. Der Ordner license in %LOCALAPPDATA%\AFDIM bleibt immer erhalten. /PURGEDATA löscht weder %ProgramData%\AFDIM\license noch den Registrierungsschlüssel HKCU\Software\AFDIM. Der Updatecache wird immer entfernt.

Wenn AutoCAD während der Deinstallation ausgeführt wird, behält das Deinstallationsprogramm die Dateien, die AutoCAD verwendet. Eine interaktive Deinstallation zeigt ein Fenster mit diesem Hinweis: Schließen Sie alle CAD-Fenster und führen Sie das Deinstallationsprogramm dann erneut aus. Eine stille Deinstallation listet diese Dateien in ihrem Protokoll auf. Ein Neustart wird nicht angefordert. Dateien in einem Ordner, dessen Pfad sich geändert hat, bleiben ebenfalls erhalten. Schließen Sie alle CAD-Fenster und wiederholen Sie die Deinstallation oder Neuinstallation, oder prüfen Sie die Pfade im Protokoll, bevor Sie etwas von Hand löschen. Bei der nächsten Anmeldung wird nichts gelöscht.

Prüfung nach der Bereitstellung

1. Starten Sie AutoCAD. Die Registerkarte AFDIM im Menüband wird mit den beiden Schaltflächen Dimension und Settings angezeigt. Diese beiden Namen sind in allen Sprachen Englisch.
2. Führen Sie AFDIM aus. Es funktioniert ohne NETLOAD. Auf einem Computer ohne Lizenz öffnet sich das Fenster Willkommen bei AFDIM oder AFDIM ist nicht aktiviert. Beide Fenster zeigen, dass das Plugin geladen wurde.
3. Prüfen Sie, ob PackageContents.xml im Bundle-Ordner vorhanden ist und einen Components-Block enthält, dessen SeriesMin und SeriesMax die installierte AutoCAD-Version abdecken.
4. Prüfen Sie, ob state.json die erwarteten Werte für activeVersion, channel und installScope enthält.

Wenn AFDIM als unbekannter Befehl gemeldet wird, starten Sie AutoCAD einmal neu, denn AutoCAD sucht nur beim Start nach Plugins. Wenn das Problem weiterhin besteht, prüfen Sie die Richtlinien für SECURELOAD und TRUSTEDPATHS. Senden Sie dann die /LOG-Datei und die AutoCAD-Version an den Support.