Implementatie

Deze pagina is voor degene die AFDIM installeert op de computers van een werkplaats. AFDIM bestaat uit één Inno Setup-installatieprogramma, AFDIM_Setup_<version>.exe, van de pagina Downloaden. Het installeert een AutoCAD® Autoloader-bundel. Er wordt niets handmatig bij AutoCAD geregistreerd: geen NETLOAD en geen COM-registratie. AutoCAD scant bij elke start de ApplicationPlugins-mappen en laadt de bundel.

Wat waar wordt geïnstalleerd

Bereik	Pluginbundel	Verwijderprogramma	Verhoogde rechten nodig
Per gebruiker (standaard)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Nee
Alle gebruikers (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Ja

Het verwijderprogramma staat bewust buiten de bundelmap, omdat AutoCAD de bundelmap scant. Bij een installatie voor alle gebruikers blijft het verwijderprogramma onder %ProgramFiles%, zodat een standaardgebruiker het niet kan vervangen. Gebruik alleen het verwijderprogramma van het installatietype in de tabel. Start nooit een verwijderprogramma vanuit %ProgramData%, ook niet als een oude melding daarnaar verwijst. Ontbreekt het verwijderprogramma van een installatie voor alle gebruikers, start dan het officiële installatieprogramma van de pagina Downloaden met /ALLUSERS om die installatie te herstellen, en verwijder haar daarna. Het installatieprogramma weigert te installeren over een installatie van het andere type. Start het verwijderprogramma van een installatie per gebruiker zonder beheerdersrechten.

De bundel bevat PackageContents.xml (het Autoloader-manifest), state.json (geïnstalleerde versie, updatekanaal en installatiebereik) en een map Contents met een submap per versie. Een installatie met /NOAUTOUPDATE voegt het bestand noautoupdate toe. Het installatieprogramma maakt ook een snelkoppeling in het Startmenu: AFDIM › AFDIM Help.

Tijdens het uitvoeren schrijft AFDIM de volgende bestanden. Elk Windows-account heeft een eigen kopie, behalve %ProgramData%\AFDIM\license, die door alle accounts wordt gedeeld.

Locatie	Inhoud
%APPDATA%\AFDIM	Instellingen en opgeslagen tekenstandaarden
%LOCALAPPDATA%\AFDIM\logs	Ondersteuningslogboek
%LOCALAPPDATA%\AFDIM\cache	Gedownloade updates
%LOCALAPPDATA%\AFDIM\license	Licentie van dit Windows-account
%ProgramData%\AFDIM\license	Licentie voor alle accounts op de computer, als Windows schrijven toestaat
HKCU\Software\AFDIM	Installatie-ID en tijdregistratie van de licentiecontrole
%TEMP%\AFDIM	Geometrie-exporten gemaakt met Geometrie van de laatste run exporteren… (instellingenvenster, tabblad Info)

Het verwijderprogramma laat de licentiemappen en registersleutel altijd staan. Zie Verwijderen.

De twee installatiebereiken kunnen niet naast elkaar bestaan

Het installatieprogramma start niet wanneer AFDIM al met het andere bereik is geïnstalleerd. AutoCAD scant beide ApplicationPlugins-mappen, zodat beide kopieën zouden worden geladen. De opdracht AFDIM zou tweemaal worden geregistreerd en de updater in de app zou maar één kopie bijwerken. Het weigeringsbericht vermeldt precies welk unins000.exe u eerst moet uitvoeren. Bij een stille installatie verschijnt geen bericht: de installatie stopt en schrijft de reden naar het /LOG-bestand.

Ondersteunde AutoCAD-releases

Eén bundel is geschikt voor alle werkplekken. PackageContents.xml verwijst elke AutoCAD-releaseserie naar de bijbehorende build.

Build	Releaseserie	AutoCAD-jaren	Status
net472	R19.0 tot R23.1	2013 tot 2020	Meegeleverd; 2014 en 2016 tot 2018 experimenteel
net48	R24.0 tot R24.3	2021, 2022, 2023, 2024	Meegeleverd
net8.0-windows	R25.0 tot R25.1	2025, 2026	Meegeleverd
net10.0-windows	R26.0	2027	Meegeleverd, experimenteel

Een later geïnstalleerde AutoCAD-versie binnen een ondersteunde reeks laadt AFDIM zonder herinstallatie. AutoCAD Mechanical van dezelfde jaren laadt dezelfde build. AutoCAD LT wordt niet ondersteund omdat het geen .NET-API heeft. De wizardpagina Detected AutoCAD is alleen ter informatie; er is geen selectievakje voor elke versie.

Installeren terwijl AutoCAD actief is

Dit wordt ondersteund. Elke versie wordt in een eigen submap geïnstalleerd, zodat een actieve AutoCAD geen bestanden vergrendelt die het installatieprogramma schrijft. Het installatieprogramma toont een melding en gaat door. Niemand hoeft AutoCAD eerst af te sluiten. Een actieve AutoCAD laadt AFDIM bij de volgende start.

Stille installatie

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

De installatiewizard en de licentieovereenkomst zijn in het Engels. De pagina AFDIM Help wordt in het Vietnamees geopend op Windows dat voor Vietnam is ingesteld, en anders in het Engels.

De plugin heeft een eigen interfacetaal. Een nieuwe installatie start in het Engels of in het Vietnamees als Windows voor Vietnam is ingesteld (weergavetaal, regionale notatie of land). Elke gebruiker kan de taal wijzigen met de vervolgkeuzelijst met 56 talen in de kop van het instellingenvenster. Dat venster opent met de knop Settings op de ribbon-tab AFDIM. De taal geldt voor het venster, meldingen en opdrachtregelberichten. Niet-vertaalde tekst blijft Engels. De keuze wordt opgeslagen in de instellingen van die gebruiker.

Schakelaar	Effect
/VERYSILENT	Geen gebruikersinterface. Gebruik dit voor een installatie via een script.
/SILENT	Alleen een voortgangsvenster, geen wizardpagina’s.
/SUPPRESSMSGBOXES	Onderdrukt berichtvensters. Gebruik samen met /VERYSILENT.
/NORESTART	Voorkomt een herstart. Het installatieprogramma vereist geen herstart; geef de schakelaar toch mee.
/LOG="C:\path\afdim.log"	Schrijft een volledig installatielogboek. Voeg dit toe aan elk ondersteuningsverzoek over installatie.
/ALLUSERS	Installeert voor alle gebruikers onder %ProgramFiles%. Vereist verhoogde rechten. Slaat het installatiebereik op in state.json, waardoor updates in de app worden uitgeschakeld.
/CURRENTUSER	Installeert voor de huidige gebruiker. Dit is de standaardinstelling.
/NOAUTOUPDATE	Schakelt updates in de app uit door het bestand noautoupdate toe te voegen. Als u het installatieprogramma opnieuw uitvoert zonder deze schakelaar, worden updates weer ingeschakeld.
/EXCLUDESERIES=<series>	Laat de build voor die releaseserie weg, zodat AutoCAD-releases uit die serie AFDIM niet laden. Scheid meerdere series met komma’s.
/NOICONS	Maakt geen snelkoppeling in het Startmenu.
/DIR="C:\path"	Overschrijft de installatiemap. Dit is zelden juist, omdat AutoCAD alleen de standaardlocaties voor ApplicationPlugins scant.

/EXCLUDESERIES verwacht een releaseserie, geen jaartal: 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. De schakelaar verwijdert de volledige build voor die reeks. Door R23.0 uit te sluiten, wordt AFDIM in alle AutoCAD-versies van 2013 tot 2020 niet geladen. Uitsluiting van R24.1 voorkomt laden in elke AutoCAD van 2021 tot 2024. Uitsluiting van R25.0 of R25.1 voorkomt laden in zowel 2025 als 2026. Het installatieprogramma negeert onbekende series.

Per gebruiker of voor alle gebruikers

Beveiligingsafweging bij installatie per gebruiker

Bij de standaardinstallatie staat de plugin-DLL onder %APPDATA%. De aangemelde gebruiker kan naar deze map schrijven en AutoCAD laadt de DLL bij elke start in het eigen proces. Elk programma dat al namens die gebruiker draait, kan de DLL ter plekke overschrijven, bijvoorbeeld malware of een gecompromitteerde add-in. De code draait daarna zonder melding of verhoogde rechten in AutoCAD. Dit geldt voor elke AutoCAD-plugin per gebruiker: de gebruiker moet naar de map kunnen schrijven om installatie zonder beheerdersrechten mogelijk te maken.

Wat het risico verkleint:

Maatregel	Effect
Installeren met /ALLUSERS	De DLL staat onder %ProgramFiles%, waar een standaardgebruiker niet naar kan schrijven. Vervanging vereist beheerdersrechten.
SECURELOAD op de standaardwaarde 1 houden	AutoCAD weigert .NET-assemblies buiten vertrouwde paden. Het voorkomt geen overschrijving van een bestaand vertrouwd bestand, maar blokkeert wel een nieuwe DLL op een andere locatie.
Toepassingsbeheer (WDAC of AppLocker)	Kan een aangepaste DLL blokkeren. Vanaf 0.1.6 zijn het installatieprogramma en AFDIM.dll code-ondertekend (uitgever TO VAN TIN).
De bundelmap controleren op onverwachte schrijfbewerkingen	Alleen het installatieprogramma of een update in de app (Nu bijwerken op het tabblad Info) hoort iets in Contents\<version>\ te wijzigen.

Een werkplaats die de DLL alleen op een locatie wil waar beheerders die kunnen wijzigen, installeert met /ALLUSERS.

Werkplaatsen met meerdere werkplekken en roamingprofielen

Gebruik /ALLUSERS voor een werkplaats met meerdere werkplekken. %APPDATA% wordt meegeroamd. Met roamingprofielen of mapomleiding kopieert een installatie per gebruiker de plugin bij elke aanmelding via het netwerk. Ook kunnen 2 computers die als dezelfde gebruiker zijn aangemeld tegelijk dezelfde map gebruiken.

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

Voer dit uit vanuit een context met verhoogde rechten, bijvoorbeeld een opstartscript van SCCM, Intune of Groepsbeleid. Elke gebruiker op de computer krijgt AFDIM en de pluginbestanden staan niet in het roamingprofiel. De instellingen van elke gebruiker in %APPDATA%\AFDIM blijven wel bij het profiel.

Als u ondanks roamingprofielen per gebruiker moet installeren, sluit dan %APPDATA%\Autodesk\ApplicationPlugins uit van mapomleiding.

Updates bij installaties voor alle gebruikers

Bij een installatie voor alle gebruikers (ook wel installatie voor de hele computer) zijn updates in de app uitgeschakeld omdat een standaardgebruiker niet naar %ProgramFiles% kan schrijven. Wanneer AFDIM een nieuwere versie vindt, toont de groep Updates op het tabblad Info van het instellingenvenster de volgende tekst in plaats van Nu bijwerken:

Deze installatie kan zichzelf niet bijwerken: ze is voor alle gebruikers geïnstalleerd, updates zijn bij de installatie uitgeschakeld of de map is alleen-lezen.

Distribueer nieuwe versies op dezelfde manier als de eerste. Een nieuwer installatieprogramma over een bestaande installatie uitvoeren is een ondersteunde upgrade. De instellingen van elke gebruiker en de licentie van elke computer blijven behouden. De wijzigingen van elke versie staan op de pagina Release notes.

Een updatecontrole is één HTTPS-verzoek voor de ondertekende updatefeed op update.afdim.com. Deze blokkeert AutoCAD nooit. AFDIM controleert:

• op de achtergrond wanneer AutoCAD start: maximaal eens per 24 uur na een geslaagde controle en niet eerder dan 2 uur na een mislukte;
• eenmaal wanneer het instellingenvenster wordt geopend, als AFDIM in die AutoCAD-sessie nog niet heeft gecontroleerd;
• wanneer een gebruiker op het tabblad Info Nu controleren kiest.

De eerste 2 controles gebeuren alleen als Automatisch op updates controleren is aangevinkt op het tabblad Info en de omgevingsvariabele AFDIM_DISABLE_BACKGROUND_SERVICES=1 niet is ingesteld. Met die variabele worden ook het AFDIM-logboek en de achtergrondcontrole van licenties uitgeschakeld, die een wachtend licentiebestand of een verlenging ophaalt. Zonder logboek bevat een ondersteunings-ZIP geen log.

Licenties op uitgerolde computers

Elke computer heeft een eigen licentie nodig. Activeer die in de groep Licentie op het tabblad Info van het instellingenvenster. Met een licentiesleutel kiest een gebruiker Licentiesleutel invoeren…. De computer moet dan via HTTPS api.afdim.com kunnen bereiken. Als AutoCAD geen netwerktoegang heeft, kiest de gebruiker Licentie aanvragen. De getoonde aanvraagcode wordt via de Licentiepagina verstuurd. Het ontvangen licentiebestand wordt met Licentie laden… in dezelfde groep geladen. Zie Hoe licenties werken.

Wanneer Windows dit toestaat, schrijft AFDIM de geladen licentie ook naar %ProgramData%\AFDIM\license. Andere Windows-accounts op dezelfde computer hoeven dan niet opnieuw te activeren.

Stil verwijderen

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 registreert de stille opdracht ook in de registerwaarde QuietUninstallString onder Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. De sleutel staat onder HKCU bij installatie per gebruiker en onder HKLM bij installatie voor alle gebruikers.

Standaard bewaart het verwijderprogramma de instellingen van de gebruiker, zodat verwijderen en opnieuw installeren als reparatie kan werken. Voeg /PURGEDATA toe om gegevens ook te verwijderen:

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

/PURGEDATA verwijdert %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM en %TEMP%\AFDIM van het account dat het verwijderprogramma uitvoert. Andere Windows-accounts behouden hun mappen. In %LOCALAPPDATA%\AFDIM blijft de map license altijd behouden. /PURGEDATA verwijdert nooit %ProgramData%\AFDIM\license of de registersleutel HKCU\Software\AFDIM. De updatecache wordt altijd verwijderd.

Als AutoCAD actief is tijdens het verwijderen, laat het verwijderprogramma de bestanden staan die AutoCAD gebruikt. Bij interactief verwijderen verschijnt een venster dat dit meldt: sluit alle CAD-vensters en voer het verwijderprogramma daarna opnieuw uit. Bij stil verwijderen staan die bestanden in het logboek. Er wordt geen herstart gevraagd. Bestanden in een map waarvan het pad is gewijzigd, blijven ook staan. Sluit alle CAD-vensters en probeer het verwijderen of opnieuw installeren nog eens, of bekijk de paden in het logboek voordat u iets met de hand verwijdert. Bij de volgende aanmelding wordt niets verwijderd.

Controle na implementatie

1. Start AutoCAD. De ribbon-tab AFDIM verschijnt met de knoppen Dimension en Settings. Deze namen zijn in elke taal Engels.
2. Voer AFDIM uit. Dit werkt zonder NETLOAD. Op een computer zonder licentie opent het venster Welcome to AFDIM of AFDIM is niet geactiveerd. Beide vensters tonen dat de plugin is geladen.
3. Controleer of PackageContents.xml in de bundelmap staat en een blok Components heeft waarvan SeriesMin en SeriesMax de geïnstalleerde AutoCAD-versie omvatten.
4. Controleer of state.json de verwachte activeVersion, channel en installScope bevat.

Als AFDIM een onbekende opdracht is, start AutoCAD dan eenmaal opnieuw; AutoCAD scant plugins alleen bij het starten. Als het nog steeds niet werkt, controleer dan het beleid voor SECURELOAD en TRUSTEDPATHS. Stuur daarna het /LOG-bestand en de AutoCAD-versie naar Support.