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.4.5 - documentation en ligne de la bibliothèque QxOrm - GitHub
QxEntityEditor 1.2.3
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 © 2018 Lionel Marty - contact@qxorm.com