QxOrm Windows Linux Macintosh C++
Accueil T�l�chargement Exemple rapide Tutoriel (4)
Manuel (2)
Forum Nos clients
QxOrm >> Tutoriel >> Installer un environnement de d�veloppement avec QxOrm sous Windows
Version courante :  QxOrm 1.5.0 - documentation en ligne de la biblioth�que QxOrm - GitHub
QxEntityEditor 1.2.8
Version fran�aise du site Web site english version
S�lection du tutoriel : Tuto n�1 : qxBlog Tuto n�2 : qxClientServer Tuto n�3 : install QxOrm Tuto n�4 : video QxEntityEditor

Ce tutoriel pr�sente les diff�rentes �tapes pour installer un environnement de d�veloppement avec Qt, boost (optionnel) et la biblioth�que QxOrm sous Windows, chaque biblioth�que �tant compil�e en mode 32 bits (la proc�dure sera similaire pour d�velopper en mode 64 bits).
A la fin de ce tutoriel, vous pourrez utiliser au choix les EDI Microsoft Visual C++ 2012 et QtCreator.

Pr�requis : Microsoft Visual C++ 2012 est d�j� install� sur le poste (peu importe la version : � Express �, � Professional �, etc.).

Remarque : chaque version de la biblioth�que QxOrm est test�e sous Windows avec MSVC++ (en mode 32 bits et 64 bits) et MinGW GCC 4.5. Bien que ce tutoriel s'applique pour l'EDI MSVC++ 2012, les diff�rentes �tapes de la proc�dure d'installation seront �quivalentes pour les autres compilateurs/�diteurs.

Autre remarque : bien que ce tutoriel s'applique pour les utilisateurs Windows, chaque version de QxOrm est test�e et valid�e sous Linux (GCC) et sous Mac OS X (Clang).

Ce tutoriel est constitu� des �tapes suivantes : Remarque : ce tutoriel est �galement disponible sur le site www.developpez.com.
 qt_ambassador
QxOrm library has been accepted into the Qt Ambassador Program

1- T�l�charger et installer Qt (Qt4 ou Qt5)

T�l�charger Qt � l'adresse suivante : http://www.qt.io/download/
Par exemple :



Ensuite, ex�cutez le fichier t�l�charg� et suivez les instructions du programme d'installation de Qt.


2- Ajouter le dossier � bin � de Qt dans le � PATH � de Windows

Une fois Qt install�, il est recommand� d'ajouter le dossier � bin � du r�pertoire d'installation de Qt dans la variable d'environnement � PATH � de Windows.

Allez dans les � Param�tres syst�me avanc�s � de Windows, puis cliquez sur le bouton � Variables d'environnements � :



Ajouter une variable syst�me nomm�e � QT_DIR � :
  • Nom de la variable : � QT_DIR � ;
  • Valeur de la variable : chemin d'acc�s vers le r�pertoire d'installation de Qt :
    • Pour Qt4 : � QT_DIR � doit pointer vers la racine du dossier d'installation de Qt ;
    • Pour Qt5 : le dossier d'installation est diff�rent par rapport � Qt4, dans notre cas il faut descendre jusqu'au niveau : � .\5.1.1\msvc2012\ �.
Par exemple :



Modifier la variable syst�me � PATH � pour ajouter la valeur suivante : � ;%QT_DIR%\bin\; �



A pr�sent, Qt est disponible sur votre environnement de d�veloppement. Il est possible de tester l'installation en ouvrant une fen�tre DOS (menu � D�marrer �, � Ex�cuter � puis � cmd �), puis en lan�ant la commande : � qmake -version � :



Remarque : pourquoi avoir ajout� Qt dans le PATH de Windows ? Tous les ex�cutables n�cessaires pour le fonctionnement de Qt (qmake, moc, ui, rcc, etc.) sont accessibles dans le syst�me sans avoir � param�trer autre chose. De plus, il sera tr�s facile de basculer d'une version de Qt � une autre : il suffit tout simplement de modifier la valeur de � QT_DIR � pour indiquer un autre r�pertoire d'installation de Qt.


3- Installer la biblioth�que boost (optionnel)

Remarque : par d�faut, la biblioth�que QxOrm d�pend uniquement de Qt (QtCore et QtSql). L'installation de boost est optionnelle et non requise avec la configuration par d�faut : si vous ne souhaitez pas travailler avec la biblioth�que boost, alors vous pouvez aller directement � l'�tape suivante de ce tutoriel.

Autre remarque : QxOrm propose 2 niveaux de d�pendance � boost en option :
  • une d�pendance uniquement aux fichiers d'en-t�tes de boost (*.hpp) : option de compilation _QX_ENABLE_BOOST ;
  • une d�pendance au module boost serialization : option de compilation _QX_ENABLE_BOOST_SERIALIZATION.
Le plus simple et le plus rapide est de t�l�charger le package boost fourni sur le site QxOrm.
Le package boost le plus r�cent est disponible � cette adresse : https://www.qxorm.com/lib/boost_1_57.zip



Ce package contient tous les fichiers en-t�tes (*.hpp) de boost (dans le dossier � include �), et le module � boost::serialization � compil� pour les environnements suivants (dans le dossier � lib_shared � en mode 32 bits et � lib_shared_64b � en mode 64 bits) :
  • MSVC++ 2008 (fichiers avec un nom contenant vc90) ;
  • MSVC++ 2010 (fichiers avec un nom contenant vc100) ;
  • MSVC++ 2012 (fichiers avec un nom contenant vc110) ;
  • MinGW GCC 4.5 (fichiers avec un nom contenant mgw45).
A la racine du package boost, le fichier � version_1_57.txt � indique les lignes de commande utilis�es pour compiler le module � boost::serialization � (module optionnel et non requis par d�faut).


4- Ajouter le dossier � lib_shared � du package boost dans le � PATH � de Windows (optionnel)

Remarque : cette �tape est optionnelle et non requise avec la configuration par d�faut : si vous ne souhaitez pas travailler avec les fonctionnalit�s propos�es par le module boost serialization, alors vous pouvez aller directement � l'�tape suivante de ce tutoriel.

Allez dans les � Param�tres syst�me avanc�s � de Windows, puis cliquez sur le bouton � Variables d'environnements � :



Ajouter une variable syst�me nomm�e � BOOST_DIR � :
  • Nom de la variable : � BOOST_DIR � ;
  • Valeur de la variable : chemin d'acc�s vers le r�pertoire d'installation du package boost.
Par exemple :



Modifier la variable syst�me � PATH � pour ajouter la valeur suivante : � ;%BOOST_DIR%\lib_shared\; �



Remarque : il est �galement possible d'ajouter le r�pertoire � lib_shared_64b � dans le PATH de Windows si l'on souhaite d�velopper en mode 64 bits : � ;%BOOST_DIR%\lib_shared_64b\; �.


5- T�l�charger et installer la biblioth�que QxOrm

La derni�re version de la biblioth�que QxOrm est disponible � cette adresse : https://www.qxorm.com/qxorm_fr/download.html
Une fois t�l�charg�e, veuillez d�compresser le fichier dans le dossier de votre choix.


6- Param�trer le fichier � QxOrm.pri � (optionnel)

Remarque : si vous ne souhaitez pas travailler avec la biblioth�que boost, alors aucune modification n'est n�cessaire dans le fichier de configuration � QxOrm.pri �.

Sinon, si vous souhaitez travailler avec la biblioth�que boost, alors il est n�cessaire d'indiquer � la biblioth�que QxOrm comment acc�der � boost en modifiant le fichier � QxOrm.pri � (attention, seul le fichier � QxOrm.pri � peut �tre modifi�, les autres fichiers du package QxOrm ne doivent pas �tre modifi�s).

Ouvrez le fichier � QxOrm.pri � avec un �diteur de texte (notepad ou notepad++ par exemple), puis modifier les valeurs des param�tres :
  • � QX_BOOST_INCLUDE_PATH � (requis) ;
  • � QX_BOOST_LIB_PATH � (optionnel, utilis� seulement si l'option de compilation _QX_ENABLE_BOOST_SERIALIZATION est d�finie) ;
  • � QX_BOOST_LIB_SERIALIZATION_DEBUG � (optionnel, utilis� seulement si l'option de compilation _QX_ENABLE_BOOST_SERIALIZATION est d�finie) ;
  • � QX_BOOST_LIB_SERIALIZATION_RELEASE � (optionnel, utilis� seulement si l'option de compilation _QX_ENABLE_BOOST_SERIALIZATION est d�finie) ;
  • � QX_BOOST_LIB_WIDE_SERIALIZATION_DEBUG � (optionnel, utilis� seulement si l'option de compilation _QX_ENABLE_BOOST_SERIALIZATION est d�finie) ;
  • � QX_BOOST_LIB_WIDE_SERIALIZATION_RELEASE � (optionnel, utilis� seulement si l'option de compilation _QX_ENABLE_BOOST_SERIALIZATION est d�finie).
Par exemple :

isEmpty(QX_BOOST_INCLUDE_PATH) { QX_BOOST_INCLUDE_PATH = $$quote(D:/Dvlp/_Libs/Boost/1_57/include) }

contains(DEFINES, _QX_ENABLE_BOOST_SERIALIZATION) {

isEmpty(QX_BOOST_LIB_PATH) { QX_BOOST_LIB_PATH = $$quote( D:/Dvlp/_Libs/Boost/1_57/lib_shared) }
isEmpty(QX_BOOST_LIB_SERIALIZATION_DEBUG) { QX_BOOST_LIB_SERIALIZATION_DEBUG = "boost_serialization-vc110-mt-gd-1_57" }
isEmpty(QX_BOOST_LIB_SERIALIZATION_RELEASE) { QX_BOOST_LIB_SERIALIZATION_RELEASE = "boost_serialization-vc110-mt-1_57" }
# isEmpty(QX_BOOST_LIB_WIDE_SERIALIZATION_DEBUG) { QX_BOOST_LIB_WIDE_SERIALIZATION_DEBUG = "boost_wserialization-vc110-mt-gd-1_57" }
# isEmpty(QX_BOOST_LIB_WIDE_SERIALIZATION_RELEASE) { QX_BOOST_LIB_WIDE_SERIALIZATION_RELEASE = " boost_wserialization-vc110-mt-1_57" }

} # contains(DEFINES, _QX_ENABLE_BOOST_SERIALIZATION)

Remarque : Le fichier � QxOrm.pri � est un fichier de configuration de la biblioth�que QxOrm. Ce fichier devra �tre inclus dans tous les fichiers projets d�pendants de QxOrm en ajoutant la ligne suivante dans le fichier *.pro du projet : include(my_path_to_QxOrm_library/QxOrm.pri)


7- Ajouter QxOrm dans le � PATH � de Windows

Tout comme pour les variables � QT_DIR � et � BOOST_DIR �, nous allons ajouter une variable d'environnement nomm�e � QXORM_DIR �.
Allez dans les � Param�tres syst�me avanc�s � de Windows, puis cliquez sur le bouton � Variables d'environnements � :



Ajouter une variable syst�me nomm�e � QXORM_DIR � :
  • Nom de la variable : � QXORM_DIR � ;
  • Valeur de la variable : chemin d'acc�s vers le r�pertoire d'installation du package QxOrm.
Par exemple :



Modifier la variable syst�me � PATH � pour ajouter la valeur suivante : � ;%QXORM_DIR%\lib\; �





8- Tester l'installation avec le projet de test � qxBlog �

Pour tester rapidement l'installation, il est possible d'ouvrir le projet de test � qxBlog � du package QxOrm : ouvrir le fichier � ./test/qxBlog/qxBlog.sln � avec l'�diteur MSVC++ 2012, puis compiler et ex�cuter le projet.

Si l'ex�cution du projet se passe sans erreur et sans assert, alors votre environnement de d�veloppement est pr�t : Qt, boost et QxOrm sont correctement install�s !


9- Tester tous les projets de test du package QxOrm avec MSVC++ 2012

Il est possible de tester tous les projets de test du package QxOrm, chaque projet ayant un fichier � *.sln � et peut donc �tre utilis� par MSVC++ : chaque projet de test doit se compiler et s'ex�cuter sans aucune erreur.

Remarque : Qt fournit un Add-in pour les EDI Microsoft Visual C++, il est donc possible de les installer pour faciliter l'int�gration de Qt (gestion automatique des fichiers projets *.pro par exemple).
Pour t�l�charger cet Add-in, rendez-vous sur la page de t�l�chargement de Qt : http://www.qt.io/download/





10- Tester QxOrm avec l'EDI QtCreator

Pour ceux qui pr�f�rent utiliser QtCreator � la place de MSVC++ : lancer QtCreator pr�sent dans le dossier d'installation de Qt � .\Tools\QtCreator\bin\qtcreator.exe �.
Ouvrir le menu � Outils >> Options �, puis aller dans la section � Compiler & Ex�cuter �, onglet � Kits �, pour v�rifier que c'est bien le compilateur de MSVC++ 2012 qui sera utilis� � la compilation dans QtCreator :



Si par d�faut, vous n'avez pas de d�bogueur param�tr� comme sur la copie d'�cran ci-dessus, veuillez installer � Debugging Tools for Windows SDK � disponible sur le site de Microsoft (http://msdn.microsoft.com/en-us/windows/hardware/hh852363.aspx). Ensuite, relancez QtCreator et vous devriez avoir � pr�sent :



Remarque : vous trouverez plus d'informations sur le param�trage du d�bogeur dans QtCreator sur le site de Qt : http://qt-project.org/wiki/Qt_Creator_Windows_Debugging

A pr�sent, vous pouvez utiliser QtCreator ou MSVC++ 2012, au choix !

QxOrm � 2011-202XDL Teamty - ic-east.com