Distribution

Den här sidan riktar sig till den som installerar AFDIM på verkstadens datorer. AFDIM levereras som ett Inno Setup-installationsprogram, AFDIM_Setup_<version>.exe, från sidan Hämta. Det installerar ett AutoCAD® Autoloader-paket. Inget registreras manuellt i AutoCAD: varken NETLOAD eller COM-registrering. AutoCAD söker igenom mapparna ApplicationPlugins vid varje start och läser in paketet.

Vad som installeras och var

Omfattning	Pluginpaket	Avinstallationsprogram	Kräver behörighetshöjning
Per användare (standard)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Nej
Alla användare (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Ja

Avinstallationsprogrammet ligger avsiktligt utanför paketmappen eftersom AutoCAD söker igenom paketmappen. En installation för alla användare placerar avinstallationsprogrammet under %ProgramFiles% så att en standardanvändare inte kan ersätta det. Använd bara avinstallationsprogrammet för installationstypen i tabellen. Kör aldrig ett avinstallationsprogram från %ProgramData%, inte ens om ett gammalt meddelande pekar dit. Om avinstallationsprogrammet för en installation för alla användare saknas kör du det officiella installationsprogrammet från sidan Ladda ned med /ALLUSERS för att reparera installationen och avinstallerar den sedan. Installationsprogrammet vägrar installera ovanpå en installation av den andra typen. Kör avinstallationsprogrammet för en installation per användare utan administratörsbehörighet.

Paketet innehåller PackageContents.xml (Autoloader-manifestet), state.json (installerad version, uppdateringskanal och installationsomfattning) och mappen Contents med en undermapp per version. En installation med /NOAUTOUPDATE lägger till filen noautoupdate. Installationsprogrammet lägger även till genvägen AFDIM › AFDIM Help på Start-menyn.

AFDIM skriver följande vid körning. Varje Windows-konto har en egen kopia, utom %ProgramData%\AFDIM\license, som delas av alla konton.

Plats	Innehåll
%APPDATA%\AFDIM	Inställningar och sparade ritstandarder
%LOCALAPPDATA%\AFDIM\logs	Supportlogg
%LOCALAPPDATA%\AFDIM\cache	Hämtade uppdateringar
%LOCALAPPDATA%\AFDIM\license	Licens för det här Windows-kontot
%ProgramData%\AFDIM\license	Licens för alla konton på datorn, om Windows tillåter skrivning
HKCU\Software\AFDIM	Installations-ID och tidsuppgift för licenskontrollen
%TEMP%\AFDIM	Geometriexporter som skapats med Exportera geometrin från den senaste körningen… (inställningsdialogrutan, fliken Om)

Avinstallationsprogrammet behåller alltid licensmapparna och registernyckeln. Se Avinstallera.

De två omfattningarna kan inte samexistera

Installationsprogrammet vägrar köra om AFDIM redan är installerat med den andra omfattningen. AutoCAD söker i båda rotmapparna ApplicationPlugins, så båda kopiorna skulle läsas in. Kommandot AFDIM skulle registreras två gånger och uppdateraren inifrån programmet skulle endast uppgradera en kopia. Meddelandet om att installationen avböjs anger exakt vilken unins000.exe som ska köras först. En tyst installation visar inget meddelande: den avbryts utan att installera och skriver orsaken till /LOG-filen.

AutoCAD-versioner som täcks

Ett paket täcker alla AutoCAD-installationer. PackageContents.xml kopplar varje AutoCAD-versionsserie till motsvarande bygge.

Bygge	Versionsserie	AutoCAD-år	Status
net472	R19.0 till R23.1	2013 till 2020	Levererat; 2014 och 2016 till 2018 experimentella
net48	R24.0 till R24.3	2021, 2022, 2023, 2024	Levererat
net8.0-windows	R25.0 till R25.1	2025, 2026	Levererat
net10.0-windows	R26.0	2027	Levererat, experimentellt

En AutoCAD-version som du installerar senare inom en serie som täcks läser in AFDIM utan ominstallation. AutoCAD Mechanical från samma år läser in samma bygge. AutoCAD LT stöds inte eftersom det saknar .NET API. Guidens sida Detected AutoCAD är informativ och har ingen kryssruta för varje version.

Installera medan AutoCAD körs

Detta stöds. Varje version installeras i en egen undermapp, så en AutoCAD-instans som körs låser inga filer som installationsprogrammet skriver. Installationsprogrammet visar en notering och fortsätter. Ingen behöver stänga AutoCAD först. AutoCAD läser in AFDIM nästa gång programmet startas.

Tyst installation

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

Installationsguiden och licensavtalet är på engelska. Sidan AFDIM Help öppnas på vietnamesiska i Windows som är inställt för Vietnam och annars på engelska.

Pluginet har ett eget gränssnittsspråk. En ny installation startar på engelska eller vietnamesiska om Windows är inställt för Vietnam (visningsspråk, regionalt format eller land). Varje användare kan ändra språk med listan med 56 språk i inställningsdialogrutans rubrik. Dialogrutan öppnas med knappen Settings på menyfliken AFDIM. Språket används i dialogrutan, informationsfönstren och kommandoradens meddelanden. Text som ännu inte är översatt visas på engelska. Valet sparas i användarens inställningar.

Växel	Effekt
/VERYSILENT	Inget användargränssnitt. Använd den vid skriptad utrullning.
/SILENT	Endast förloppsfönster, inga guidesidor.
/SUPPRESSMSGBOXES	Visa inte meddelanderutor. Använd tillsammans med /VERYSILENT.
/NORESTART	Starta aldrig om. Installationsprogrammet behöver inte starta om. Ange ändå växeln.
/LOG="C:\path\afdim.log"	Skriv en fullständig installationslogg. Bifoga den till supportärenden om installationen.
/ALLUSERS	Installera för alla användare under %ProgramFiles%. Kräver behörighetshöjning. Registrerar datoromfattningen i state.json, vilket stänger av uppdateringar inifrån programmet.
/CURRENTUSER	Installera för den aktuella användaren. Detta är standard.
/NOAUTOUPDATE	Stäng av uppdateringar inifrån programmet för den här installationen genom att lägga till filen noautoupdate. Om du kör installationsprogrammet igen utan växeln aktiveras uppdateringar på nytt.
/EXCLUDESERIES=<series>	Uteslut bygget som täcker den versionsserien så att AutoCAD-versionerna i serien inte läser in AFDIM. Avgränsa flera serier med kommatecken.
/NOICONS	Skapa inte genvägen på Start-menyn.
/DIR="C:\path"	Åsidosätt installationsmappen. Detta är sällan rätt eftersom AutoCAD endast söker i standardplatserna ApplicationPlugins.

/EXCLUDESERIES tar en versionsserie, inte ett å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. Växeln tar bort hela bygget som täcker serien. Om R23.0 utesluts läses AFDIM inte in i någon AutoCAD-version från 2013 till 2020. Om R24.1 utesluts läses det inte in i någon version från 2021 till 2024. Om R25.0 eller R25.1 utesluts läses det inte in i varken 2025 eller 2026. Installationsprogrammet ignorerar en serie det inte känner till.

Per användare eller alla användare

Säkerhetsavvägningen vid installation per användare

Standardinstallationen placerar plugin-DLL-filen under %APPDATA%. Den inloggade användaren kan skriva till mappen och AutoCAD läser in DLL-filen i sin egen process vid varje start. Ett program som redan körs som samma användare kan skriva över DLL-filen, till exempel skadlig kod eller ett komprometterat tillägg. Koden körs sedan inuti AutoCAD utan fråga och utan behörighetshöjning. Detta gäller alla AutoCAD-plugin som installeras per användare eftersom användaren måste kunna skriva till mappen för att installation utan administratörsrättigheter ska fungera.

Så kan risken minskas:

Åtgärd	Effekt
Installera med /ALLUSERS	DLL-filen finns under %ProgramFiles%, som en standardanvändare inte kan skriva till. Den kräver administratörsrättigheter för att ersätta.
Behåll standardvärdet 1 för SECURELOAD	AutoCAD vägrar .NET-sammansättningar utanför betrodda sökvägar. Det stoppar inte överskrivning av en betrodd fil på plats, men stoppar en ny DLL-fil på en annan plats.
Programkontroll (WDAC eller AppLocker)	Kan blockera en manipulerad DLL. Från 0.1.6 är installationsprogrammet och AFDIM.dll kodsignerade (utgivare TO VAN TIN).
Övervaka paketmappen efter oväntade skrivningar	Inget ska ändra Contents\<version>\ utom installationsprogrammet eller en uppdatering inifrån programmet (Uppdatera nu på fliken Om).

En verkstad som vill placera DLL-filen där endast administratörer kan ändra den bör installera med /ALLUSERS.

Flera arbetsstationer och roamingprofiler

Använd /ALLUSERS i en verkstad med flera arbetsstationer. %APPDATA% följer profilen. Med roamingprofiler eller omdirigerade mappar kopierar en installation per användare pluginet över nätverket vid varje inloggning. Två datorer som är inloggade som samma användare kan också konkurrera om mappen.

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

Kör kommandot med förhöjd behörighet, till exempel från ett startskript i SCCM, Intune eller Grupprincip. Alla användare på datorn får då AFDIM och pluginfilerna finns inte i roamingprofilen. Varje användares inställningar i %APPDATA%\AFDIM följer fortfarande profilen.

Om du måste installera per användare med roamingprofiler undantar du %APPDATA%\Autodesk\ApplicationPlugins från mappomdirigeringen.

Uppdateringar på installationer för hela datorn

En installation för alla användare, även kallad datoromfattande installation, stänger av uppdateringar inifrån programmet eftersom en standardanvändare inte kan skriva till %ProgramFiles%. När AFDIM hittar en nyare version visar gruppen Uppdateringar på fliken Om följande text i stället för Uppdatera nu:

Den här installationen kan inte uppdatera sig själv: den installerades för alla användare, uppdateringar stängdes av vid installationen eller mappen är skrivskyddad.

Distribuera nya versioner på samma sätt som den första. Det är en uppgraderingsmetod som stöds att köra ett nyare installationsprogram ovanpå en befintlig installation. Inställningarna för varje användare och licensen för varje dator behålls. Information om ändringar i varje version finns på sidan Versionsinformation.

En uppdateringskontroll gör en HTTPS-begäran efter det signerade uppdateringsflödet på update.afdim.com. Den blockerar aldrig AutoCAD. AFDIM söker:

• i bakgrunden när AutoCAD startar: högst en gång per 24 timmar efter en lyckad sökning och tidigast 2 timmar efter en misslyckad sökning
• en gång när inställningsdialogrutan öppnas om AFDIM inte har sökt under AutoCAD-sessionen
• när en användare väljer Sök nu på fliken Om

De två första kontrollerna görs endast när Sök automatiskt efter uppdateringar är markerat på fliken Om och miljövariabeln AFDIM_DISABLE_BACKGROUND_SERVICES=1 inte är angiven. Variabeln stänger även av AFDIM-loggfilen och den bakgrundskontroll av licenser som hämtar väntande licensfiler eller förnyelser. Utan loggfil innehåller ett supportpaket ingen logg.

Licenser på datorer som distribuerats

Varje dator behöver en egen licens. Aktivera den i gruppen Licens på fliken Om i inställningsdialogrutan. Med en licensnyckel väljer användaren Ange licensnyckel…. Datorn måste då kunna nå api.afdim.com via HTTPS. Om AutoCAD saknar nätverksåtkomst väljer användaren i stället Begär licens. Begärandekoden som visas skickas via licenssidan. Licensfilen som kommer tillbaka läses in med Läs in licens… i samma grupp. Se Så fungerar licensieringen.

När Windows tillåter det skriver AFDIM även den inlästa licensen till %ProgramData%\AFDIM\license. Då behöver andra Windows-konton på samma dator inte aktivera igen.

Tyst avinstallation

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 registrerar också det tysta kommandot i registervärdet QuietUninstallString under nyckeln Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. Nyckeln finns under HKCU för en installation per användare och under HKLM för en installation för alla användare.

Som standard behåller avinstallationsprogrammet användarens inställningar, så avinstallation och ominstallation kan användas för att reparera. Lägg till /PURGEDATA om du även vill ta bort data:

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

/PURGEDATA tar bort %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM och %TEMP%\AFDIM för kontot som kör avinstallationsprogrammet. Andra Windows-konton behåller sina mappar. Mappen license under %LOCALAPPDATA%\AFDIM behålls alltid. /PURGEDATA tar aldrig bort %ProgramData%\AFDIM\license eller registernyckeln HKCU\Software\AFDIM. Uppdateringscachen tas alltid bort.

Om AutoCAD körs under avinstallationen behåller avinstallationsprogrammet de filer som AutoCAD använder. En interaktiv avinstallation visar ett fönster som säger detta: stäng alla CAD-fönster och kör sedan avinstallationsprogrammet igen. En tyst avinstallation listar dessa filer i sin logg. Ingen omstart begärs. Filer i en mapp vars sökväg har ändrats behålls också. Stäng alla CAD-fönster och försök avinstallera eller installera om igen, eller granska sökvägarna i loggen innan du tar bort något för hand. Inget tas bort vid nästa inloggning.

Kontroll efter distribution

1. Starta AutoCAD. Menyfliken AFDIM visas med två knappar: Dimension och Settings. Dessa två namn är engelska på alla språk.
2. Kör AFDIM. Det fungerar utan NETLOAD. På en dator utan licens öppnas fönstret Välkommen till AFDIM eller AFDIM är inte aktiverat. Båda fönstren visar att pluginet har lästs in.
3. Kontrollera att PackageContents.xml finns i paketmappen och har ett Components-block där SeriesMin och SeriesMax omfattar den installerade AutoCAD-versionen.
4. Kontrollera att state.json visar förväntade värden för activeVersion, channel och installScope.

Om kommandot AFDIM är okänt startar du om AutoCAD en gång eftersom AutoCAD söker efter plugin endast vid start. Om det fortfarande inte fungerar kontrollerar du principen för SECURELOAD och TRUSTEDPATHS. Skicka sedan /LOG-filen och AutoCAD-versionen till supporten.