Udrulning

Denne side er til den person, der installerer AFDIM på værkstedets computere. AFDIM leveres som ét Inno Setup-installationsprogram, AFDIM_Setup_<version>.exe, fra siden Download. Det installerer en AutoCAD® Autoloader-pakke. Intet registreres manuelt i AutoCAD: hverken NETLOAD eller COM-registrering. AutoCAD scanner sine ApplicationPlugins-mapper ved hver start og indlæser pakken.

Hvad installeres hvor

Omfang	Pluginpakke	Afinstallationsprogram	Kræver forhøjede rettigheder
Pr. bruger (standard)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Nej
Alle brugere (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Ja

Afinstallationsprogrammet ligger med vilje uden for pakkemappen, fordi AutoCAD scanner pakkemappen. En installation for alle brugere placerer afinstallationsprogrammet under %ProgramFiles%, så en almindelig bruger ikke kan erstatte det. Brug kun afinstallationsprogrammet for installationstypen i tabellen. Kør aldrig et afinstallationsprogram fra %ProgramData%, heller ikke hvis en gammel meddelelse peger derhen. Hvis afinstallationsprogrammet for en installation for alle brugere mangler, skal du køre det officielle installationsprogram fra siden Download med /ALLUSERS for at reparere installationen og derefter afinstallere den. Installationsprogrammet nægter at installere oven på en installation af den anden type. Kør afinstallationsprogrammet for en installation pr. bruger uden administratorrettigheder.

Pakken indeholder PackageContents.xml (Autoloader-manifestet), state.json (installeret version, opdateringskanal og installationsomfang) og mappen Contents med en undermappe pr. version. En installation med /NOAUTOUPDATE tilføjer filen noautoupdate. Installationsprogrammet opretter også genvejen AFDIM › AFDIM Help i menuen Start.

AFDIM skriver følgende under kørsel. Hver Windows-konto har sin egen kopi, undtagen %ProgramData%\AFDIM\license, som deles af alle konti.

Placering	Indhold
%APPDATA%\AFDIM	Indstillinger og gemte tegnestandarder
%LOCALAPPDATA%\AFDIM\logs	Supportlog
%LOCALAPPDATA%\AFDIM\cache	Hentede opdateringer
%LOCALAPPDATA%\AFDIM\license	Licens til denne Windows-konto
%ProgramData%\AFDIM\license	Licens til alle konti på computeren, hvis Windows tillader skrivning
HKCU\Software\AFDIM	Installations-id og tidsregistrering af licenskontrollen
%TEMP%\AFDIM	Geometrieksporter fra Eksportér geometrien fra den seneste kørsel… (indstillingsdialogen, fanen Om)

Afinstallationsprogrammet bevarer altid licensmapperne og registreringsdatabasenøglen. Se Afinstallation.

De to installationsomfang kan ikke eksistere samtidig

Installationsprogrammet nægter at køre, hvis AFDIM allerede er installeret med det andet omfang. AutoCAD scanner begge ApplicationPlugins-rødder, så begge kopier ville blive indlæst. Kommandoen AFDIM ville blive registreret to gange, og opdateringsfunktionen i programmet ville kun opgradere den ene kopi. Afvisningsmeddelelsen angiver præcist, hvilken unins000.exe der skal køres først. En lydløs installation viser ingen meddelelse: den stopper uden at installere og skriver årsagen i /LOG-filen.

Dækkede AutoCAD-versioner

Én pakke dækker alle arbejdsstationer. PackageContents.xml sender hver AutoCAD-versionsserie til det tilhørende build.

Build	Versionsserie	AutoCAD-år	Status
net472	R19.0 til R23.1	2013 til 2020	Udgivet; 2014 og 2016 til 2018 eksperimentelle
net48	R24.0 til R24.3	2021, 2022, 2023, 2024	Udgivet
net8.0-windows	R25.0 til R25.1	2025, 2026	Udgivet
net10.0-windows	R26.0	2027	Udgivet, eksperimentelt

En AutoCAD-version, du installerer senere inden for en dækket serie, indlæser AFDIM uden geninstallation. AutoCAD Mechanical fra de samme år indlæser samme build. AutoCAD LT understøttes ikke, fordi programmet ikke har et .NET API. Installationsguidens side Detected AutoCAD er kun til orientering; der er ikke et afkrydsningsfelt for hver version.

Installation, mens AutoCAD kører

Det understøttes. Hver version installeres i sin egen undermappe, så en kørende AutoCAD-instans ikke låser nogen af de filer, installationsprogrammet skriver. Installationsprogrammet viser en bemærkning og fortsætter. Ingen behøver lukke AutoCAD først. En kørende AutoCAD indlæser AFDIM næste gang programmet startes.

Lydløs installation

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

Installationsguiden og licensaftalen er på engelsk. Siden AFDIM Help åbnes på vietnamesisk i Windows, der er indstillet til Vietnam, og ellers på engelsk.

Pluginet har sit eget grænsefladesprog. En ny installation starter på engelsk eller vietnamesisk, hvis Windows er indstillet til Vietnam (visningssprog, regionalt format eller land). Hver bruger kan ændre sproget med rullelisten med 56 sprog i indstillingsdialogens overskrift. Dialogen åbnes med knappen Settings på fanen AFDIM. Sproget gælder dialogen, beskedvinduerne og kommandolinjemeddelelserne. Tekst, der endnu ikke er oversat, vises på engelsk. Valget gemmes i brugerens indstillinger.

Parameter	Virkning
/VERYSILENT	Intet brugergrænseflade. Brug den til en scriptet udrulning.
/SILENT	Kun statusvindue, ingen guidesider.
/SUPPRESSMSGBOXES	Undertryk meddelelsesvinduer. Brug den sammen med /VERYSILENT.
/NORESTART	Genstart aldrig. Installationsprogrammet kræver ingen genstart. Angiv alligevel parameteren.
/LOG="C:\path\afdim.log"	Skriv en fuld installationslog. Vedhæft den til supporthenvendelser om installation.
/ALLUSERS	Installer for alle brugere under %ProgramFiles%. Kræver forhøjede rettigheder. Registrerer maskinomfanget i state.json, hvilket deaktiverer opdateringer i programmet.
/CURRENTUSER	Installer for den aktuelle bruger. Dette er standarden.
/NOAUTOUPDATE	Deaktiver opdateringer i programmet ved at tilføje filen noautoupdate. Kør installationsprogrammet igen uden parameteren for at slå opdateringer til.
/EXCLUDESERIES=<series>	Udelad buildet for denne versionsserie, så AutoCAD-versionerne i serien ikke indlæser AFDIM. Adskil flere serier med kommaer.
/NOICONS	Opret ikke genvejen i menuen Start.
/DIR="C:\path"	Tilsidesæt installationsmappen. Det er sjældent korrekt, da AutoCAD kun scanner standardplaceringerne ApplicationPlugins.

/EXCLUDESERIES tager en versionsserie, ikke et år: 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. Parameteren fjerner hele buildet for serien. Hvis du udelader R23.0, indlæses AFDIM ikke i nogen AutoCAD-version fra 2013 til 2020. Udelades R24.1, indlæses det ikke i nogen version fra 2021 til 2024. Udelades R25.0 eller R25.1, indlæses det hverken i 2025 eller 2026. Installationsprogrammet ignorerer en serie, det ikke kender.

Pr. bruger eller alle brugere

Sikkerhedsafvejningen ved installation pr. bruger

Standardinstallationen placerer pluginets DLL-fil under %APPDATA%. Den indloggede bruger kan skrive til mappen, og AutoCAD indlæser DLL-filen i sin egen proces ved hver start. Et program, der allerede kører som samme bruger, kan overskrive DLL-filen, f.eks. malware eller et kompromitteret tilføjelsesprogram. Dets kode kører derefter inde i AutoCAD uden en prompt og uden forhøjede rettigheder. Det gælder alle AutoCAD-plugins, der installeres pr. bruger, fordi brugeren skal kunne skrive i mappen, for at installation uden administratorrettigheder kan fungere.

Sådan reduceres risikoen:

Foranstaltning	Virkning
Installer med /ALLUSERS	DLL-filen ligger under %ProgramFiles%, som en almindelig bruger ikke kan skrive til. Udskiftning kræver administratorrettigheder.
Behold standardværdien 1 for SECURELOAD	AutoCAD afviser .NET-assemblies uden for betroede stier. Det forhindrer ikke overskrivning af en betroet fil på stedet, men forhindrer en ny DLL på en anden placering.
Programkontrol (WDAC eller AppLocker)	Kan blokere en manipuleret DLL. Fra 0.1.6 er installationsprogrammet og AFDIM.dll kodesigneret (udgiver TO VAN TIN).
Hold øje med uventede skrivninger i pakkemappen	Intet bør ændre Contents\<version>\ ud over installationsprogrammet eller en opdatering i programmet (Opdatér nu på fanen Om).

En virksomhed, der vil placere DLL-filen et sted, som kun administratorer kan ændre, bør installere med /ALLUSERS.

Flere arbejdsstationer og roamingprofiler

Brug /ALLUSERS på et værksted med flere arbejdsstationer. %APPDATA% roamer. Med roamingprofiler eller omdirigerede mapper kopierer en installation pr. bruger pluginet over netværket ved hver indlogning. To computere, der er logget ind som samme bruger, kan også komme til at konkurrere om mappen.

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

Kør det fra en kontekst med forhøjede rettigheder, f.eks. et opstartsscript i SCCM, Intune eller Gruppepolitik. Alle brugere på computeren får derefter AFDIM, og pluginfilerne ligger ikke i roamingprofilen. Den enkelte brugers indstillinger i %APPDATA%\AFDIM følger stadig profilen.

Hvis installationen skal være pr. bruger med roamingprofiler, skal %APPDATA%\Autodesk\ApplicationPlugins udelukkes fra mappeomdirigeringen.

Opdateringer ved maskinomfattende installationer

En installation for alle brugere, også kaldet en maskinomfattende installation, deaktiverer opdateringer i programmet, fordi en almindelig bruger ikke kan skrive til %ProgramFiles%. Når AFDIM finder en nyere version, viser gruppen Opdateringer på fanen Om nedenstående tekst i stedet for Opdatér nu:

Denne installation kan ikke opdatere sig selv: den er installeret for alle brugere, opdateringer blev slået fra under installationen, eller mappen er skrivebeskyttet.

Udrul nye versioner på samme måde som den første. Det understøttes at køre et nyere installationsprogram oven på en eksisterende installation. Hver brugers indstillinger og hver computers licens bevares. Ændringerne i hver version findes på siden Versionsnoter.

En opdateringskontrol er én HTTPS-anmodning efter det signerede opdateringsfeed på update.afdim.com. Den blokerer aldrig AutoCAD. AFDIM kontrollerer:

• i baggrunden, når AutoCAD starter: højst én gang pr. 24 timer efter en vellykket kontrol og tidligst 2 timer efter en mislykket kontrol
• én gang, når indstillingsdialogen åbnes, hvis AFDIM endnu ikke har kontrolleret i den AutoCAD-session
• når en bruger vælger Søg nu på fanen Om

De to første kontroller udføres kun, når Søg automatisk efter opdateringer er markeret på fanen Om, og miljøvariablen AFDIM_DISABLE_BACKGROUND_SERVICES=1 ikke er angivet. Variablen deaktiverer også AFDIM-logfilen og licenskontrollen i baggrunden, der henter en afventende licensfil eller fornyelse. Uden logfil indeholder en support-zip ingen log.

Licenser på udrullede computere

Hver computer skal have sin egen licens. Aktivér den i gruppen Licens på fanen Om i indstillingsdialogen. Med en licensnøgle vælger brugeren Indtast licensnøgle…. Computeren skal på det tidspunkt kunne nå api.afdim.com via HTTPS. Hvis AutoCAD ikke har netværksadgang, vælger brugeren Anmod om licens i stedet. Anmodningskoden sendes via licenssiden. Den modtagne licensfil indlæses med Indlæs licens… i samme gruppe. Se Sådan fungerer licensering.

Når Windows tillader det, skriver AFDIM også den indlæste licens til %ProgramData%\AFDIM\license. Andre Windows-konti på samme computer behøver så ikke aktivere igen.

Lydløs afinstallation

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 registrerer også den lydløse kommando i registreringsværdien QuietUninstallString under nøglen Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. Nøglen ligger under HKCU ved en installation pr. bruger og under HKLM ved en installation for alle brugere.

Afinstallationsprogrammet bevarer som standard brugerens indstillinger, så afinstallation og geninstallation kan bruges til reparation. Tilføj /PURGEDATA for også at slette data:

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

/PURGEDATA sletter %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM og %TEMP%\AFDIM for den konto, der kører afinstallationsprogrammet. Andre Windows-konti beholder deres mapper. Mappen license under %LOCALAPPDATA%\AFDIM bevares altid. /PURGEDATA sletter aldrig %ProgramData%\AFDIM\license eller registreringsdatabasenøglen HKCU\Software\AFDIM. Opdateringscachen fjernes altid.

Hvis AutoCAD kører under afinstallationen, beholder afinstallationsprogrammet de filer, som AutoCAD bruger. En interaktiv afinstallation viser et vindue, der siger det: luk alle CAD-vinduer, og kør derefter afinstallationsprogrammet igen. En lydløs afinstallation viser disse filer i sin log. Der anmodes ikke om genstart. Filer i en mappe, hvis sti er ændret, beholdes også. Luk alle CAD-vinduer, og prøv afinstallationen eller geninstallationen igen, eller gennemse stierne i loggen, før du sletter noget manuelt. Intet slettes ved næste login.

Kontrol efter udrulning

1. Start AutoCAD. Fanen AFDIM vises med to knapper, Dimension og Settings. Disse to navne er engelske på alle sprog.
2. Kør AFDIM. Det virker uden NETLOAD. På en computer uden licens åbner vinduet Velkommen til AFDIM eller AFDIM er ikke aktiveret. Begge vinduer viser, at pluginet er indlæst.
3. Kontrollér, at PackageContents.xml findes i pakkemappen og har en Components-blok, hvor SeriesMin og SeriesMax dækker den installerede AutoCAD-version.
4. Kontrollér, at state.json viser de forventede værdier for activeVersion, channel og installScope.

Hvis AFDIM er en ukendt kommando, skal du genstarte AutoCAD én gang, da AutoCAD kun scanner efter plugins ved start. Hvis det stadig ikke virker, skal du kontrollere politikken for SECURELOAD og TRUSTEDPATHS. Send derefter /LOG-filen og AutoCAD-versionen til Support.