16.1. Construire avec Visual C++ 2005

 $ENV{PATH}=$ENV{PATH} . ';c:\chemin\vers\bison\bin';
 

PostgreSQL se construit en utilisant soit les versions professionnelles (quelque soit l'édition) soit la version Express gratuite de Visual Studio 2005TM. Les produits supplémentaires suivants sont nécessaires pour construire le package complet. Utilisez le fichier config.pl pour indiquer les répertoires où se trouvent les bibliothèques.

Pour construire tout PostgreSQL dans la configuration par défaut, exécutez la commande :

 
 build
 
 

Pour construire tout PostgreSQL dans la configuration de débogage, exécutez la commande :

 
 build DEBUG
 
 

Pour construire un seul projet, par exemple psql, exécutez les commandes :

 
 build psql
 
 
 build DEBUG psql
 
 

Pour modifier la configuration de construction par défaut, placez ce qui suit dans le fichier buildenv.pl :

 
 $ENV{CONFIG}="Debug";
 
 

Il est aussi possible de construire à partir de l'interface de Visual Studio. Dans ce cas, vous devez exécuter :

 
 perl mkvcbuild.pl
 
 

à partir de l'invite, puis ouvrir le fichier pgsql.sln généré (dans le répertoire racine des sources) dans Visual Studio.

La plupart du temps, la récupération automatique des dépendances dans Visual Studio prendra en charge les fichiers modifiés. Mais, s'il y a eu trop de modifications, vous pouvez avoir besoin de nettoyer l'installation. Pour cela, exécutez simplement la commande clean.bat, qui nettoiera automatiquement les fichiers générés. Vous pouvez aussi l'exécuter avec le paramètre dist, auquel cas il se comporte comme make distclean et supprime les fichiers flex/bison en sortie.

Par défaut, tous les fichiers sont écrits dans un sous-répertoire de debug ou release. Pour installer ces fichiers en utilisant les emplacements standards et pour générer aussi les fichiers requis pour initialiser et utiliser la base de données, exécutez la commande :

 
 perl install.pl c:\destination\directory
 
 

Pour exécuter les tests de régression, assurez-vous que vous avez terminé la construction de toutes les parties requises. Ensuite, assurez-vous que les DLL nécessaires au chargement de toutes les parties du système (comme les DLL Perl et Python pour les langages de procédure) sont présentes dans le chemin système. Dans le cas contraire, configurez-les dans le fichier buildenv.pl. Pour lancer les tests, exécutez une des commandes suivantes à partir du répertoire src\tools\msvc :

 
 vcregress check
 
 
 vcregress installcheck
 
 
 vcregress plcheck
 
 
 vcregress contribcheck
 
 

Pour modifier la planification utilisée (en parallèle par défaut), ajoutez-la à la ligne de commande, comme :

 
 vcregress check serial
 
 

Pour plus d'informations sur les tests de régression, voir Chapitre 29, Tests de régression.

Construire la documentation PostgreSQL au format HTML nécessite plusieurs outils et fichiers. Créez un répertoire racine pour tous ces fichiers et stockez-les dans des sous-répertoires conformément à la liste ci-dessous.

Modifiez le fichier buildenv.pl et ajoutez une variable pour l'emplacement du répertoire racine, par exemple :

 $ENV{DOCROOT}='c:\docbook';
 

Pour construire la documentation, exécutez la commande builddoc.bat. Notez que ceci exécutera la construction une deuxième fois, pour générer les index. Les fichiers HTML générés seront dans le répertoire doc\src\sgml.