CompInstall

Instalador de componentes

Delphi App Utility To Pacotes de componentes de instalação automática no IDE.

• O que há de novo
• Descrição
• Características
• Como usar
• Estrutura compinstall.ini

O que há de novo

• 20/02/2024 (versão 2.6)

  • Delphi 12 Suporte.
  • Novas Propriedades da Ini: iniversão, saída de saída e pacote path
  • O PublishFiles agora suporta o subpasta.
  • Limpe todos os arquivos e subpastas ao atualizar do GitHub.
  • Detectar compilador não suportado.

Clique aqui para ver todo o Changelog

• 12/09/2021 (versão 2.5)

  • Delphi 11 Suporte.

• 25/03/2021 (versão 2.4)

  • Como não é uma boa prática incorporar o instalador do componente Exe nas fontes de componentes do GitHub, a atualização do repositório do GitHub foi modificada para não atualizar o exe do instalador de componentes, mas apenas as fontes de componentes configuradas.
  • Funcionalidade de backup removida na atualização automática do GitHub.

• 01/02/2021 (versão 2.3)

  • Criação de subestimados corrigida (ausente) ao extrair arquivos na atualização do GitHub.
  • A nova pasta de backup na atualização do GitHub (a pasta real será renomeada usando a data e a hora de sufix).

• 18/12/2020 (versão 2.2)

  • CHAMADA CORRILIVA PARA RSVARS.BAT Quando o Delphi é instalado em um caminho que contém caracteres de espaços.

• 31/10/2020 (versão 2.1)

  • Incluído Delphi 10.4 Sydney Support.
  • Verificação implementada da existência do compilador Delphi de 64 bits quando o sinalizador de 64 bits foi definido.

• 26/10/2020 (versão 2.0)

  • O processo de compilação agora usa threads.
  • Atualização automática do Github.

• 05/05/2020 (versão 1.2)

  • Corrigido o método RegisterBPL porque Delphi Xe5 ou abaixo use a pasta pública "RAD Studio" em vez de "Embarcadero Studio".

• 15/02/2019 (versão 1.1)

  • Removido parâmetro de permitir 64bit na seção geral. O aplicativo detectará este parâmetro automaticamente quando aparecer em qualquer parâmetro de pacote.

Descrição

Este aplicativo permite que você distribua seu componente Delphi sem precisar fazer uma longa lista de tarefas para instalar manualmente o componente no IDE ( quando você está fornecendo fontes de componentes, é claro ).

Além disso, se o componente estiver hospedado no GitHub, você poderá indicar o caminho do repositório e o aplicativo verificará as atualizações diretamente nas versões do repositório.

Características

• Detecta todas as versões Delphi instaladas e permite que o programador escolha qual IDE instalar.
• Compila pacotes gerando arquivos BPL.
• Instala pacotes no IDE.
• Registre os caminhos no caminho da biblioteca.
• Cópias necessárias para arquivos de recursos para a pasta compilada (.dfm, .res, ...).
• Atualiza o componente hospedado no GitHub automaticamente.
• Suporta 32 bits e 64 bits compilação.

Como usar

Você precisa apenas criar um arquivo ini chamado CompInstall.ini e gravar parâmetros no aplicativo.

Em seguida, coloque o CompInstall.exe e o Compinstall.ini no diretório de pacotes de componentes e seja feliz.

NOTA: Este aplicativo requer msbuild, que está presente no .NET Framework 2.0, 3.5 e 4.0. Quando o lançamento do aplicativo, ele verificará se houver qualquer msbuild disponível.

Estrutura compinstall.ini

[Template] Seção

IniVersion (obrigatório) = versão da estrutura ini ( versão atual = 2 )

Se a versão INI for maior que a versão suportada pelo aplicativo atual, o aplicativo exibirá uma mensagem de erro e a instalação de bloquear.

[General] Seção

Name (obrigatório) = nome do componente exibido no formulário de instalação e registrado em pacotes Delphi.

Version (necessária) = versão do componente exibida no formulário de instalação e usada pelo controle de update automático do github (se ativado).

DelphiVersions (exigido) = É uma lista dividida por ";" com todas as versões Delphi suportadas pelo componente. De acordo com as versões Delphi instaladas no Windows e, combinando com este parâmetro, um ComboBox no formulário de instalação listará todas as versões possíveis do Delphi.

Valores apoiados: 2005; 2006; 2007; 2009; 2010; Xe; Xe2; Xe3; Xe4; Xe5; Xe6; Xe7; Xe8; 10; 10.1; 10.2; 10.3; 10.4; 11; 12

Packages (exigidos) = é uma lista dividida por ";" com pacotes a serem compilados, em ordem correta. Basta digitar o nome do pacote sem a extensão do arquivo.

AddLibrary (opcional) = 0 ou 1. Quando 1, o caminho das pastas de liberação do componente será registrado no caminho da biblioteca Delphi.

OutputPath (opcional) = pasta relativa onde os arquivos compilados são armazenados (devem ser os mesmos configurados nas configurações do pacote). Você pode usar variáveis {PLATFORM} e {CONFIG} . O valor padrão é: {PLATFORM}{CONFIG} (até agora, {config} é sempre "release").

Seção de pacotes

Para especificar parâmetros do pacote, crie uma seção com o nome do pacote com o prefixo P_ , como:

[P_MyPackage]

Path (opcional) = pasta relativa onde está o arquivo de pacote. Se em branco, o pacote deve estar na pasta raiz do componente.

Allow64bit (opcional) = 0 ou 1. Quando 1, especifique este pacote a ser compilado duas vezes, com versões de 32 e 64 bits. Lembre-se de criar essa plataforma no Delphi Project Manager, caso contrário, a compilação de 64 bits falhará.

Se qualquer pacote tiver essa opção ativada, ele será exibido uma caixa de seleção, permitindo instalar a versão de 64 bits do componente (a caixa de seleção inicia o verificado por padrão).

PublishFiles (Opcional) = É uma lista dividida por ";" Com todos os arquivos que você deseja copiar nas pastas de liberação (geralmente os arquivos de formulário DFM usados nos arquivos de tempo de execução e recursos).

Install (opcional) = 0 ou 1. Quando 1, este pacote será instalado no Delphi IDE. Você precisa definir esta opção para pacotes de tempo de design quando deseja registrar componentes no Delphi IDE.

Nota: o aplicativo compila seu componente usando sempre o destino de liberação sempre.

Seção [GitHub]

Repository (Opcional) = permite especificar um repositório GitHub (Sintaxe: Repository name GitHub account ); portanto, quando o aplicativo iniciar, ele verificará a atualização do componente usando a API do GitHub, lendo a versão mais recente e comparando sua versão com a versão atual. Se as versões não corresponderem, uma caixa de diálogo será exibida perguntando se você deseja atualizar automaticamente arquivos.

Exemplo

Neste exemplo, existem dois pacotes Delphi (Dampackage e DamDesignPackage). O pacote de tempo de design (DamDesignPackage) está configurado para instalar no Delphi IDE. O pacote de tempo de execução (Dampackage) está configurado para copiar o arquivo de formulário DFM e o arquivo de recursos para liberar a pasta.

 [Template]
IniVersion=2

[General]
Name=Dam Component
Version=1.0
DelphiVersions=XE2;XE3;XE4;XE5;XE6;XE7;XE8;10;10.1;10.2;10.3;10.4
Packages=DamPackage;DamDesignPackage
AddLibrary=1
OutputPath=Library{PLATFORM}{CONFIG}

[P_DamPackage]
Path=SourceCode
Allow64bit=1
PublishFiles=DamDialog.dfm;ResourcesDam_Resource.res

[P_DamDesignPackage]
Install=1

Verifique meus componentes Delphi aqui no Github e encontre o arquivo Compinstall.ini para ver outros exemplos de uso.