Implantação

Esta página é para quem instala o AFDIM nos computadores de uma oficina. O AFDIM é distribuído em um instalador Inno Setup, AFDIM_Setup_<version>.exe, disponível na página Download. Ele instala um pacote AutoCAD® Autoloader. Não é necessário registrar nada manualmente no AutoCAD: não use NETLOAD nem registro COM. O AutoCAD verifica suas pastas ApplicationPlugins a cada inicialização e carrega o pacote.

Locais da instalação

Escopo	Pacote do plug-in	Desinstalador	Exige elevação
Por usuário (padrão)	%APPDATA%\Autodesk\ApplicationPlugins\AFDIM.bundle	%APPDATA%\AFDIM\uninstall\unins000.exe	Não
Todos os usuários (/ALLUSERS)	%ProgramFiles%\Autodesk\ApplicationPlugins\AFDIM.bundle	%ProgramFiles%\AFDIM\uninstall\unins000.exe	Sim

O desinstalador fica fora da pasta do pacote porque o AutoCAD verifica essa pasta. Em uma instalação para todos os usuários, ele fica em %ProgramFiles% para impedir que um usuário padrão o substitua. Use somente o desinstalador do tipo de instalação da tabela. Nunca execute um desinstalador a partir de %ProgramData%, mesmo que uma mensagem antiga aponte para lá. Se o desinstalador de uma instalação para todos os usuários estiver faltando, execute o instalador oficial da página Download com /ALLUSERS para reparar essa instalação e depois desinstale-a. O instalador se recusa a instalar sobre uma instalação do outro tipo. Execute o desinstalador de uma instalação por usuário sem direitos de administrador.

O pacote contém PackageContents.xml (o manifesto do Autoloader), state.json (versão instalada, canal de atualização e escopo da instalação) e uma pasta Contents com uma subpasta por versão. Uma instalação com /NOAUTOUPDATE inclui um arquivo chamado noautoupdate. O instalador também cria o atalho do menu Iniciar AFDIM › AFDIM Help.

Durante a execução, o AFDIM grava os itens abaixo. Cada conta do Windows tem sua própria cópia, exceto %ProgramData%\AFDIM\license, compartilhada por todas as contas.

Local	Conteúdo
%APPDATA%\AFDIM	Configurações e normas de desenho salvas
%LOCALAPPDATA%\AFDIM\logs	Log de suporte
%LOCALAPPDATA%\AFDIM\cache	Downloads de atualizações
%LOCALAPPDATA%\AFDIM\license	Licença desta conta do Windows
%ProgramData%\AFDIM\license	Licença para todas as contas do computador, quando o Windows permite a gravação
HKCU\Software\AFDIM	ID da instalação e registro de horário da verificação da licença
%TEMP%\AFDIM	Exportações de geometria criadas com Exportar a geometria da última execução… (configurações, guia Sobre)

O desinstalador sempre mantém as pastas da licença e a chave do registro. Consulte Desinstalação.

Os dois escopos não podem coexistir

O instalador se recusa a executar quando o AFDIM já está instalado no outro escopo. O AutoCAD verifica as duas pastas ApplicationPlugins, então as duas cópias seriam carregadas. O comando AFDIM seria registrado duas vezes, e o atualizador interno atualizaria apenas uma cópia. A mensagem de recusa informa o caminho exato de unins000.exe que deve ser executado primeiro. Uma instalação silenciosa não mostra mensagem: ela é interrompida sem instalar e grava o motivo no arquivo /LOG.

Versões do AutoCAD atendidas

Um único pacote atende a todas as estações. PackageContents.xml direciona cada série de versões do AutoCAD para a compilação correspondente.

Compilação	Série	Anos do AutoCAD	Status
net472	R19.0 a R23.1	2013 a 2020	Distribuída; 2014 e 2016 a 2018 experimentais
net48	R24.0 a R24.3	2021, 2022, 2023 e 2024	Distribuída
net8.0-windows	R25.0 a R25.1	2025 e 2026	Distribuída
net10.0-windows	R26.0	2027	Distribuída, experimental

Uma versão do AutoCAD instalada posteriormente dentro de uma série atendida carrega o AFDIM sem reinstalação. O AutoCAD Mechanical dos mesmos anos carrega a mesma compilação. O AutoCAD LT não é compatível porque não tem API .NET. A página Detected AutoCAD do assistente é apenas informativa. Ela não tem uma caixa para cada versão.

Instalar com o AutoCAD em execução

Esse cenário é compatível. Cada versão é instalada em sua própria subpasta, portanto o AutoCAD em execução não bloqueia os arquivos gravados pelo instalador. O instalador mostra um aviso e continua. Não é necessário fechar o AutoCAD antes. O AutoCAD em execução carregará o AFDIM na próxima inicialização.

Instalação silenciosa

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

O assistente e o contrato de licença do instalador estão em inglês. A página AFDIM Help abre em vietnamita em um Windows configurado para o Vietnã e em inglês nos demais casos.

O plug-in tem seu próprio idioma de interface. Uma instalação nova começa em inglês ou vietnamita quando o Windows está configurado para o Vietnã (idioma de exibição, formato regional ou país). Cada usuário pode alterar o idioma usando a lista suspensa de 56 idiomas no cabeçalho da caixa de diálogo de configurações. Essa caixa é aberta pelo botão Settings na guia AFDIM da ribbon. O idioma se aplica à caixa de diálogo, às janelas de aviso e às mensagens da linha de comando. O texto ainda não traduzido aparece em inglês. A escolha fica salva nas configurações daquele usuário.

Opção	Efeito
/VERYSILENT	Sem interface. Use em uma distribuição por script.
/SILENT	Mostra apenas uma janela de progresso, sem páginas do assistente.
/SUPPRESSMSGBOXES	Suprime caixas de mensagem. Use junto com /VERYSILENT.
/NORESTART	Nunca reinicia o computador. O instalador não precisa reiniciar. Mesmo assim, informe a opção.
/LOG="C:\path\afdim.log"	Grava um log completo da instalação. Anexe-o a solicitações de suporte sobre a instalação.
/ALLUSERS	Instala para todos os usuários em %ProgramFiles%. Exige elevação. Registra o escopo da máquina em state.json, o que desativa as atualizações internas.
/CURRENTUSER	Instala para o usuário atual. Esse é o padrão.
/NOAUTOUPDATE	Desativa atualizações internas nesta instalação criando o arquivo noautoupdate. Execute o instalador novamente sem a opção para reativá-las.
/EXCLUDESERIES=<series>	Exclui a compilação que atende à série, impedindo que o AFDIM seja carregado nessas versões do AutoCAD. Separe várias séries por vírgulas.
/NOICONS	Não cria o atalho no menu Iniciar.
/DIR="C:\path"	Substitui a pasta de instalação. Isso raramente é correto porque o AutoCAD verifica somente os locais padrão de ApplicationPlugins.

/EXCLUDESERIES recebe uma série, não um ano: 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 e 2027 = R26.0. A opção remove toda a compilação que atende à série. Excluir R23.0 impede o carregamento em todas as versões do AutoCAD entre 2013 e 2020. Excluir R24.1 impede o carregamento em todas as versões entre 2021 e 2024. Excluir R25.0 ou R25.1 impede o carregamento em 2025 e 2026. O instalador ignora séries desconhecidas.

Por usuário ou para todos os usuários

Implicações de segurança da instalação por usuário

A instalação padrão coloca a DLL do plug-in em %APPDATA%. O usuário conectado pode gravar nessa pasta, e o AutoCAD carrega a DLL no próprio processo a cada inicialização. Qualquer programa que já esteja em execução como esse usuário pode substituir a DLL, por exemplo, um malware ou um complemento comprometido. A partir daí, o código é executado dentro do AutoCAD sem aviso nem elevação. Isso se aplica a qualquer plug-in do AutoCAD instalado por usuário, pois a gravação pelo usuário é necessária para que a instalação não exija direitos de administrador.

O que reduz o risco:

Medida	Efeito
Instalar com /ALLUSERS	A DLL fica em %ProgramFiles%, onde um usuário padrão não pode gravar. Substituí-la exige direitos de administrador.
Manter SECURELOAD no padrão 1	O AutoCAD recusa assemblies .NET fora dos caminhos confiáveis. Isso não impede a substituição de um arquivo confiável no local, mas impede que uma nova DLL seja colocada em outro local.
Controle de aplicativos (WDAC ou AppLocker)	Pode bloquear uma DLL adulterada. A partir da versão 0.1.6, o instalador e o AFDIM.dll têm assinatura de código (editor TO VAN TIN).
Monitorar gravações inesperadas na pasta do pacote	Nada deve modificar Contents\\<version>\\, exceto o instalador ou uma atualização interna (Atualizar agora na guia Sobre).

Uma oficina que precisa manter a DLL em um local modificável somente por administradores deve instalar com /ALLUSERS.

Várias estações e perfis móveis

Use /ALLUSERS em uma oficina com várias estações. %APPDATA% é sincronizada. Com perfis móveis ou redirecionamento de pastas, uma instalação por usuário copia o plug-in pela rede a cada entrada. Dois computadores conectados como o mesmo usuário também podem disputar essa pasta.

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

Execute em um contexto elevado, por exemplo, em um script de inicialização do SCCM, Intune ou Diretiva de Grupo. Assim, todos os usuários do computador recebem o AFDIM e os arquivos do plug-in não ficam no perfil móvel. As configurações de cada usuário em %APPDATA%\AFDIM continuam acompanhando o perfil.

Se precisar manter a instalação por usuário em perfis móveis, exclua %APPDATA%\Autodesk\ApplicationPlugins do redirecionamento de pastas.

Atualizações em instalações para toda a máquina

Uma instalação para todos os usuários, também chamada de instalação para toda a máquina, desativa as atualizações internas porque um usuário padrão não pode gravar em %ProgramFiles%. Quando o AFDIM encontra uma versão mais recente, o grupo Atualizações na guia Sobre mostra o texto abaixo em vez de Atualizar agora:

Esta instalação não pode se atualizar automaticamente: foi instalada para todos os usuários, as atualizações foram desativadas durante a instalação ou a pasta é somente leitura.

Distribua as novas versões da mesma forma que a primeira. Executar um instalador mais recente sobre uma instalação existente é uma atualização compatível. As configurações de cada usuário e a licença de cada computador são mantidas. Consulte as mudanças por versão na página Notas de versão.

A verificação de atualizações faz uma solicitação HTTPS ao feed assinado em update.afdim.com. Ela nunca bloqueia o AutoCAD. O AFDIM verifica:

• em segundo plano ao iniciar o AutoCAD: no máximo uma vez a cada 24 horas após uma verificação bem-sucedida e não antes de 2 horas após uma falha;
• uma vez ao abrir a caixa de diálogo de configurações, se ainda não verificou nesta sessão do AutoCAD;
• quando o usuário escolhe Verificar agora na guia Sobre.

As duas primeiras verificações só acontecem quando Verificar atualizações automaticamente está marcado na guia Sobre e a variável de ambiente AFDIM_DISABLE_BACKGROUND_SERVICES=1 não está definida. Essa variável também desativa o arquivo de log do AFDIM e a verificação de licença em segundo plano, que obtém uma licença pendente ou uma renovação. Sem o arquivo de log, o pacote de suporte não contém um log.

Licenças nos computadores implantados

Cada computador precisa da própria licença. Ative-a no grupo Licença da guia Sobre das configurações. Com uma chave de licença, o usuário escolhe Inserir chave de licença…. Nesse momento, o computador precisa acessar api.afdim.com por HTTPS. Se o AutoCAD não tiver acesso à rede, o usuário escolhe Solicitar licença. O código de solicitação exibido é enviado pela página de licenças. O arquivo de licença recebido é carregado com Carregar licença… no mesmo grupo. Consulte Como funciona o licenciamento.

Quando o Windows permite, o AFDIM também grava a licença carregada em %ProgramData%\AFDIM\license. Assim, as outras contas do Windows no computador não precisam ativar novamente.

Desinstalação silenciosa

rem instalação por usuário (padrão)
"%APPDATA%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

rem instalação para todos os usuários, em um contexto elevado
"%ProgramFiles%\AFDIM\uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

O Inno Setup também registra o comando silencioso no valor QuietUninstallString da chave do Registro Software\Microsoft\Windows\CurrentVersion\Uninstall\{04AC9D3E-F942-4408-8BBC-73CB09043772}_is1. A chave fica em HKCU para uma instalação por usuário e em HKLM para uma instalação para todos.

Por padrão, o desinstalador mantém as configurações do usuário, permitindo usar desinstalação e reinstalação como reparo. Para excluir também os dados, adicione /PURGEDATA:

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

/PURGEDATA exclui %APPDATA%\AFDIM, %LOCALAPPDATA%\AFDIM e %TEMP%\AFDIM da conta que executa o desinstalador. As demais contas do Windows mantêm suas pastas. Dentro de %LOCALAPPDATA%\AFDIM, a pasta license é sempre mantida. /PURGEDATA nunca exclui %ProgramData%\AFDIM\license nem a chave do Registro HKCU\Software\AFDIM. O cache de atualizações é sempre removido.

Se o AutoCAD estiver em execução durante a desinstalação, o desinstalador mantém os arquivos em uso pelo AutoCAD. Uma desinstalação interativa mostra uma janela informando isso: feche todas as janelas do CAD e execute o desinstalador novamente. Uma desinstalação silenciosa lista esses arquivos no log. Não é necessário reiniciar. Arquivos em uma pasta cujo caminho mudou também são mantidos. Feche todas as janelas de CAD e tente de novo a desinstalação ou a reinstalação, ou confira os caminhos no log antes de excluir qualquer coisa manualmente. Nada é excluído no próximo login.

Verificação após a implantação

1. Inicie o AutoCAD. A guia AFDIM da ribbon aparece com dois botões: Dimension e Settings. Esses dois nomes permanecem em inglês em todos os idiomas.
2. Execute AFDIM. O comando funciona sem NETLOAD. Em um computador sem licença, abre a janela Bem-vindo ao AFDIM ou AFDIM não está ativado. As duas janelas confirmam que o plug-in foi carregado.
3. Confira se PackageContents.xml existe na pasta do pacote e contém um bloco Components cujos valores SeriesMin e SeriesMax abrangem a versão instalada do AutoCAD.
4. Confira se state.json mostra os valores esperados em activeVersion, channel e installScope.

Se AFDIM for um comando desconhecido, reinicie o AutoCAD uma vez, pois ele só procura plug-ins na inicialização. Se o problema continuar, confira as políticas SECURELOAD e TRUSTEDPATHS. Depois, envie o arquivo /LOG e a versão do AutoCAD ao Suporte.