Deployment

Halaman ini ditujukan bagi petugas yang memasang AFDIM di komputer bengkel. AFDIM menggunakan satu installer Inno Setup, AFDIM_Setup_<version>.exe, dari halaman Unduh. Installer memasang bundle AutoCAD® Autoloader. Tidak ada pendaftaran manual ke AutoCAD: tidak perlu NETLOAD atau pendaftaran COM. AutoCAD memindai folder ApplicationPlugins setiap kali dimulai lalu memuat bundle.

Lokasi pemasangan

Cakupan	Bundle plugin	Uninstaller	Memerlukan hak administrator
Per pengguna (bawaan)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Tidak
Semua pengguna (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Ya

Uninstaller sengaja berada di luar folder bundle karena AutoCAD memindai folder bundle. Instalasi untuk semua pengguna menempatkan uninstaller di %ProgramFiles% agar pengguna biasa tidak dapat menggantinya. Gunakan hanya uninstaller untuk jenis instalasi di tabel. Jangan pernah menjalankan uninstaller dari %ProgramData%, meskipun ada pesan lama yang mengarah ke sana. Jika uninstaller instalasi untuk semua pengguna hilang, jalankan installer resmi dari halaman Unduh dengan /ALLUSERS untuk memperbaiki instalasi tersebut, lalu hapus instalasinya. Installer menolak menginstal di atas instalasi jenis lain. Jalankan uninstaller instalasi per pengguna tanpa hak administrator.

Bundle berisi PackageContents.xml (manifest Autoloader), state.json (versi terpasang, kanal pembaruan, cakupan instalasi), dan folder Contents dengan satu subfolder per versi. Instalasi dengan /NOAUTOUPDATE menambahkan file bernama noautoupdate. Installer juga menambahkan pintasan Start Menu AFDIM › AFDIM Help.

Saat berjalan, AFDIM menulis data berikut. Setiap akun Windows memiliki salinan sendiri, kecuali %ProgramData%\AFDIM\license yang digunakan bersama.

Lokasi	Isi
%APPDATA%\AFDIM	Pengaturan dan standar gambar tersimpan
%LOCALAPPDATA%\AFDIM\logs	Log dukungan
%LOCALAPPDATA%\AFDIM\cache	Unduhan pembaruan
%LOCALAPPDATA%\AFDIM\license	Lisensi akun Windows ini
%ProgramData%\AFDIM\license	Lisensi untuk semua akun di komputer, jika Windows mengizinkan penulisan
HKCU\Software\AFDIM	ID instalasi dan catatan waktu pemeriksaan lisensi
%TEMP%\AFDIM	Ekspor geometri yang dibuat melalui Ekspor geometri proses terakhir… (dialog pengaturan, tab About)

Uninstaller selalu mempertahankan folder lisensi dan kunci registri. Lihat Hapus instalasi.

Kedua cakupan tidak dapat dipasang bersamaan

Installer menolak berjalan jika AFDIM sudah dipasang dengan cakupan lain. AutoCAD memindai kedua lokasi ApplicationPlugins, sehingga kedua salinan akan dimuat. Perintah AFDIM akan terdaftar dua kali dan pembaru dalam aplikasi hanya akan memperbarui satu salinan. Pesan penolakan menyebutkan jalur unins000.exe yang harus dijalankan lebih dahulu. Instalasi senyap tidak menampilkan pesan: proses berhenti tanpa memasang dan alasannya ditulis ke file /LOG.

Rilis AutoCAD yang dicakup

Satu bundle melayani semua komputer. PackageContents.xml mengarahkan setiap seri rilis AutoCAD ke build yang sesuai.

Build	Seri rilis	Tahun AutoCAD	Status
net472	R19.0 hingga R23.1	2013 hingga 2020	Dirilis; 2014 dan 2016 hingga 2018 eksperimental
net48	R24.0 hingga R24.3	2021, 2022, 2023, 2024	Dirilis
net8.0-windows	R25.0 hingga R25.1	2025, 2026	Dirilis
net10.0-windows	R26.0	2027	Dirilis, eksperimental

AutoCAD yang dipasang kemudian dalam seri yang tercakup akan memuat AFDIM tanpa instalasi ulang. AutoCAD Mechanical untuk tahun yang sama memuat build yang sama. AutoCAD LT tidak didukung karena tidak memiliki .NET API. Halaman Detected AutoCAD pada wizard hanya memberikan informasi dan tidak memiliki kotak centang per versi.

Memasang saat AutoCAD berjalan

Cara ini didukung. Setiap versi dipasang pada subfolder sendiri, sehingga AutoCAD yang berjalan tidak mengunci file apa pun yang ditulis installer. Installer menampilkan catatan lalu melanjutkan. Anda tidak perlu meminta pengguna menutup AutoCAD terlebih dahulu. AutoCAD yang sedang berjalan memuat AFDIM saat mulai berikutnya.

Instalasi senyap

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

Wizard installer dan perjanjian lisensinya berbahasa Inggris. Halaman AFDIM Help terbuka dalam bahasa Vietnam pada Windows yang diatur untuk Vietnam, dan bahasa Inggris di pengaturan lainnya.

Plugin memiliki bahasa antarmukanya sendiri. Instalasi baru mulai dalam bahasa Inggris, atau Vietnam jika Windows diatur untuk Vietnam (bahasa tampilan, format regional, atau negara). Setiap pengguna dapat mengganti bahasa melalui daftar 56 bahasa pada header dialog pengaturan. Dialog dibuka melalui tombol Settings pada tab ribbon AFDIM. Bahasa tersebut berlaku untuk dialog, jendela pemberitahuan, dan pesan baris perintah. Teks yang belum diterjemahkan muncul dalam bahasa Inggris. Pilihan disimpan dalam pengaturan pengguna itu.

Switch	Dampak
/VERYSILENT	Tidak menampilkan antarmuka pengguna. Gunakan untuk rollout berskrip.
/SILENT	Hanya menampilkan jendela kemajuan, tanpa halaman wizard.
/SUPPRESSMSGBOXES	Menekan kotak pesan. Gunakan bersama /VERYSILENT.
/NORESTART	Tidak pernah memulai ulang. Installer tidak memerlukan restart, tetapi tetap teruskan switch ini.
/LOG="C:\path\afdim.log"	Menulis log instalasi lengkap. Lampirkan pada permintaan dukungan tentang instalasi.
/ALLUSERS	Memasang untuk semua pengguna di %ProgramFiles%. Memerlukan hak administrator. Mencatat cakupan komputer di state.json, yang menonaktifkan pembaruan dalam aplikasi.
/CURRENTUSER	Memasang untuk pengguna saat ini. Ini adalah pilihan bawaan.
/NOAUTOUPDATE	Menonaktifkan pembaruan dalam aplikasi dengan menambahkan file noautoupdate. Menjalankan installer lagi tanpa switch ini mengaktifkan pembaruan kembali.
/EXCLUDESERIES=<series>	Tidak memasang build untuk seri rilis tersebut agar rilis AutoCAD dalam seri itu tidak memuat AFDIM. Pisahkan beberapa seri dengan koma.
/NOICONS	Tidak membuat pintasan Start Menu.
/DIR="C:\path"	Mengganti folder pemasangan. Ini jarang benar karena AutoCAD hanya memindai lokasi standar ApplicationPlugins.

/EXCLUDESERIES menerima seri rilis, bukan tahun: 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. Switch ini mengecualikan seluruh build yang mencakup seri tersebut. Mengecualikan R23.0 mencegah AFDIM dimuat pada semua AutoCAD 2013 hingga 2020. Mengecualikan R24.1 mencegahnya dimuat pada semua AutoCAD 2021 hingga 2024. Mengecualikan R25.0 atau R25.1 mencegahnya dimuat pada AutoCAD 2025 dan 2026. Installer mengabaikan seri yang tidak dikenal.

Per pengguna atau semua pengguna

Pertimbangan keamanan instalasi per pengguna

Instalasi bawaan menempatkan DLL plugin di %APPDATA%. Pengguna yang masuk dapat menulis ke folder ini dan AutoCAD memuat DLL ke prosesnya sendiri setiap kali mulai. Program apa pun yang sudah berjalan sebagai pengguna itu, misalnya malware atau add-in yang disusupi, dapat mengganti DLL di tempat. Kodenya kemudian berjalan di dalam AutoCAD tanpa prompt dan tanpa hak administrator. Hal ini berlaku untuk semua plugin AutoCAD per pengguna karena pengguna harus dapat menulis ke folder agar instalasi tanpa hak administrator berfungsi.

Cara mengurangi risiko:

Tindakan	Dampak
Pasang dengan /ALLUSERS	DLL berada di %ProgramFiles%, yang tidak dapat ditulis pengguna biasa. Penggantian memerlukan hak administrator.
Pertahankan SECURELOAD pada nilai bawaan 1	AutoCAD menolak assembly .NET dari luar jalur tepercaya. Pengaturan ini tidak mencegah penimpaan file tepercaya di tempatnya, tetapi mencegah DLL baru ditempatkan di lokasi lain.
Kontrol aplikasi (WDAC atau AppLocker)	Dapat memblokir DLL yang diubah. Sejak 0.1.6, installer dan AFDIM.dll sudah ditandatangani (penerbit TO VAN TIN).
Pantau penulisan yang tidak diharapkan ke folder bundle	Tidak ada yang seharusnya mengubah Contents\<version>\ kecuali installer atau pembaruan dalam aplikasi (Update now pada tab About).

Organisasi yang menginginkan DLL di lokasi yang hanya dapat diubah administrator sebaiknya memasang dengan /ALLUSERS.

Banyak komputer dan profil roaming

Gunakan /ALLUSERS untuk bengkel dengan banyak komputer. %APPDATA% mengikuti profil roaming. Dengan profil roaming atau pengalihan folder, instalasi per pengguna menyalin plugin melalui jaringan setiap kali pengguna masuk. Dua komputer yang masuk sebagai pengguna sama juga dapat berebut folder tersebut.

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

Jalankan dari konteks dengan hak administrator, misalnya skrip startup SCCM, Intune, atau Group Policy. Setiap pengguna komputer itu memperoleh AFDIM dan file plugin tidak berada di profil roaming. Pengaturan tiap pengguna di %APPDATA%\AFDIM tetap mengikuti profilnya.

Jika instalasi per pengguna pada profil roaming harus dipertahankan, kecualikan %APPDATA%\Autodesk\ApplicationPlugins dari pengalihan folder.

Pembaruan pada instalasi untuk semua pengguna

Instalasi untuk semua pengguna (disebut juga instalasi tingkat komputer) menonaktifkan pembaruan dalam aplikasi karena pengguna biasa tidak dapat menulis ke %ProgramFiles%. Saat AFDIM menemukan versi baru, grup Updates di tab About menampilkan teks berikut sebagai pengganti Update now:

Pemasangan ini tidak dapat memperbarui dirinya sendiri: dipasang untuk semua pengguna, pembaruan dinonaktifkan saat pemasangan, atau foldernya hanya-baca.

Sebarkan versi baru dengan cara yang sama seperti versi pertama. Menjalankan installer yang lebih baru di atas instalasi yang ada merupakan peningkatan yang didukung. Pengaturan tiap pengguna dan lisensi tiap komputer tetap tersimpan. Perubahan pada setiap versi ada di Catatan rilis.

Pemeriksaan pembaruan membuat satu permintaan HTTPS untuk feed pembaruan bertanda tangan di update.afdim.com. Pemeriksaan tidak menghambat AutoCAD. AFDIM memeriksa:

• di latar belakang saat AutoCAD mulai: paling banyak sekali setiap 24 jam setelah pemeriksaan berhasil, dan tidak lebih cepat dari 2 jam setelah pemeriksaan gagal
• sekali saat dialog pengaturan dibuka jika AFDIM belum memeriksa dalam sesi AutoCAD ini
• saat pengguna memilih Check now pada tab About

Dua pemeriksaan pertama hanya dilakukan saat Periksa pembaruan secara otomatis dicentang pada tab About dan variabel lingkungan AFDIM_DISABLE_BACKGROUND_SERVICES=1 tidak ditetapkan. Menetapkan variabel tersebut juga menonaktifkan file log AFDIM dan pemeriksaan lisensi latar belakang yang mengambil file lisensi atau perpanjangan yang menunggu. Tanpa file log, zip dukungan tidak berisi log.

Lisensi pada komputer yang dikelola

Setiap komputer memerlukan lisensinya sendiri. Aktifkan di grup Licence pada tab About dialog pengaturan. Dengan kunci, pengguna memilih Enter licence key…. Pada saat itu komputer harus dapat mengakses api.afdim.com melalui HTTPS. Jika AutoCAD tidak memiliki akses jaringan, pengguna memilih Request licence. Kode permintaan yang muncul dikirim melalui halaman Lisensi. File lisensi yang diterima dimuat dengan Load licence… pada grup yang sama. Lihat Cara kerja lisensi.

Jika diizinkan Windows, AFDIM juga menulis lisensi yang dimuat ke %ProgramData%\AFDIM\license. Akun Windows lain pada komputer yang sama tidak perlu mengaktifkan lagi.

Penghapusan senyap

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 juga mencatat perintah senyap di nilai QuietUninstallString pada kunci registri Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. Kunci berada di HKCU untuk instalasi per pengguna dan di HKLM untuk instalasi semua pengguna.

Secara bawaan, uninstaller mempertahankan pengaturan pengguna sehingga penghapusan dan pemasangan ulang dapat memperbaiki instalasi. Untuk turut menghapus data, tambahkan /PURGEDATA:

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

/PURGEDATA menghapus %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM, dan %TEMP%\AFDIM milik akun yang menjalankan uninstaller. Akun Windows lain mempertahankan foldernya. Folder license di %LOCALAPPDATA%\AFDIM selalu dipertahankan. /PURGEDATA tidak pernah menghapus %ProgramData%\AFDIM\license atau kunci registri HKCU\Software\AFDIM. Cache pembaruan selalu dihapus.

Jika AutoCAD berjalan selama penghapusan, uninstaller membiarkan file yang sedang digunakan AutoCAD. Penghapusan interaktif menampilkan jendela yang menyatakan hal ini: tutup semua jendela CAD, lalu jalankan uninstaller lagi. Penghapusan senyap mencantumkan file tersebut di lognya. Tidak ada permintaan untuk memulai ulang komputer. File di folder yang jalurnya berubah juga dipertahankan. Tutup semua jendela CAD lalu ulangi penghapusan instalasi atau instal ulang, atau periksa jalur di log sebelum Anda menghapus apa pun secara manual. Tidak ada yang dihapus saat masuk berikutnya.

Pemeriksaan setelah deployment

1. Mulai AutoCAD. Tab ribbon AFDIM muncul dengan 2 tombol, Dimension dan Settings. Kedua nama ini berbahasa Inggris pada semua bahasa.
2. Jalankan AFDIM. Perintah bekerja tanpa NETLOAD. Pada komputer tanpa lisensi, perintah membuka jendela Welcome to AFDIM atau AFDIM belum diaktifkan. Kedua jendela menunjukkan plugin telah dimuat.
3. Pastikan PackageContents.xml ada di folder bundle dan memiliki blok Components dengan SeriesMin dan SeriesMax yang mencakup AutoCAD terpasang.
4. Pastikan state.json menunjukkan activeVersion, channel, dan installScope yang diharapkan.

Jika AFDIM adalah perintah yang tidak dikenal, mulai ulang AutoCAD sekali karena AutoCAD memindai plugin hanya saat mulai. Jika masih gagal, periksa kebijakan SECURELOAD dan TRUSTEDPATHS. Lalu kirim file /LOG dan versi AutoCAD ke Dukungan.