Instalacao_manual

Home > Instalação > Instalação Manual

Instalação Manual

Primeiramente você precisa identificar se sua IDE possui todas as dependências:

• Compatibilidade
• Como instalar as dependências

---

Confirmado que sua IDE possui todas as dependências necessárias, só seguir os passos abaixo para instalar o pacote:

1. Baixar o código-fonte:

1.1) Baixar os arquivos usando um cliente de controle de versão, ajustando seu cliente git pra incluir a opção --recursive pra conseguir baixar todos os submódulos:

https:

https://github.com/OpenSourceCommunityBrasil/PascalRAL

SSH:

git@github.com:OpenSourceCommunityBrasil/PascalRAL.git

1.2) Caso prefira baixar os fontes compactados (zipados) use um dos links abaixo:

Warning

Arquivo zipado não traz os submódulos, precisa baixar manualmente nos repositórios de destino

https://github.com/OpenSourceCommunityBrasil/PascalRAL/releases

https://github.com/OpenSourceCommunityBrasil/PascalRAL/archive/refs/heads/master.zip

2. Seguir as instruções de acordo com a IDE:

• Delphi
• Lazarus

Delphi:

2.1) Abra o `PascalRAL.groupproj`

⚠️ Confira se o Target Platform da IDE está na versão win32 para IDE 32 bits e win64 para IDE 64 bits!

2.2) Somente Construa(Build) o primeiro pacote PascalRAL.bpl

2.3) Construa(Build) e instale o pacote PascalRALDsgn.bpl

2.4) Agora Construa(Build) e instale o pacote referente à lib de conexão com a internet que pretende utilizar:

• Se for usar Indy > IndyRAL.bpl
• Se for usar Synopse > SynopseRAL.bpl
• Se for usar Sagui > SaguiRAL.bpl
• Se for usar o UniGUI > UniGUIRAL.bpl
• Se for usar o cliente NetHTTP > NetHttpRAL.bpl

2.5) Wizard de início rápido de aplicações

• Construa(Build) e instale o pacote RALWizard.bpl

2.6) Pacotes DBWare:

2.6.1) Construa(Build) e instale o pacote RALDBPackage.bpl

2.6.2) Agora Construa(Build) e instale o pacote referente ao componente DAC que for usar com os DBWares:

• FireDAC > Construa(Build) e instale RALDBFireDACLink.bpl
• Zeos > Construa(Build) e instale RALDBZeosLink.bpl

2.7) Pacotes de compressão externa, via dll no server

• brotli > Construa(Build) e instale RALBrotliCompress.bpl
• ZStd (facebook) > Construa(Build) e instale RALZStdCompress.bpl

2.8) Por fim, adicione ao library path os caminhos abaixo para que os componentes funcionem:

2.8.1) Configurar o Environment Variables: Tools > Options > IDE > Environment Variables

• Clique em New… em User System Overrides

• em Variable Name coloque por exemplo PascalRAL

  ⚠Esse nome de variável é case-sensitive quando for usar o coringa: $(PascalRAL)

• em Variable Value coloque o caminho da pasta raiz, até a pasta src por exemplo C:\temp\PascalRAL\src

2.8.2) Em seguida, adicione ao seu library path os caminhos abaixo de acordo com o que for utilizar:

• Logo após a lista dos paths individuais temos alguns “templates” para só copiar/colar para facilitar a instalação.

  # path da base do componente
  $(PascalRAL)\base;
  $(PascalRAL)\utils;
  
  # path específico do DBWare, adicione somente se for instalar os componentes DBWare
  $(PascalRAL)\database;
  $(PascalRAL)\database\FireDAC;
  # path específico do ZeosDBO, adicione somente se for instalar o componente Zeos
  $(PascalRAL)\database\Zeos;
  
  #Paths específicos de motor de dados, adicione somente o relativo aos motores que for usar
  $(PascalRAL)\engine\indy;
  $(PascalRAL)\engine\netHTTP;
  $(PascalRAL)\engine\synopse;
  $(PascalRAL)\engine\sagui;
  $(PascalRAL)\engine\unigui;
  $(PascalRAL)\engine\cgi;
  
  # Path específico das compressões externas via .dll
  $(PascalRAL)\others;

⚠️ Atenção!! Utilize um dos paths abaixo, são formas rápidas de copiar/colar para facilitar instalação. NÃO USE TODOS! VAI DAR CONFLITO! VOCÊ FOI AVISADO!

• ⚠️ Path mínimo para APIs usando Indy + NetHttp:

$(PascalRAL)\base;$(PascalRAL)\utils;$(PascalRAL)\engine\indy;$(PascalRAL)\engine\netHTTP;

• ⚠️ Path mínimo para APIs e DBWare com FireDAC usando Indy + NetHttp:

$(PascalRAL)\base;$(PascalRAL)\utils;$(PascalRAL)\engine\indy;$(PascalRAL)\engine\netHTTP;$(PascalRAL)\database;$(PascalRAL)\database\FireDAC;

• ⚠️ Path completo com todos os itens

$(PascalRAL)\base;$(PascalRAL)\utils;$(PascalRAL)\database;$(PascalRAL)\database\FireDAC;$(PascalRAL)\database\Zeos;$(PascalRAL)\engine\indy;$(PascalRAL)\engine\netHTTP;$(PascalRAL)\engine\synopse;$(PascalRAL)\engine\sagui;$(PascalRAL)\engine\unigui;$(PascalRAL)\engine\cgi;$(PascalRAL)\others

Lazarus:

⚠️ Por padrão os pacotes do Lazarus são todos em lowercase para evitar problemas relacionados a caracteres maiúsculos/minúsculos de sistema operacional que são case-sensitive.

2.1) Pacotes obrigatórios:

• Os pacotes de instalação se encontram em (PascalRAL)\pkg\Lazarus

2.1.1) Abra o pacote principal pascalral.lpk, compile somente.

2.1.2) Abra o pacote pascalraldsgn.lpk compile e instale.

2.1.3) Abra o pacote da lib de acesso a internet de sua preferência, localizados em (PascalRAL)\pkg\Lazarus\Engine:

• Indy > indyral.lpk, compile e instale
• Synopse mORMot2 > synopseral.lpk, compile e instale
• FpHttp > fphttpral.lpk, compile e instale
• Sagui > saguiral.lpk (necessário libsagui-3.dll), compile e instale

2.2) Pacotes opcionais:

2.2.1) DBWare: Instalação dos DBWares, localizados em (PascalRAL)\pkg\Lazarus\Database :

2.2.1.1) Abra, compile e instale o pacote raldbpackage.lpk

2.2.1.2) Abra, compile e instale o pacote DAC de acordo com sua preferência:

• SQLDB > ralsqldblink.lpk
• Zeos > ralzeoslink.lpk

2.2.2) Compressão: instalação das bibliotecas de compressão, localizadas em (PascalRAL)\pkg\Lazarus\compression:

• Brotli > Abra, compile e instale ralbrotlicompress.lpk
• ZStd (Facebook) > Abra, compile e instale ralzstdcompress.lpk

2.2.3) BSON: Instalação do manipulador dos dados em formato BSON, localizado em (PascalRAL)\pkg\Lazarus\Database:

• Abra, compile e instale o pacote raldbbson.lpk

2.3) Via OPM (Online Package Manager) <ainda não disponível>

• Abra o OPM e escolha os pacotes que deseja instalar, é necessário escolher, no mínimo, o pacote principal pascalral.lpk e algum motor de dados para poder usar o mínimo necessário do projeto