Projeto FolhaLivre

Instalação do Sistema Gerenciador de Banco de Dados Firebird/Interbase (SGDB)

O FolhaLivre utiliza um banco de dados Firebird/Interbase para armazenar e manipular suas informações, por isso, é necessário a instalação do Sistema Gerenciador de Banco de Dados (SGDB) correspondente.

• Faça o download do Firebird 1.5 (o FolhaLivre ainda não é compatível com a versão 2) em http://www.firebirdsql.org/ para a plataforma Win32.
• Execute o programa de instalação do Firebird e instale-o completamente, escolhendo a opção "Full installation of Super Server e Development Tools" para a máquina-servidor (computador onde ficará a base de dados);
• Para os computadores que serão as máquinas-clientes, execute o programa de instalação do Firebird e escolha a opção "Minimun client install - no server, no tools";

Importante: O SGDB Firebird precisa está em execução na máquina-servidor para que o FolhaLivre funcione.

Instalação do FolhaLivre

• Para a máquina-servidor

  1. Faça o download do arquivo flivre-install-x.y.zip. Descompacte-o (extrair) para pasta c:\flivre\ ou para outra pasta de sua preferência. Esta pasta conterá os sequintes arquivos:

     flivre.exe - Binário (executável);
     flivre.fdb - Base de dados
     splashscreen - Imagem de apresentação em formato bitmap;
     gnu-gpl.txt - Licença GNU-General Public Licence;
     flivre.ini - Arquivo de configuração;
     history.txt - Histórico das modificações;
     alguns arquivos jpeg - Papéis de parede.
     

  2. Modifique o arquivo flivre.ini apenas se você for utilizar o FolhaLivre em ambiente de rede, compartilhando-o entre diversos usuários.

     Altere a opção server da seção OPTIONS com o nome ou o endereço IP da máquina-servidor e altere também a opção DatabaseName da seção IBX_DRIVER com a localização completa da base de dados no formato <maquina>:<arquivo>, sendo <máquina> o nome ou o IP da máquina-servidor e <arquivo> a localização completa da base de dados na máquina-servidor. Veja dois exemplos:

     [OPTIONS]
     driver=IBX
     server=servidor
     
     [IBX_DRIVER]
     DatabaseName=servidor:c:\flivre\flivre.fdb
     

     ou

     [OPTIONS]
     driver=IBX
     server=192.168.0.1
     
     [IBX_DRIVER]
     DatabaseName=192.168.0.1:c:\flivre\flivre.fdb
     

     Veja o arquivo flivre.ini que acompanha o FolhaLivre.

• Para a máquina-cliente

  1. Copie a pasta que você preparou na máquina-servidor para a máquina-cliente ou repita os passos 1 e 2 que você realizou na máquina-servidor.
  2. Apague o arquivo flivre.fdb da pasta que está na máquina-cliente;

Atualização do FolhaLivre

1. Faça o download do arquivo flivre-upgrade-x.y.zip. Escolha sempre a versão mais recente.
2. Descompacte (extraia) o arquivo baixado para pasta onde está instalado o FolhaLivre, tanto na máquina-servidor quanto nas máquinas-cliente (se for o caso).
3. Execute o FolhaLivre da máquina-servidor e escolha a opção >Ferramentas>Atualização da base de dados e confirme a operação.

Instalação dos códigos-fontes

Esta seção é exclusiva para desenvolvedores e exige um relativo conhecimento do programa Borland Delphi/Kylix. Se você não é desenvolvedor ou não tem interesse em programação, por favor desconsidere esta parte.

• Descompacte o arquivo flivre-source-x.y.zip na pasta c:\flivre\ ou em outra pasta mantendo a hierarquia das subpastas. O nome da pasta onde você descompactou o arquivo flivre-source-x.y.zip será chamada de ~ por questão de praticidade. Depois da descompactação são criadas as seguintes pastas:

  ~\source\         - arquivos de fontes exclusivos do FolhaLivre;
  ~\source\kernel\  - núcleo básico para vários projetos;
  ~\aklib\          - arquivos da biblioteca AKLib.
  

• No Borland Delphi/Kylix acesse a opção >Tools>Environment Options.... Na guia (aba) Library escolha o botão ... em Library Path e adicione a pasta ~\source\kernel\ na lista de pastas apresentadas. Isso é necessário para que o Delphi/Kylix encontre as respectivas units (arquivos/unidades) durante o desenvolvimento e compilação, pois as mesmas não são adicionadas explicitamente no projeto flivre.dpr.

Instalação das Bibliotecas

Esta seção é exclusiva para desenvolvedores e exige um relativo conhecimento do programa Borland Delphi/Kylix. Se você não é desenvolvedor ou não tem interesse em programação, por favor desconsidere esta parte.

O FolhaLivre utiliza algumas bibliotecas de componentes para auxiliar no desenvolvimento. Estas bibliotecas não fazem parte do Projeto FolhaLivre, com exceção da AKLib, sendo de seus respectivos autores a responsabilidade de seus aprimoramentos.

Seus códigos fontes estão disponíveis e suas licenças permitem sua inclusão em um software livre/aberto.

As bibliotecas utilizadas pelo FolhaLivre são as sequintes:

• AKLib [http://br.groups.yahoo.com/group/folha_livre/];
• SynEdit [http://synedit.sourceforge.net/];
• MDIWallPaper [http://www.delphi32.com/vcl/537//];
• TStringAlignGrid [http://www.delphi32.com/vcl/4920/]
• FortesReport [http://www.fortesinformatica.com.br/]

Para instalar as biblioteca siga os seguintes passos:

• Faça o download das bibliotecas, com exceção da AKLib, que vem junto ao código-fonte do FolhaLivre e encontra-se na pasta ~\aklib\;
• Descompacte cada biblioteca em uma pasta diferente mantendo a hierarquia das subpastas;

• No Borland Delphi/Kylix acesse a opção >Tools>Environment Options.... Na guia Library clique no botão [...] em Library Path.

• Na tela Directories apresentada inclua a pasta onde estão as units *.pas da biblioteca. Isso permite que o Borland Delphi/Kylix encontre todas as units necessárias à compilação.

  Por exemplo, se você descompactou a biblioteca SynEdit.zip na pasta de instalação do Borland Delphi/Kylix, informe na lista a entrada: $(DELPHI)\SynEdit\Source\.

• No menu principal do Borland Delphi/Kylix >File>Open, na caixa de diálogo Open altere a opção Arquivos do Tipo para Delphi package (*.dpk), mude para a pasta onde está o pacote dpk (package) da biblioteca a ser instalada correspondente à versão do Delphi/Kylix, pressione o botão [Abrir].

• Uma caixa de diálogo Package será apresentada, pressione o botão [Install] e a partir deste ponto o Borland Delphi/Kylix compilará as units e tentará instalar no IDE os respectivos componentes. Se nenhum erro for encontrado, uma janela de confirmação será mostrada. Se a instalação foi bem sucedida feche a caixa de diálogo "Package".

• O projeto flivre.dpr está configurado para gerar o executável na pasta ~.