CompInstall

Installateur de composant

Delphi App utilitaire pour installer automatiquement les packages de composants dans IDE.

• Quoi de neuf
• Description
• Caractéristiques
• Comment utiliser
• Structure compinstall.ini

Quoi de neuf

• 20/02/2024 (version 2.6)

  • Support Delphi 12.
  • Nouvelles propriétés INI: Iversion, OutputPath et Package Path
  • PublishFiles prend désormais en charge le sous-dossier.
  • Effacez tous les fichiers et sous-repliants lors de la mise à jour à partir de GitHub.
  • Détecter le compilateur non pris en charge.

Cliquez ici pour voir l'intégralité

• 09/12/2021 (version 2.5)

  • Support Delphi 11.

• 25/03/2021 (version 2.4)

  • Comme il n'est pas une bonne pratique d'intégrer l'installateur de composant EXE dans les sources de composants GitHub, la mise à jour du référentiel GitHub a été modifiée pour ne pas mettre à jour le programme d'installation du composant EXE, mais uniquement les sources de composants configurées.
  • Supprimé la fonctionnalité de sauvegarde dans GitHub Auto-Update.

• 02/01/2021 (version 2.3)

  • Correction de la création de sous-reproches (manquante) lors de l'extraction de fichiers sur la mise à jour GitHub.
  • Nouveau dossier de sauvegarde sur GitHub Update (le dossier réel sera renommé à l'aide de Date and Heure Sufix).

• 18/12/2020 (version 2.2)

  • Correction de l'appel à rsvars.bat lorsque Delphi est installé dans un chemin contenant des caractères d'espace.

• 31/10/2020 (version 2.1)

  • Inclus Delphi 10.4 Support de Sydney.
  • Vérification implémentée de l'existence du compilateur Delphi 64 bits lorsque le drapeau 64 bits a été défini.

• 26/10/2020 (version 2.0)

  • Le processus de compilation utilise désormais du thread.
  • GitHub Auto-Update Poutenir.

• 05/03/2020 (version 1.2)

  • Correction de la méthode RegisterBPL car Delphi XE5 ou moins utilise le dossier public "RAD Studio" à la place "Embarcadero Studio".

• 15/02/2019 (version 1.1)

  • Supprimé le paramètre Autoriser 64 bits dans la section générale. L'application détectera automatiquement ce paramètre lorsque vous apparaîtra à n'importe quel paramètre de package.

Description

Cette application vous permet de distribuer votre composant Delphi sans avoir à faire une longue liste de tâches pour installer manuellement le composant dans IDE ( lorsque vous fournissez des sources de composants, bien sûr ).

De plus, si le composant est hébergé sur GitHub, vous pouvez indiquer le chemin du référentiel et l'application vérifiera directement les mises à jour dans les versions du référentiel.

Caractéristiques

• Détecte toutes les versions Delphi installées et permet au programmeur de choisir l'IDE à installer.
• Compile les packages générant des fichiers BPL.
• Installe les packages dans IDE.
• Informe les chemins vers le chemin de la bibliothèque.
• Les copies de fichiers de ressources requis pour compiler le dossier (.dfm, .res, ...).
• Mette à jour le composant hébergé sur GitHub automatiquement.
• Prend en charge la compilation de 32 bits et 64 bits.

Comment utiliser

Vous n'avez qu'à créer un fichier INI appelé Compinstall.ini et à écrire des paramètres à l'application.

Mettez ensuite le Compinstall.exe et Compinstall.ini dans votre répertoire de packages de composants et soyez heureux.

Remarque: Cette application nécessite MSBuild, qui est présente à .NET Framework 2.0, 3.5 et 4.0. Lors du lancement de l'application, il vérifiera si un MSBuild est disponible.

Structure compinstall.ini

[Template] Section

IniVersion (requis) = version de la structure INI ( version actuelle = 2 )

Si la version INI est supérieure à la version actuelle de l'application prise en charge, l'application affiche un message d'erreur et l'installation de blocage.

SECTION [General]

Name (requis) = nom du composant affiché au formulaire d'installation et enregistré dans les packages Delphi.

Version (OBLIQUE) = Version du composant affichée au formulaire d'installation et utilisée par GiTHub Auto-Update Control (si activé).

DelphiVersions (requis) = c'est une liste divisée par ";" avec toutes les versions Delphi prises en charge par le composant. Selon les versions Delphi installées sous Windows et se combinant avec ce paramètre, un ComboBox dans le formulaire d'installation répertorie toutes les versions de Delphi possibles.

Valeurs prises en charge: 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 (requis) = c'est une liste divisée par ";" avec des packages à compiller, dans le bon ordre. Tapez simplement le nom du package sans l'extension du fichier.

AddLibrary (facultatif) = 0 ou 1. Lorsque 1, le chemin de la direction des dossiers de la composante sera enregistré dans le chemin de la bibliothèque Delphi.

OutputPath (Facultatif) = dossier relatif où les fichiers compilés sont stockés (doivent être les mêmes configurés dans les paramètres du package). Vous pouvez utiliser des variables {PLATFORM} et {CONFIG} . La valeur par défaut est: {PLATFORM}{CONFIG} (maintenant, {config} est toujours "release").

Section des forfaits

Pour spécifier les paramètres du package, créez une section avec le nom du package avec le préfixe P_ , comme:

[P_MyPackage]

Path (Facultatif) = dossier relatif où se trouve le fichier de package. Si vide, le package doit être dans le dossier racine des composants.

Allow64bit (facultatif) = 0 ou 1. Lorsque 1, spécifiez ce package à compiller deux fois, avec des versions 32 bits et 64 bits. N'oubliez pas de créer cette plate-forme chez Delphi Project Manager, sinon la compilation 64 bits échouera.

Si un package a activé cette option, il sera affiché une boîte à cocher permettant d'installer la version 64 bits du composant (la case à cocher démarre par défaut).

PublishFiles (facultatif) = c'est une liste divisée par ";" Avec tous les fichiers que vous souhaitez copier dans les dossiers de version (généralement des fichiers de formulaire DFM utilisés sur les fichiers d'exécution et de ressource).

Install (facultatif) = 0 ou 1. Lorsque 1, ce package sera installé dans Delphi IDE. Vous devez définir cette option pour les packages de conception-temps lorsque vous souhaitez enregistrer des composants dans Delphi IDE.

Remarque: l'application compile votre composant en utilisant toujours la cible de libération .

[GitHub] Section

Repository (Facultatif) = vous permet de spécifier un référentiel GitHub (syntaxe: GitHub account / Repository name ), donc lorsque l'application démarre, il vérifiera la mise à jour des composants à l'aide de l'API GitHub, lisant la dernière version existante et comparant sa version avec la version actuelle. Si les versions ne correspondent pas, une boîte de dialogue sera affichée pour vous demander si vous souhaitez automatiquement la mise à jour de fichiers.

Exemple

Dans cet exemple, il y a deux packages Delphi (Dumpackage et DamDesignPackage). Le package de conception-temps (DamDesignPackage) est configuré pour s'installer dans Delphi IDE. Le package d'exécution (amombrage) est configuré pour copier le fichier de formulaire DFM et le fichier de ressources pour libérer le dossier.

 [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

Vérifiez mes composants Delphi ici à GitHub et trouvez un fichier compinstall.ini pour voir d'autres exemples d'utilisation.