Packages/fr

Les paquets, pour VLE, sont des projets autonomes dans lesquels un ensemble de code sources (des modèles atomiques), de fichiers vpz, de documentations et de données se placent. Le but des paquets est de supprimer les dossiers globaux où se trouvent les plug-ins de simulation qui avaient lieu dans les versions antérieures à VLE 0.8.

Dossier VLE_HOME
Avant de développer la définition des paquets VLE, il est nécessaire de préciser l'endroit unique où les paquets doivent être déposés.

Le dossier VLE_HOME, défini par la variable d'environnement VLE_HOME, ou par défaut sous les Unix $HOME/.vle ou %HOMEDRIVE%%HOMEPATH%\vle sous Windows (correspondant au compte utilisateur, par exemple c:\documents and settings\homer\vle, pour l'utilisateur homer sur une configuration classique Windows), contient l'ensemble des projets en cours ainsi que des plug-ins développés par l'utilisateur. L'arborescence de ce dossier est la suivante :

$VLE_HOME ├─ conditions    ; des plug-ins de conditions pour GVLE ├─ outputs       ; des plug-ins de sorties pour GVLE ├─ pkgs          ; le dossier des paquets │  └─ firemanqss ; un exemple de paquet : firemanqss │      ├─ build │      ├─ data │      ├─ doc │      ├─ exp │      ├─ lib │      └─ src └─ stream        ; des plug-ins de sorties pour OOV

Les projets ou paquets que vous voulez que la plate-forme VLE retrouvent doivent tous se trouver dans le répertoire $VLE_HOME/pkgs. Pour une plus grande sécurité, vous pouvez protéger vos dossiers en créant des liens symboliques (sous systèmes POSIX). Par exemple :

Arborescence d'un projet
Un paquet VLE prend la forme d'un dossier avec un ensemble de sous-répertoires et de fichiers obligatoires. Par exemple, l'arborescence du paquet firemanqss dans le dossier VLE_HOME</tt> est la suivante : $VLE_HOME/pkgs/firemanqss ├─ build         ; le dossier de compilation (temporaire pour VLE) ├─ cmake         ; le dossier des scripts cmake ├─ data          ; le dossier des données ├─ doc           ; les documentations du modèle ├─ exp           ; le dossier des vpz ├─ lib           ; le dossier des simulateurs ├─ src           ; les sources des modèles ├─ Authors.txt   ; les auteurs du paquet ├─ ChangeLog.txt ; l'histoire du paquet ├─ License.txt   ; la licence du paquet ├─ News.txt      ; description des versions publiées du paquet ├─ Readme.txt    ; quelques notes sur le paquet └─ CMakeList.txt ; le fichier CMake pour compiler le paquet

Utilisation de VLE avec un projet
À utiliser pour déposer les modèles dans un dépôt de modèles. Les paquets sources et binaires sont des archives Zip ou tarball.
 * Initialisation du projet :
 * création des dossiers src, doc, data, exp, lib et build dans le dossier firemanqss de pkgs.
 * Configuration du projet :
 * exécution, dans le dossier build du paquet, de la commande cmake et le dossier du paquet comme destination, en mode RelWithDebInfo.
 * Compilation du projet :
 * exécution, dans le dossier build du paquet, de la commande make pour compiler la projet.
 * exécution, dans le dossier src du paquet, de la commande make install pour installer les fichiers des bibliothèques dynamiques dans le dossier lib du projet.
 * Liste tous les fichiers vpz et so / dll du projet :
 * Création des paquets :
 * exécution dans un sous dossier temporaire de $TMP, de la commande cmake sans dossier d'installation, puis make package package_source
 * déplacement des fichiers construits dans le dossier VLE_HOME.
 * Exécution d'une simulation :

Création de paquets sources et binaires

 * La création des paquets sources et binaires est à la charge du programme CPack. Le but de ces paquets est double :
 * Fournir un moyen simple de s'échanger des modèles ;
 * Préparer la plate-forme VLE à disposer d'un dépôt de modèles.

Notes sur l'API

 * Mise à disposition de méthodes pour récupérer directement les fichiers disponibles dans le dossier data avec les méthodes disponibles dans la classe devs::Dynamics</tt>:
 * Ainsi, pour récupérer le dossier chemin complet data</tt> du paquet :
 * Pour récupérer un fichier contenu dans le dossier data</tt> du paquet :
 * De la même manière, nous pouvons récupérer les dossiers et fichiers disponibles dans le dossier doc avec les méthodes :