Instalação

Antes de começar

Feche o IDE do Delphi antes de executar o instalador. A instalação de pacotes enquanto o IDE estiver aberto pode fazer com que o registo falhe ou exija um reinício manual.

Executar o instalador

Execute o instalador adequado à sua versão e edição do Delphi:

Siga as instruções do assistente. O instalador requer privilégios de administrador para gravar na pasta Program Files e para atualizar as entradas do registo do Delphi.

Aviso de segurança do Windows

Os instaladores estão assinados digitalmente com um certificado de assinatura de código autoassinado. O Windows SmartScreen poderá apresentar uma caixa de diálogo de aviso azul com a mensagem «O Windows protegeu o seu PC» ou «Editor desconhecido» antes de o instalador ser executado. Isto é normal e não indica qualquer problema com o ficheiro.

Para continuar, clique em Mais informações na caixa de diálogo de aviso e, em seguida, clique em Executar na mesma. Se a caixa de diálogo mostrar o nome do editor Easygate, Lda., o ficheiro é o instalador original não modificado.

São oferecidos dois tipos de instalação:

O componente DCU principal é sempre instalado e não pode ser desmarcado. Os componentes opcionais disponíveis são:

No modo Completo, todos os componentes opcionais são instalados. No modo Personalizado, todos os componentes são apresentados pré-selecionados (correspondendo à seleção do modo Completo) e podem ser desmarcados individualmente.

O que o instalador faz

O instalador executa automaticamente os seguintes passos:

  1. Copia os pacotes compilados (.bpl, .dcp, .dcu) para o diretório de instalação, na pasta Lib\.
  2. Regista os pacotes de tempo de design no IDE do Delphi, gravando em HKEY_CURRENT_USER\Software\Embarcadero\BDS\<versão>\Known Packages.
  3. Adiciona os subdiretórios de bibliotecas para os componentes do pacote selecionado (VCL e/ou FMX) ao caminho de pesquisa de bibliotecas do Delphi em HKEY_CURRENT_USER\Software\Embarcadero\BDS\<versão>\Library\Win32 e \Win64. Os caminhos do DCU principal não são adicionados automaticamente; adicione-os por projeto, conforme descrito em Utilizar o DCU principal.
  4. Se for detetada uma versão anterior do EgStrParser, esta é primeiro desinstalada.

O registo é efetuado por utilizador (HKEY_CURRENT_USER), pelo que se aplica apenas à conta de utilizador atual do Windows.

Verificar a instalação

Abra o IDE do Delphi. Abra a Paleta de Componentes (Ver > Paleta de Ferramentas) e procure por TEgStrParser. O componente deverá aparecer na categoria Easygate. Se o componente não aparecer, vá a Componente > Instalar Pacotes, localize o pacote de tempo de design do EgStrParser na lista e certifique-se de que está marcado.

Desinstalação

Utilize Painel de Controlo > Programas > Desinstalar um programa e selecione o EgStrParser. O desinstalador remove todos os ficheiros copiados pelo instalador e elimina os caminhos das bibliotecas e as entradas de Pacotes Conhecidos do registo do Delphi. Os ficheiros criados ou modificados após a instalação (por exemplo, ficheiros de código-fonte copiados para um diretório de projeto) não são removidos.

Edição Pro — ficheiros-fonte

O instalador da edição Pro inclui os ficheiros-fonte da biblioteca parser como um componente opcional. Execute EgStrParserProSetup-2.0.0-D12.exe ou EgStrParserProSetup-2.0.0-D13.exe e selecione Completa para instalar todos os componentes, incluindo o código-fonte, ou Personalizada para escolher individualmente.

Os ficheiros EgStrParser.pas e EgStrParserComp.pas são copiados para <diretório de instalação>\Source\. Para os utilizar num projeto, adicione esse diretório ao caminho de pesquisa do projeto ou copie-os diretamente para o diretório do projeto.

Utilizar o DCU principal

O DCU principal permite-lhe compilar o parser diretamente na sua aplicação sem necessitar do pacote de tempo de execução (.bpl). Cada pasta de plataforma contém dois DCUs: EgStrParser.dcu (o motor de análise) e EgStrParserComp.dcu (o componente TEgStrParser).

O DCU é instalado em:

<diretório de instalação>\Lib\Delphi370\Win32\Release\core\   (Win32, Delphi 13)
<diretório de instalação>\Lib\Delphi370\Win64\Release\core\   (Win64, Delphi 13)
<diretório de instalação>\Lib\Delphi290\Win32\Release\core\   (Win32, Delphi 12)
<diretório de instalação>\Lib\Delphi290\Win64\Release\core\   (Win64, Delphi 12)

Para o utilizar, adicione o caminho apropriado ao caminho de pesquisa do seu projeto (não ao caminho global das bibliotecas do Delphi) e adicione EgStrParser e, se necessário, EgStrParserComp à cláusula uses. O componente TEgStrParser está disponível através do DCU principal; o método ParseInput também pode ser chamado diretamente sem o componente.

O instalador não adiciona os caminhos do DCU principal ao caminho global das bibliotecas do Delphi, para evitar conflitos com os DCUs dos pacotes já registados nesse caminho.

Exemplo — adicionar o caminho nas opções do projeto:

  1. Abra Projeto > Opções > Compilação > Compilador Delphi.
  2. Em Caminho de pesquisa, adicione o caminho do DCU principal para a sua plataforma de destino e versão do Delphi (por exemplo, C:\Program Files\Easygate\EgStrParser\Lib\Delphi370\Win64\Release\core).
  3. Na sua unidade, adicione EgStrParser à cláusula uses e chame ParseInput diretamente.
uses EgStrParser;

var
  R: TParseResult;
begin
  R := ParseInput('10/2/26 ~ 11/2/26', itDate);
  if R.ResultType = otRange then
    ShowMessage(R.SQLExpression);
end;
(C) 2026 Easygate, Lda