Um instalador padrão tem como objetivo facilitar a implantação do sistema, eliminando a necessidade de configurações manuais, apontamentos ou execução de parametrizações básicas.
Com ele, você conta com um processo padronizado, simples e eficiente, garantindo uma instalação rápida e sem complicações.
A seguir, estão a documentação e os detalhes do instalador.
Requisitos
- Inno Setup
Criador de instaladores baseado em scripts. Download: https://jrsoftware.org/isdl.php/Inno-Setup-Downloads
- Inno Script Studio
Interface gráfica para edição de scripts do Inno Setup. É com ele que você poderá alterar e atualizar o instalador. Download: https://www.kymoto.org/products/inno-script-studio/downloads
Arquivos de Personalização
- login.png (450x450)
Imagem exibida na tela de login do sistema. Pode ser um usuário padrão (como o homem azul do Up) ou a logo da sua empresa.
- logopequena.png
Exibida no dashboard do sistema.
- logo.png (1412x1050)
Imagem principal da marca da revenda. Preferencialmente com fundo transparente. Aparece quando o dashboard está fechado.
- carregando.png (1200x535)
Exibida antes da tela de login. Recomenda-se usar uma mensagem como “Estamos carregando, aguarde”. Também é possível utilizar um GIF animado.
- pdv.png (735x466)
Imagem exibida no modo balcão do PDV e quando o produto não possui foto. Excelente ponto para inserir a marca da revenda.
- pdv.ico
Ícone utilizado na área de trabalho para o PDV.
- icone.ico
Ícone utilizado na área de trabalho para o ERP.
- normal.bmp
Imagem exibida na lateral do instalador durante o processo de instalação.
- small.bmp / favicon.ico
Ícones do instalador exibidos durante a instalação.
- sem_foto.png
Utilizada no PDV moderno quando o produto não possui imagem.
- fundopdv.png (945x591)
Fundo das telas PDV e PDV Super. Recomenda-se utilizar uma faixa superior com a marca da revenda ou um fundo neutro.
- auxiliares.ico
Ícone da pasta “Auxiliares”, criada pelo instalador (caso utilizada).
- licenca.rtf
Arquivo de licença de uso do software. Deve ser personalizado com os dados da empresa.
- infoafter.rtf
Mensagem exibida ao final da instalação.
Estrutura do Instalador
- bin
Pasta de saída do instalador compilado (executável final).
- dlls
Armazena as DLLs que serão distribuídas para as pastas do sistema.
- executaveis
Contém as aplicações utilizadas pelo sistema CódigoUP. Quando houver uma nova versão, basta substituir o arquivo nesta pasta.
- firebird
Armazena o banco de dados padrão e o banco do PDV offline. O instalador utiliza sempre o Firebird 5.0. Para alterar o banco padrão, substitua o arquivo DADOS.FDB. No caso do PDV OFF, utilize PDV OFF\DADOS.FDB.
- fix_erp_dlls
Contém DLLs e scripts utilizados para correção de registros no Windows.
- ini
Arquivos INI utilizados pelo sistema. São auto configuráveis de acordo com a instalação.
- outros
Armazena instaladores auxiliares como Aquipede, WhatsUP e UpSystem reduzido. Para esse cenário, utilize o padrão padraov2.iss. (Quanto mais arquivos e instaladores, maior será o executável final.)
- pastas
Contém estruturas utilizadas pelo sistema, como:
* Schemas de notas fiscais * IBPT * Migrador Excel * Conformidade Fácil * Boletos
- recursos
Contém arquivos de personalização e scripts (.bat) para configurações do Windows.
- utilitarios
Tudo dentro desta pasta será instalado e poderá ter atalho na área de trabalho (ex: AnyDesk, RustDesk, WinRAR). Para adicionar ou remover um utilitário, basta incluir ou excluir o arquivo desta pasta.
Observação: O Master Remote (acesso remoto) deve estar na pasta executaveis. Se o arquivo MasterControl.exe estiver presente, ele será instalado automaticamente junto com o sistema. Caso não esteja, essa instalação será ignorada.
Padrões de Instalador
O projeto possui dois padrões de instalador:
- padrao.iss
Instalador padrão com todas as funcionalidades básicas.
- padraov2.iss
Versão mais completa, que permite:
* Escolher o tipo de instalação (Completa ou Reduzida) * Instalar o Aquipede * Instalar o WhatsUP
Observação: o instalador V2 gera um executável final maior, pois inclui outros instaladores internamente.
Configuração do Arquivo .ISS
Ao abrir o arquivo .iss, são poucas as configurações que precisam ser ajustadas:
- MyAppName
Nome do sistema exibido no instalador e no painel de controle do Windows. Exemplo: "ERP Rosa dos Ventos".
- MyAppVersion
Controle interno de versão do instalador. Pode seguir um padrão próprio ou acompanhar a versão do sistema.
- MyAppPublisher
Nome da sua empresa. Será exibido no Windows e também utilizado dentro do sistema (ex: rodapé do login e relatórios).
- MyAppURL
Site da empresa (opcional).
- ProjectBaseDir
Caminho onde está o projeto do instalador na sua máquina.
- DefaultDirName
Caminho onde o sistema será instalado. Exemplo: C:\UpSystem ou C:\ERP_Rosa_DV
Importante: Caso altere esse caminho, certifique-se de que o banco de dados e todas as estações utilizem o mesmo padrão.
Funcionamento do Instalador
Após aceitar os termos de uso, será necessário escolher o tipo de instalação:
- Servidor
Utiliza conexões locais (localhost, 127.0.0.1).
- Estação
Utiliza o nome ou IP do servidor (ex: DESKTOP891-23M, 192.168.x.xxx).
- PDV OFF
Opera com banco local e segue o padrão do servidor.
Componentes da Instalação
Durante a instalação, é possível selecionar:
- Firebird 5.0 (x86 e x64)
- Executáveis adicionais (UpIfood, Busca Preço, etc.)
Esses itens são instalados quando selecionadas as opções:
- Firebird
- Pasta completa
A opção pasta reduzida é voltada para estações e contém apenas arquivos essenciais.
Tarefas Adicionais
Durante a instalação, você poderá selecionar:
- Criação de atalhos na área de trabalho
- Uso do iniciar.exe (atualização automática do sistema)
- Bloqueio de múltiplas instâncias do sistema
Também estão disponíveis:
- Inicialização do backup ao final da instalação
- Criação da pasta de utilitários
- Instalação do serviço Força de Vendas (quando aplicável)
Processo de Instalação
Durante a instalação:
- O Firebird é instalado automaticamente, sem intervenção do usuário
- Portas do firewall são liberadas (3050, 2018, 8082, 7079, 1080)
- Permissões da pasta são configuradas (Todos, Usuários, Administradores e SYSTEM)
- DLLs são registradas automaticamente
Caso já exista um Firebird instalado, o sistema apenas exibirá um aviso e continuará normalmente.
Ao final, será exibida a mensagem de sucesso e a opção de abrir o sistema.