instalador

Instalador 🚧

Home > Instalação > Instalador

🚧 Em desenvolvimento. O instalador ainda não foi lançado; o link sai na página de Releases.

Em uma frase: escolhe a versão do RAL, as IDEs e os recursos, baixa tudo para uma pasta e instala em várias IDEs de uma vez — Delphi e Lazarus — sem abrir nenhuma.

Você vai precisar

• Windows para o Delphi (Delphi XE ou mais novo); Windows, Linux ou macOS para o Lazarus (FPC 3.2.0 ou mais novo, inclusive o FPC Unleashed).
• As IDEs fechadas durante a instalação (a IDE aberta regrava a configuração ao fechar).
• O Delphi aberto ao menos uma vez nesta conta de usuário.

Como usar

1. Idioma e tipo de IDE (Delphi, Lazarus ou os dois).

2. IDEs: a lista traz as instaladas, registradas ou não. A que nenhuma versão do RAL aceita (Delphi 7, 2009, 2010) aparece com o motivo e não pode ser marcada.

3. Versão e recursos: a estável mais recente vem escolhida; pré-lançamentos, tags antigas e ramos ficam no grupo "outras versões". Os recursos vêm por categoria:

   categoria	pasta em pkg/<IDE>	exemplos
   pacotes base	raiz	PascalRAL, PascalRALDsgn
   motores	Engine	IndyRAL, SynopseRAL, fphttpral
   plugins 🚧	Plugins	RALPluginAuthPackage
   storage 🚧	Storage	RALStoragePackage
   banco de dados	Database	RALDBFireDACPackage (1.x: RALDBFireDACLink)
   módulos 🚧	Modules	RALModuleWebPackage, RALModuleSwaggerPackage
   compressão	Compression	RALCompressZStdPackage (1.x: RALZStdCompress)
   assistentes 🚧	Wizard	RALWizardDsgn

   Pelo menos um motor é obrigatório: sem ele o botão Avançar fica apagado e a linha vermelha diz por quê. A versão que não serve numa IDE marcada também apaga o botão, com o motivo.

4. Pasta de instalação: é permanente. As IDEs apontam para ela; não apague.

5. Plano: o que será baixado e o que muda em cada IDE, antes de qualquer escrita.

O que o instalador garante

• Nunca pior do que estava. Tudo compila antes numa pasta de preparo (Delphi) ou numa cópia da configuração (Lazarus). Só quando o núcleo, o pacote de design e pelo menos um motor compilam é que a IDE muda. Senão o resumo diz "Nada mudou nesta IDE", com o primeiro erro. Um recurso opcional que não compila fica de fora sozinho.
• Mesma versão, mesmos recursos: nada a fazer. Trocar recursos só compila o que falta; outra versão é "Atualizar", "Voltar" ou "Trocar", e recompila tudo.
• Library path em todas as plataformas instaladas no Delphi (Win32, Win64, Android, iOS, Linux64, macOS) que aquela versão do RAL aceita. Plataforma instalada depois: abra a IDE uma vez e rode o instalador de novo — só o path dela entra.
• Versão não verificada naquela IDE (o projeto testa por amostragem) instala do mesmo jeito, com o aviso; se não compilar, nada muda.

Opções

opção	o que faz
Somente library path	aponta os fontes, não compila nem instala pacote (Delphi)
Também Win64	compila o runtime de Win64 (a IDE de 64 bits do Delphi 12+ entra sozinha)
Instalar sem componentes na IDE (só runtime)	compila os pacotes para quem usa pacotes de runtime; nada vai para a paleta. No Lazarus, só registra os pacotes (os projetos podem exigi-los)

Na 1.x, "só runtime" no Delphi ainda compila o PascalRALDsgn (os motores o exigem), que depende do designide: um programa compilado com pacotes de runtime precisa dele e não roda fora da máquina de desenvolvimento. A 2.0 separou o design.

DLLs das dependências

libsagui (SaguiRAL), brotli (Win64, e Delphi antes do 10.1) e ZSTD vão para <pasta de instalação>\redist\win32 e \win64. Copie a DLL para junto do executável do seu programa: o instalador não sabe onde ele fica.

Desinstalar e limpar

Desmarque todos os recursos de uma IDE que tem o RAL: a última página vira "Desinstalar". Depois, o instalador lista o que ele baixou e nenhuma IDE usa mais (versões, dependências, DLLs, cache), tudo marcado: desmarque o que quer manter. Não há como desfazer a limpeza. Dependência que já era sua (encontrada na IDE) nunca aparece.

Depois de atualizar

O link "Atualizar os meus projetos para a <versão>" abre o migrador de projetos, já com a versão de origem e a de destino. Veja Atualizar de versão.

Linha de comando

ralcli ides
ralcli plano --ide=#1 --versao=1.1 --pacotes=IndyRAL
ralcli instalar --ide=#1 --pacotes=IndyRAL [--so-runtime] [--sim]
ralcli desinstalar --ide=#1 --limpar
ralcli limpar [--manter=2,3]

Código de saída: 0 deu certo; 1 algo falhou; 2 uso errado; 3 nada mudou numa IDE porque o conjunto mínimo não compilou.

Erros comuns

mensagem	causa	o que fazer
"nenhum motor escolhido"	só o núcleo marcado	marque um motor (IndyRAL, fphttpral...)
"não recebe esta versão do RAL"	versão sabida quebrada naquela IDE	escolha outra versão do RAL
"Nada mudou nesta IDE: ... não compilou"	o conjunto mínimo falhou	leia o primeiro erro no log; a IDE ficou como estava
"está aberto"	IDE aberta	feche a IDE e rode de novo
"abra a IDE uma vez e rode o instalador de novo"	plataforma instalada depois	abra o Delphi uma vez

Veja também

Instalação manual · Compatibilidade · Atualizar de versão · 🚧 Migrar para a 2.0