instalacao_lazarus

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

Instalação manual no Lazarus

Vale para a 1.1 em diante · Nível: iniciante

Em uma frase: abrir os pacotes .lpk do RAL no Lazarus, compilar e instalar.

Você vai precisar: os fontes do RAL com os submódulos (Instalação Manual) e as dependências do motor que vai usar (Como instalar as dependências).

Note

Os pacotes do Lazarus têm nome em minúsculas de propósito: Linux diferencia maiúsculas de minúsculas.

Como abrir, compilar e instalar um pacote

• Abrir: Package > Open Package File (.lpk)...
• Compilar: botão Compile da janela do pacote.
• Instalar: botão Use > Install. O Lazarus pergunta se pode recompilar a IDE: responda Yes. Ela fecha e abre sozinha.

Dica para vários pacotes: em cada um, Use > Install e responda No à recompilação; no fim, Tools > Build Lazarus with Profile... recompila a IDE uma vez só.

Passo a passo

Os pacotes ficam em pkg\Lazarus e subpastas.

#	Pacote	O que fazer	Obrigatório?
1	pascalral.lpk	Compile	sim
2	pascalraldsgn.lpk	Compile e Install	sim
3	um motor, ao menos (tabela abaixo)	Compile e Install	sim, um
4	ralwizardpack.lpk	Compile e Install	não: assistente de novo projeto
5	Database\raldbpackage.lpk	Compile e Install	só para banco de dados (DBWare)
6	Database\raldbsqldblink.lpk ou Database\raldbzeoslink.lpk	Compile e Install	só com o raldbpackage
7	Database\raldbbson.lpk	Compile e Install	só para o formato BSON
8	compression\ralbrotlicompress.lpk, compression\ralzstdcompress.lpk	Compile e Install	só para compressão brotli/zstd

Na 2.0 🚧 os pacotes têm outros nomes e há pacotes novos: veja a seção Na 2.0 abaixo.

Os motores ficam em pkg\Lazarus\Engine:

Pacote	Motor	Precisa antes	Servidor	Cliente
fphttpral.lpk	fpHTTP (vem com o FPC)	nada	sim	sim
indyral.lpk	Indy	pacote indylaz (pelo OPM)	sim	sim
synopseral.lpk	mORMot2	pacote mormot2	sim	sim
saguiral.lpk	Sagui	libsagui (.dll/.so) junto do programa	sim	não
cgiral.lpk	CGI (atrás do IIS, Apache, nginx)	pacote weblaz (vem com o Lazarus)	sim	não
msquicral.lpk 1.2	QUIC (MsQuic)	msquic (.dll/.so) junto do programa	sim	sim

Para escolher, veja Qual motor escolher?.

Na 2.0 🚧

Important

Em desenvolvimento (2.0). Ainda não está numa versão lançada e pode mudar.

Os passos são os mesmos; mudam os pacotes. A troca de cada nome da 1.x está em Migrar para a 2.0. Pacote de runtime só se compila; o de design (...dsgn) se instala, e o de "runtime e design" também.

#	Pacote (em pkg\Lazarus)	O que fazer	Obrigatório?
1	pascalral.lpk	Compile	sim
2	pascalraldsgn.lpk	Compile e Install	sim
3	um motor, ao menos (Engine\fphttpral.lpk, Engine\indyral.lpk...)	Compile e Install	sim, um
4	Plugins\ralpluginauthpackage.lpk	Compile e Install	para Basic, JWT, Digest, OAuth2
5	Plugins\ralplugintlspackage.lpk	Compile e Install	para o certificado automático
6	Storage\ralstoragepackage.lpk	Compile e Install	para storages e banco de dados
7	Modules\ralmodulewebpackage.lpk, Modules\ralmoduleswaggerpackage.lpk	Compile e Install	para servir arquivos e Swagger
8	Wizard\ralwizarddsgn.lpk	Compile e Install	não: assistente de novo projeto
9	Database\raldbpackage.lpk + Database\raldbdsgn.lpk	Compile o primeiro; Install o segundo	para DBWare
10	Database\raldbsqldbpackage.lpk + raldbsqldbdsgn.lpk, ou raldbzeospackage.lpk + raldbzeosdsgn.lpk	idem	com o DBWare
11	Storage\ralstoragebsonpackage.lpk	Compile e Install	para o formato BSON
12	Compression\ralcompressbrotlipackage.lpk, Compression\ralcompresszstdpackage.lpk	Compile e Install	para brotli/zstd
13	Modules\ralmodulexmlpackage.lpk	Compile e Install	para XML e Storage XML
14	Modules\ralmodulesoappackage.lpk + Modules\ralmodulesoapdsgn.lpk	Compile o primeiro; Install o segundo	para SOAP (servidor, cliente)

Um projeto exige os pacotes das units que usa: ralpluginauthpackage para RALAuthentication, ralstoragepackage para RALStorageBIN, ralmodulewebpackage para RALWebModule, e assim por diante.

Só código, sem componentes na paleta

Faça só o Compile dos pacotes (sem Install) e, no seu projeto, Project > Project Inspector > Add > New Requirement com pascalral e o pacote do motor. Com o LazProjectGroups instalado, abra pkg\Lazarus\PascalRALGroup.lpg e compile o grupo inteiro de uma vez.

Pelo OPM (Online Package Manager)

Ainda não disponível.

Erros comuns

Mensagem	Causa	O que fazer
Can't find unit IdHTTP (ou mormot.*, ZConnection)	o pacote da dependência não está instalado	instale indylaz, mormot2 ou zcomponent antes
Broken dependency: ... ao abrir o pacote	idem	idem
a IDE não volta depois de recompilar	erro no meio da recompilação	abra o lazarus.old.exe (ou startlazarus), veja Messages
uma unit removida do RAL ainda "aparece"	.ppu antigo na pasta lib	Run > Clean up and Build... no pacote, ou lazbuild -B pacote.lpk

Mais casos: Problemas comuns.

Veja também

• Instalação no Delphi
• Primeiro servidor e cliente