Apache Adobe Flex TutorialTutoriaux Adobe Flex & AIR en Français

Flex Modules – Optimiser vos modules avec load-externs

La taille des modules varie selon les composants et les classes utilisées par le module. Par défaut, un module inclus tout le code des classes du framework Flex utilisées, ce qui peut rendre le module bien plus lourd.

Pour réduire la taille des modules, vous pouvez ordonner au module d'externaliser les classes qui sont inclues dans l'application. Cela inclut les classes personnalisées et les classes du framework. Le module va donc seulement inclure les classes dont il a besoin, alors que le code du framework et les autres dépendances seront inclues dans l'application.

Pour externaliser les classes du framework, on va générer un rapport de liaison (linker report) depuis l'application qui va gérer les modules. Vous pourrez ensuite utiliser ce "linker report" comme paramètre pour l'option "-load-externs" du compilateur.

Créer et utiliser un linker report en ligne de commande (mxmlc)

• Générer le linker report (fichier XML) et le compiler dans l'application:

mxmlc -link-report=report.xml MyApplication.mxml

Le répertoire par défaut du rapport XML est le même répertoire que celui du compilateur (dans ce cas, dans le répertoire "bin"

• Compilez ensuite le module en passant le linker report dans l'option load-externs:

mxmlc -load-externs=report.xml MyModule.mxml

Si vous utilisez Flex Builder pour compiler des modules, vous pouvez utiliser cette technique si vous avec un projet séparé pour chaque module. Dans ce cas, pour l'application principale, vous pouvez ajouter l'option link-report au champ "Additional Compiler Arguments" dans les propriétés de votre projet Flex. Vous pouvez ensuite utiliser l'option load-externs dans le même champ pour chaque projet contenant un module.

Créer et utiliser un linker report dans Flex Builder

• Sélectionnez le projet principal dans la vue Flex Navigator
• Click droit > Properties > Flex Compiler
• Dans le champ "Additional Compiler Arguments", indiquez le répertoire de sortie de votre linker report comme ceci:

-locale en_US -link-report=c:/temp/externs/report.xml

Le répertoire par défaut du link-report est le répertoire principal de Flex Builder lui même. Sous Windows, c'est par exemple: c:\Program Files\Adobe\Flex Builder 3. Si vous faites uniquement "-link-report=report.xml", le fichier report.xml sera donc crée dans le répertoire de FB.

• Cliquez sur OK pour sauver vos changements
• Sélectionnez le projet du module dans le Flex Navigator. Si vous utilisez plusieurs projets pour vos modules, répétez ces étapes pour chaque projet.
• Click droit > Properties > Flex Compiler
• Dans le champ "Additional Compiler Arguments", indiquez le répertoire de sortie dans lequel se trouve le linker report comme ceci:
• Cliquez sur OK pour sauver vos changements
• Assurez-vous que le projet de l'application principale apparait bien en premier dans l'ordre de build. Cela vous assure que le linker report est généré par l'application principale avant qu'il soit consommé par les modules.

Re-compilation de modules

Si vous modifiez un module, vous n'avez pas à recompiler l'application qui utilise le module. L'application charge le module à l'exécution, il n'y a donc pas de vérification à la compilation. De même, si vous ne changer pas votre application, vous n'avez pas à recompiler les modules.

Cependant, si vous faîtes des modifications qui pourraient affecter le "linker report" ou du code commun, vous devriez compiler à la fois l'application et les modules.