~~NOTOC~~

====== Compiler Metafor sous Windows ======

Quelle que soit la plateforme (windows, Linux, ...) la compilation de Metafor comporte 2 étapes : 
  * la génération du projet via CMake
  * la compilation proprement dite (Visual Studio)

===== Génération du projet : CMake =====

[[http://www.cmake.org/|CMake]] est, entre autres choses, un outil multi-plateforme de génération de projet.

Supposant que vous avez fait un checkout des sources Metafor dans le répertoire ''E:\Dev\Meta''. Créer un répertoire vide au même niveau que les sources (peu importe son nom, ici, ''MetaBin''). Son emplacement par rapport aux sources est par contre immuable). Vous avez donc les 3 répertoires suivants:
  * ''E:\Dev\Meta\oo_meta''
  * ''E:\Dev\Meta\oo_nda''
  * ''E:\Dev\Meta\MetaBin''

Ouvrir une fenetre de commande et se positionner dans ''E:\Dev\Meta\MetaBin''
  * start -> accessoire -> cmd.exe
  * dans la fenetre de commande taper 
    * ''E:''
    * ''cd Dev\Meta\MetaBin''

La génération du projet Windows se fait en executant la commande suivante : 
  * ''%%cmake  -C ..\oo_meta\CMake\win64-vs2012.cmake ..\oo_meta%%''
soit 
  * l'execution de ''cmake'' 
  * lisant le fichier de configuration ''..\oo_meta\CMake\win64-vs2012.cmake'' 
  * dont la racine des source se trouve dans ''..\oo_meta''
<note> Attention : ''-C'' en MAJUSCULE </note>

===== Compilation - Visual Studio =====


Dans l'ensemble des répertoires et fichiers généré par [[http://www.cmake.org/|CMake]], 
se trouve le fichier projet du visual-studio ''E:\Dev\Meta\MetaBin\metafor.sln''.

==== Chargement du projet ====

Dans le Visual-Studio :
  * File -> Open -> Project/Solution 
  * sélectionner le fichier ''E:\Dev\Meta\MetaBin\metafor.sln''
ou 
  * double-cliquez le fichier ''E:\Dev\Meta\MetaBin\metafor.sln'' dans le gestionnaire de fichier windows
ou 
  * ...

==== Compilation ====

Il reste à choisir sa configuration :
  * Release : version optimisée pour faire des calculs
  * Debug : version non optimisée pour débugger le code
et compiler : 
  * Build->Build Solution (F7) 
  * Incredibuild-> BuildSolution (Ctrl+Alt+8) si Incredibuild est installé

==== Execution ====

L'executable Metafor généré s'appelle : 
  * ''E:\Dev\Meta\MetaBin\bin\Release\Metafor.exe'' pour une compilation Release
  * ''E:\Dev\Meta\MetaBin\bin\debug\Metafor_d.exe'' pour une compilation Debug

Pour demarrer Metafor on peut 
  * "double-cliquer" le fichier 
  * l'executer dans une fenetre de commande (''cmd.exe'') 
    * taper "Metafor -help" pour avoir les paramètres d'execution en ligne de commande
  * appeler Metafor à travers le Visual-Studio (utile pour debugger): 
    * Dans le "Solution explorer" sélectionner "Metafor"
    * Cliquer droit et selectionner "Set As StartUp Project" (Metafor se met en gras)
    * Debug -> Start (''with'' ou ''without debugger'' selon usage) 
  * Pour définir des paramètres d'execution dans le Visual-Studio (pour un debug ++):
    * Dans le "Solution explorer" sélectionner "Metafor"
    * Cliquer droit -> properties -> debugging
    * Définir les "command Argument" selon besoins
    * Debug -> Start (''with' ou ''without debugger'' selon usage)