Logo

Instalando o ACBr manualmente

Gladiston Santana - Um site para chamar de meu

Introdução

O ACBr é, indiscutivelmente, a framework de automação comercial mais robusta do ecossistema Pascal. Essencial para softhouses, a suite oferece uma solução completa que abrange desde a gestão bancária (boletos e extratos) até o cumprimento de obrigações governamentais complexas, como a emissão de NF-e, NFS-e e integrações com diversos hardwares fiscais.

Embora o projeto ofereça um instalador (Wizard), usuários de Lazarus frequentemente enfrentam desafios com permissões de administrador, o que pode fragmentar o perfil do desenvolvedor. Além disso, a instalação completa pode tornar a IDE excessivamente pesada. Por isso, a instalação manual é a estratégia ideal para manter um ambiente de desenvolvimento ágil, instalando apenas o necessário para as demandas da sua corporação.

Para conhecer o projeto a fundo, visite: Projeto ACBr Oficial.

Instalando o ACBr manualmente

ASSISTIR VÍDEO NO YOUTUBE

Instalando o TortoiseSVN

O ACBr utiliza Subversion (SVN). O primeiro passo é instalar o cliente para Windows:

1. Baixe e instale o TortoiseSVN.

2. Crie um diretório base, preferencialmente em C:\ACBr.

3. Utilize a URL do repositório Trunk2:
https://svn.code.sf.net/p/acbr/code/trunk2

Configuração de Rede TortoiseSVN

Se estiver em um ambiente corporativo com Proxy, ajuste as configurações em TortoiseSVN -> Settings -> Network:

Ajustes de Proxy no SVN

4. Execute o Checkout na pasta criada e aguarde o download completo dos fontes.

Instalando os pacotes no Lazarus

No diretório C:\ACBr\Doctos, o arquivo "Bem_Vindo_ao_Trunk2.odt" detalha a hierarquia de dependências. Abaixo, organizei uma ordem de instalação prática que funcionou em meus testes. Lembre-se: as linhas em negrito são fundamentais.

  • 1. synapse\laz_synapse.lpk (Apenas compilar)
  • 2. ACBrComum\ACBrComum.lpk
  • 3. ACBrDiversos\ACBrDiversos.lpk
  • 4. PCNComum\PCNComum.lpk (Apenas compilar)
  • 5. ACBrOpenSSL\ACBrOpenSSL.lpk
  • 6. ACBrSerial\ACBrSerial.lpk
  • 7. ACBrTXT\ACBrTXTComum.lpk (Apenas compilar)
    • Opcionais pós-requisito: ACBr_SPED, ACBr_Sintegra, ACBr_PAF, etc.
  • 8. ACBrTCP\ACBrTCP.lpk
  • 9. ACBrTEFD\ACBr_TEFD.lpk
  • 10. ACBrDFe\ACBrDFeComum.lpk (Apenas compilar)
  • 11. ACBrDFe\ACBrDFeReportRL.lpk (Requer Fortes Report)

Instalando no Linux

Para desenvolvedores em ambiente Linux, o processo pode ser automatizado para evitar dificuldades com bibliotecas do sistema (XML, OpenSSL). Desenvolvi um repositório dedicado para isso:

acbr_install_linux no GitHub

Como utilizar:

git clone https://github.com/gladiston/acbr_install_linux.git
cd acbr_install_linux
chmod +x install_acbr.sh
./install_acbr.sh

Atualizações e Manutenção

A atualização via SVN Update é simples, mas requer atenção: sempre que atualizar os fontes, é necessário reconstruir a IDE para que as melhorias e correções entrem em vigor.

SVN Update

No Lazarus, utilize o menu Tools -> Build Lazarus with Profile: IDE ... para a recompilação total.

Build Lazarus

Conclusão

Dominar a instalação manual do ACBr é um rito de passagem para qualquer desenvolvedor que pretenda atuar com seriedade no mercado de automação comercial brasileiro. Embora a curva de aprendizado inicial pareça íngreme e a hierarquia de pacotes um tanto complexa, o resultado é um ambiente de trabalho personalizado, leve e extremamente estável.

O ACBr não é apenas um conjunto de componentes; é o coração da operação de milhares de empresas, e saber gerenciá-lo com precisão é um diferencial técnico indispensável.