Wdrażanie

Ta strona jest przeznaczona dla osób instalujących AFDIM na komputerach w zakładzie. AFDIM jest instalowany jednym instalatorem Inno Setup AFDIM_Setup_<version>.exe ze strony Pobieranie. Instalator dodaje pakiet AutoCAD® Autoloader. Nie trzeba ręcznie rejestrować niczego w AutoCAD: nie używa się NETLOAD ani rejestracji COM. AutoCAD skanuje foldery ApplicationPlugins podczas każdego uruchomienia i ładuje pakiet.

Co i gdzie jest instalowane

Zakres	Pakiet dodatku	Dezinstalator	Wymaga podwyższonych uprawnień
Dla użytkownika (domyślnie)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Nie
Dla wszystkich użytkowników (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Tak

Dezinstalator celowo znajduje się poza folderem pakietu, ponieważ AutoCAD skanuje ten folder. Instalacja dla wszystkich użytkowników przechowuje dezinstalator w %ProgramFiles%, aby standardowy użytkownik nie mógł go zastąpić. Używaj tylko dezinstalatora rodzaju instalacji z tabeli. Nigdy nie uruchamiaj dezinstalatora z %ProgramData%, nawet jeśli wskazuje tam stary komunikat. Jeśli brakuje dezinstalatora instalacji dla wszystkich użytkowników, uruchom oficjalny instalator ze strony Pobierz z /ALLUSERS, aby naprawić tę instalację, a potem ją odinstaluj. Instalator odmawia instalacji na instalacji innego rodzaju. Dezinstalator instalacji dla jednego użytkownika uruchamiaj bez uprawnień administratora.

Pakiet zawiera PackageContents.xml (manifest Autoloadera), state.json (zainstalowana wersja, kanał aktualizacji i zakres instalacji) oraz folder Contents z podfolderem dla każdej wersji. Instalacja z parametrem /NOAUTOUPDATE dodaje plik noautoupdate. Instalator dodaje też skrót do menu Start: AFDIM › AFDIM Help.

Podczas działania AFDIM zapisuje poniższe dane. Każde konto Windows ma własną kopię, z wyjątkiem %ProgramData%\AFDIM\license, z którego korzystają wszystkie konta.

Lokalizacja	Zawartość
%APPDATA%\AFDIM	Ustawienia i zapisane normy rysunkowe
%LOCALAPPDATA%\AFDIM\logs	Dziennik pomocy technicznej
%LOCALAPPDATA%\AFDIM\cache	Pobrane aktualizacje
%LOCALAPPDATA%\AFDIM\license	Licencja tego konta Windows
%ProgramData%\AFDIM\license	Licencja dla wszystkich kont na komputerze, jeśli Windows zezwala na zapis
HKCU\Software\AFDIM	Identyfikator instalacji i zapis czasu sprawdzenia licencji
%TEMP%\AFDIM	Eksporty geometrii tworzone opcją Eksportuj geometrię z ostatniego uruchomienia… (okno ustawień, karta Informacje)

Dezinstalator zawsze zachowuje foldery licencji i klucz rejestru. Zobacz Odinstalowanie.

Nie można łączyć obu zakresów

Instalator odmawia działania, jeśli AFDIM jest już zainstalowany w drugim zakresie. AutoCAD skanuje oba foldery ApplicationPlugins, więc załadowałby obie kopie. Polecenie AFDIM zostałoby zarejestrowane 2 razy, a aktualizator w aplikacji uaktualniłby tylko jedną kopię. Komunikat odmowy podaje dokładny plik unins000.exe, który trzeba najpierw uruchomić. Instalacja cicha nie wyświetla komunikatu: zatrzymuje się bez instalowania i zapisuje przyczynę w pliku /LOG.

Obsługiwane wydania AutoCAD

Jeden pakiet obsługuje wszystkie stanowiska. Plik PackageContents.xml kieruje każdą serię wydań AutoCAD do odpowiedniej kompilacji.

Kompilacja	Seria wydań	Roczniki AutoCAD	Stan
net472	od R19.0 do R23.1	od 2013 do 2020	Wydana; wersje 2014 oraz od 2016 do 2018 są eksperymentalne
net48	od R24.0 do R24.3	2021, 2022, 2023, 2024	Wydana
net8.0-windows	od R25.0 do R25.1	2025, 2026	Wydana
net10.0-windows	R26.0	2027	Wydana, eksperymentalna

Później zainstalowany AutoCAD z obsługiwanej serii załaduje AFDIM bez ponownej instalacji. AutoCAD Mechanical z tych samych roczników ładuje tę samą kompilację. AutoCAD LT nie jest obsługiwany, ponieważ nie ma interfejsu API .NET. Strona Detected AutoCAD kreatora ma charakter informacyjny i nie zawiera pola wyboru dla każdej wersji.

Instalacja przy działającym AutoCAD

Jest obsługiwana. Każda wersja jest instalowana we własnym podfolderze, więc działający AutoCAD nie blokuje plików zapisywanych przez instalator. Instalator wyświetla informację i kontynuuje działanie. Nie wymaga wcześniejszego zamknięcia AutoCAD. Działający AutoCAD załaduje AFDIM przy następnym uruchomieniu.

Instalacja cicha

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

Kreator instalacji i umowa licencyjna są w języku angielskim. Strona AFDIM Help otwiera się po wietnamsku w systemie Windows skonfigurowanym dla Wietnamu, a w innych przypadkach po angielsku.

Dodatek ma własny język interfejsu. Nowa instalacja uruchamia się po angielsku albo po wietnamsku, gdy system Windows jest skonfigurowany dla Wietnamu (język wyświetlania, format regionalny lub kraj). Każdy użytkownik może zmienić język, wybierając go z listy 56 języków w nagłówku okna ustawień. Okno otwiera przycisk Settings na karcie wstążki AFDIM. Wybrany język dotyczy okna, powiadomień i komunikatów wiersza poleceń. Nieprzetłumaczony tekst pozostaje po angielsku. Wybór jest zapisywany w ustawieniach danego użytkownika.

Parametr	Działanie
/VERYSILENT	Brak interfejsu użytkownika. Użyj przy wdrożeniu skryptowym.
/SILENT	Tylko okno postępu, bez stron kreatora.
/SUPPRESSMSGBOXES	Ukrywa okna komunikatów. Używaj razem z /VERYSILENT.
/NORESTART	Nigdy nie uruchamia ponownie komputera. Instalator nie wymaga restartu, ale mimo to podaj ten parametr.
/LOG="C:\path\afdim.log"	Zapisuje pełny dziennik instalacji. Dołącz go do zgłoszenia dotyczącego instalacji.
/ALLUSERS	Instaluje dodatek dla wszystkich użytkowników w %ProgramFiles%. Wymaga podwyższonych uprawnień. Zapisuje zakres komputera w state.json, co wyłącza aktualizacje w aplikacji.
/CURRENTUSER	Instaluje dodatek dla bieżącego użytkownika. Jest to ustawienie domyślne.
/NOAUTOUPDATE	Wyłącza aktualizacje w aplikacji dla tej instalacji, dodając plik noautoupdate. Ponowne uruchomienie instalatora bez tego parametru włącza aktualizacje.
/EXCLUDESERIES=<series>	Pomija kompilację obsługującą daną serię wydań, aby wersje AutoCAD z tej serii nie ładowały AFDIM. Oddziel kilka serii przecinkami.
/NOICONS	Nie tworzy skrótu w menu Start.
/DIR="C:\path"	Zmienia folder instalacji. Rzadko jest to właściwe, ponieważ AutoCAD skanuje tylko standardowe lokalizacje ApplicationPlugins.

Parametr /EXCLUDESERIES przyjmuje serię wydań, a nie rocznik: 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. Parametr pomija całą kompilację obejmującą daną serię. Pominięcie R23.0 zatrzymuje ładowanie AFDIM we wszystkich wersjach AutoCAD od 2013 do 2020. Pominięcie R24.1 zatrzymuje je we wszystkich wersjach AutoCAD od 2021 do 2024. Pominięcie R25.0 lub R25.1 zatrzymuje je w wersjach 2025 i 2026. Instalator ignoruje nieznaną serię.

Instalacja dla jednego lub wszystkich użytkowników

Ryzyko bezpieczeństwa instalacji dla jednego użytkownika

Instalacja domyślna umieszcza bibliotekę DLL dodatku w %APPDATA%. Zalogowany użytkownik może zapisywać w tym folderze, a AutoCAD ładuje z niego bibliotekę DLL do własnego procesu podczas każdego uruchomienia. Każdy program działający już w kontekście tego użytkownika może zastąpić bibliotekę DLL, na przykład złośliwe oprogramowanie lub naruszony dodatek. Od tego momentu jego kod działa w AutoCAD bez ostrzeżenia i bez podwyższonych uprawnień. Dotyczy to każdego dodatku AutoCAD instalowanego dla jednego użytkownika, ponieważ użytkownik musi mieć możliwość zapisu w folderze, aby instalacja bez uprawnień administratora działała.

Co ogranicza ryzyko:

Środek	Działanie
Instalacja z /ALLUSERS	Biblioteka DLL znajduje się w %ProgramFiles%, do którego standardowy użytkownik nie może zapisywać. Zastąpienie pliku wymaga uprawnień administratora.
Pozostawienie domyślnej wartości SECURELOAD równej 1	AutoCAD odrzuca zestawy .NET spoza zaufanych ścieżek. Nie zapobiega zastąpieniu pliku w zaufanej lokalizacji, ale blokuje nową bibliotekę DLL zapisaną gdzie indziej.
Kontrola aplikacji (WDAC lub AppLocker)	Może blokować zmodyfikowaną bibliotekę DLL. Od wersji 0.1.6 instalator i AFDIM.dll są podpisane cyfrowo (wydawca TO VAN TIN).
Monitorowanie folderu pakietu pod kątem nieoczekiwanych zapisów	Folder Contents\<version>\ powinien być zmieniany tylko przez instalator lub aktualizację w aplikacji (Aktualizuj teraz na karcie Informacje).

Zakład, który chce umieścić bibliotekę DLL w lokalizacji zmienianej wyłącznie przez administratorów, powinien użyć parametru /ALLUSERS.

Wiele stanowisk i profile mobilne

Użyj /ALLUSERS w zakładzie z wieloma stanowiskami. %APPDATA% jest synchronizowane. Przy profilach mobilnych lub przekierowaniu folderów instalacja dla jednego użytkownika kopiuje dodatek przez sieć podczas każdego logowania. Dwa komputery zalogowane jako ten sam użytkownik mogą też jednocześnie uzyskiwać dostęp do folderu.

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

Uruchom polecenie z podwyższonymi uprawnieniami, na przykład ze skryptu startowego SCCM, Intune lub zasad grupy. Każdy użytkownik komputera otrzyma wtedy AFDIM, a pliki dodatku nie będą częścią profilu mobilnego. Ustawienia każdego użytkownika w %APPDATA%\AFDIM nadal będą podążać za profilem.

Jeśli instalacja musi pozostać przypisana do użytkownika w profilu mobilnym, wyklucz %APPDATA%\Autodesk\ApplicationPlugins z przekierowania folderów.

Aktualizacje instalacji dla całego komputera

Instalacja dla wszystkich użytkowników, zwana też instalacją dla całego komputera, wyłącza aktualizacje w aplikacji, ponieważ standardowy użytkownik nie może zapisywać w %ProgramFiles%. Gdy AFDIM znajdzie nowszą wersję, grupa Aktualizacje na karcie Informacje wyświetli poniższy tekst zamiast Aktualizuj teraz:

Ta instalacja nie może zaktualizować się samodzielnie: została zainstalowana dla wszystkich użytkowników, aktualizacje wyłączono podczas instalacji albo folder jest tylko do odczytu.

Rozpowszechniaj nowe wersje tak samo jak pierwszą. Uruchomienie nowszego instalatora na istniejącej instalacji jest obsługiwanym uaktualnieniem. Zachowuje ustawienia każdego użytkownika i licencję każdego komputera. Informacje o zmianach w poszczególnych wersjach znajdują się na stronie Informacje o wydaniach.

Sprawdzanie aktualizacji to jedno żądanie HTTPS do podpisanego źródła aktualizacji w update.afdim.com. Nigdy nie blokuje AutoCAD. AFDIM sprawdza aktualizacje:

• w tle po uruchomieniu AutoCAD: najwyżej raz na 24 godziny po pomyślnym sprawdzeniu i nie wcześniej niż 2 godziny po nieudanym
• raz po otwarciu okna ustawień, jeśli AFDIM nie sprawdzał jeszcze aktualizacji w tej sesji AutoCAD
• po kliknięciu Sprawdź teraz na karcie Informacje

Pierwsze 2 sprawdzenia są wykonywane tylko wtedy, gdy na karcie Informacje zaznaczono Automatycznie sprawdzaj dostępność aktualizacji i nie ustawiono zmiennej środowiskowej AFDIM_DISABLE_BACKGROUND_SERVICES=1. Ustawienie tej zmiennej wyłącza również plik dziennika AFDIM i sprawdzanie licencji w tle, które pobiera oczekujący plik licencji lub odnowienie. Bez pliku dziennika archiwum pomocy technicznej nie będzie zawierać dziennika.

Licencje na wdrożonych komputerach

Każdy komputer potrzebuje własnej licencji. Aktywuj ją w grupie Licencja na karcie Informacje w oknie ustawień. W przypadku klucza licencyjnego użytkownik wybiera Wprowadź klucz licencyjny…. W tym momencie komputer musi połączyć się przez HTTPS z api.afdim.com. Jeśli AutoCAD nie ma dostępu do sieci, użytkownik wybiera Poproś o licencję. Wyświetlony kod żądania należy wysłać przez stronę licencji. Otrzymany plik licencji ładuje się przyciskiem Wczytaj licencję… w tej samej grupie. Zobacz Jak działa licencjonowanie.

Jeśli system Windows na to pozwala, AFDIM zapisuje też wczytaną licencję w %ProgramData%\AFDIM\license. Inne konta Windows na tym samym komputerze nie muszą wtedy ponownie aktywować licencji.

Cicha dezinstalacja

rem instalacja dla jednego użytkownika (domyślnie)
"%APPDATA%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

rem instalacja dla wszystkich użytkowników, z podwyższonymi uprawnieniami
"%ProgramFiles%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

Inno Setup zapisuje też polecenie cichej dezinstalacji w wartości QuietUninstallString klucza rejestru Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. Klucz znajduje się w HKCU dla instalacji dla jednego użytkownika i w HKLM dla instalacji dla wszystkich użytkowników.

Domyślnie dezinstalator zachowuje ustawienia użytkownika, dzięki czemu odinstalowanie i ponowna instalacja mogą działać jak naprawa. Aby usunąć również dane, dodaj /PURGEDATA:

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

/PURGEDATA usuwa foldery %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM i %TEMP%\AFDIM konta, które uruchamia dezinstalator. Foldery innych kont Windows pozostają. Wewnątrz %LOCALAPPDATA%\AFDIM folder license zawsze zostaje zachowany. /PURGEDATA nigdy nie usuwa %ProgramData%\AFDIM\license ani klucza rejestru HKCU\Software\AFDIM. Pamięć podręczna aktualizacji jest zawsze usuwana.

Jeśli AutoCAD działa podczas dezinstalacji, dezinstalator zachowuje pliki używane przez AutoCAD. Dezinstalacja interaktywna wyświetla okno z taką informacją: zamknij wszystkie okna CAD, a następnie uruchom dezinstalator ponownie. Dezinstalacja cicha wypisuje te pliki w dzienniku. Ponowne uruchomienie komputera nie jest wymagane. Pliki w folderze, którego ścieżka się zmieniła, również zostają. Zamknij wszystkie okna CAD i ponów dezinstalację lub ponowną instalację albo przejrzyj ścieżki w dzienniku, zanim cokolwiek usuniesz ręcznie. Przy następnym logowaniu nic nie jest usuwane.

Kontrola po wdrożeniu

1. Uruchom AutoCAD. Pojawi się karta wstążki AFDIM z 2 przyciskami: Dimension i Settings. Te 2 nazwy są zawsze po angielsku.
2. Uruchom AFDIM. Działa bez NETLOAD. Na komputerze bez licencji otworzy się okno Welcome to AFDIM albo AFDIM nie jest aktywowany. Każde z tych okien potwierdza, że dodatek został załadowany.
3. Sprawdź, czy w folderze pakietu istnieje PackageContents.xml i zawiera blok Components, którego SeriesMin i SeriesMax obejmują zainstalowany AutoCAD.
4. Sprawdź, czy state.json zawiera oczekiwane wartości activeVersion, channel i installScope.

Jeśli AutoCAD nie rozpoznaje polecenia AFDIM, uruchom go ponownie, ponieważ wyszukuje dodatki tylko podczas startu. Jeśli problem nadal występuje, sprawdź zasady SECURELOAD i TRUSTEDPATHS. Następnie wyślij plik /LOG i wersję AutoCAD do pomocy technicznej.