Images-actives

De Wiki Dane (ex wikitice)
Aller à : navigation, rechercher

Documentation relative à l'application Images Actives du CRDP de l'Académie de Versailles 

Compiler Images Actives

Cet article donne des indications pour recompiler l'application "Images actives" sur votre système d'exploitation : Linux, Macintosh ou Windows.

Dans sa version actuelle, Images Actives comporte deux langages et doit être compilé en 2 phases.

  1. Compilez le code ActionScript 3 à l'aide du compilateur mxmlc inclus dans le SDK Open Source d'Adobe
  2. Compilez le code C++ avec un compilateur adapté à votre OS et le framework QT4 LGPL

Notez que la récompilation du code Actionscript n'est pas une nécessité : en effet, le fichier swf obtenu consiste en bytecode qui s'exécute dans une machine virtuelle.

Récupérez le code source avec svn à l'adresse : https://svn.crdp.ac-versailles.fr/svn/images-actives/trunk/

Compiler le code AS3

Plusieurs possibilités s'offrent à vous selon votre système d'exploitation :

  • la compilation en ligne de commande avec le Flex SDK open source
  • la compilation avec Ant avec le Flex SDK open source
  • la compilation sous Eclipse avec le plugin FDT (Flash Development Tool) et éventuellemnt Ant
  • sous Windows, l'environnement de développement open source Flashdevelop est un choix pertinent.

Notez qu'Images Actives ne compilera pas tant que vous n'aurez pas mis dans le répertoire /assets/fonts des fichiers de polices (.ttf) correspondant à ceux qui figurent dans les balises embed de la classe fr.acversailles.crdp.imagesActives.vue.fonts. Vous pouvez aussi en profiter pour mettre d'autres polices.

En ligne de commande

Nous ne donnons ici que la marche à suivre sous Linux, mais elle devrait fonctionner sous les autres OS.

Téléchargez "Open Source Flex SDK" 4.1 depuis la page http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4

(la version "Adobe Flex SDK" n'est pas requise).

Placez vous dans le répertoire racine (AS3). Lancez la compilation :

chemin/du/flex-sdk/bin/mxmlc -compiler.source-path src -compiler.library-path lib -compiler.library-path assets/preloader/CRDP_Preload_1.swc -compiler.library-path /chemin/du/flex-sdk/frameworks/libs -default-size 800 600 -default-frame-rate 24 -target-player=10.0.0 -default-background-color 0x000000 -static-link-runtime-shared-libraries=true src/fr/acversailles/crdp/imagesActives/ImagesActives.as

Expication de la commande de compilation :

chemin/du/flex-sdk/bin/mxmlc le compilateur (mxmlc)
-compiler.source-path src le répertoire des sources
-compiler.library-path lib le répertoire des librairies as3 utilisées par le projet
-compiler.library-path assets/preloader/CRDP_Preload_1.swc animation de préchargement du CRDP de l'Académie de versailles (archive)
-compiler.library-path /chemin/du/flex-sdk/frameworks/libs
librairies du framework flex
-default-size 800 600
L'animation est compilée dans les dimensions 800 600
-default-frame-rate 24 La cadence du flash player est définie à 24 images/seconde
-target-player=10.0.0 La version 10 du flash player est requise
-default-background-color 0x000000 Couleur de fond par défaut
-static-link-runtime-shared-libraries=true Nécessaire car il n'y a pas de librairies partagées à l'exécution
src/fr/acversailles/crdp/imagesActives/ImagesActives.as Classe principale : fr.acversailles.crdp.imagesActives.ImgesActives
-o CRDPImagesActives.swf Le fichier compilé s'appelle CRDPImagesActives.swf

Si vous voulez également recompiler l'animation en format paysage :

Editez la classe : fr.acversailles.crdp.imagesActives.Parametres et commentez ainsi les lignes 14-15

public static const LARGEUR_SCENE : Number = 1200;

//public static const LARGEUR_SCENE : Number = 800;

Modifiez en conséquence l'option -default-size du compilateur.
Il s'agit d'une modification récente qui aurait vocation à être implémentée de façon plus élégante  via un mécanisme de compilation conditionnelle avec passage de la hauteur en paramètre de mxmlc.

Avec Ant sans FDT

Si vous souhaitez utiliser Ant sans dépendre de la tâche 'fdt.launch.application' de FDT utilisez la tâche Ant 'exec' avec la syntaxe suivante :

<exec executable="chemin/du/sdk/bin/mxmlc" failonerror="true">

<arg path="repertoire/principal/src/fr/acversailles/crdp/imagesActives/ImagesActives.as " />

<arg line="-compiler.source-path repertoire/principal/src" />

<arg line="-compiler.library-path chemin/du/sdk/frameworks/libs" />

<arg line="-compiler.library-path repertoire/principal/lib" />

<arg line="-output bin/CRDPImagesActives.swf" />

<arg line="-default-size 800 600" /> <arg line="-default-frame-rate 24" />

<arg line="-target-player=10.0.0" />

<arg line="-default-background-color 0x000000" />

<arg line="-static-link-runtime-shared-libraries=true" />

</exec>

Sous Eclipse FDT avec Ant

Dans l'environnement de développement Eclipse, avec le plugin commercial FDT (pour lequel il existe  toutefois des licences gratuites pour l'éducation) , vous pouvez compiler le projet avec ant :

  • ouvrez la vue ant
  • glissez-y le fichier build.xml inclus dans le répertoire ant
  • double-cliquez le fichier build.xml

Il est souvent nécessaire, dans le menu "External Tool Configurations", sous l'onglet "JRE", de cocher "Run in the same JRE as the workspace"pour que cela fonctionne.

Compiler le code C++/QT4

Nous supposons que vous avez installé le framework Qt4 LGPL et que vous disposez d'un compilateur. Sous linux, utilisez par exemple GNU-GCC, sous Windows MinGW, sous mac, installez l'environnement Xcode et le compilateur viendra avec.

Si vous avez recompilé le code Actionscript, placez les fichiers CRDPImagesActives.swf obtenus dans les répertoires /assets/web/paysage et /assets/web/portrait.

Ouvrez l'interpréteur de commandes, placez vous dans le répertoire cpp et saisissez :
qmake -project

Un fichier portant l'extension .pro a été généré, editez-le et sous la ligne :

INCLUDEPATH += .

ajoutez :
QT += xml

puis  :


sous linux et windows :

qmake

sous Mac OS :

qmake -spec macx-g++

Et enfin, quel que soit l'OS :

make