Retrouvez gratuitement la notice de l'appareil FLASH BUILDER 4 ADOBE au format PDF.
Téléchargez la notice de votre Développement logiciel au format PDF gratuitement ! Retrouvez votre notice FLASH BUILDER 4 - ADOBE et reprennez votre appareil électronique en main. Sur cette page sont publiés tous les documents nécessaires à l'utilisation de votre appareil FLASH BUILDER 4 de la marque ADOBE.
Création de modules
Application de styles
Liaison des contrôles à des données
Flash Builder est basé sur Eclipse, un environnement IDE de type « open source », et fournit tous les outils requis pour développer des applications qui utilisent la structure Flex et ActionScript 3.0. Flash Builder s’exécute sous Microsoft Windows et Apple Macintosh OS X et est disponible en plusieurs versions. Les options de configuration d’installation vous permettent d’installer Flash Builder en ensemble de plug-ins dans une installation de workbench Eclipse existante ou de créer une installation incluant le workbench Eclipse.
Flash Builder vous permet de développer des applications dans un environnement IDE complet et de réaliser les tâches suivantes :
Adobe LiveCycle® Data Services, avec ou sans serveur Flex. Voir « Création de projets Flex » à la page 41.
• Rédaction et modification du code source des applications à l’aide d’éditeurs fournissant des fonctions telles que la restructuration de code, les indicateurs de code, la navigation de code rationnalisée et la vérification automatique des erreurs de syntaxe. Voir « A propos de la modification du code dans Flash Builder » à la page 103.
• Publication du code source des applications afin que les utilisateurs et les autres développeurs puissent le visionner. Voir « Publication du code source » à la page 85.
Flash Builder est disponible en deux versions : Standard et Premium. Flash Builder version Standard Cette version fournit un environnement IDE complet qui vous permet de créer des applications à l’aide de la structure Flex et de l’API Flash. Flash Builder version Standard inclut également des éditeurs MXML, ActionScript et CSS, ainsi que des outils de débogage. Il fournit une bibliothèque de diagrammes et de graphiques interactifs qui vous permettent de créer des tableaux de bord riches, des analyses de données interactives et des composants de visualisation des données. Flash Builder version Premium Outre les fonctionnalités de la version Standard, Flash Builder Premium comporte des outils de profilage de la mémoire et des performances ainsi que des outils de tests automatisés. Utilisez le Moniteur de réseau pour consulter les données qui sont transmises entre une application client et un service de données. L’environnement de test FlexUnit permet de générer et de modifier des tests reproduisibles pouvant être exécutés à partir de scripts ou directement à l’intérieur ou à l’extérieur de l’environnement Flash Builder. Les fonctionnalités de génération par ligne de commande vous permettent de synchroniser les paramètres de génération d’un développeur avec une génération nocturne.
Flash Builder comporte deux programmes d’installation. Programme d’installation plug-in Ce programme d’installation est destiné aux utilisateurs ayant déjà recours au workbench Eclipse et souhaitant ajouter les plug-ins Flash Builder à leur ensemble de plug-ins Eclipse. Cela peut être le cas par exemple des développeurs d’applications Java. Etant donné qu’Eclipse est une plateforme extensible et ouverte, des centaines de plug-ins sont disponibles à différentes fins de développement. Programme d’installation autonome Ce programme d’installation est un package personnalisé de plug-ins Eclipse et
L’interface utilisateur de l’installation autonome est plus étroitement intégrée que l’installation plug-in. L’installation autonome permet d’éviter en grande partie les confusions auxquelles l’installation plug-in, multi-usage et ouverte, risque de prêter. Elle est idéale pour les nouveaux utilisateurs ainsi que pour ceux qui souhaitent développer uniquement des applications reposant sur la structure Flex et ActionScript 3.0.
A propos de Flash Builder
ActionScript, utilisez le programme d’installation autonome de Flash Builder. Ce programme d’installation vous permet également d’installer d’autres plug-ins Eclipse afin d’étendre la portée de vos futurs travaux de développement. Les programmes d’installation plug-in et autonome de Flash Builder fournissent les mêmes fonctionnalités.
Cette version de Flash Builder comporte le client de l’Aide de la communauté Adobe (Adobe Community Help Client, CHC). Le client CHC est une application basée sur AIR qui remplace le moteur d’aide Eclipse pour Flash Builder et constitue la plateforme pour la nouvelle génération d’aide Adobe. Le client CHC se caractérise par les propriétés suivantes :
Si vous disposez d’une connexion réseau, le client CHC accède au contenu situé sur le Web pour vous fournir en permanence les informations les plus récentes. En l’absence de connexion Internet, il est également opérationnel en mode local.
Vous pouvez utiliser les fonctions de recherche de l’Aide de la communauté (adobe.com) ou procéder à une recherche locale. La recherche de l’Aide de la communauté regroupe les ressources, dont celles des sites tiers. La recherche adobe.com comporte des critères vous permettant d’en restreindre la portée.
La navigation en contexte fournit un ensemble généré dynamiquement de liens associés dirigeant vers des pages clés.
Notions de base du workbench Flash Builder Adobe® Flash® Builder™ repose sur Eclipse, un environnement de développement intégré de type « open source ». Il vous permet de développer des applications Flex® et ActionScript® 3.0 à l’aide de puissants outils de codage, de mise en forme visuelle, de création et de débogage.
Le workbench Flash Builder est un environnement de développement entièrement intégré conçu pour vous aider à développer des applications pour la structure Adobe Flex. Vous pouvez développer des applications à déployer sur Adobe Flash Player et des applications de bureau à déployer sur Adobe AIR®. Flash Builder repose sur Eclipse, un environnement IDE de type « open source ». Flash Builder est un ensemble de plug-ins Eclipse vous permettant de créer des applications Flex et ActionScript 3.0. La plupart des fonctionnalités de base de l’environnement IDE de Flash Builder provient d’Eclipse. Cela inclut, par exemple, les fonctions de gestion, de recherche et de navigation dans les ressources. Les plug-ins Flash Builder ajoutent les fonctions et fonctionnalités permettant de créer des applications Flex et ActionScript 3.0. Ils modifient également l’interface utilisateur IDE et certaines fonctionnalités pour prendre en charge ces tâches. Les informations nécessaires à l’utilisation de Flash Builder sont présentées dans la documentation de Flash Builder. A moins d’utiliser d’autres plug-ins Eclipse (CVS ou Java, par exemple) avec Flash Builder, ou si vous souhaitez étendre les plug-ins Flash Builder (voir « Extension du workbench Flash Builder » à la page 23), vous n’avez pas à vous soucier de l’infrastructure Eclipse sous-jacente. Workbench Le terme workbench désigne l’environnement de développement Flash Builder. Le workbench contient
Perspective Une perspective représente un groupe de vues et d’éditeurs du workbench. Il s’agit essentiellement d’un
Profil Flash. Si vous utilisez la configuration plug-in de Flash Builder (voir « Programmes d’installation Flash Builder » à la page 2), le workbench peut contenir d’autres perspectives telles qu’une perspective Java contenant des éditeurs et des vues permettant de développer des applications Java. Pour plus d’informations sur les perspectives, voir « A propos des perspectives de Flash Builder » à la page 7. Editeur Un éditeur vous permet d’éditer différents types de fichier. Les éditeurs dont vous disposez varient selon le
MXML, ActionScript 3.0 et CSS (Cascading Style Sheets, feuilles de style en cascade). Pour plus d’informations sur la modification du code dans Flash Builder, voir « A propos de la modification du code dans Flash Builder » à la page 103. Vues Une vue comporte généralement un éditeur. Par exemple, lors de l’édition MXML, les vues Composants et Propriétés apparaissent également dans la perspective Développement Flash. Ces vues prennent en charge le développement d’applications et s’affichent par conséquent lorsqu’un fichier MXML est ouvert en édition.
Adobe Dreamweaver® et dans d’autres outils de développement Adobe. Espace de travail A ne pas confondre avec le workbench, un espace de travail représente une zone définie d’un système
Ressource Le terme ressource est utilisé de façon générique pour désigner les fichiers et dossiers des projets d’un espace
Projet Toutes les ressources constituant vos applications figurent dans des projets. Vous ne pouvez pas créer une
Builder : les projets Flex, les projets ActionScript et les projets de bibliothèque. Pour plus d’informations, voir « Utilisation des projets » à la page 35. Configuration de lancement Une configuration de lancement est créée pour chacun de vos projets. Elle définit les
Flash Builder contient des éditeurs vous permettant d’éditer du code MXML, ActionScript 3.0 et CSS. Les éditeurs constituent la pierre angulaire du workbench et des vues. Les perspectives dans lesquelles ils figurent prennent en charge leurs fonctionnalités. Les éditeurs sont associés à des types de ressource. Ainsi, lorsque vous ouvrez des ressources dans le workbench, l’éditeur correspondant s’affiche. Le workbench représente un environnement orienté document (et orienté projet) destiné au développement d’applications. Le développement d’applications Flex dans Flash Builder repose sur l’utilisation des éditeurs MXML, ActionScript 3.0 et CSS. Chaque éditeur intègre les fonctionnalités nécessaires au type de ressource donné. Flash Builder contient les éditeurs suivants. Editeur MXML Utilisez l’éditeur MXML pour éditer le code MXML et pour incorporer un code ActionScript et CSS
Source sert à l’édition du code. Le mode Création permet la présentation et la conception visuelles des applications. Les deux modes sont synchronisés et les modifications effectuées dans un mode sont aussitôt répercutées dans l’autre mode. Pour plus d’informations, voir « A propos de la modification du code dans Flash Builder » à la page 103. Editeur ActionScript Utilisez l’éditeur ActionScript pour éditer des fichiers de classe et d’interface ActionScript. Bien
Editeur CSS Utilisez l’éditeur CSS pour afficher et éditer des feuilles de style en cascade. Vous pouvez ensuite appliquer des styles aux éléments visuels de vos applications. Pour plus d’informations, voir « Utilisation visuelle des composants » à la page 196 et Using Styles and Themes.
Les indicateurs de code apparaissent automatiquement lorsque vous saisissez du code (vous pouvez également afficher les indicateurs de code en appuyant sur Ctrl+Espace). L’exemple suivant illustre les indicateurs de code dans l’éditeur MXML :
Les indicateurs de code ActionScript sont également pris en charge. Les indicateurs de code ActionScript s’affichent dans les balises <fx:Script> incorporées dans un document MXML et dans des fichiers ActionScript autonomes. L’Assistant de contenu affiche des indicateurs de code pour tous les éléments de langage ActionScript : interfaces, classes, variables, fonctions, types de renvoi, etc. L’assistant de contenu affiche également le contenu ASDoc pour les classes et interfaces ActionScript. Il propose également des indicateurs de code pour les composants MXML personnalisés ou les classes ActionScript que vous créez vous-même. Si vous définissez par exemple un composant MXML personnalisé et l’ajoutez à votre projet, les indicateurs de code apparaissent lorsque vous référencez le composant dans le fichier d’application MXML. Pour plus d’informations, voir « A propos de l’assistant de contenu » à la page 106.
Flash Builder permet la génération automatique de code de gestionnaires d’événement afin de simplifier l’association d’événements aux composants de votre application. En mode Création, sélectionnez un composant. Dans la catégorie Evénements de la vue Propriétés, cliquez ensuite sur le bouton Générer un gestionnaire d’événement d’un événement répertorié. L’éditeur affiche le mode Source et génère un gestionnaire d’événement dans la section Script du code source. L’éditeur place également une propriété d’événement dans la balise de composant qui référence le gestionnaire d’événement généré. Vous pouvez également générer des gestionnaires d’événement en mode Source en faisant appel à l’assistant de contenu.
La navigation par code simplifie la saisie du code, en particulier avec les projets de grande taille comportant de nombreuses ressources. La navigation par code offre la possibilité de sélectionner un élément de code (une référence à un composant personnalisé d’un fichier d’application MXML, par exemple) et d’aller à la source de la définition du code, quel que soit son emplacement dans le projet, espace de travail ou chemin. D’autres fonctionnalités de navigation par code incluent la réduction de code qui vous permet de réduire et de développer des instructions de code à plusieurs lignes. Une autre fonctionnalité est la vue Structure, qui offre une présentation hiérarchique et vous permet de parcourir tous les éléments de l’interface utilisateur et de code d’un fichier. Pour plus d’informations, voir « Navigation et organisation du code » à la page 111.
Lorsque vous saisissez du code, Flash Builder insère automatiquement des lignes de code pour améliorer la lisibilité, ajoute une couleur distinctive aux éléments de code et propose de nombreuses commandes de formatage rapide du code que vous saisissez (ajout d’un commentaire de bloc, par exemple). Lorsque vous collez du code MXML ou ActionScript dans l’éditeur de code, Flash Builder met automatiquement en retrait le code en fonction de vos préférences. Vous pouvez également spécifier une mise en retrait pour un bloc de code sélectionné. Pour plus d’informations, voir « Formatage et modification du code » à la page 116.
Flash Builder peut rechercher toutes les références et les déclarations correspondant aux identifiants d’un fichier, d’un projet ou d’un espace de travail donné. La recherche porte également sur les éléments reliés à partir de fichiers SWC ainsi que les entrées des chemins de bibliothèque (classes, interfaces, fonctions, variables et quelques métadonnées, par exemple). La restructuration vous permet de renommer les identificateurs de votre code tout en mettant à jour toutes les références correspondantes dans la totalité de la base de code. Pour plus d’informations, voir « Recherche de références et restructuration de code » à la page 118.
Pour prendre en charge une tâche particulière ou un groupe de tâches, les éditeurs et les vues correspondantes sont combinés dans une perspective. Flash Builder contient deux perspectives : Débogage Flash et Développement Flash. Flash Builder Premium contient une perspective supplémentaire, Profil Flash. Les perspectives changent automatiquement selon la tâche en cours. Par exemple, si vous créez un projet Flex, le workbench affiche la perspective Développement ; si vous lancez une session de débogage, la perspective Débogage Flash s’affiche lorsque le premier point d’arrêt est atteint. Vous pouvez changer manuellement de perspective en sélectionnant Fenêtre > Perspective dans le menu principal (Fenêtre > Ouvrir la perspective dans la version plug-in). Vous pouvez également utiliser la barre des perspectives, située dans la barre d’outils principale du workbench.
En mode Source (édition de code), la perspective Développement contient les éléments suivants.
ActionScript et CSS que vous utilisez. L’éditeur MXML comporte deux modes (Source et Création). Le passage de l’un à l’autre adapte la perspective Développement en fonction des tâches qui y seront effectuées.
L’éditeur CSS est un éditeur à fonction unique pour les projets basés sur le SDK Flex 4. Pour les projets basés sur le SDK Flex 3, l’éditeur CSS comporte toutefois deux modes (Source et Création). Pour plus d’informations sur l’utilisation de l’éditeur MXML, voir « A propos de la modification du code dans Flash Builder » à la page 103 et « Utilisation visuelle des composants » à la page 196.
Développement et Débogage.
Vue Structure En mode Source, la vue Structure offre une présentation hiérarchique de la structure du code du document MXML ou ActionScript sélectionné, ce qui vous permet d’inspecter et de parcourir les sections ou lignes de code du document. La vue Structure affiche également les alertes d’erreur de syntaxe générées par le compilateur. Cette vue apparaît également lorsque vous utilisez l’éditeur ActionScript.
à la page 122. Pour une présentation des vues optionnelles disponibles dans Flash Builder, voir « Autres vues utiles du workbench » à la page 20. Vue ASDoc
Pour plus d’informations, voir « Aide au codage dans Flash Builder » à la page 105. Vue Données/Services
Vue Moniteur de réseau
Il est disponible avec Flash Builder Premium. Pour plus d’informations, voir « Surveillance des applications accédant aux services de données » à la page 155.
La présentation et la création visuelles des applications ont lieu en mode Création de l’éditeur MXML. Ce mode représente visuellement le code édité en mode Source. Il contient cependant, par rapport à ce dernier, des vues supplémentaires prenant en charge les tâches de création. Il s’agit des vues Composants, Propriétés, Aspect et Etats. Le mode Création comporte en outre la vue Structure qui affiche la structure MXML des applications. Pour plus d’informations sur la création d’applications Flex dans Flash Builder, voir « Création d’une interface utilisateur avec Flash Builder » à la page 188. Remarque : le mode Création n’est pas disponible avec les projets ActionScript. Pour prévisualiser l’interface utilisateur des applications ActionScript, vous devez les créer et les exécuter. Pour plus d’informations sur l’utilisation d’ActionScript, voir « Projets ActionScript » à la page 66 et « Exécution des applications » à la page 90. En mode Création, la perspective Développement contient l’éditeur MXML et les vues Composants, Etats, Propriétés, Aspect et Structure.
Flex vous permet de créer des applications dont l’apparence varie selon les événements déclenchés directement par l’utilisateur ou générés de façon programmée. Ces changements d’interface utilisateur sont appelés états d’affichage. Vous créez et gérez les états d’affichage dans la vue Etats.
Vue Aspect La vue Aspect vous permet de définir le style global de l’application pour le texte et les couleurs. Vous pouvez également y définir le thème des applications du projet.
Pour plus d’informations, voir « Définition des propriétés des composants » à la page 201. Vue Structure En mode Création, la vue Structure présente une vue hiérarchique de la structure MXML de vos applications. Vous pouvez facilement parcourir la structure d’une application en sélectionnant des instructions de balises MXML et des composants individuels. L’élément sélectionné dans la vue Structure est mis en surbrillance dans la vue Création.
MXML » à la page 204.
La perspective Débogage Flash contient les outils nécessaires au débogage de vos applications. Tout comme la perspective Développement, l’éditeur en est le principal outil. Pour le débogage des applications, l’éditeur, associé aux outils correspondants, recherche et met en surbrillance les lignes de code qui doivent être corrigées avant que vous puissiez poursuivre le test de l’application.
également passer manuellement à la perspective Débogage en la sélectionnant dans la barre des perspectives située à l’extrémité droite de la barre d’outils principale du workbench. La perspective Débogage contient les vues Débogage, Points d’arrêt, Console, Variables et Expressions. Vue Débogage La vue Débogage (dans d’autres débogueurs, cette option porte le nom pile des appels) affiche le frame de pile du thread suspendu de l’application que vous déboguez. Utilisez la vue Débogage pour gérer le processus de débogage. Cette vue vous permet par exemple de reprendre ou d’interrompre le thread ou une étape dans les instructions de code.
Les applications créées avec Flex ne comportent qu’un seul thread (ce qui n’est pas le cas de Java, par exemple). Vous ne pouvez déboguer qu’une seule application à la fois. Au cours du débogage d’une application, vous ne pouvez donc afficher les processus et la vue Débogage que d’un seul thread d’exécution. La vue Débogage affiche la liste des fonctions appelées jusqu’à ce point, dans l’ordre de leur appel. Par exemple, la première fonction appelée apparaît en bas de la liste. Vous pouvez double-cliquer sur une fonction pour la déplacer dans le script ; Flash Builder met à jour les informations de la vue Variables conformément au nouvel emplacement de la fonction dans le script. Vue Points d’arrêt La vue Points d’arrêt répertorie tous les points d’arrêt définis dans le projet. Double-cliquez sur un point d’arrêt pour afficher son emplacement dans l’éditeur. Vous pouvez également désactiver, ignorer et supprimer des points d’arrêt.
Vue Console La vue Console affiche le résultat des instructions trace placées dans le code ActionScript ainsi que les informations provenant du débogueur lui-même (statut, avertissements et erreurs).
La vue Expressions permet de surveiller un ensemble de variables critiques. Vous pouvez choisir les variables que vous jugez critiques dans la vue Variables et les ajouter à la vue Expressions afin de les surveiller. Vous pouvez également ajouter et évaluer des expressions de contrôle.
à la page 146. Pour plus d’informations sur le débogage des applications Flex et ActionScript, voir « Débogage des applications » à la page 141.
Flash Builder Premium propose une perspective supplémentaire. Le profileur Adobe Flex permet d’identifier les problèmes de performance et les fuites de mémoire des applications. La perspective Profil affiche plusieurs panneaux (ou vues) présentant les données de profilage sous différentes formes. Lorsque vous interagissez avec l’application, le profileur enregistre les données concernant le statut de l’application, notamment le nombre d’objets, leur taille, le nombre d’appels de la méthode et le temps consacré à ces appels. Pour plus d’informations sur le profileur, voir « A propos du profilage » à la page 159.
Certaines vues du workbench en particulier vous seront très précieuses lors du développement d’applications dans Flash Builder. Il s’agit des vues Tâches, Signets et Recherche. Vue Signets La vue Signets sert à gérer les signets que vous ajoutez à des lignes de code spécifiques ou à des ressources. Tout comme dans un navigateur Web, les signets permettent de garder la trace d’éléments importants. La sélection d’un signet recherche et affiche ce signet dans le workbench.
Vue Recherche La vue Recherche s’affiche automatiquement lorsque vous recherchez des ressources dans l’espace de travail. Elle permet de définir des recherches, accéder à des recherches précédentes et filtrer la liste des résultats de la recherche.
Toutes les commandes du workbench apparaissent dans le système de menus, les menus contextuels, les barres d’outils et les raccourcis clavier.
Nouveau Affiche un menu déroulant contenant tous les types de projet et tous les documents que vous pouvez créer. Enregistrer Enregistre le document ouvert dans l’éditeur et actuellement sélectionné. Imprimer la source Imprime le document ouvert dans l’éditeur et actuellement sélectionné. Générer tout Apparaît lorsque l’option « Générer automatiquement » est désactivée dans le menu Projet. Exécuter Ouvre le fichier SWF de l’application principale dans le navigateur Web par défaut ou directement dans l’application Flash Player autonome. Vous pouvez également sélectionner d’autres fichiers d’application dans le projet à partir du menu contextuel associé. Pour plus d’informations, voir « Exécution des applications » à la page 92. Déboguer Utilise le fichier d’application principal du projet actuel pour ouvrir une session de débogage. Vous pouvez également sélectionner d’autres fichiers d’application dans le projet à partir du menu contextuel associé. Pour plus d’informations, voir « Lancement d’une session de débogage » à la page 141. Profiler Crée, gère et exécute des configurations. Pour plus d’informations, voir « A propos du profilage » à la
Exporter vers une version validée Lance un assistant qui vous aide à sélectionner l’application pour laquelle vous
Outils externes Sélectionne une configuration de lancement personnalisée. Marquer les occurrences Permet de sélectionner et de marquer les occurrences de code en mode Source. Annotation suivante Permet de sélectionner et de passer aux annotations de code suivantes en mode Source. Annotation précédente Permet de sélectionner et de passer aux annotations de code précédentes en mode Source. Emplacement de la dernière édition Renvoie à l’emplacement de la dernière modification apportée à une ressource (la
Précédent et Suivant Permettent d’accéder aux documents précédemment sélectionnés. Vous pouvez également
Pour afficher la barre d’outils, ouvrez un fichier MXML en mode Création.
Source Affiche l’éditeur en mode Source, c’est-à-dire la zone d’édition du code. Création Affiche l’éditeur en mode Création, c’est-à-dire la zone de présentation et de conception visuelles des applications Flex.
à jour de l’affichage de la création visuelle. Pour plus d’informations, voir « Ajout d’états d’affichage et de transitions » à la page 227. Mode Sélection Activé par défaut à l’ouverture d’un fichier, ce mode vous permet de sélectionner, déplacer et
Mode Panoramique Permet d’effectuer un panoramique et de parcourir la zone de création. En revanche, ne permet
Mode Zoom Affiche par défaut des valeurs d’agrandissement prédéfinies. Pour effectuer un zoom arrière, appuyez sur Alt+clic (Opt+clic sous Mac). Pour revenir au mode d’affichage 100%, double-cliquez sur le bouton Mode Zoom. Agrandissement Liste déroulante affichant des pourcentages d’agrandissement. Cette liste est également disponible dans le menu Création > Agrandissement. La liste affiche par défaut la valeur 100%.
Si vous modifiez un fichier CSS pour un projet d’application basé sur le SDK Flex 3, l’éditeur CSS affiche le mode Création. L’éditeur CSS comporte plusieurs boutons vous permettant de contrôler l’éditeur en modes Source et Création. Pour afficher la barre d’outils de l’éditeur CSS, créez un projet basé sur le SDK Flex 3 et ouvrez un fichier CSS en mode Création.
Source Affiche l’éditeur en mode Source, c’est-à-dire la zone d’édition du code. Création Affiche l’éditeur en mode Création, c’est-à-dire la zone de présentation et de conception visuelles des applications Flex. Actualiser Recharge les éléments visuels (images, fichiers SWF ou fichiers de classes contenant les méthodes API de
Style Répertorie les styles contenus dans le fichier CSS. Nouveau style Affiche la boîte de dialogue Nouveau style permettant de choisir les types de sélecteur et les composants à appliquer au nouveau style. Supprimer le style Supprime le style sélectionné du fichier CSS. Mode Sélection Activé par défaut à l’ouverture d’un fichier. Permet de sélectionner, de déplacer et de redimensionner
Mode Panoramique Permet d’effectuer un panoramique et de parcourir la zone de création. En mode Panoramique,
Mode Zoom Affiche par défaut des valeurs d’agrandissement prédéfinies. Pour effectuer un zoom arrière, appuyez sur Alt+clic (Opt+clic sous Mac). Pour revenir au mode d’affichage 100%, double-cliquez sur le bouton Mode Zoom.
Arrière-plan Lance un sélecteur de couleurs permettant de sélectionner une couleur d’arrière-plan pour la zone
Aperçu en tant que Ne s’affiche que lorsque la règle de style n’est associée à aucun composant MXML en particulier. Editer les grilles d’échelle (pas affiché) Ne s’affiche que lorsque la règle de style utilise des habillages de fichier d’image.
De nombreuses opérations accessibles à partir du système de menus de Flash Builder sont également disponibles sous forme de raccourcis clavier. Affichage de la liste de tous les raccourcis clavier de Flash Builder ❖ Sélectionnez Aide > Assistant de touches. Vous pouvez utiliser l’option Assistant de touches comme référence pour tous les raccourcis clavier Flash Builder, ou exécuter ces commandes directement à partir du panneau Assistant de touches en double-cliquant sur les commandes. Vous pouvez également modifier les raccourcis clavier ou créer vos propres raccourcis. Pour plus d’informations, voir « Modification des raccourcis clavier » à la page 30.
Flash Builder se structure autour d’un ensemble de plug-ins Eclipse fournissant les outils nécessaires à la création d’applications Flex et ActionScript 3.0. Cette structure permet aux plug-ins de proposer des points d’extension pouvant être utilisés pour étendre les fonctionnalités et les capacités de l’outil. Pour plus d’informations, voir Référence d’extensibilité d’Adobe Flash Builder.
Builder Le terme workbench désigne l’environnement de développement Flash Builder. Le workbench contient trois éléments principaux : les perspectives, les éditeurs et les vues. L’utilisation associée de ces trois composants varie en fonction du stade de développement de l’application. Le workbench constitue le conteneur de tous les outils de développement des applications. Remarque : pour plus d’informations sur certaines fonctionnalités du workbench Eclipse, voir le guide de l’utilisateur du workbench Eclipse à l’adresse http://help.eclipse.org/help31/index.jsp.
Les perspectives comportent des combinaisons de vues et d’éditeurs adaptées à l’exécution de certains groupes de tâches. Vous utiliserez ainsi généralement la perspective Débogage Flash pour déboguer une application. Pour une présentation des perspectives, voir « A propos des perspectives de Flash Builder » à la page 7.
Vous pouvez également cliquer sur le bouton Ouvrir la perspective dans l’angle supérieur droit de la fenêtre du workbench afin de sélectionner une perspective dans le menu contextuel. Pour afficher la liste complète des perspectives, sélectionnez Autre dans le menu contextuel Ouvrir la perspective. Le titre de la perspective que vous ouvrez remplace celui de la perspective précédemment affichée. Une icône apparaît en regard du titre. Elle permet de parcourir rapidement les perspectives dans la même fenêtre. Par défaut, les perspectives s’affichent dans la même fenêtre.
La perspective par défaut est signalée par le terme par défaut affiché entre parenthèses après le nom de la perspective. 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Perspectives. 2 Sous Perspectives disponibles, sélectionnez la perspective à définir par défaut, puis cliquez sur Perspective par
Vous pouvez ouvrir les perspectives dans une nouvelle fenêtre. 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Perspectives. 2 Sous Ouverture d’une nouvelle perspective, sélectionnez Dans une nouvelle fenêtre.
Pour modifier la présentation d’une perspective, changez les éditeurs et les vues visibles dans une perspective donnée. Par exemple, vous pouvez afficher la vue Signets dans une perspective et la masquer dans une autre. Vous pouvez également configurer d’autres aspects d’une perspective, notamment les sous-menus Fichier > Nouveau, Fenêtre > Perspective > Autre, Fenêtre > Autres vues ainsi que les jeux d’actions (boutons et options de menu) qui apparaissent dans la barre d’outils et dans les éléments du menu principal (les noms des menus varient légèrement dans la configuration plug-in de Flash Builder). Création d’une perspective 1 Ouvrez une perspective existante. 2 Affichez les vues et les éditeurs de votre choix.
4 Dans la boîte de dialogue Sauvegarder la perspective sous, entrez le nouveau nom de la perspective, puis cliquez sur OK.
1 Ouvrez la perspective à configurer. 2 Sélectionnez Fenêtre > Perspective > Personnaliser la perspective (Fenêtre > Personnaliser la perspective dans la
3 Sélectionnez les onglets Raccourcis ou Commandes en fonction des éléments que vous souhaitez ajouter à la
4 Cochez les cases correspondant aux éléments que vous souhaitez afficher dans les menus et dans les barres d’outils
5 Cliquez sur OK. 6 Sélectionnez Fenêtre > Perspective > Sauvegarder la perspective sous (Fenêtre > Sauvegarder la perspective sous
7 Dans la boîte de dialogue Sauvegarder la perspective sous, entrez le nouveau nom de la perspective, puis cliquez sur OK.
Vous pouvez supprimer des perspectives définies précédemment. Vous ne pouvez pas supprimer une perspective que vous n’avez pas créée. 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Perspectives. 2 Sous Perspectives disponibles, sélectionnez la perspective que vous souhaitez supprimer. 3 Cliquez sur Supprimer, puis sur OK.
Vous pouvez rétablir la présentation d’origine d’une perspective que vous avez modifiée. 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Perspectives. 2 Sous Perspectives disponibles, sélectionnez la perspective à réinitialiser. 3 Cliquez sur Réinitialiser, puis sur OK.
La plupart des perspectives du workbench se composent d’un éditeur ainsi que d’une ou de plusieurs vues. Un éditeur est un composant visuel du workbench, généralement utilisé pour éditer ou explorer une ressource. Les vues sont également des composants visuels de l’espace de travail. Elles prennent en charge les éditeurs, offrent des alternatives de présentation des éléments sélectionnés dans l’éditeur et permettent de parcourir les informations du workbench. Pour une présentation des éditeurs et des vues, voir « A propos du workbench » à la page 4.
du workbench Eclipse (dans la configuration plug-in de Flash Builder, sélectionnez Fenêtre > Affichage d’une vue). Après avoir ajouté une vue à la perspective active, vous pouvez l’enregistrer en tant que partie de la perspective. Pour plus d’informations, voir « Personnalisation d’une perspective » à la page 24. Vous pouvez également créer des vues rapides qui facilitent l’accès aux vues fréquemment utilisées. Pour plus d’informations, voir « Création et utilisation de vues rapides » à la page 27.
Vous pouvez déplacer les vues à l’intérieur du workbench, les ancrer à différents emplacements ou en annuler l’ancrage, en fonction de vos besoins. 1 Déplacez la vue vers l’emplacement souhaité en faisant glisser sa barre de titre.
Vous pouvez faire glisser un groupe de vues empilées en cliquant sur l’espace vide situé à droite des onglets des vues et en déplaçant la souris. Vous pouvez également déplacer une vue à l’aide de son menu contextuel. Ouvrez le menu contextuel à partir de l’onglet de la vue, sélectionnez Déplacer > Vue, déplacez la vue vers l’emplacement souhaité, puis cliquez de nouveau avec le bouton de la souris. 2 (Facultatif) Enregistrez vos modifications en sélectionnant Fenêtre > Perspective > Sauvegarder la perspective sous
Outre l’ancrage des vues à différents emplacements du workbench, vous pouvez réorganiser les onglets des vues à l’intérieur d’un groupe de vues. ❖ Cliquez sur l’onglet de la vue à déplacer, faites glisser la vue vers l’emplacement souhaité, puis relâchez le bouton
Le passage d’une vue à l’autre peut se faire de différentes façons :
• Sélectionnez une vue dans le menu Fenêtre de Flash Builder. • Utilisez un raccourci clavier. Utilisez Ctrl+F7 sous Windows ou Commande+F7 sous Macintosh. Appuyez sur la touche F7 pour sélectionner une vue. Pour obtenir une liste de tous les raccourcis clavier, cliquez sur Aide > Assistant de touches.
Cliquez sur l’icône de vue rapide dans la barre de raccourcis pour afficher la vue. Cliquez à l’extérieur de la vue rapide (ou sur le bouton Réduire de sa barre d’outils) pour la masquer à nouveau. Remarque : si vous convertissez la vue Explorateur de packages en vue rapide, puis ouvrez un fichier à partir de la vue rapide Explorateur de packages, la vue est automatiquement masquée pour vous permettre d’utiliser ce fichier. Création d’une vue rapide ❖ Faites glisser la vue que vous souhaitez convertir en vue rapide vers la barre de raccourcis située dans l’angle inférieur gauche de la fenêtre du workbench. L’icône de la vue que vous avez déplacée apparaît dans la barre de raccourcis. Cliquez sur cette icône pour ouvrir la vue. Cliquez à l’extérieur de la vue pour la masquer. Restauration d’une vue rapide en vue normale ❖ Dans le menu contextuel de la vue, désélectionnez Vue rapide.
Vous pouvez filtrer les tâches ou les problèmes qui s’affichent dans les vues Tâches ou Erreurs. Vous pouvez par exemple limiter l’affichage aux problèmes consignés par le workbench ou aux tâches que vous avez consignées comme rappels. Vous pouvez filtrer les éléments en fonction de la ressource ou du groupe de ressources auquel ils sont associés, de la chaîne de texte affichée dans le champ Description, de la gravité du problème, de la priorité de la tâche ou du statut de la tâche. 1 Dans la barre des tâches de la vue Tâches ou Erreurs, cliquez sur Filtrer. 2 Renseignez la boîte de dialogue Filtres, puis cliquez sur OK.
Si votre espace de travail contient de nombreux projets, vous pouvez créer un jeu de documents afin de regrouper un certain nombre de projets. Vous pouvez alors afficher des jeux de documents différents dans les vues Explorateur de packages et Tâches ainsi que limiter la portée de vos recherches à des jeux de documents (et éviter donc les recherches portant sur l’ensemble de l’espace de travail).
le jeu. 5 Cliquez sur Terminer.
Affichage de tous les projets dans l’espace de travail ❖ Dans la vue Explorateur de packages, ouvrez le menu de la barre d’outils et choisissez Désélectionner le jeu de documents.
L’ouverture d’un fichier lance un éditeur dans lequel il peut être modifié. ❖ Effectuez l’une des opérations suivantes :
• Double-cliquez sur le signet associé au fichier dans la vue Signets. • Double-cliquez sur un avertissement d’erreur ou un enregistrement de tâche associé au fichier dans la vue Erreurs. Le fichier s’ouvre dans l’éditeur défini par défaut pour ce type de fichier. Pour ouvrir le fichier dans un autre éditeur, sélectionnez Ouvrir avec dans le menu contextuel du fichier. Sélectionnez l’éditeur que vous souhaitez utiliser.
Le workbench permet d’associer les éditeurs à différents types de fichiers. 1 Sélectionnez Fenêtre > Préférences. 2 Cliquez sur le signe plus pour développer la catégorie Général.
Pour ajouter un type de fichier à la liste, cliquez sur Ajouter, entrez le nouveau type de fichier dans la boîte de dialogue Ajouter un type de fichier, puis cliquez sur OK. 5 Dans la liste Editeurs associés, sélectionnez l’éditeur à associer à ce type de fichier.
Vous pouvez éditer un fichier MXML ou ActionScript dans un éditeur externe puis l’utiliser dans Flash Builder. Le workbench effectue les opérations de création ou d’actualisation nécessaires afin d’appliquer les modifications que vous avez apportées au fichier en dehors du workbench. Actualisation d’un fichier MXML ou ActionScript édité en dehors du workbench 1 Editez le fichier MXML ou ActionScript dans l’éditeur externe de votre choix. 2 Enregistrez et fermez le fichier. 3 Démarrez Flash Builder. 4 Dans l’une des vues de navigation du workbench, ouvrez le menu contextuel, puis sélectionnez Actualiser.
Le workbench vous permet d’ouvrir plusieurs fichiers dans différents éditeurs. Mais contrairement aux vues, les éditeurs ne peuvent pas être déplacés à l’extérieur du workbench pour créer des fenêtres. Vous pouvez cependant disposer les éditeurs en mosaïque dans la zone d’édition afin d’afficher les fichiers source côte à côte. 1 Ouvrez deux ou plusieurs fichiers dans la zone d’édition. 2 Cliquez sur l’onglet de l’un des éditeurs. 3 Faites-le glisser vers le bord gauche, droit, supérieur ou inférieur de la zone d’édition.
4 (Facultatif) Faites glisser les bords des éditeurs pour les redimensionner, si besoin est.
Vous pouvez procéder de différentes façons pour agrandir une vue ou un éditeur de manière à occuper entièrement la fenêtre du workbench. Agrandissement (restauration) d’une vue ou d’un éditeur • Accédez au menu contextuel de la barre de titre de la vue ou de l’éditeur et sélectionnez Agrandir (Restaurer).
• Cliquez sur les icônes Agrandir/Restaurer situées dans l’angle supérieur droit de la vue ou de l’éditeur.
Vous ne pouvez travailler que dans un seul espace de travail à la fois. Lorsque vous installez et exécutez Flash Builder pour la première fois, un message vous invite à créer un espace de travail qui devient l’espace de travail par défaut. Vous pouvez créer d’autres espaces de travail et passer de l’un à l’autre en sélectionnant l’espace de travail voulu au lancement de Flash Builder ou en choisissant Fichier > Commuter l’espace de travail.
Vous pouvez personnaliser le workbench en fonction de vos besoins. Vous pouvez par exemple définir l’affichage des éléments dans la barre d’outils principale, créer des raccourcis clavier ou modifier les polices et les couleurs de l’interface utilisateur.
Flash Builder vous permet de réorganiser les sections de la barre d’outils principale. Les sections de la barre d’outils principale sont séparées par un espace. 1 Vérifiez que la barre d’outils est déverrouillée. Dans le menu contextuel de la barre d’outils, désélectionnez l’option
2 Positionnez le pointeur de la souris sur la ligne verticale qui délimite sur la gauche la section à déplacer. 3 Cliquez sur cette ligne et déplacez la section vers la gauche, la droite, le haut ou le bas. Relâchez le bouton de la souris
Afin d’éviter tout déplacement non intentionnel des barres d’outils, verrouillez-les de nouveau en activant l’option correspondante de leur menu contextuel.
1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Touches. 2 Dans l’écran Vue de la boîte de dialogue Touches, sélectionnez la commande à modifier. 3 Dans le champ Liaison, entrez le nouveau raccourci clavier à lier à la commande. 4 Dans la liste déroulante Quand, sélectionnez à quel moment le raccourci clavier doit être activé. 5 Cliquez sur Appliquer ou sur OK.
Par défaut, le workbench utilise les polices et les couleurs du système d’exploitation de l’ordinateur. Vous pouvez cependant personnaliser les polices et les couleurs de différentes manières. Le workbench permet de configurer les polices suivantes. Police de bannière Apparaît dans la barre de titre de nombreux assistants. Par exemple, l’assistant Nouveau projet Flex utilise la police de la bannière pour le titre supérieur. Police de boîte de dialogue Apparaît dans les widgets et les boîtes de dialogue.
Police de console CVS Apparaît dans la console CVS. Police des ressources ignorées Affiche les ressources ignorées par la console CVS. Police des modifications sortantes Affiche les modifications sortantes dans CVS. Police de la console (Police du texte, par défaut) Apparaît dans la console Déboguer. Police du texte des volets Détails (Police du texte, par défaut) Apparaît dans les volets Détails des vues Débogage. Police de la table de la vue Mémoire (Police du texte, par défaut) Apparaît dans le tableau de la vue Mémoire. Police de texte de l’éditeur Java (Police du texte, par défaut) Apparaît dans les éditeurs Java. Police du texte de l’éditeur de fichier de propriétés (Police du texte, par défaut) Apparaît dans les éditeurs de fichier
Police du texte de comparaison (Police du texte, par défaut) Apparaît dans les outils de comparaison textuelle ou de
Police du texte de la comparaison Java (Police du texte, par défaut) Apparaît dans les outils de comparaison ou de
Police du message de la vue (Police du texte de l’éditeur du fichier des propriétés, par défaut) Affiche les messages dans la barre de titre de la vue (le cas échéant).
Java Development Tools permet par exemple de définir la police utilisée par l’éditeur Java (dans Préférences, sélectionnez > Général > Apparence > Couleurs et polices > Java > Police de texte de l’éditeur Java). Certaines zones (l’arborescence de l’Explorateur de packages, par exemple) sont toujours affichées dans la police du système d’exploitation. Pour modifier la police de ces zones, utilisez les outils de configuration fournis par le système d’exploitation (les propriétés d’affichage du Panneau de configuration de Windows, par exemple).
1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Apparence > Couleurs et polices. 2 Développez les catégories Comparaison de texte, Couleurs et polices de base, CVS, Déboguer ainsi que Dossiers des
Remarque : vous pouvez également cliquer sur Utiliser la police du système au lieu de Modifier pour laisser le système d’exploitation choisir une valeur de police appropriée. Sous Windows par exemple, si vous sélectionnez cette option, Flash Builder utilise la police sélectionnée dans les propriétés d’affichage du Panneau de configuration de Windows. 3 Définissez vos préférences en matière de police et de couleur.
Modification des couleurs 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Apparence > Couleurs et polices. 2 Développez les catégories Comparaison de texte, Couleurs et polices de base, CVS, Déboguer ainsi que Dossiers des
3 Cliquez sur la barre de couleurs à droite pour ouvrir le sélecteur de couleurs. 4 Sélectionnez une nouvelle couleur.
Vous pouvez définir la réaction du workbench à un clic ou à un double-clic. 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général. 2 Dans la section Mode d’ouverture, sélectionnez les options voulues et cliquez sur OK.
Flash Builder intègre un outil de recherche qui vous permet de localiser rapidement des ressources. Pour plus d’informations sur la recherche de texte dans un fichier particulier, voir « Recherche et remplacement de texte dans l’éditeur » à la page 118.
Flash Builder vous permet d’effectuer des recherches complexes de fichiers. ❖ Dans la version plug-in de Flash Builder, sélectionnez Rechercher > Rechercher ou Rechercher > Fichier.
Remarque : cliquez sur Personnaliser pour définir les types d’onglet de recherche disponibles dans la boîte de dialogue Rechercher.
Flash Builder présente des fonctions de recherche avancées plus puissantes que les fonctions de recherche/remplacement. Afin de faciliter la compréhension de la manière dont les fonctions, variables et autres identifiants sont utilisés, Flash Builder permet de rechercher et de repérer les références ou les déclarations vers les identifiants dans les fichiers ActionScript ou MXML, les projets ou les espaces de travail. Pour plus d’informations, voir « Recherche de références et restructuration de code » à la page 118.
La vue Recherche affiche les résultats de votre recherche. Ouverture d’un fichier de la liste ❖ Double-cliquez sur le fichier.
Suppression de tous les fichiers de la liste ❖ Cliquez sur Supprimer toutes les occurrences. Navigation entre les fichiers correspondants ❖ Cliquez sur Afficher l’occurrence suivante ou Afficher l’occurrence précédente. Affichage des recherches précédentes ❖ Cliquez sur la flèche en regard de l’option Afficher les recherches précédentes et sélectionnez une recherche dans la liste déroulante. Retour à la vue Recherche après sa fermeture 1 Sélectionnez Fenêtre > Autres vues > Généralités (Fenêtre > Afficher la vue > Autre dans la configuration plug-in de Flash Builder). 2 Développez la catégorie Généralités, sélectionnez Recherche, puis cliquez sur OK.
L’éditeur MXML de Flash Builder vous permet d’utiliser les modes Source ou Création. Flash Builder permet également de créer une vue partagée dans laquelle vous pourrez afficher les deux modes simultanément. Affichage du fichier en mode Création ❖ Cliquez sur Création en haut de la zone de l’éditeur. Affichage du fichier en mode Source ❖ Cliquez sur Source en haut de la zone de l’éditeur. Utilisation simultanée des modes Source et Création 1 Dans le menu contextuel de l’onglet de l’éditeur, sélectionnez Nouvel éditeur. Vous disposez à présent de deux onglets d’édition pour le même fichier. 2 Faites glisser l’un des onglets vers la droite pour le juxtaposer à l’autre onglet. 3 Configurez l’un des éditeurs en mode Création et l’autre éditeur en mode Source.
❖ Appuyez sur Ctrl+`(guillemet ouvrant).
Les raccourcis clavier disponibles dans Flash Builder dépendent de nombreux facteurs, y compris de la vue ou de l’éditeur sélectionné, de l’ouverture ou non d’une boîte de dialogue, des plug-ins installés et du système d’exploitation. Vous pouvez obtenir à tout moment la liste des raccourcis clavier disponibles à l’aide de la fonction Assistant de touches. ❖ Sélectionnez Aide > Assistant de touches.
Builder de manière telle à ce qu’il vous invite à sélectionner l’espace de travail au démarrage, définir l’éditeur à utiliser à l’ouverture de certains types de ressource et paramétrer différentes options pour l’exécution et le débogage de vos applications. Vos préférences Flash Builder s’appliquent uniquement à l’espace de travail actuel. Vous pouvez cependant exporter les préférences du workbench et les importer dans un autre espace de travail. L’exportation des préférences est utile si vous gérez plusieurs espaces de travail ou si vous souhaitez partager les préférences du workbench avec d’autres membres de votre équipe de développement. Vous pouvez également définir des préférences individuelles pour chaque projet d’un espace de travail, par exemple définir des options de compilation ou de débogage distinctes pour chacun de vos projets Flex. Définition des préférences du workbench Flash Builder 1 Ouvrez la fenêtre Préférences. 2 Développez Général, choisissez l’une des catégories de préférences du workbench et modifiez-la si nécessaire. 3 Cliquez sur OK.
Adobe® Flash® Builder™ vous permet de créer, gérer, assembler et distribuer des projets pour la création d’applications pour le Web et de bureau. Lorsque vous générez des fichiers SWC (shared component library), vous pouvez partager des composants et d’autres ressources entre diverses applications ou avec d’autres développeurs. Vous pouvez également utiliser différentes versions du SDK Flex d’Adobe directement dans Flash Builder.
Flash Builder adopte une approche classique du développement de logiciels : le regroupement des ressources (dossiers et fichiers) qui constituent une application au sein d’un conteneur appelé projet. Un projet contient un ensemble de propriétés qui contrôlent la façon dont l’application est générée, l’endroit où l’application construite est hébergée, la façon dont le débogage est géré et les relations avec d’autres projets dans l’espace de travail. La vue Explorateur de packages vous permet de gérer les projets, en ajoutant, modifiant et supprimant des ressources. Vous pouvez également fermer les projets à l’intérieur d’un espace de travail, importer des ressources et créer des liens vers des ressources externes. Outre les projets Flex, Flash Builder offre un type de projet de base appelé projet ActionScript. Grâce à un projet ActionScript, vous pouvez coder et déboguer des applications ActionScript qui accèdent directement aux API d’Adobe Flash Player et sont compilées dans des fichiers SWF. Les projets ActionScript ne font pas appel à la structure Flex ni au langage MXML. Applications déployées dans Flash Player Faites appel à l’assistant Nouveau projet Flex pour créer des applications pouvant être déployées dans Flash Player. A la création du projet, sélectionnez l’option Application Web (exécutée dans Adobe Flash Player). Ce type d’application est compilé dans des fichiers SWF autonomes. Pour plus d’informations, voir « Utilisation des projets » à la page 35 et « Projets ActionScript » à la page 66. Applications déployées dans Adobe AIR Faites appel à l’assistant de création d’un projet Flex pour créer des applications pouvant être déployées dans Adobe® AIR®. Sous Type d’applications, sélectionnez l’option Application de bureau (exécution dans Adobe AIR). Utilisez la fonction Exporter vers une version validée pour générer un package AIR de qualité finale prêt à être installé. Pour plus d’informations, voir « Développement d’applications AIR avec Flash Builder » à la page 137. Flash Builder vous permet de déboguer, assembler et gérer des projets AIR. Il vous permet également d’exécuter des applications dans AIR. Adobe AIR Marketplace est un endroit où les développeurs d’AIR publient des applications AIR que les utilisateurs peuvent télécharger. Pour trouver Marketplace, aller à www.adobe.com/go/marketplace. Si vous avez des questions sur Adobe AIR Marketplace, aller à www.adobe.com/go/marketplace_faq. Projets de bibliothèque Flex Flash Builder vous permet également de créer des bibliothèques de code personnalisé que vous partagez entre vos applications ou que vous distribuez à d’autres développeurs. Un projet de bibliothèque génère un fichier SWC, c’està-dire un fichier archive pour les composants Flex ainsi que pour d’autres ressources. Pour plus d’informations, voir « Projets de bibliothèque » à la page 69.
Pour pouvoir commencer à créer une application dans Flash Builder, vous devez d’abord créer un projet. Spécifiez s’il s’agit d’une application Web (exécutée dans Adobe Flash Player) ou d’une application de bureau (exécutée dans Adobe AIR). Lorsque vous créez un projet Flex, un fichier d’application principale est créé. Vous ajoutez ensuite toutes les autres ressources, dont les fichiers d’application MXML, les fichiers de composants MXML personnalisés et les fichiers ActionScript, qui formeront votre application Lorsque vous créez un projet ActionScript, un fichier ActionScript principal est créé. Vous pouvez ensuite construire une application grâce à ActionScript et à l’API de Flash Player. Pour plus d’informations, voir « Création de projets Flex » à la page 41 et « Gestion des projets » à la page 49. Projets gérés dans les espaces de travail Les projets sont gérés depuis un espace de travail, c’est-à-dire une zone définie du système de fichiers contenant les ressources (fichiers et dossiers) composant les applications. Vos projets résident par défaut dans l’espace de travail. Vous pouvez toutefois créer des projets en dehors de l’espace de travail. Flash Builder les relie automatiquement à l’espace de travail. Le passage d’un espace de travail à l’autre entraîne le redémarrage de Flash Builder. Multiplicité des projets dans chaque espace de travail Vous pouvez ajouter autant de projets que vous le souhaitez à un espace de travail. Tous les projets s’affichent dans l’Explorateur de packages, dans lequel vous pouvez les gérer à votre guise. Vous pouvez ajouter des ressources, classer les projets dans des dossiers et générer des projets dans l’espace de travail. Pour plus d’informations, voir « Gestion des projets » à la page 49 et « Création de dossiers et de fichiers dans un projet » à la page 63. Ressources externes liées Outre les ressources internes des projets, vous pouvez créer des liens avec des ressources situées en dehors d’un projet et d’un espace de travail. Les ressources externes liées apparaissent en tant que partie du projet, mais elles se trouvent en dehors de l’emplacement du projet. Pour plus d’informations, voir « Liaison à des ressources situées en dehors de l’espace de travail du projet » à la page 64. Multiplicité des applications dans un projet Flash Builder vous permet de définir plusieurs fichiers dans votre projet pour former une application. Lorsque vous créez un projet, Flash Builder génère un fichier d’application principale qui sert de point d’accès à l’application. Le compilateur fait appel à ce fichier pour générer le fichier SWF de l’application. Vous pouvez cependant créer des fichiers d’application supplémentaires en fonction de la complexité du projet. Tous les fichiers d’application doivent se trouver dans le dossier src sous le dossier racine du projet. Pour plus d’informations, voir « Gestion des fichiers d’application du projet » à la page 52. Prise en charge de plusieurs SDK Flex Que vous ayez des projets en cours de développement ou que vous deviez gérer une base de code d’un ancien projet, Flash Builder vous permet d’utiliser différentes versions du SDK Flex. Pour spécifier les SDK installés, vous devez configurer l’espace de travail de Flash Builder, qui propose un SDK par défaut pour tous les projets. Une fois un projet configuré, vous pouvez ajouter, supprimer ou modifier les configurations des SDK dans la boîte de dialogue Préférences en sélectionnant Flex > SDK installés. Vous pouvez aussi modifier les configurations des SDK en sélectionnant Projet > Propriétés > Compilateur Flex. Pour plus d’informations, voir « Utilisation de plusieurs SDK dans Flash Builder » à la page 83.
Utilisation des projets
Par défaut, votre projet est automatiquement généré à chaque fois que vous enregistrez des changements dans un fichier. Vous maîtrisez complètement la façon dont vos applications sont générées ainsi que la fréquence à laquelle elles le sont. Si vous n’avez pas de besoins spécifiques en termes de personnalisation de la génération, celle-ci se fait en toute transparence et les fichiers SWF de l’application sont générés automatiquement. Pour plus d’informations, voir « Génération de projets » à la page 73. Exportation vers une version validée Une fois que l’application est prête à être déployée, l’assistant Exporter vers une version validée vous permet de créer une version non déboguée de qualité finale de l’application. L’assistant copie les ressources requises dans un dossier bin-release distinct du dossier de la version de débogage. Vous pouvez définir si le code source de l’application doit être ou non inclus. L’application exportée est une version de production optimisée qui peut être affichée par les utilisateurs finaux. Pour les projets Adobe AIR, les applications AIR sont exportées dans un fichier AIR. La fonctionnalité Exporter vers une version validée permet de créer un fichier AIR signé numériquement que les utilisateurs doivent installer avant d’exécuter une application. Scripts Ant personnalisés Apache Ant est un outil de génération Java qui permet de créer des scripts personnalisés pour la création d’applications dans Flash Builder. Ant vous permet de modifier et d’étendre le processus de génération standard. Pour plus d’informations, voir « Personnalisation des générations avec Apache Ant » à la page 83. Génération par ligne de commande Flash Builder Premium vous permet d’implémenter des générations par ligne de commande. Faites appel aux générations par ligne de commande pour synchroniser les paramètres de génération d’un développeur avec la génération nocturne. Pour plus d’informations, voir « Génération par ligne de commande de Flash Builder » à la page 86.
Flash Builder permet de créer des types de projets dans les configurations suivantes.
Les options de configuration des projets dépendent de la façon dont l’application accède aux données et de l’installation d’Adobe® LiveCycle® Data Services ES ou d’Adobe BlazeDS. Vous pouvez créer des projets pour des applications Web (exécutées dans Flash Player) ou de bureau (exécutées dans Adobe AIR). Les options sont les suivantes. Aucun En l’absence de serveur d’applications, cette configuration de base vous permet de spécifier le dossier de sortie de l’application Flex compilée. Vous pouvez également définir les chemins de génération du nouveau projet. ASP.NET Si Microsoft Windows et Microsoft Visual Web Developer sont installés, vous pouvez créer des projets qui
Service (IIS), vous pouvez créer des projets avec un dossier de sortie Flex sous IIS. ColdFusion Cette configuration de projet vous permet de créer des projets utilisant ColdFusion avec LiveCycle Data
Utilisation des projets
LiveCycle Data Services ou BlazeDS. Si le plug-in Eclipse Web Tools Project (WTP) est installé, sélectionnez l’option Créer un projet mixte Java/Flex à l’aide de WTP pour créer des projets mixtes Java/Flex avec ou sans service d’accès aux objets distants. Pour les projets compilés localement avec WTP, les projets sont déployés sur votre serveur J2EE.
PHP Cette configuration de projet vous permet de créer des projets Flex dotés d’un dossier de sortie Flex sous la racine Web Apache/IIS (ou dossier virtuel). Flash Builder propose des outils pour accéder aux données distantes des serveurs PHP. Pour plus d’informations, voir Construction d’applications centrées sur les données avec Flash Builder. Autre Si le serveur d’applications dont vous disposez n’est pas répertorié, cette option permet de spécifier le dossier
Services Web et HTTP Pour chaque type d’application, vous pouvez créer des applications pouvant accéder à des
En s’appuyant sur l’API de Flash plutôt que la structure Flex, les projets ActionScript permettent aux développeurs d’ActionScript d’utiliser Flash Builder pour coder, générer et déboguer les applications basées uniquement sur ActionScript. Ces projets ne faisant pas appel à MXML pour définir une interface utilisateur, vous ne pouvez pas afficher la présentation et la conception de l’application en mode Création. Vous utilisez exclusivement l’éditeur de source et les outils de débogage le cas échéant, puis vous générez le projet dans des fichiers d’application SWF afin de prévisualiser l’application et de la tester dans un navigateur Web ou un Flash Player autonome. Pour plus d’informations sur les projets ActionScript, voir « Projets ActionScript » à la page 66.
Les projets de bibliothèque permettent d’assembler et de distribuer les composants et autres ressources. Ils génèrent des fichiers SWC que vous ajoutez à d’autres projets ou que vous distribuez à d’autres développeurs. Pour plus d’informations, voir « Projets de bibliothèque » à la page 69.
Utilisez les projets Flash Professional pour modifier, générer ou déboguer les fichiers FLA ou XFL créés avec Adobe Flash Professional CS5. Les projets Flash Professional nécessitent l’installation de Flash Professional CS5. Pour plus d’informations, voir « Création de projets Flash Professional » à la page 48. Tous les projets d’un espace de travail s’affichent dans l’Explorateur de packages, comme l’illustre l’exemple suivant. L’Explorateur de packages présente une arborescence des projets dans une vue à la fois physique et logique (plate). Cette vue vous permet de gérer les projets en ajoutant et en supprimant des ressources (dossier et fichiers), en important des ressources externes et en créant des liens vers ces ressources ainsi qu’en déplaçant les ressources vers d’autres projets dans l’espace de travail.
Utilisez le menu de l’Explorateur de packages pour spécifier la présentation des packages.
Vous pouvez développer le contenu d’une bibliothèque et ouvrir les éditeurs pour afficher les pièces jointes.
Vous pouvez créer un jeu de documents (collection de ressources), définir des filtres d’affichage et trier les ressources par nom et type. Ces options sont disponibles dans les menus de l’Explorateur de packages. Pour plus d’informations sur la modification des vues, voir « Navigation et personnalisation du workbench Flash Builder » à la page 23.
Dans l’Explorateur de packages, vous pouvez ouvrir les ressources du projet pour les modifier. Vous pouvez par exemple modifier les codes MXML et ActionScript dans les blocs <fx:Script> et le code CSS dans les blocs <fx:Style>. Vous pouvez également passer en mode Création et agencer visuellement les composants et les contrôles pour définir la présentation de l’application et son comportement. Pour plus d’informations sur l’utilisation des éditeurs de Flash Builder, voir « A propos de la modification du code dans Flash Builder » à la page 103 et « Création d’une interface utilisateur avec Flash Builder » à la page 188. Vous pouvez ensuite ajouter des projets, fichiers et dossiers et les organiser et les gérer selon vos besoins (voir « Création de dossiers et de fichiers dans un projet » à la page 63).
Utilisation des projets
Pour plus d’informations sur l’utilisation de projets dans l’Explorateur de packages, voir « Gestion des projets » à la page 49 et « Création de dossiers et de fichiers dans un projet » à la page 63.
Flash Builder comporte des assistants pour la création de projets Flex, ActionScript et de bibliothèque Flex. Le tableau suivant décrit chacun de ces projets. Pour créer un projet, sélectionnez Fichier > Nouveau. Type de projet
Les applications Flex et ActionScript prennent en charge plusieurs types de ressources standard (MXML, ActionScript et CSS). Le tableau suivant répertorie les types de ressources que vous pouvez ajouter à vos projets. Pour ajouter ces ressources, sélectionnez Fichier > Nouveau. Type de ressource
« Environnement de test FlexUnit » à la page 150.
Lorsque vous créez un projet, l’assistant Nouveau projet Flex vous guide à travers les différentes étapes et vous demande de préciser le type de projet à créer, le nom du projet, son emplacement ainsi que d’autres options. Pour plus d’informations sur la création d’un projet ActionScript, voir « Création de projets ActionScript » à la page 67. Pour plus d’informations sur la création de projets de bibliothèque, voir « Projets de bibliothèque » à la page 69.
En l’absence de serveur, cette configuration de base vous permet de spécifier le dossier de sortie des applications compilées. Vous pouvez également, en option, définir les chemins de génération du nouveau projet. 1 Sélectionnez Fichier > Nouveau > Projet Flex.
4 Choisissez le type d’application (Web ou de bureau). 5 Sélectionnez Aucun comme type de serveurs d’applications. 6 Cliquez sur Terminer ou sur Suivant pour accéder à d’autres options de configuration.
1 Sélectionnez Fichier > Nouveau > Projet Flex. 2 Entrez un nom de projet. 3 Spécifiez l’emplacement du projet. L’emplacement par défaut est l’espace de travail actuel. Sous Windows, l’espace
4 Choisissez le type d’application (Web ou de bureau). 5 Sélectionnez ASP.NET comme type de serveurs d’applications. 6 Cliquez sur Suivant. 7 Sélectionnez le serveur ASP.NET :
• Spécifiez le dossier de sortie de l’application Flex. 8 Cliquez sur Terminer ou sur Suivant pour accéder à d’autres options de configuration.
Remarque : LiveCycle Data Services ES et BlazeDS prennent en charge des versions spécifiques du SDK Flex. Consultez le Tableau de compatibilité LiveCycle Data Services pour découvrir les versions du SDK Flex prises en charge par votre version de LiveCycle DataService ES. Ce tableau de compatibilité répertorie également les versions du SDK Flex prises en charge par BlazeDS.
Utilisation des projets
La seconde option compile le fichier source de l’application directement sur le serveur. 1 Sélectionnez Fichier > Nouveau > Projet Flex. 2 Entrez un nom de projet. 3 Spécifiez l’emplacement du projet. L’emplacement par défaut est l’espace de travail actuel. Pour choisir un
4 Choisissez le type d’application (Web ou de bureau). 5 Sélectionnez J2EE comme type de serveurs d’applications. 6 Cochez l’option Utiliser le service d’accès aux objets distants. LiveCycle Data Services ES est sélectionné par défaut.
Java et Flex faisant appel à WTP (le dossier source Java est sélectionné pour vous). 7 Cliquez sur Suivant. 8 Configurez le serveur J2EE.
BlazeDS, précisez les paramètres racine : Dossier racine Serveur Flex (application Web) qui sert votre application (C:\fds2\jrun4\servers\default\flex,
(monServeur\MesApplications\jrun4\servers\default\flex, par exemple). URL racine URL racine valide du serveur Flex (application Web) qui sert votre application. Pour LCDS, l’URL
Racine du contexte La racine du contexte correspond généralement au dernier segment du chemin racine de
Lorsque vous créez un projet Flex avec LiveCycle Data Services ES, Flash Builder crée un répertoire portant le même nom que le projet ou utilise un répertoire existant portant ce nom. Ce répertoire est un sousrépertoire du dossier racine que vous avez spécifié pour le projet.
Remarque : quelle que soit l’option choisie pour un projet LiveCycle Data Services ES dans Flash Builder, vous devez spécifier un dossier racine LiveCycle Data Services ES et une URL racine. Ces valeurs mappent la racine d’une application Web LiveCycle Data Services ES. Si vous désélectionnez les options, vous devez saisir uniquement la racine Web et l’URL racine. 9 Spécifiez l’emplacement auquel le projet sera compilé.
Utilisation des projets
Pour accéder aux données qui utilisent ColdFusion, vous devez disposer d’Adobe ColdFusion® 8 ou d’Adobe ColdFusion 9. Pour plus d’informations, consulter lapage produit de ColdFusion. 1 Sélectionnez Fichier > Nouveau > Projet Flex. 2 Entrez un nom de projet. 3 Spécifiez l’emplacement du projet.
4 Spécifiez le type d’application (Web ou de bureau). 5 Pour le type de serveurs d’applications, sélectionnez ColdFusion, puis choisissez l’une des options suivantes. Utiliser le service d’accès aux objets distants Si vous désactivez l’option Utiliser le service d’accès aux objets
Si vous activez l’option Utiliser le service d’accès aux objets distants, vous pouvez effectuer les choix suivants.
Activez cette option si vous prévoyez d’utiliser les outils de développement centrés sur les données disponibles avec Flash Builder. Cette option s’applique également si vous utilisez Flash Remoting pour invoquer des méthodes dans les composants ColdFusion (CFC). Voir Création d’applications centrées sur les données avec Flash Builder. 6 Cliquez sur Suivant. Spécifiez un emplacement de serveur, une racine Web, une URL racine et une racine du
Pour l’accès à un service d’objets distants, vous pouvez définir une configuration ColdFusion autonome ou une configuration ColdFusion déployée sur un serveur J2EE.
Utilisation des projets
Spécifiez la racine Web, l’URL racine et la racine du contexte. Si vous faites appel à la configuration multiserveurs ColdFusion, vous ne devrez généralement pas spécifier la racine du contexte. La racine du contexte correspond en règle générale au dernier segment du chemin racine de l’URL lorsque vous déployez ColdFusion en tant qu’application Web dans la configuration J2EE ColdFusion. Pour spécifier l’emplacement du serveur ou de la racine Web, recherchez un répertoire local ou saisissez le chemin vers un répertoire situé sur un serveur réseau. Vérifiez que le répertoire est partagé et que le compte sous lequel Flash Builder est exécuté possède des droits d’accès en écriture. Vérifiez que vous avez mappé ou monté un lecteur réseau pour le serveur réseau. Le chemin au serveur réseau est fonction de la plateforme. Par exemple : (Windows) \\10.192.18.12\serveur\racine Web (Windows) Z:\racine Web (Mac) /Volumes/racine Web 7 Cliquez sur Valider la configuration pour vérifier l’exactitude des paramètres spécifiés. 8 Sélectionnez un dossier de sortie pour l’application compilée. 9 Cliquez sur Terminer ou sur Suivant pour accéder à d’autres options de configuration.
1 Sélectionnez Fichier > Nouveau > Projet Flex. 2 Entrez un nom de projet. 3 Sélectionnez un emplacement pour le projet. L’emplacement par défaut est l’espace de travail actuel. Pour choisir
4 Choisissez le type d’application (Web ou de bureau). 5 Sélectionnez PHP comme type de serveurs d’applications. Cliquez sur Suivant. 6 Spécifiez la racine Web et l’URL racine pour le service. Cliquez sur Valider la configuration.
Flash Builder est exécuté possède des droits d’accès en écriture. Vérifiez que vous avez mappé ou monté un lecteur pour le serveur réseau. Spécifiez ensuite le chemin vers le serveur. Ce chemin est fonction de la plateforme. Par exemple : (Windows) \\10.192.18.12\serveur\racine Web (Windows) Z:\racine Web (Mac) /Volumes/racine Web 8 Cliquez sur Terminer ou sur Suivant pour accéder à d’autres options de configuration.
Lorsque vous créez un projet Flex, vous pouvez en personnaliser la configuration. Toutes les étapes de configuration supplémentaires sont facultatives. Remarque : vous pouvez modifier la configuration d’un projet après sa création. Pour ce faire, accédez au mode Source de l’éditeur de Flash Builder, puis sélectionnez Projet > Propriétés.
Par défaut, Flash Builder place les fichiers source dans le dossier src du projet. Le nom par défaut du fichier de l’application MXML principale est le nom du projet. Ces valeurs par défaut peuvent être modifiées à la création du projet. Lorsque vous créez un projet, Flash Builder exécute les fichiers d’application à partir d’une URL par défaut, en fonction des paramètres du projet. Spécifiez une URL de dossier de sortie pour remplacer les paramètres par défaut. Voir « Définition d’un dossier de sortie de projet » à la page 79 et « Exécution des applications » à la page 90.
En règle générale, tous les composants sont disponibles. Dans certains cas, vous pouvez ne spécifier que les composants MX. Voir « Jeu de composants (MX + Spark ou MX uniquement) » à la page 78.
Par défaut, les classes d’application de la structure Flex 4 utilisent la liaison dynamique. Les options suivantes sont également activées par défaut :
• Utiliser les bibliothèques RSL locales de débogage lors du débogage • Déterminer automatiquement l’ordre de la bibliothèque, en fonction des dépendances Voir « Liaison de la structure des applications » à la page 78.
Vous pouvez ajouter au chemin de génération des bibliothèques de projet, des dossiers de bibliothèque SWC ou des fichiers SWC ; vous pouvez également les en supprimer. Vous pouvez en outre modifier l’ordre du chemin de génération. Cliquez sur le bouton Editer pour modifier l’emplacement des bibliothèques ou des dossiers ajoutés. Utilisez le bouton Ajouter un SDK Flex pour rétablir le SDK par défaut d’un projet dont vous avez supprimé le SDK Flex du chemin de génération.
Cliquez sur l’onglet Chemin source pour ajouter des dossiers source supplémentaires à un projet. Vous pouvez réorganiser les dossiers source, en modifier l’emplacement ou les supprimer du chemin source.
Utilisation des projets
Vous serez probablement amené dans certains cas à modifier la configuration d’origine du serveur d’un projet. Pour une application Web ou de bureau, accédez à la fenêtre des propriétés du projet concerné. Sélectionnez l’option Serveur Flex pour ajouter ou modifier les options du serveur du projet.
La suppression de la configuration serveur d’un projet conduit également à la suppression de tout fichier SWC ajouté au chemin d’accès à la bibliothèque pour ce type de serveur.
Toutes les options de serveur pour la configuration serveur sélectionnée sont disponibles. Pour en savoir plus sur les paramètres de configuration du serveur, voir « Création de projets Flex » à la page 41. La modification du type de serveur d’un projet peut provoquer des erreurs dans le code existant reposant sur le type de serveur d’origine. Vous devrez examiner et corriger chaque erreur de code.
L’option MX uniquement ne met pas à la disposition des applications du projet les composants Spark fournis avec Flex 4. Vous pouvez convertir un projet Flex 4 en projet MX uniquement. Gardez cependant à l’esprit que Flash Builder ne réécrit pas le code du projet. Vous devrez mettre à jour le code manuellement afin d’en supprimer toute référence aux composants Spark.
un emplacement de projet différent, désactivez l’option Utiliser l’emplacement par défaut. 4 Choisissez le type d’application (Web ou de bureau). 5 Spécifiez un type de serveurs d’applications (ou n’en spécifiez aucun, s’il n’est pas requis). Cliquez sur Suivant. 6 (Facultatif) Spécifiez le dossier de sortie de l’application. 7 Cliquez sur Terminer ou sur Suivant pour accéder à d’autres options de configuration.
1 Dans Flash Builder, activez le projet à convertir.
2 Sélectionnez Projet > Propriétés > Chemin de génération Flex.
Utilisation des projets
4 Modifiez tout code d’application du projet accédant à des composants Spark.
Utilisez des projets Flash Professional pour accéder aux fichiers FLA ou XFL créés avec Flash Professional CS5. Cette fonctionnalité permet aux développeurs Flash Professional de profiter de l’environnement de modification et de débogage que fournit Flash Builder. Pour accéder aux fonctions de Flash Professional dans Flash Builder, vous devez installer Flash Professional CS5. Vous commencez généralement par créer un projet et des fichiers dans Flash Professional. Vous créez ensuite un projet correspondant dans Flash Builder pour la modification et le débogage des fichiers. Lors de la modification des fichiers dans Flash Builder, vous pouvez définir des points d’arrêt dans les fichiers ActionScript du projet. Les points d’arrêt définis dans des fichiers appartenant au projet Flash Professional sont reconnus par le débogueur Flash Professional lors de l’appel de Déboguer l’animation. Vous pouvez lancer Flash Professional à partir de Flash Builder pour publier et exécuter les fichiers. Vous pouvez également lancer le débogueur Flash Professional à partir de Flash Builder.
1 Sélectionnez Fichier > Nouveau > Projet Flash Professional. 2 Recherchez le fichier FLA ou XFL pour le projet. 4 Cliquez sur Terminer.
S’il n’est pas déjà en cours d’exécution, Flash Professional démarre.
Vous pouvez appliquer les opérations suivantes aux fichiers source d’un projet Flash Professional :
• Déboguer le fichier dans le débogueur Flash Builder ou Flash Professional. Pour déboguer le fichier dans Flash Builder, sélectionnez Exécuter > Déboguer fichier ou cliquez sur le bouton Déboguer dans la barre d’outils. Pour déboguer le fichier dans Flash Professional, sélectionnez Exécuter > Déboguer l’animation ou cliquez sur le bouton Déboguer l’animation dans Flash Builder. Les points d’arrêt définis dans Flash Builder sont reconnus par le débogueur Flash Professional.
Sélectionnez Projet > Publier la séquence ou cliquez sur Publier dans le bouton Flash Professional de la barre d’outils.
Utilisation des projets
Pour exécuter le fichier dans Flash Builder, sélectionnez Exécuter > Exécuter fichier ou cliquez sur le bouton Exécuter de la barre d’outils. Pour exécuter le fichier dans Flash Professional, sélectionnez Exécuter > Tester l’animation ou cliquez sur le bouton Tester l’animation de la barre d’outils.
1 Sélectionnez Projet > Propriétés du projet > Flash Professional. 2 Sélectionnez Ajouter pour ajouter des fichiers supplémentaires au projet.
Définir par défaut pour spécifier le fichier cible par défaut du projet. 3 Cliquez sur OK.
L’Explorateur de packages permet d’ajouter des ressources à un projet, d’importer des ressources, d’exporter des projets ainsi que de déplacer et de supprimer des ressources.
Chaque projet Flex possède son propre jeu de propriétés. Pour définir ces propriétés, sélectionnez le projet dans la vue Explorateur de packages. Dans le menu principal, sélectionnez ensuite Projet > Propriétés. Vous pouvez également accéder aux propriétés à partir du menu contextuel du projet. Vous pouvez définir les préférences de projet suivantes. Ressource Présente des informations générales concernant le projet, les paramètres pour le codage de texte et les délimiteurs de lignes du système d’exploitation. Générateurs Précise l’outil de génération à utiliser. Flash Builder contient un outil de génération standard. Vous pouvez faire appel à Apache Ant (outil de génération « open source ») pour créer des scripts de génération ou importer des scripts de génération Ant existants (voir « Personnalisation des générations avec Apache Ant » à la page 83). Modèle de données La configuration du modèle de données est uniquement disponible avec LiveCycle Data Services
Données/Services Pour les projets accédant à des services de données, cette page définit si le générateur de code par défaut doit être utilisé pour accéder aux services. Vous pouvez également indiquer si vous souhaitez utiliser une seule occurrence de serveur pour accéder aux services (pour plus d’informations sur l’extension de Flash Builder de manière à prendre en charge la génération de code personnalisé, voir Extension de la prise en charge des services dans Flash Builder). pour plus d’informations sur l’utilisation d’une seule occurrence de serveur lors de l’accès aux services, voir Utilisation d’une occurrence de serveur unique). Applications Flex Affiche le nom des fichiers de projet définis comme fichiers d’application pouvant être compilés,
Utilisation des projets
« Définition d’un dossier de sortie de projet » à la page 79 et « Génération manuelle de projets » à la page 81). Compilateur Flex Spécifie d’une part les préférences optionnelles pour le compilateur (génération d’un fichier SWF accessible, activation des avertissements de compilation et de la vérification des types, spécification d’arguments de compilation supplémentaires et définition de la version du SDK Flex) et définit d’autre part les paramètres de l’enveloppe HTML (voir « Options de génération avancées » à la page 81). Modules Flex Précise les modules à générer et à optimiser pour le projet. Pour plus d’informations sur l’utilisation des
Serveur Flex Spécifie le type de serveurs d’applications pour le projet. A la création d’un projet, vous avez la possibilité
Voir « Création de projets Flex » à la page 41 et Création d’un projet Flex pour l’accès à des services de données. Thème Flex Spécifie le thème à utiliser pour toutes les applications du projet. Vous pouvez spécifier l’un des thèmes
Références de projet Répertorie les projets auxquels le projet en cours fait référence. Exécuter/déboguer les paramètres Gère les paramètres de configuration de lancement. Voir « Gestion des configurations de lancement » à la page 94.
• Les configurations de lancement du projet sont mises à jour de manière telle à être lancées correctement au cours de l’exécution AIR.
• Les paramètres personnalisés de Flash Player sont supprimés. • Le chemin d’accès à la bibliothèque est modifié pour inclure le fichier airglobal.swc au lieu du fichier playerglobal.swc. Au cours de la conversion, vous pouvez définir pour chaque application du projet si vous souhaitez modifier les balises Application de base en balises WindowedApplication. Si vous décidez de convertir ces balises, cette modification sera la seule à intervenir dans le code d’application au cours de la conversion. Examinez les attributs des balises de base après la conversion pour vérifier que l’application est exécutée correctement dans Adobe AIR. Modification d’un projet d’application Web en projet d’application de bureau Remarque : cette procédure ne peut pas être annulée. 1 Sélectionnez le projet que vous souhaitez convertir.
2 Dans le menu contextuel du projet, sélectionnez :
Utilisation des projets
Les balises Application de toutes les applications existantes du projet sont converties en balises WindowedApplication. Aucune autre modification ne sera apportée au code. Examinez les attributs des balises de base pour vérifier que l’application est exécutée correctement dans Adobe AIR. Les nouvelles applications créées dans le projet sont des applications de bureau pouvant être exécutées dans Adobe AIR.
Aucune modification n’est apportée au code. Vous devez éditer les applications dans le projet avant de pouvoir les exécuter dans Adobe AIR. Les nouvelles applications créées dans le projet sont des applications de bureau pouvant être exécutées dans Adobe AIR.
Vous pouvez faire appel à une association d’opérations de suppression et d’importation pour déplacer un projet d’un espace de travail vers un autre. Lorsque vous supprimez un projet d’un espace de travail, vous pouvez l’effacer de l’espace de travail mais le laisser dans le système de fichiers (voir « Suppression de projets » à la page 51). Après avoir supprimé un projet d’un espace de travail, vous pouvez l’importer dans un autre.
Lorsque vous créez un projet Flex, vous pouvez spécifier quel SDK Flex vous souhaitez utiliser. Les paramètres du SDK pourront être modifiés ultérieurement en cliquant sur Projet > Propriétés > Compilateur Flex > Utiliser un SDK spécifique. Vous pouvez compiler un projet en utilisant un SDK Flex qui n’est pas disponible dans votre installation Flash Builder en le téléchargeant et en l’y ajoutant. Par exemple, pour que le SDK utilisé corresponde à celui du serveur, procédez à l’extraction du SDK du serveur, puis ajoutez-le à Flash Builder en cliquant sur Projet > Propriétés > Compilateur Flex > Configurer les SDK Flex.
L’importation de projets utilisant une compilation de serveur n’est pas prise en charge. Vous pouvez importer un projet spécifiant une compilation de serveur. L’importation comportera toutefois des erreurs qui s’afficheront dans la vue Erreurs. Les erreurs sont accompagnées d’un lien fournissant des informations sur la conversion d’un projet de compilation de serveur en projet de compilation d’outils.
Lorsque vous supprimez un projet, vous le retirez de l’espace de travail en cours. Vous pouvez également le supprimer simultanément du système de fichiers. Au lieu de supprimer le projet de l’espace de travail, vous pouvez le fermer. La fermeture du projet vous permet de conserver une référence à ce projet dans l’espace de travail tout en libérant des ressources système. Pour plus d’informations, voir « Fermeture et ouverture de projets » à la page 52. 1 Dans l’Explorateur de packages, sélectionnez le projet à supprimer.
Utilisation des projets
3 Sélectionnez une option. Supprimer également le contenu sous le répertoire Supprime définitivement le projet de l’espace de travail et du
Ne pas supprimer le contenu Supprime le projet de l’espace de travail sans le supprimer du système de fichiers.
Pour économiser de la mémoire et accélérer la génération sans supprimer un projet, vous pouvez le fermer. Lorsque vous fermez un projet, vous réduisez le projet et ses ressources, mais son nom reste visible dans l’Explorateur de packages. Un projet fermé nécessite moins de mémoire qu’un projet ouvert et est exclu des générations. Vous pouvez facilement rouvrir un projet fermé. 1 Dans l’Explorateur de packages, sélectionnez le projet à fermer ou rouvrir. 2 Dans le menu contextuel de l’Explorateur de packages, sélectionnez Fermer le projet ou Ouvrir le projet.
Lorsque vous créez un projet Flex, un fichier d’application principale est créé. Par défaut, il est nommé d’après le projet. Le fichier d’application principale est le point d’accès à vos applications et est la base du fichier SWF de l’application. Cependant, à mesure que vous ajoutez des fichiers à l’application, vous pouvez désigner un fichier différent comme fichier d’application principale. Si vous préférez définir plusieurs fichiers d’application de manière à ce que chaque fichier d’application soit généré dans un fichier SWF distinct, consultez « Gestion des fichiers d’application du projet » à la page 52. 1 Dans l’Explorateur de packages, sélectionnez le fichier d’application MXML que vous voulez définir comme fichier
2 Dans le menu contextuel de l’Explorateur de packages, sélectionnez Définir comme application par défaut.
Applications ActionScript si vous utilisez un projet ActionScript).
Un projet possède généralement un seul fichier d’application principale, qui sert de point d’accès à l’application. Le compilateur Flash Builder utilise ce fichier pour générer le fichier d’application SWF. Une application Flex complexe peut par exemple être dotée de nombreux composants MXML personnalisés qui représentent des éléments d’application distincts mais interdépendants. Vous pouvez créer un fichier d’application contenant un composant personnalisé et ensuite le générer, l’exécuter et le tester séparément. Par défaut, vous pouvez exécuter l’application à chaque ajout d’un fichier d’application MXML au projet Flex. Ce fichier est alors ajouté à la liste des fichiers d’application du projet. Tous les fichiers définis comme fichiers d’application doivent se trouver dans le dossier source du projet. Vous pouvez gérer la liste des fichiers d’application en sélectionnant un projet et en affichant ses propriétés. 1 Dans l’Explorateur de packages, sélectionnez un projet. 2 Sélectionnez Projet > Propriétés dans le menu principal ou sélectionnez Propriétés dans le menu contextuel. 3 Dans la boîte de dialogue Propriétés du projet, sélectionnez Applications Flex (ou Applications ActionScript si vous
Utilisation des projets
Flash Builder exporte les projets Flex et les projets de bibliothèques Flex au format FXP. Les projets ActionScript peuvent être exportés uniquement vers des fichiers archive, généralement au format ZIP. Le format FXP est un format d’archive contenant les dossiers, les fichiers et les métadonnées d’un projet. Un projet exporté contient tous les projets de bibliothèque Flex dépendants. Remarque : vous pouvez également faire appel à l’assistant d’exportation Eclipse pour exporter des projets Flex et des projets de bibliothèque Flex au format ZIP ou vers un autre format d’archive. Lors de l’exportation ou de l’importation d’un projet Flex, certains contenus du projet nécessiteront un traitement spécial.
Vous pouvez importer un projet Flex faisant référence à une version du SDK Flex qui n’a pas été installée avec Flash Builder. Pour plus d’informations sur le téléchargement et l’installation de versions supplémentaires du SDK Flex, voir « SDK Flex installés » à la page 253. Si Flash Builder ne trouve pas une version spécifique du SDK Flex, une boîte de dialogue s’ouvre vous permettant de la rechercher. Après avoir installé la version correcte du SDK Flex, accédez à son emplacement.
Les projets Flex qui se connectent à des services de données comportent des dossiers services contenant des liens vers des fichiers de services déployés. A l’exportation du projet, Flash Builder exporte les liens, mais pas les services déployés. A l’importation, vous devrez déployer les fichiers de services manuellement et mettre à jour les liens, si besoin est. Pour les projets se connectant aux services via LiveCycle Data Service ou BlazeDS, vérifiez que les destinations de service sont disponibles sur le serveur cible. Pour les projets qui référencent des fichiers locaux, déployez ces derniers en utilisant le même chemin que celui du projet d’origine à l’importation. Cette manière de procéder s’applique aux projets accédant à des fichiers de service XML statiques ou à des fichiers locaux pour des services HTTP ou Web.
Les projets Flex qui se connectent à des services de données en utilisant PHP et la structure Zend Framework contiennent deux fichiers de configuration. A l’importation, examinez ces fichiers afin de vérifier qu’ils ont été correctement configurés pour votre système : amf-config.ini gateway.php
Un projet Flex utilisant LiveCycle Data Services (LCDS) est relié à un fichier de modèle de données.
Utilisation des projets
FXP Les menus des configurations autonome et plug-in de Flash Builder correspondant à cette procédure diffèrent légèrement. Certains projets Flex devront faire l’objet d’un traitement spécial à l’importation. Voir « Exportation et importation de projets » à la page 53. 1 Dans Flash Builder, sélectionnez Fichier > Exporter un projet Flex (FXP).
Vous pouvez également faire appel au menu contextuel du projet dans l’Explorateur de packages. Sélectionnez Exporter > Flash Builder > Projet Flash Builder. 2 Dans l’assistant Exportation d’un projet Flex, sélectionnez le projet à exporter.
3 (Facultatif) Activez l’option Valider la compilation du projet.
4 Cliquez sur Terminer.
1 Dans Flash Builder, sélectionnez Fichier > Exporter > Autre. 2 Dans l’assistant d’exportation, sélectionnez Général > Fichier archive. Cliquez sur Suivant. 3 Sélectionnez le projet et les fichiers à exporter :
• Dans le volet de droite, indiquez pour chaque dossier sélectionné les fichiers à exporter. 4 Recherchez un emplacement dans lequel enregistrer le projet exporté et attribuez un nom au fichier. 5 Définissez les options pour le fichier archive, puis cliquez sur Terminer.
Utilisation des projets
Flash Builder peut importer des projets Flex, des projets de bibliothèque Flex et des projets ActionScript. Les projets peuvent être importés à partir de dossiers de projet existants ou à partir de fichiers issus d’une préalable exportation à partir de Flash Builder. Vous pouvez importer plusieurs versions d’un même projet Flex ou d’un même projet de bibliothèque Flex. Une fois l’importation de plusieurs versions effectuée, vous pouvez les comparer, puis copier ou fusionner leurs différences.
Certains projets Flex devront faire l’objet d’un traitement spécial à l’importation. Cela est le cas par exemple lorsque :
• le projet fait référence à des fichiers de service pour l’accès aux données ; • la configuration Zend Framework pour l’accès aux services PHP doit être mise à jour ; • le projet utilise des liens LiveCycle Data Services (LCDS) vers un fichier de modèle de données. Pour plus d’informations sur les projets nécessitant un traitement spécial, voir « Exportation et importation de projets » à la page 53.
Flash Builder prend en charge le développement des applications conçues dans Adobe® Flash® Catalyst™. Catalyst exporte un projet au format FXP et des composants au format FXPL. Le fichier FXPL est un package de bibliothèque. Les fichiers FXP et FXPL peuvent être ensuite importés dans Flash Builder à des fins de développement. Pour les fichiers FXP, il en résulte un projet Web Flex exécuté dans Adobe Flash Player. Un fichier FXPL contient un fichier de bibliothèque. Vous pouvez importer des fichiers FXPL sous la forme d’un projet de bibliothèque Flex ou importer le contenu dans un projet Flex existant. Vous pouvez créer un projet Adobe AIR à partir d’un projet Catalyst. Importez le fichier FXP du projet Catalyst dans Flash Builder. Convertissez le type d’application du projet d’application Web (exécutée dans Flash Player) en application de bureau (exécutée dans Adobe AIR). Voir « Conversion de projets Flex en projets Adobe AIR » à la page 50.
Vous pouvez importer un projet à partir d’un fichier FXP exporté ou en accédant au dossier contenant le projet. Remarque : pour plus d’informations sur l’importation de contenu d’un projet de bibliothèque dans un autre projet Flex, voir « Importation d’un projet FXPL Catalyst » à la page 56. Un projet FXPL est un projet de bibliothèque créé par Adobe Catalyst. Les menus des configurations autonome et plug-in de Flash Builder correspondant à cette procédure diffèrent légèrement. 1 Dans le menu de Flash Builder, sélectionnez Fichier > Importer un projet FXP.
Les fonctions d’importation d’un projet sont également disponibles dans le menu contextuel de l’Explorateur de packages. 2 (Dossier du projet) Si l’importation est effectuée à partir d’un dossier de projet existant, activez l’option Dossier du
3 (Fichier FXP) Si vous effectuez une importation à partir d’un fichier FXP, sélectionnez Fichier et naviguez jusqu’à
Utilisation des projets
4 (Projet de bibliothèque ou projet FXPL) Si vous importez un projet de bibliothèque ou un projet FXPL Catalyst,
5 (Fichier FXP) Si un projet du même nom existe dans l’espace de travail, spécifiez la méthode d’importation.
Dans le champ Extraire le nouveau projet vers, spécifiez l’emplacement dans lequel vous souhaitez extraire le fichier. Cet emplacement est généralement un répertoire de l’espace de travail de Flash Builder représentant un dossier du projet. Vous pouvez spécifier un nouveau dossier de projet ou remplacer un projet existant.
6 (Variables de chemin) Si vous importez un projet définissant des variables de chemin, mettez à jour les variables de
Les projets compilés pour ColdFusion, PHP, LiveCycle Data Services ou d’autres technologies de serveur font appel aux variables de chemin pour accéder au serveur Web et aux ressources du serveur. D’autres projets peuvent présenter des variables de chemin personnalisées. Sélectionnez chaque variable de chemin et attribuez-lui une valeur valide. 7 (Références aux polices) Si vous importez un fichier FXP exporté par Catalyst, le projet peut contenir des références
Voir « Résolution des références aux polices lors de l’importation de projets Catalyst » à la page 57. 8 Cliquez sur Terminer. 9 (Projets pour serveurs PHP) Si vous importez un projet pour serveur d’applications de type PHP, installez ou
La boîte de dialogue Zend vous guide au long du processus. Remarque : si vous annulez le processus dans la boîte de dialogue Zend, installez ou mettez à jour manuellement Zend Framework. L’accès aux services PHP est impossible tant que Zend Framework n’est pas installé et configuré correctement. Pour plus d’informations sur l’installation, la configuration et le dépannage de l’installation Zend Framework, voir Installation de Zend Framework. 10 (Projets pour serveurs) Déployez des services. a Placez manuellement des services dans la racine Web du serveur. Utilisez la structure de répertoire utilisée dans
Un projet FXPL Catalyst est un projet de bibliothèque créé par Adobe Catalyst. Lors de l’importation d’un projet FXPL, vous avez la possibilité d’importer le contenu dans un autre projet Flex ou dans un projet de bibliothèque Flex. Cette fonctionnalité est conçue pour permettre aux développeurs de collaborer avec les concepteurs d’applications Catalyst. Vous pouvez toutefois l’utiliser pour importer le contenu d’un projet de bibliothèque dans un autre projet Flex ou dans un projet de bibliothèque Flex.
Utilisation des projets
1 Dans le menu de Flash Builder, sélectionnez Fichier > Importer un projet FXP.
Les fonctions d’importation d’un projet sont également disponibles dans le menu contextuel de l’Explorateur de packages. 2 Activez l’option Fichier et recherchez l’emplacement du fichier. 3
• Importez le contenu dans un projet existant. Pour Dossier source, accédez au dossier src d’un projet existant. Pour Package, accédez à un package existant ou spécifiez un nouveau nom de package pour le contenu.
Sélectionnez le projet à remplacer. La version antérieure du projet est définitivement supprimée. 4 Cliquez sur Terminer.
Voir « Résolution des références aux polices lors de l’importation de projets Catalyst » à la page 57.
Lors de l’importation d’un projet FXP créé avec Adobe Catalyst, ce projet peut contenir des références à des polices qui ne sont pas disponibles sur votre système. L’assistant d’importation permet de corriger les références aux polices à l’aide de CSS. Si vous sélectionnez l’option correspondante, Flash Builder importe la feuille de style Catalyst Main.css. Main.css contient les références aux polices utilisées dans le projet. Si vous obtenez des erreurs de compilation provenant des polices référencées dans la feuille de style, corrigez les références de la feuille de style avec les polices disponibles sur votre système. Les projets FXPL Catalyst ne contiennent pas de feuilles de style. Flash Builder tente de corriger les références aux polices lors de l’importation d’un fichier FXPL. S’il ne trouve pas de police correspondante sur le système cible, les références aux polices d’origine sont conservées. Pour les projets FXPL, les références aux polices que Flash Builder ne parvient pas à résoudre sont détectées à l’exécution. Les références aux polices non résolues entraînent une substitution de police ou une erreur d’exécution. Remarque : pour les fichiers FXPL, Flash Builder modifie l’attribut fontFamily dans les fichiers MXML lorsqu’il tente de résoudre les références aux polices.
Utilisation des projets
Vous pouvez importer un projet Flex 3 dans Flash Builder en utilisant le mode de compatibilité Flex 3. Dans ce cas, les espaces de noms et les composants Flex 3 demeureront inchangés. Vous pourrez cependant profiter du compilateur disponible avec Flex 4. Les documents créés en mode de compatibilité Flex 3 utilisent les composants MX et les espaces de noms suivants : mx="http://www.adobe.com/2006/mxml"
2 Recherchez le fichier ZIP du projet Flex 3 précédemment exporté ou le dossier du projet Flex 3. 3 Cliquez sur Terminer. 4 Dans la boîte de dialogue Choisir la version du SDK Flex, vérifiez que le SDK Flex 4 a été activé. Sélectionnez
Si vous importez plusieurs versions d’un projet, vous pouvez comparer, copier ou fusionner les contenus des versions. Vous pouvez uniquement comparer des versions différentes d’un même projet. 1 Dans l’Explorateur de packages, sélectionnez l’un des projets que vous souhaitez comparer. 2 Ouvrez le menu contextuel et sélectionnez Comparer le projet avec la version.
3 Sélectionnez la version avec laquelle vous souhaitez effectuer la comparaison. L’éditeur de comparaison Eclipse
4 Dans l’éditeur de comparaison, accédez au fichier que vous souhaitez comparer et sélectionnez Afficher la
L’éditeur de comparaison affiche les deux versions du fichier et en met en évidence les différences. Vous pouvez utiliser les options de l’éditeur de comparaison pour copier ou fusionner les différences dans le fichier. Pour plus d’informations, voir la documentation Eclipse sur l’éditeur de comparaison.
Les projets ActionScript sont exportés au format d’archive ZIP. Utilisez l’assistant d’importation Eclipse pour importer les projets ActionScript. 1 Dans Flash Builder, sélectionnez Fichier > Importer > Autre > Général > Fichier archive. Importation de projets exportés avec l’assistant d’exportation Eclipse Un projet exporté à l’aide de l’assistant d’exportation Eclipse devra être importé avec l’assistant d’importation Eclipse. Sélectionnez Fichier > Importer > Général. Recherchez le format correspondant à votre projet. Pour plus d’informations, voir la documentation Eclipse sur l’importation de projets. Cette documentation est disponible dans l’aide des assistants d’importation et d’exportation Eclipse.
Utilisation des projets
Données/Services, utilisez les propriétés du service pour un serveur afin de déterminer l’emplacement du service. Si vous avez exporté un projet PHP basé sur la structure Zend Framework, cette dernière doit être installée sur le serveur cible. Modifiez le fichier amf-config.ini qui configure la structure Zend Framework. Pour zend_path, spécifiez le chemin absolu du répertoire d’installation de Zend Framework. Pour plus d’informations sur l’installation, la configuration et le dépannage de l’installation Zend Framework, voir Installation de Zend Framework.
Flash Builder importe les projets dans ses espaces de travail. Un projet peut être importé dans plusieurs espaces de travail. Dans ce cas, les fichiers du projet se trouvent dans un seul emplacement sur le disque, mais sont référencés par chaque espace de travail. Les modifications apportées au projet se répercutent dans tous les espaces de travail.
Vous pouvez créer un projet dans lequel importer les fichiers source et les ressources situés sur votre système de fichiers mais n’appartenant à aucun projet. 1 Dans le menu Flash Builder, sélectionnez Fichier > Nouveau > Projet.
2 Dans l’assistant Nouveau projet Flex, spécifiez la source et le dossier de sortie.
Pour plus d’informations sur l’exportation d’une version de production et d’un programme d’installation AIR, voir « Exportation vers une version validée (application de bureau, exécutée dans Adobe AIR) » à la page 60.
Vous pouvez exporter une version optimisée de qualité finale (fichier SWF ou AIR non débogué) de l’application en utilisant l’assistant Exporter vers une version validée. Les ressources requises sont copiées dans un dossier distinct de celui de la version de débogage. Une fois l’assistant exécuté, vous devrez procéder à des opérations supplémentaires pour déployer l’application sur un serveur.
Flash Player) 1 Sélectionnez Projet > Exporter vers une version validée pour ouvrir l’assistant correspondant. 2 Sélectionnez le projet et l’application que vous souhaitez exporter.
Utilisation des projets
Cliquez sur Choisir des fichiers source pour spécifier les fichiers source à inclure. Outre les fichiers source spécifiés, l’assistant génère un fichier archive ZIP contenant les fichiers source. Important : pour les projets pour serveurs, vous pouvez sélectionner le dossier des services à l’exportation des fichiers source. L’exportation de fichiers implémentant des services a des implications en termes de sécurité. Ces fichiers peuvent donner accès à votre base de données, noms d’utilisateurs et mots de passe inclus. Voir Exportation des fichiers source vers la version validée d’une application. 4 Cliquez sur Terminer. 5 Copiez le dossier contenant la version exportée vers la racine Web du serveur hébergeant l’application. 6 (Projets pour serveurs) Si vous exportez la version d’un projet spécifiant un type de serveurs d’applications,
Conservez la structure de répertoire utilisé lors du développement. Cette étape s’applique aux services ColdFusion, PHP, BlazeDS et LCDS. Le type de serveurs d’applications est défini à la création du projet dans Flash Builder. Pour des fichiers locaux déployés sur le serveur, un fichier de régulation interdomaines est nécessaire pour accéder à ces services. Cette manière de procéder s’applique aux projets accédant à des fichiers de service XML statiques ou à des fichiers locaux pour des services HTTP ou Web. Voir Utilisation des fichiers de régulation interdomaines. 7 (Projets pour serveurs PHP uniquement) Pour les projets PHP, exécutez les étapes supplémentaires suivantes : a Installez la structure Zend Framework sur le serveur. Voir Installation de Zend Framework. b Modifiez le fichier amf-config.ini qui se trouve dans le dossier de sortie de la version exportée.
Définissez amf.production sur true. Saisissez pour webroot le chemin absolu vers la racine Web du serveur.
Adobe AIR) Pour les projets AIR, une version de production crée un fichier AIR signé numériquement que l’utilisateur devra installer préalablement à l’exécution de l’application. Ce processus s’apparente à la création d’un fichier .exe de programme d’installation pour une application native standard. Vous pouvez également créer un package intermédiaire non signé que vous pourrez signer ultérieurement avant la publication. Avant d’entamer la procédure d’exportation vers une version validée, vous devez décider de la manière dont vous souhaitez signer numériquement l’application AIR :
• Créer et utiliser un certificat numérique autosigné • Assembler l’application et la signer ultérieurement Les certificats numériques délivrés par VeriSign et Thawte confirment votre identité d’éditeur et indiquent qu’aucune modification n’a été apportée au fichier d’installation depuis sa signature. Les certificats numériques autosignés sont utilisés dans le même but, mais se distinguent par le fait qu’ils ne sont pas validés par un tiers.
Utilisation des projets
(.airi). La validité de ce type de fichier est limitée. Il ne peut en effet pas être installé. Il est utilisé dans les procédures de test (effectuées par les développeurs) et peut être lancé avec l’outil de ligne de commande AIR ADT. La mise à disposition de cette fonctionnalité est liée au fait que dans certains environnements de développement, la signature est prise en charge par un développeur ou une équipe spécifique, garantissant ainsi un niveau de sécurité supérieur.
1 (Facultatif) Modifiez les paramètres du serveur dans les propriétés du projet.
2 Sélectionnez Projet > Exporter vers une version validée pour ouvrir l’assistant correspondant. 3 Sélectionnez le projet et l’application que vous souhaitez exporter. 4 (Facultatif) Sélectionnez Activer l’affichage de la source pour permettre l’accès aux fichiers source à partir de
Cliquez sur Choisir des fichiers source pour spécifier les fichiers source à inclure. Outre les fichiers source spécifiés, l’assistant génère un fichier archive ZIP contenant les fichiers source. Important : pour les projets pour serveurs, vous pouvez sélectionner le dossier des services à l’exportation des fichiers source. L’exportation de fichiers implémentant des services a des implications en termes de sécurité. Ces fichiers peuvent donner accès à votre base de données, noms d’utilisateurs et mots de passe inclus. Voir Exportation des fichiers source vers la version validée d’une application. 5 Sélectionnez l’option Exporter vers un fichier AIR ou l’option Exporter vers le programme d’installation natif.
L’option Exporter vers un fichier AIR crée un fichier de programme d’installation générique permettant l’installation de l’application sur les plates-formes Windows ou Mac OS X. L’option Exporter vers le programme d’installation natif crée un programme d’installation pour la plate-forme cible (Windows ou Mac OS X). 6 A la page Signature numérique, procédez comme suit :
Pour exporter un fichier dont la signature peut être effectuée ultérieurement, exportez un fichier intermédiaire AIRI. 7 Dans la page Contenu du fichier AIR, sélectionnez les fichiers de sortie à inclure dans le fichier AIR ou AIRI. 8 Cliquez sur Terminer. 9 Copiez le projet .air vers le bureau cible. 10 (Projets pour serveurs) Si vous exportez la version d’un projet spécifiant un type de serveurs d’applications,
Cette étape s’applique aux services ColdFusion, PHP, BlazeDS et LCDS. Le type de serveurs d’applications est défini à la création du projet dans Flash Builder. 11 (Projets pour serveurs PHP uniquement) Exécutez les étapes supplémentaires suivantes : a Installez la structure Zend Framework sur le serveur. Voir Installation de Zend Framework. b Modifiez le fichier amf-config.ini qui se trouve dans le dossier de sortie de la version exportée.
Utilisation des projets
Saisissez pour webroot le chemin absolu vers la racine Web du serveur.
La version déboguée de l’application contient des informations de débogage. Elle intervient au cours du débogage de l’application. La version validée résultant de l’exportation ne contient aucune information de débogage. La taille de son fichier est donc inférieure à celle du fichier de la version déboguée. Un fichier d’enveloppe HTML contient un lien vers le fichier SWF de l’application. Il intervient dans l’exécution ou le débogage de l’application dans un navigateur Web. Remarque : les commandes Exécuter et Déboguer lancent la version de développement dans le dossier bin-debug (et non dans le dossier de version validée, bin-release). Dans une application standard, le dossier de sortie ressemble à l’exemple suivant.
Flash Player autonome. Pour définir la manière dont les applications sont exécutées ou déboguées, modifiez la configuration de lancement du projet (voir « Exécution des applications » à la page 92). Pour plus d’informations sur l’exécution ou le débogage des applications, voir « Exécution des applications » à la page 90 et « Débogage des applications » à la page 141. L’utilisation de LiveCycle Data Services ES conduit à la création d’applications tirant parti des technologies de serveur Flex. Lorsque vous générez des applications LiveCycle Data Services ES, vous pouvez opter entre la compilation locale des fichiers de sortie avec Flash Builder ou la compilation sur le serveur intervenant au moment d’accéder à l’application pour la première fois.
Les projets sont constitués de ressources (dossiers et fichiers) que vous pouvez gérer depuis l’Explorateur de packages. Les projets sont contenus dans un espace de travail. L’Explorateur de packages propose une représentation logique de l’espace de travail dans le système de fichiers. Il est actualisé à chaque fois que vous ajoutez, supprimez ou modifiez une ressource.
Utilisation des projets
Builder ni par l’Explorateur de packages.
Vous pouvez ajouter des dossiers et des fichiers à un projet selon vos besoins. Vous pouvez par exemple créer un dossier destiné à stocker tous les modèles de données ou à organiser toutes les ressources qui composent l’aspect visuel de l’application. Création d’un dossier 1 Dans l’Explorateur de packages, sélectionnez Fichier > Nouveau > Dossier. 2 Si l’espace de travail contient plusieurs projets, sélectionnez le projet à ajouter au dossier autonome.
Si vous le créez en dehors du dossier du chemin d’accès source, vous pourrez l’ajouter ultérieurement à ce chemin afin de le transformer en racine d’une structure de packages. Une fois que vous avez terminé cette procédure, sélectionnez Projet > Propriétés, puis Chemin de génération Flex. Cliquez sur Ajouter un dossier et accédez au dossier que vous venez de créer. 3 Entrez le nom du dossier, puis cliquez sur Terminer.
1 Dans l’Explorateur de packages, sélectionnez Fichier > Nouveau > Fichier. 2 Si l’espace de travail contient plusieurs projets, sélectionnez le projet auquel vous voulez ajouter le fichier. 3 Entrez le nom du fichier, puis cliquez sur Terminer.
La suppression de dossiers et de fichiers du projet les élimine de l’espace de travail et, par conséquent, du système de fichiers. Remarque : la suppression d’une ressource liée ne supprime du projet que le lien, pas la ressource en soi (voir « Liaison à des ressources situées en dehors de l’espace de travail du projet » à la page 64). Cependant, si vous avez créé un lien à un dossier et que vous supprimez un ou plusieurs de ses fichiers, ceux-ci sont supprimés du système de fichiers. 1 Dans l’Explorateur de packages, sélectionnez la ressource à supprimer. 2 Sélectionnez Edition > Supprimer ou appuyez sur la touche Suppr, puis cliquez sur Oui.
Lorsque vous travaillez avec plusieurs projets dans un espace de travail, vous pouvez déplacer des ressources d’un projet vers un autre. 1 Dans l’Explorateur de packages, sélectionnez la ressource à déplacer.
Utilisation des projets
• Coupez et collez la ressource dans un autre projet. Remarque : vous pouvez déplacer des ressources normales et des ressources liées. Pour plus d’informations sur la liaison de ressources, voir « Liaison à des ressources situées en dehors de l’espace de travail du projet » à la page 64.
A mesure que vous modifiez, ajoutez ou supprimez les ressources d’un projet, le workbench actualise automatiquement les différentes vues qui affichent ces ressources. La suppression d’un fichier du projet par exemple est immédiatement répercutée dans l’Explorateur de packages. Vous pouvez également modifier des ressources situées en dehors de Flash Builder, directement dans le système de fichiers. Ces modifications ne sont visibles dans Flash Builder qu’après actualisation de l’espace de travail. Par défaut, l’espace de travail de la configuration autonome de Flash Builder est actualisé automatiquement. Cette option peut être modifiée dans les préférences de Flash Builder. Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Espace de travail. Vous pouvez également modifier le comportement par défaut de Flash Builder et désactiver l’actualisation automatique de l’espace de travail. Actualisation manuelle de l’espace de travail ❖ Dans le menu contextuel de l’Explorateur de packages, sélectionnez Actualiser. Toutes les ressources de projet dans l’espace de travail sont actualisées. Désactivation de l’actualisation automatique 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Espace de travail. 2 Désélectionnez l’option Actualiser automatiquement.
Vous pouvez créer des liens avec des ressources situées en dehors du projet et de l’emplacement de l’espace de travail ainsi qu’avec des dossiers et des fichiers situés n’importe où dans le système de fichiers. Cette option est utile en cas de partage des ressources entre différents projets. Vous pouvez par exemple partager une bibliothèque de composants Flex ou ActionScript personnalisés entre plusieurs projets Flex. Les dossiers contenant des ressources liées sont signalés dans l’Explorateur de packages (comme l’illustre l’exemple suivant). Vous pouvez ainsi distinguer les ressources normales des ressources liées.
Lorsque les ressources sont partagées, les modifications que vous apportez aux dossiers et fichiers source affectent tous les projets qui leur sont liés. Soyez prudent lorsque vous supprimez de vos projets des ressources liées : dans certains cas, vous supprimez simplement la référence au lien ; dans d’autres, vous supprimez la source même. Pour plus d’informations, voir « Suppression de dossiers et de fichiers » à la page 63.
Utilisation des projets
Liaison à des ressources situées en dehors de l’espace de travail du projet 1 Dans l’Explorateur de packages, sélectionnez le projet auquel vous souhaitez ajouter des ressources liées. 2 Sélectionnez Fichier > Nouveau > Dossier (ou Fichier). 3 Sélectionnez le projet ou le dossier du projet auquel vous souhaitez ajouter les ressources liées. 4 Saisissez le nom du dossier ou du fichier. Il peut être différent du nom du dossier ou du fichier avec lequel vous
5 Cliquez sur le bouton Options avancées. 6 Sélectionnez Lier au dossier dans le système de fichiers. Saisissez ou recherchez l’emplacement de la ressource. 7 Cliquez sur Terminer pour lier la ressource au projet.
Vous pouvez établir des liens vers des ressources en définissant des variables de chemin. Vous évitez ainsi de devoir saisir le chemin complet d’un dossier local ou d’un dossier réseau dans lequel vous enregistrez les fichiers. Pour plus d’informations, voir « Création d’une variable de chemin » à la page 80. 1 Dans l’Explorateur de packages, sélectionnez le projet auquel vous souhaitez ajouter des ressources liées.
2 Sélectionnez Fichier > Nouveau > Dossier (ou Fichier, si vous voulez ajouter des fichiers). 3 Sélectionnez le projet ou le dossier du projet auquel vous souhaitez ajouter les ressources liées. 4 Cliquez sur le bouton Options avancées. 5 Sélectionnez Lier au dossier dans le système de fichiers. Cliquez sur le bouton Variables. 6 Sélectionnez une variable de chemin définie ou cliquez sur Nouveau pour créer une variable de chemin.
7 Saisissez le nom de la variable de chemin et saisissez ou recherchez l’emplacement du fichier ou du dossier.
8 Sélectionnez la nouvelle variable de chemin dans la boîte de dialogue Sélection d’une variable de chemin, puis
9 Cliquez sur Terminer pour terminer la création du lien vers la ressource.
(dans la boîte de dialogue Préférences, sélectionnez Général > Espace de travail > Ressources liées).
Pour partager des ressources entre plusieurs projets, placez-les dans des dossiers qui pourront ensuite être reliés aux différents projets à l’aide du chemin d’accès source de ces derniers. Il s’agit de la meilleure méthode de partage de ressources, telles que les classes, les composants MXML et les images. Les mises à jour de ces ressources sont immédiatement disponibles pour tous les projets qui les utilisent. Lorsque les projets sont compilés, les ressources partagées sont ajoutées au fichier SWC.
Utilisation des projets
1 Sélectionnez un projet dans l’Explorateur de packages. 2 Sélectionnez Projet > Propriétés > Chemin de génération Flex (ou Chemin de génération ActionScript si vous
3 Sur la page des propriétés du chemin de génération, cliquez sur l’onglet Chemin source. 4 Cliquez sur le bouton Ajouter un dossier. 5 Saisissez ou recherchez le chemin du dossier, puis cliquez sur OK.
L’onglet de propriétés Chemin source vous permet également de modifier, supprimer ou changer l’ordre des éléments du chemin source. Les dossiers qui sont ajoutés au chemin source sont signalés dans l’Explorateur de packages.
Les références de projet pouvant avoir une incidence sur l’ordre de génération, Flash Builder propose une alternative à leur utilisation. Projets de bibliothèque Flex Méthode priviliégiée de création d’une bibliothèque réutilisable. Flash Builder crée une
Chemin source Méthode recommandée pour inclure du code dans le projet ne se trouvant pas sous la même structure de dossier. Elle active les indicateurs de code dans les fichiers du projet et dans les classes situées dans des fichiers liés. Le compilateur sait où trouver le code source. Vous pouvez ajouter au projet un nombre quelconque de chemins source. Ils s’affichent en tant que dossiers liés dans l’Explorateur de packages.
Dans l’Explorateur de packages, vous pouvez sélectionner une ressource et en afficher les propriétés. 1 Dans l’Explorateur de packages, sélectionnez une ressource. 2 Sélectionnez Fichier > Propriétés.
Flash Builder vous permet de créer des projets ActionScript qui font appel à l’API Flash (et non à la structure Flex). Les outils du workbench de Flash Builder et l’éditeur ActionScript s’associent ainsi pour former un environnement de développement d’applications ActionScript, intégré et riche en fonctionnalités. Les projets ActionScript ne possèdent pas de représentation visuelle dans Flash Builder. En d’autres termes, il n’existe pas de mode Création pour les applications ActionScript. Vous affichez les applications ActionScript en les compilant dans Flash Builder, puis en les exécutant dans Flash Player. Vous pouvez utiliser tous les outils de débogage. Lorsque vous créez un projet ActionScript ou un fichier ActionScript autonome destiné à contenir des fonctions, une classe ou une interface, la perspective de développement Flex change pour prendre en charge l’éditeur ActionScript. Les principales vues associées à l’éditeur ActionScript sont les vues Structure et Erreurs.
Utilisation des projets
Lorsque vous créez un projet, l’assistant Nouveau projet ActionScript vous guide tout au long des différentes étapes et vous demande de préciser le type de projet à créer, le nom du projet, son emplacement, ainsi que d’autres options avancées. 1 Sélectionnez Fichier > Nouveau > Projet ActionScript. 2 Saisissez le nom du projet, puis spécifiez les éléments suivants. Emplacement du projet L’emplacement par défaut est l’espace de travail actuel. Sous Windows, l’emplacement de l’espace de travail par défaut est C:\Documents and Settings\Développeur FlexAdobe Flash Builder\. Sous Macintosh, l’emplacement de l’espace de travail par défaut est /Users/Développeur FlexAdobe Flash Builder/. Pour choisir un emplacement de projet différent, désactivez l’option Utiliser l’emplacement par défaut. Version SDK Flex Choisissez la version par défaut ou spécifiez-en une. Vous pouvez aussi cliquer sur le lien
Préférences. 3 Cliquez sur Suivant pour définir les options avancées (sinon, cliquez sur Terminer). Chemin source Précise le chemin de liaison des ressources externes à l’application. En présence d’un dossier de classes partagées ActionScript par exemple, vous pouvez créer un lien vers ce dossier en l’ajoutant au chemin source. Chemin d’accès à la bibliothèque Précise le chemin d’accès de liaison des bibliothèques de ressources externes
Dossier source principal Précise, par défaut, la racine du projet. Vous pouvez toutefois sélectionner un dossier
Fichier de l’application principale Précise le nom du fichier ActionScript qui est le fichier de l’application principale. Par défaut, Flash Builder utilise le nom du projet comme nom de fichier de l’application principale. Vous pouvez le modifier. Dossier de sortie Précise l’emplacement des fichiers de l’application compilée. Par défaut, il s’agit du dossier bin. Vous pouvez en sélectionner un autre. URL du dossier de sortie Précise l’emplacement du serveur des fichiers de l’application compilée. Cette
4 Une fois les paramètres du projet ActionScript saisis, cliquez sur Terminer.
Vous pouvez faire appel à un assistant Flash Builder pour créer rapidement des classes ActionScript pour les projets Flex et ActionScript. Cet assistant vous permet également de générer facilement des stubs pour des fonctions devant être implémentées. 1 Sélectionnez Fichier > Nouveau > Classe ActionScript. 2 Dans la boîte de dialogue, spécifiez les propriétés de base de la nouvelle classe, puis cliquez sur Terminer.
Utilisation des projets
également le composant dans la vue Composants pour permettre son insertion rapide dans les applications. Pour plus d’informations, voir « Ajout de composants en mode Création MXML » à la page 192. 3 Rédigez la définition de la classe ActionScript.
Vous pouvez faire appel à un assistant Flash Builder pour créer rapidement des interfaces ActionScript pour les projets Flex et ActionScript. Une interface est un ensemble de constantes et de méthodes que différentes classes peuvent partager. 1 Sélectionnez Fichier > Nouveau > Interface ActionScript. 2 Spécifiez les propriétés de base de la nouvelle interface dans la boîte de dialogue, puis cliquez sur Terminer. 3 Ajoutez à l’interface ActionScript les éventuelles constantes ou méthodes que les différentes classes partagent.
Les fonctions des accesseurs Get et Set permettent de faire en sorte que les propriétés d’une classe restent privées pour cette classe. Les utilisateurs peuvent accéder à ces propriétés de la même manière qu’ils accèdent à une variable de classe (au lieu d’appeler une méthode de classe). Flash Builder peut générer des fonctions d’accesseur Get et Set ActionScript pour les variables de classe. Lorsque vous générez des accesseurs Get et Set, Flash Builder propose les options suivantes :
En règle générale, les variables de classe ont un accès privé.
Par convention, les variables de classe privée ont un trait de soulignement au début du nom.
• Préciser si vous voulez générer des fonctions d’accesseur Get et Set. • Spécifier le placement de la fonction d’accesseur dans l’un des emplacements suivants : • Avant la première méthode • Après la dernière méthode • Avant les déclarations de variable • Afficher un aperçu du code qui sera généré. Génération de fonctions d’accesseur Get ou Set 1 Ouvrez un fichier ActionScript dans l’éditeur de source, puis placez le curseur sur une variable de classe. 2 Sélectionnez Source > Générer les méthodes Get/Set dans le menu Flash Builder ou le menu contextuel. 3 Dans la boîte de dialogue Générer les méthodes Get/Set, spécifiez les informations concernant les fonctions
Remarque : pour afficher le code qui sera généré, sélectionnez Aperçu avant de cliquer sur OK.
Utilisation des projets
Les projets de bibliothèque vous permettent de créer des bibliothèques de code personnalisé que vous pouvez partager entre vos applications ou distribuer à d’autres développeurs. Un projet de bibliothèque génère un fichier SWC, c’està-dire un fichier archive pour les composants Flex ainsi que pour d’autres ressources. Par exemple, la structure Flex est contenue dans des fichiers SWC. Lorsque vous créez un projet Flex, les fichiers SWC de la structure Flex sont ajoutés au chemin de la bibliothèque du projet. Vous pouvez afficher et modifier le chemin de la bibliothèque dans la page de propriétés du chemin de génération du projet (pour les projets Flex, sélectionnez Projet > Propriétés > Chemin de génération Flex). Un fichier SWF est archivé dans un fichier SWC contenant des composants, des ressources et un fichier catalog.xml, fichier manifeste des éléments contenus dans le fichier SWF. Le fichier SWF contient généralement un ou plusieurs composants et toute autre ressource requise. L’ajout de la bibliothèque à un projet vous permet d’utiliser ces composants et en active les indicateurs de code. Les bibliothèques SWC constituent une méthode pratique d’assemblage et de distribution des composants, mais servent également de thèmes, l’aspect visuel des applications Flex. Un fichier de thème SWC contient un fichier CSS ainsi que toutes les ressources graphiques associées. Pour plus d’informations sur la création et l’utilisation des thèmes, voir About themes. Les bibliothèques sont utiles si vous créez des composants intégralement dans ActionScript et que vous les utilisez en mode Création dans Flash Builder. Les composants ActionScript ne sont pas rendus visuellement en mode Création tant qu’ils ne sont pas compilés dans un fichier SWF. En ajoutant des composants ActionScript dans un projet de bibliothèque, vous créez un fichier SWF qui est contenu dans un fichier SWC. Vous pouvez ajouter la bibliothèque à un chemin d’accès à la bibliothèque d’un projet et les composants ActionScript sont rendus visuellement en mode Création lorsque vous les ajoutez à l’application.
Vous pouvez utiliser les bibliothèques SWC dans vos projets des façons suivantes. Fusionnées dans l’application Lorsque vous ajoutez un fichier SWC au chemin d’accès à la bibliothèque du projet, les composants contenus dans la bibliothèque sont disponibles pour être utilisés dans l’application. Lorsque vous générez l’application, seuls les composants de bibliothèque que vous avez utilisés dans les faits sont compilés dans le fichier SWF de l’application. En d’autres termes, tout le code de votre application est fusionné dans un seul fichier SWF. C’est la façon la plus courante et la plus simple d’utiliser les composants de bibliothèques. Externes à l’application Vous pouvez conserver les composants de bibliothèque séparément du fichier SWF compilé pour qu’ils ne soient pas fusionnés dans le fichier. Le compilateur résout tout le code contenu dans la bibliothèque utilisé par l’application, mais ne le fusionne pas dans le fichier SWF de l’application. L’avantage de cette méthode est de réduire la taille du fichier SWF de l’application. Les composants contenus dans le fichier SWC sont extraits et chargés dans la mémoire selon les besoins, au moment de l’exécution. Bibliothèque partagée à l’exécution Dans les projets Flex uniquement, vous pouvez également utiliser des fichiers
Le partage de composants entre applications à l’aide de ce type de bibliothèque présente plusieurs avantages. Dans un premier temps, la bibliothèque est chargée en mémoire une fois, placée dans le cache, puis mise à disposition de toutes les applications faisant appel à ces composants. Dans un second temps, les composants se trouvant dans la bibliothèque sont chargés uniquement selon les besoins, ce qui réduit le temps de démarrage de l’application, car la taille de l’application est moindre. Le problème potentiel de cette méthode est que la bibliothèque partagée à l’exécution est
Utilisation des projets
Lorsque vous créez un projet de bibliothèque, l’assistant Nouveau projet de bibliothèque Flex vous guide à travers les différentes étapes et vous demande d’indiquer le nom du projet, son emplacement, ainsi que le chemin de génération. Une fois le projet de bibliothèque créé, vous ajoutez des composants, spécifiez les éléments du projet de bibliothèque à inclure dans le fichier SWC, puis générez le projet afin de créer le fichier SWC. La première étape de la création d’un fichier SWC dans Flash Builder est la création d’une projet de bibliothèque Flex. 1 Sélectionnez Fichier > Nouveau > Projet de bibliothèque Flex. 2 Saisissez un nom de projet, puis précisez les éléments suivants. Emplacement du projet L’emplacement par défaut est l’espace de travail actuel. Sous Windows, l’emplacement de l’espace de travail par défaut est C:\Documents and Settings\Développeur FlexAdobe Flash Builder\. Sous Macintosh, l’emplacement de l’espace de travail par défaut est /Users/Développeur FlexAdobe Flash Builder/. Pour choisir un emplacement de projet différent, désactivez l’option Utiliser l’emplacement par défaut. Version SDK Flex Choisissez la version par défaut ou spécifiez-en une. Vous pouvez aussi cliquer sur le lien
Inclure les bibliothèques Adobe AIR Sélectionnez cette option si votre bibliothèque doit utiliser des fonctions AIR, telles que l’accès aux API AIR. Flash Builder change alors le chemin d’accès à la bibliothèque de ce nouveau projet de bibliothèque Flex de manière qu’il contienne les fichiers airglobal.swc et airframework.swc. Les projets Web Flex ne peuvent pas utiliser cette bibliothèque.
3 Cliquez sur Suivant. 4 (Facultatif) Définissez les informations concernant le chemin de génération. Vous pouvez, par exemple, ajouter des
également ajouter d’autres projets, dossiers ou fichiers SWC de bibliothèque à inclure dans votre projet de bibliothèque. Voir « Utilisation des fichiers SWC dans le cadre des projets » à la page 71. 5 Une fois les paramètres du projet saisis, cliquez sur Terminer.
Il existe plusieurs façons d’ajouter des composants à un projet de bibliothèque :
à des ressources situées en dehors de l’espace de travail du projet » à la page 64).
« Ajout de dossiers de ressources au chemin source du projet » à la page 65). Remarque : tous les composants que vous incluez dans le projet de bibliothèque doivent être associés au projet de bibliothèque (directement ou en tant que ressources liées).
Utilisation des projets
1 Sélectionnez Projet > Propriétés > Chemin de génération de bibliothèque Flex.
2 Sélectionnez les classes de composants à inclure dans le fichier SWC. 3 (Facultatif) Sous l’onglet Ressources, sélectionnez les ressources à inclure dans le fichier SWC. 4 Une fois que vous avez effectué vos sélections, cliquez sur OK.
Une fois que vous avez sélectionné les éléments à inclure dans le fichier SWC et si vous avez sélectionné l’option de génération automatique, le fichier SWC est compilé immédiatement et généré dans le dossier de sortie du projet. Si vous générez vos projets manuellement, vous pouvez créer le projet de bibliothèque quand vous le souhaitez en sélectionnant Projet > Générer le projet ou Générer tout. La création du projet de bibliothèque génère un fichier SWC que vous pouvez partager avec d’autres applications ou utilisateurs. Un fichier SWC est un fichier archive. Vous pouvez l’ouvrir grâce à n’importe quel utilitaire d’archivage, tel que WinZip. Les fichiers library.swf et catalog.xml sont contenus dans le fichier SWC, ainsi que les fichiers de propriétés et autre ressources incorporées. Vous pouvez exporter la bibliothèque sous la forme d’un répertoire ouvert plutôt qu’en tant que fichier SWC. Vous exportez généralement une bibliothèque en tant que répertoire ouvert si vous prévoyez de faire appel au fichier library.swf dans le fichier SWC en tant que bibliothèque RSL. Pour ce faire, vous devez définir les options directory et output du compilateur. Définissez l’option output comme le nom du répertoire à créer et l’option directory sur true pour indiquer que vous voulez ouvrir le répertoire et non un fichier SWC lorsque vous générez la bibliothèque. Pour modifier les options du compilateur, sélectionnez Projet > Propriétés > Compilateur de bibliothèque Flex et ajoutez les options au champ Arguments de compilateur supplémentaires, par exemple : -directory=true -output=myOpenDir
Pour pouvoir utiliser des fichiers SWC dans vos projets Flex, vous devez les ajouter au chemin d’accès à la bibliothèque du projet. Les fichiers SWC peuvent se trouver dans le projet, dans un projet de bibliothèque Flex, dans un dossier partagé dans l’espace de travail ou dans tout autre emplacement lié au projet (en utilisant un dossier partagé qui a été ajouté au chemin source du projet, par exemple). Lorsque vous utilisez des fichiers SWC dans des applications, certaines options de configuration déterminent s’ils sont liés de manière statique ou dynamique à l’application, s’ils sont fusionnés dans le fichier SWF de l’application ou s’ils sont externes et si leur accès se fait séparément au moment de l’exécution. Ajout d’un fichier SWC au chemin d’accès à la bibliothèque 1 Sélectionnez un projet dans l’Explorateur de packages, puis cliquez sur Projet > Propriétés > Chemin de génération Flex.
Ajouter un projet Ajoute un projet de bibliothèque Flex. Ajouter un dossier SWC Permet d’ajouter un dossier contenant des fichiers SWC. Ajouter un fichier SWC Ajoute un fichier SWC compilé. Ajouter un SDK Flex Permet d’ajouter d’autres SDK Flex. Ce bouton est désactivé si le chemin d’accès à la
4 Saisissez ou recherchez l’emplacement du ficher SWC, du projet ou du dossier, puis sélectionnez-le. Cliquez sur OK.
Fusion du fichier SWC dans le fichier SWF de l’application au moment de la compilation 1 Sélectionnez un projet dans l’Explorateur de packages, puis cliquez sur Projet > Propriétés > Chemin de génération Flex. 2 Sous l’onglet Chemin d’accès à la bibliothèque, sélectionnez et développez l’entrée du fichier SWC pour en afficher
3 Double-cliquez sur l’option Type de lien. La boîte de dialogue Options de l’élément de chemin d’accès à la
4 Sélectionnez l’option Fusionné dans le code, puis cliquez sur OK.
Définition du fichier SWC en tant que fichier de bibliothèque externe 1 Sélectionnez un projet dans l’Explorateur de packages, puis cliquez sur Projet > Propriétés > Chemin de génération Flex. 2 Sous l’onglet Chemin d’accès à la bibliothèque, sélectionnez et développez l’entrée du fichier SWC pour en afficher
3 Double-cliquez sur l’option Type de lien. La boîte de dialogue Options de l’élément de chemin d’accès à la
4 Sélectionnez l’option Externe, puis cliquez sur OK.
Flex. 2 Sous l’onglet Chemin d’accès à la bibliothèque, sélectionnez et développez l’entrée du fichier SWC pour en afficher
3 Double-cliquez sur l’option Type de lien. La boîte de dialogue Options de l’élément de chemin d’accès à la
4 Sélectionnez l’option Bibliothèque RSL (Runtime Shared Library). 5 Entrez l’URL où la bibliothèque SWC doit résider lors du déploiement de l’application. sélectionnez l’option Extraire automatiquement le fichier SWF dans le chemin de déploiement. 7 Cliquez sur OK.
Pour plus d’informations sur l’utilisation des fichiers SWC en tant que bibliothèque RSL, voir Using Runtime Shared Libraries dans Utilisation d’Adobe Flex 4.
Adobe® Flash® Builder™ génère et exporte automatiquement les projets vers des applications. Cette opération comporte la création de fichiers d’application et de bibliothèque, le placement des fichiers de sortie dans les emplacements appropriés et la signalisation de toute erreur survenue en cours de compilation. Différentes options permettent d’ajuster les paramètres de génération. Vous pouvez ainsi déterminer la manière dont les projets sont intégrés aux applications. Vous pouvez par exemple définir des préférences pour la génération de projets individuels ou pour l’ensemble des projets de l’espace de travail, modifier le chemin de sortie ou l’ordre de génération et ainsi de suite. Vous pouvez en outre créer des instructions de génération personnalisées à l’aide d’outils tiers tels qu’Apache Ant. Lorsque les applications sont prêtes à être publiées, vous pouvez en publier l’ensemble du code source ou uniquement certaines parties. A l’instar du code source HTML, le code source de l’application peut être visualisé dans un navigateur Web.
Un déroulement de travail se compose de la génération de projets Flex et ActionScript, l’option Générer automatiquement étant activée. Au cours du développement, Flash Builder affiche les erreurs et les avertissements dans la vue Erreurs. A l’exécution de l’application, une version de débogage du fichier SWF est placée dans le dossier de sortie (bin) du projet avec les ressources requises et une enveloppe HTML. Cette génération contient des informations de débogage et n’est destinée qu’à l’usage des développeurs. Pour plus d’informations sur l’exportation de projets, voir « Exportation et importation de projets » à la page 53. Une fois l’application prête à être déployée, l’assistant Exporter vers une version validée vous permet de créer une version optimisée de qualité finale de l’application. Cette opération enregistre le fichier SWF dans le dossier binrelease. Les informations de débogage étant supprimées, la taille du fichier diminue. S’agissant d’une version de production, elle peut être visionnée par les utilisateurs finaux. Pour les projets Adobe AIR, les applications AIR sont exportées dans un fichier AIR. La fonction Exporter vers une version validée permet de créer un fichier AIR signé numériquement que les utilisateurs doivent installer avant d’exécuter une application (à l’instar d’un fichier install.exe). Les projets Adobe LiveCycle Data Services ES peuvent en revanche être compilés sur le serveur en y accédant. Pour plus d’informations, voir « Gestion des projets » à la page 49. Aucune exportation n’est requise pour les projets de bibliothèque. Le fichier SWC créé par un projet de bibliothèque Flex se prête à la fois au développement et à la production. Pour plus d’informations, voir « Projets de bibliothèque » à la page 69.
Utilisation des projets
MXML et ActionScript 3.0 sont des langages compilés. Contrairement aux langages interprétés (JavaScript, par exemple) immédiatement exécutables par leurs environnements d’exécution, MXML et ActionScript 3.0 doivent être convertis dans un format compilé avant de pouvoir être exécutés dans Flash Player. Ce processus, ainsi que la création des fichiers de sortie correspondants, est désigné par le terme de génération. Flash Builder génère automatiquement un projet à chaque modification ou enregistrement de l’un de ses fichiers. La possibilité de générer des applications manuellement ne signifie pas qu’il est nécessaire d’y recourir. Toutefois, la compréhension du processus de génération et des fichiers de sortie créés facilitera le diagnostic et la résolution des éventuels problèmes de configuration du projet. Projets Flex Les fichiers source et les ressources intégrées (les images, par exemple) sont compilés dans un seul et unique format de sortie désigné par SWF. Les fichiers ayant ce format peuvent être exécutés directement dans l’application Flash Player autonome ou dans un navigateur Web par le biais d’un fichier d’enveloppe HTML, également créé par la génération. Ces fichiers sont créés dans le dossier de sortie du projet (ce dossier, nommé par défaut « bin », peut être renommé). Projets LiveCycle Data Services ES LiveCycle Data Services ES offre la possibilité de créer des projets qui seront
Remarque : les projets LiveCycle Data Services ES peuvent être définis de manière telle à être compilés sur le serveur. Flash Builder les compile néanmoins au fur et à mesure du développement de vos applications, afin de permettre au compilateur de valider la syntaxe du code et d’afficher les messages d’erreur. Ces projets ne disposent pas d’option de dossier de sortie et Flash Builder ne génère aucun fichier de sortie. Projets ActionScript 3.0 A l’instar des projets Flex, les projets ActionScript 3.0 compilent les fichiers source et les ressources intégrées dans un fichier SWF. Projets de bibliothèque Flex Pour les projets de bibliothèque, les fichiers source sont des composants et des ressources
En configuration autonome, Flash Builder génère vos applications automatiquement. En configuration plug-in, vous devez sélectionner l’option Générer automatiquement. Malgré la possibilité, décrite ci-dessus, de générer des applications manuellement, il ne devrait pas être nécessaire d’y recourir. La désactivation de la génération automatique empêche en outre le compilateur de détecter les erreurs de syntaxe et d’afficher les avertissements et les messages d’erreur au fur et à mesure de la saisie du code. La vue Erreurs ne vous fournira donc aucune information jusqu’à l’achèvement de la compilation du projet. Il est donc conseillé d’activer le mode de génération automatique de Flash Builder. Les options avancées permettent de définir la durée et l’étendue des générations. Vous pouvez par exemple générer un seul projet ou un ensemble de projets dans l’espace de travail ou encore définir un jeu de documents (une collection) de projets à générer. Toutes les commandes de génération se situent dans le menu Projet, ainsi que l’illustre l’exemple suivant. Pour plus d’informations, voir « Options de génération avancées » à la page 81.
En présence de dépendances entre des projets distincts de l’espace de travail, le compilateur détermine automatiquement l’ordre dans lequel les projets ont été générés afin de résoudre correctement les dépendances. Vous pouvez toutefois remplacer l’ordre de génération par défaut en définissant manuellement l’ordre dans lequel les projets de l’espace de travail sont générés. Pour plus d’informations, voir « Génération manuelle de projets » à la page 81. Vous pouvez en outre modifier le chemin d’accès à la génération, la liste des applications et les paramètres du compilateur pour chaque projet de l’espace de travail. Pour plus d’informations, voir « Génération manuelle de projets » à la page 81, « Gestion des fichiers d’application du projet » à la page 52 et « Options de génération avancées » à la page 81.
Les erreurs détectées par le compilateur au cours de la génération s’affichent dans la vue Erreurs des perspectives Développement et Débogage, ainsi que dans l’éditeur de code, dans lequel les lignes contenant des erreurs sont signalées par un x, comme l’illustre l’exemple suivant.
Utilisation des projets
Des erreurs générées par l’environnement Eclipse sont susceptibles de se produire. Elles surviennent généralement lorsque des ressources (des fichiers SWC, par exemple) ne sont pas trouvées à l’exécution. Dans ce cas, les messages d’erreur apparaissent dans le fichier journal des erreurs Eclipse. L’emplacement par défaut de ce fichier journal sous Windows est le suivant : \Documents and Settings\nom_utilisateur\workspace\.metadata\.log. Sous Mac, l’emplacement par défaut se trouve également dans le répertoire de l’espace de travail. Les fichiers et dossiers commençant par un point y sont toutefois masqués par défaut.
Vous pouvez modifier et étendre le processus de génération standard en faisant appel à Apache Ant, outil de génération Java à code source libre. Pour plus d’informations sur la création de générateurs personnalisés, voir « Personnalisation des générations avec Apache Ant » à la page 83.
Vous pouvez modifier les paramètres par défaut du compilateur Flex utilisé par Flash Builder. Pour afficher les paramètres par défaut et en modifier les valeurs, ouvrez la page des propriétés du compilateur Flex. Dans le menu Flash Builder, sélectionnez Projet > Propriétés > Compilateur Flex.
Le SDK par défaut pour Flash Builder 4 est Flex 4.0. Cependant, si votre projet utilise une version spécifique, telle que Flex 3.4, Flash Builder compile les applications du projet à l’aide du SDK Flex spécifié. Vous pouvez définir comme paramètre par défaut un SDK Flex spécifique ou vous pouvez définir que la compilation soit effectuée en utilisant la compatibilité avec Flex 3. La spécification de la compatibilité ascendante affecte certains comportements, tels que les règles de présentation, les marges intérieures et les espaces, les habillages ainsi que d’autres paramètres de style. Elle a également une incidence sur les règles d’analyse des fichiers de propriétés. La définition de la version de compatibilité n’applique pas toutes les différences existant entre les versions. Pour plus d’informations, voir Backward compatibility.
La version par défaut de Flash Player utilisée par le compilateur est la version minimale requise par le SDK Flex utilisé pour la compilation. Vous pouvez définir une version spécifique de Flash Player pour l’application. Les fonctionnalités nécessitant une version ultérieure de Flash Player ne seront pas compilées dans l’application.
Flash Builder fournit des cases à cocher pour les options suivantes du compilateur :
Certains contrôles MX fournissent une prise en charge de FTE. Les contrôles MX prenant en charge FTE utilisent les mêmes polices intégrées que les composants Spark utilisant FTE. Voir Using FTE in MX controls.
• Générer un fichier SWF accessible
Utilisation des projets
Lorsque la vérification stricte est activée, le compilateur imprime des appels de propriété et de fonction non définis. Il effectue également une vérification de type au moment de la compilation pour les affectations et les options fournies aux appels de méthode.
Cette option active des avertissements spécifiques. Pour plus d’informations, voir Viewing warnings and errors. Vous pouvez également spécifier des arguments de compilateur disponibles avec la ligne de commande mxmlc compiler. Vous pouvez définir les valeurs de la plupart des options du champ Arguments de compilateur supplémentaires en utilisant la syntaxe de la ligne de commande. Pour plus d’informations sur la syntaxe pour la définition des options dans la boîte de dialogue Compilateur Flex, voir About the command-line compilers. Dans le champ Arguments de compilateur supplémentaires, vous pouvez remplacer un chemin vers le répertoire du SDK par le jeton ${flexlib}, comme l’illustre l’exemple suivant : -include-libraries "${flexlib}/libs/automation.swc" "${flexlib}/libs/automation_agent.swc"
Lorsque cette option est activée, l’application compilée vérifie que la version de Flash Player est correcte. Si l’option d’utilisation de l’installation rapide est activée, l’application exécute un fichier SWF dans le lecteur Flash Player existant pour mettre à niveau les utilisateurs vers la dernière version du lecteur.
Cette option active la liaison profonde. La liaison profonde permet aux utilisateurs de parcourir leurs interactions avec l’application en utilisant les boutons Précédent et Suivant de leur navigateur.
Vous pouvez accéder directement par ligne de commande aux compilateurs de structure Flex (mxmlc et compc). Lorsque vous installez Flash Builder, l’invite de structure Flex se trouve dans le menu de démarrage Windows (Programmes > Adobe). Pour plus d’informations, voir About the command-line compilers dans Utilisation d’Adobe Flex 4.
Flash Builder vous permet de générer des applications automatiquement en utilisant les paramètres de projet par défaut. Cette méthode est recommandée pour la génération d’applications. Vous pouvez toutefois personnaliser la génération de projets en fonction de vos besoins. Vous avez ainsi la possibilité par exemple de sélectionner un autre dossier de sortie par défaut ou de modifier les options du compilateur.
Utilisation des projets
Par défaut, les projets Flex mettent à la disposition des applications l’ensemble des composants, c’est-à-dire les composants Spark fournis avec Flex 4 et les composants MX livrés avec Flex 3. Il est possible toutefois que dans certains cas, vous ne souhaitiez faire appel qu’aux composants MX fournis avec Flex 3. Vous pouvez par exemple disposez d’un projet Flex 3 dans lequel vous ne voulez pas introduire les nouveaux composants Spark mais pour lequel vous souhaitez toutefois bénéficier des avantages des fonctionnalités introduites avec Flex 4 et Flash Builder 4 (nouvelle syntaxe d’états, fonctions de compilation améliorées et autres fonctionnalités de langage). Dans ce cas, activez l’option MX uniquement pour le jeu de composants. L’activation de cette option supprime du chemin de génération toutes les bibliothèques associées à Spark. Lors de la conversion d’un projet Flex 4 en projet MX uniquement, Flash Builder n’apporte aucune modification au code du projet. Vous devrez mettre à jour le code manuellement afin d’en supprimer toute référence aux composants et aux bibliothèques Spark.
Par défaut, les classes d’application de la structure Flex 4 utilisent la liaison dynamique. Au lieu de compiler toutes les classes dans le fichier SWF de l’application (liaison statique), certaines classes sont chargées à partir de la bibliothèque partagée à l’exécution (Runtime Shared Library, RSL). Les applications créées avec une liaison dynamique sont dotées de fichiers SWF plus petits, ce qui permet de les télécharger plus rapidement. En revanche, ces applications utilisent plus de mémoire, toutes les classes de la structure étant chargées, y compris celles dont vous n’avez pas besoin. Pour plus d’informations, voir Bibliothèque partagée à l’exécution. Vous pouvez modifier les propriétés d’un projet afin de personnaliser ce comportement pour toutes les applications d’un projet. Après avoir sélectionné un projet, dans le menu de Flash Builder, choisissez Projet > Propriétés > Chemin de génération Flex > Chemin d’accès à la bibliothèque. Par défaut, Flash Builder utilise le comportement par défaut du SDK pour la liaison des structures. Pour Flex 4, il s’agit de la liaison dynamique des bibliothèques partagées à l’exécution (RSL) ; pour Flex 3, de la liaison statique. Utilisez le menu déroulant Liaison de structure pour remplacer le comportement par défaut. Pour le SDK Flex 4, les options suivantes sont activées par défaut :
Utilise les bibliothèques RSL locales lors du débogage de l’application. L’utilisation des bibliothèques RSL locales vous permet d’intervenir dans les fichiers RSL de débogage. Cette option est ignorée lors de l’exportation d’une version validée.
Si cette option est activée, Flash Builder détermine l’ordre des bibliothèques en fonction des dépendances au sein des bibliothèques. Pour personnaliser l’ordre des bibliothèques, désactivez cette option et indiquez l’ordre voulu à l’aide des boutons Haut et Bas.
Utilisation des projets
En configuration autonome, Flash Builder génère vos projets automatiquement. En configuration plug-in, vous devrez activer cette option. Flash Builder est conçu pour générer les projets automatiquement. La désactivation de cette option empêche le compilateur de détecter les erreurs de syntaxe et d’afficher les avertissements et les messages d’erreur au fur et à mesure de la saisie du code. Pour plus d’informations sur la génération manuelle de projets, voir « Génération manuelle de projets » à la page 81. Effectuez l’une des opérations suivantes :
• Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Espace de travail. Sélectionnez ou désélectionnez l’option Générer automatiquement. Cette option a une incidence sur tous les projets de l’espace de travail.
Lorsque vous créez un projet dans Flash Builder, le résultat de la création est généré par défaut dans le dossier de sortie. Les projets LiveCycle Data Services ES faisant appel à l’option de compilation sur le serveur dérogent à cette règle. A son exécution, l’application est en effet compilée sur le serveur. Vous pouvez modifier le nom de ce dossier à la création du projet ou une fois le projet créé. Vous avez en outre la possibilité de créer un dossier ou de sélectionner un dossier existant de l’espace de travail. 1 Dans l’Explorateur de packages, sélectionnez un projet. 2 Cliquez avec le bouton droit de la souris (Windows) ou en maintenant la touche Ctrl enfoncée (Macintosh), puis
La boîte de dialogue des propriétés du projet apparaît. 3 Sélectionnez la page Chemin de génération Flex. 4 Modifiez le dossier de sortie spécifié en saisissant un nouveau nom ou en recherchant et sélectionnant le dossier
Remarque : le dossier de sortie d’une application LiveCycle Data Services ES ne peut pas être modifié de cette manière. Son emplacement est en effet contrôlé par le serveur Flex et est accessible uniquement par le biais du fichier Flexconfig.xml du projet. 5 Cliquez sur OK.
Important : la modification du nom du dossier de sortie entraîne la suppression du dossier de sortie d’origine ainsi que de l’ensemble de son contenu. Vous devrez regénérer le projet afin de recréer les fichiers d’application SWF et d’enveloppe HTML.
Chaque projet possède son propre chemin de génération composé du chemin source et du chemin de bibliothèque (les chemins de génération de projet de bibliothèque sont légèrement plus complexes. Pour plus d’informations, voir « Projets de bibliothèque » à la page 69). Le chemin source correspond à l’emplacement des fichiers source MXML et ActionScript du projet. Le chemin de bibliothèque correspond à l’emplacement des classes de la structure Flex de base ainsi que des composants Flex personnalisés que vous avez créés (sous la forme de fichiers SWC). Modification du chemin source 1 Sélectionnez un projet dans l’Explorateur de packages.
Utilisation des projets
3 Sélectionnez la page Chemin de génération Flex (dans le cadre d’un projet ActionScript, sélectionnez la page
4 Cliquez sur le bouton Ajouter un dossier pour ajouter un dossier au chemin source. 5 Saisissez le nom du dossier ou cliquez sur le bouton Parcourir pour rechercher l’emplacement des classes
Vous pouvez également utiliser des variables de chemin afin d’éviter de saisir le chemin complet du système de fichiers. Vous pouvez saisir le nom d’une variable existante ou en créer une. Pour plus d’informations, voir « Création d’une variable de chemin » à la page 80. 6 Apportez les modifications nécessaires au chemin source, puis cliquez sur OK.
1 Répétez les étapes 1 à 3 de la procédure précédente afin d’accéder à la page des propriétés Chemin de génération Flex. 2 Cliquez sur l’onglet Chemin d’accès à la bibliothèque.
SWC. Un fichier SWC est un fichier d’archivage pour les composants Flex et d’autres ressources (pour plus d’informations, voir « Utilisation des fichiers SWC dans le cadre des projets » à la page 71). Vous pouvez modifier le chemin vers la structure ou, si vous avez créé des composants Flex personnalisés, ajouter de nouveaux dossiers ou fichiers SWC au chemin de la bibliothèque. Vous avez également la possibilité de supprimer des éléments du chemin. 3 Apportez les modifications nécessaires au chemin de la bibliothèque, puis cliquez sur OK.
Vous pouvez établir des liens vers des ressources en définissant des variables de chemin. Vous évitez ainsi de devoir saisir le chemin complet d’un dossier local ou d’un dossier réseau dans lequel vous enregistrez les fichiers. Définissez par exemple une variable de chemin nommée Classes, puis spécifiez le chemin vers un dossier du système de fichiers. La variable Classes peut ensuite être sélectionnée comme étant l’emplacement du nouveau dossier auquel la relation a été établie. Si le dossier est déplacé, il vous suffit de mettre à jour l’emplacement dans la variable de chemin définie pour que tous les projets reliés à la variable Classes puissent continuer à accéder aux ressources. Définition ou création d’une variable de chemin 1 Sélectionnez un projet dans l’Explorateur de packages Flex. 2 Cliquez avec le bouton droit de la souris (Windows) ou en maintenant la touche Ctrl enfoncée (Macintosh), puis
3 Sélectionnez la page Chemin de génération Flex (dans le cadre d’un projet ActionScript, sélectionnez la page
4 Vous pouvez créer une variable pour chaque élément du chemin (dont les dossiers du chemin source et les dossiers
5 Saisissez une variable de chemin conformément au format suivant : ${nom_de_la_variable_de_chemin}.
Utilisation des projets
6 Cliquez sur OK pour ajouter la variable au chemin.
Flash Builder offre des options avancées pour la personnalisation des générations de projet. Vous pouvez par exemple générer des projets manuellement, modifier l’ordre par défaut de génération des projets dans l’espace de travail et créer des générateurs personnalisés avec l’utilitaire Apache Ant.
La génération manuelle de projets vous permet de contrôler la durée et l’étendue de la génération. Vous pouvez par exemple générer un seul projet ou un ensemble de projets dans l’espace de travail. Vous pouvez également définir un jeu de documents de projets ou de ressources de projet et ne générer que ces projets et ces ressources. Un jeu de documents est une collection de ressources d’espace de travail (projets, fichiers et dossiers) pouvant être sélectionnées et groupées en fonction de l’utilisation qui en est faite. Pour plus d’informations sur les jeux de documents, voir « Création de jeux de documents » à la page 27. Les options de génération se situent dans le menu Projet, ainsi que l’illustre l’exemple suivant.
1 Dans l’Explorateur de packages, sélectionnez le projet que vous souhaitez générer. 2 Sélectionnez Projet > Générer le projet dans le menu principal.
Remarque : le programme vous invite à enregistrer les fichiers de projet qui ne l’ont pas encore été avant le début de la génération. Pour éviter l’affichage de cette invite, activez l’enregistrement automatique des fichiers avant le début de la génération dans les préférences de l’espace de travail. Génération de tous les projets dans l’espace de travail ❖ Sélectionnez Projet > Générer tout dans le menu principal. Tous les projets de l’espace de travail sont générés. Les fichiers d’application sont ajoutés aux dossiers de sortie des projets respectifs. Dans la mesure où vous n’avez pas défini l’enregistrement automatique des fichiers avant le début de la génération, le programme vous invite à les enregistrer.
Utilisation des projets
Utilisez l’une des méthodes suivantes :
Cliquez sur Nouveau pour créer un jeu de documents. Pour plus d’informations sur la création d’un jeu de documents, voir « Création de jeux de documents » à la page 27.
Tous les projets du jeu de documents sont générés. Les fichiers d’application sont ajoutés au dossier de sortie du projet.
Lorsque vous générez des projets manuellement, le programme vous invite à enregistrer toutes les ressources avant de débuter la génération. Pour éviter l’affichage de cette invite, activez l’enregistrement automatique des ressources du projet dans les préférences de l’espace de travail. 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Espace de travail. 2 Sélectionnez l’option Sauvegarder automatiquement avant la génération. 3 (Facultatif) Vous pouvez modifier la fréquence d’enregistrement des ressources en saisissant une valeur (en
Une fois un projet créé, les générations ultérieures n’impliqueront que les ressources ajoutées ou modifiées. Une génération nettoyée permet de forcer le compilateur Flash Builder à regénérer toutes les ressources d’un projet. Vous pouvez y recourir par exemple pour éliminer toutes les sources potentielles d’un problème survenu au cours du test de l’application. 1 Sélectionnez Projet > Nettoyer dans le menu principal. 2 Choisissez le ou les projets dont vous souhaitez éliminer les fichiers de génération pour les regénérer. 3 Cliquez sur OK.
Flash Builder permet de créer des relations entre les projets ouverts dans l’espace de travail. Vous pouvez par exemple importer les classes ActionScript d’un projet à l’autre. La création de relations entre les projets a une incidence sur l’ordre dans lequel les projets sont générés. Par défaut, le compilateur génère des projets reliés dans l’ordre garantissant la génération correcte de tous les projets. Prenons l’exemple de deux projets, dont le premier fait référence à des classes contenues dans le second : le second projet est généré en premier. Dans la plupart des cas, le compilateur génère les projets dans l’ordre requis et les applications sont créées correctement sans qu’aucune intervention ne soit nécessaire. Vous avez cependant la possibilité de modifier l’ordre de génération. Cette modification peut s’avérer nécessaire par exemple si vous avez créé un générateur personnalisé Ant et que vous l’avez associé à un projet de l’espace de travail que vous devez générer avant les autres projets. Pour plus d’informations sur la création de générateurs personnalisés, voir « Personnalisation des générations avec Apache Ant » à la page 83. 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Espace de travail > Ordre de génération.
Utiliser l’ordre de génération par défaut L’ordre de génération par défaut dépend des dépendances entre les
Utilisation des projets
Itérations maximales lors de la génération avec des cycles En présence de références cycliques dans un projet (ce
2 Modifiez si nécessaire l’ordre de génération, puis cliquez sur OK.
La création d’un générateur personnalisé vous permet de modifier et d’étendre le processus de génération standard. Flash Builder comporte un script de génération standard intervenant dans la compilation des applications. Vous pouvez, le cas échéant, créer des scripts de génération personnalisés grâce à Apache Ant, outil de génération Java à code source libre. Le développement de scripts de génération Ant dépasse le cadre de ce guide. Cette rubrique illustre toutefois comment créer un générateur personnalisé et l’appliquer à vos projets. Vous pouvez appliquer les générateurs personnalisés à tous les types de projet Flash Builder. Création d’un générateur 1 Dans l’Explorateur de packages, sélectionnez un projet. Cliquez avec le bouton droit de la souris (Windows) ou en maintenant la touche Ctrl enfoncée (Macintosh) pour afficher le menu contextuel et sélectionnez Propriétés. 2 Sélectionnez la page de propriétés Générateurs. La liste sera plus ou moins longue en fonction du nombre de plug-
3 Sélectionnez Nouveau. 4 Dans la boîte de dialogue Sélection d’un type de configuration, choisissez le type de configuration approprié. Flash
5 Cliquez sur OK pour appliquer les valeurs définies au projet.
Flash Builder permet de modifier la version du SDK utilisé pour la compilation des projets. Vous pouvez sélectionner le SDK à la création ou en cours de développement du projet. Le SDK se compose d’une structure et du compilateur. Le SDK Flex 2.0.1 signifie que vous utilisez la version 2.0.1 des fichiers SWC de la structure Flex et la version 2.0.1 du compilateur Flex. Vous ne pouvez pas utiliser le compilateur Flex 3 avec les fichiers SWC de la structure Flex 2.0.1, par exemple. La possibilité de modifier le SDK est utile en présence d’un projet développé avec Flex Builder 2.0.1 (qui utilise le SDK Flex 2.0.1) alors que vous exécutez la version 4 de Flash Builder (qui utilise par défaut le SDK Flex 4). En sélectionnant un SDK antérieur pour la génération, vous pouvez préserver la compatibilité avec la dernière version du SDK des projets qui n’ont pas été mis à jour. En outre, si vous travaillez sur un projet utilisant le SDK Flex 2.0.1 mais vous souhaitez faire appel à des fonctions de Flash Builder 4 (restructuration du code, par exemple), vous pouvez mettre à niveau Flash Builder, puis sélectionner un SDK antérieur comme SDK par défaut.
Utilisation des projets
AdvancedDataGrid (introduit dans le SDK Flex 3), puis modifiez le SDK du projet en sélectionnant la version 2.0.1, Flash Builder signale que la classe AdvancedDataGrid est inconnue. Flash Builder regénère également tous les fichiers de prise en charge des projets, dont les fichiers de gestion de l’historique et de liaisons profondes utilisés par l’enveloppe HTML. Pour les projets SDK Flex 2.0.1, Flash Builder crée les fichiers compatibles de gestion des historiques history.swf, history.html et history.js dans le répertoire des modèles HTML. Pour les projets SDK Flex 3, Flash Builder crée les fichiers compatibles de liaisons profondes history.htm et history.js et historyFrame.html dans le répertoire html-templates/history. Les options présentes dans Flash Builder varient en outre en fonction du SDK sélectionné. Si vous ajoutez par exemple un module à un projet utilisant le SDK Flex 2.0.1, Flash Builder ne vous propose pas d’optimiser le module. Cette opération devra être effectuée manuellement. Pour plus d’informations sur les différences entre les SDK Flex 3 et Flex 2.0.1, voir Backward compatibility dans Utilisation d’Adobe Flex 4. Flash Builder utilise le SDK par défaut pour les nouveaux projets créés. Le SDK par défaut est la dernière version fournie avec Flash Builder. Vous pouvez toutefois sélectionner tout SDK répertorié dans la liste des SDK disponibles dans Flash Builder. Lorsque vous créez un projet de bibliothèque Flex ou un projet ActionScript, vous pouvez sélectionner le SDK à utiliser dans les boîtes de dialogue Nouveau projet de bibliothèque Flex et Nouveau projet ActionScript. Ajout d’un nouveau SDK Flex à la liste des SDK disponibles 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Flash Builder > SDK Flex installés. Elle répertorie les SDK installés. Le nom du SDK par défaut est coché. 2 Cliquez sur Ajouter. 3 Saisissez l’emplacement du SDK dans le champ Emplacement du SDK Flex. 4 Attribuez-lui un nom dans le champ Nom du SDK Flex. Ne saisissez pas le nom d’un SDK existant. 5 Cliquez sur OK pour enregistrer vos modifications. 6 Cliquez de nouveau sur OK pour ajouter le nouveau SDK à la liste des SDK disponibles. Cette liste est gérée dans
Modification de la version de SDK du projet en cours 1 Sélectionnez Projets > Propriétés. 2 Choisissez Compilateur Flex. 3 Cliquez sur Utiliser un SDK spécifique. 4 Sélectionnez un SDK dans la liste déroulante. Si elle ne contient pas le SDK recherché, cliquez sur le lien Configurer
Utilisation des projets
1 Ouvrez la boîte de dialogue Préférences et sélectionnez Flash Builder > SDK Flex installés. Le nom du SDK par défaut est coché. 2 Cochez la case correspondant à un autre SDK pour le définir comme SDK par défaut. Ce SDK sera appliqué à tout
3 Cliquez sur OK pour enregistrer vos modifications. 4 Cliquez à nouveau sur le bouton OK.
Une fois qu’une application est prête à être publiée, Flash Builder vous permet de définir si les utilisateurs peuvent visionner le code source ainsi que les ressources de l’application. A l’instar du langage HTML, les utilisateurs peuvent accéder à la source et la visionner dans un navigateur Web en sélectionnant Afficher la source dans le menu contextuel. Le visualiseur de source met en forme et colore le code afin d’en faciliter la lecture. Il constitue également un moyen pratique de partager le code avec d’autres développeurs Flex et ActionScript 3.0. Activation de l’option d’affichage de la source 1 Ouvrez l’ensemble du projet d’application dans l’éditeur, puis sélectionnez Projet > Exporter vers une version validée. 2 Sélectionnez Activer l’affichage de la source ou, pour les projets ActionScript, Inclure la source. 3 Cliquez sur Choisir des fichiers source. 4 Dans la boîte de dialogue Publier la source de l’application, sélectionnez le ou les fichiers de l’application à inclure
Important : pour les projets pour serveurs, vous pouvez sélectionner le dossier des services à l’exportation des fichiers source. L’exportation de fichiers implémentant des services a des implications en termes de sécurité. Ces fichiers peuvent donner accès à votre base de données, noms d’utilisateurs et mots de passe inclus. Voir Exportation des fichiers source vers la version validée d’une application. 5 (Facultatif) Modifiez le dossier de sortie de la source. Par défaut, un dossier d’affichage de la source est ajouté au
Sélectionnez un élément source pour en afficher le code dans le navigateur. Les utilisateurs peuvent également télécharger tous les fichiers source en cliquant sur le lien vers le fichier Download.zip. Remarque : les restrictions de sécurité d’Internet Explorer risquent d’entraver l’affichage du code source sur votre ordinateur local. Vous devrez dans ce cas déployer l’application sur un serveur Web.
Dans les projets Flex, l’ajout de l’élément de menu Afficher la source à l’application s’effectue par l’intermédiaire de l’assistant Exporter vers une version validée. Dans les applications ActionScript, cette option doit être ajoutée manuellement.
Utilisation des projets
ActionScript pour activer le menu d’affichage de la source : com.adobe.viewsource.ViewSource.addMenuItem(obj:InteractiveObject, url:String, hideBuiltins:Boolean = true)
{ public function MyASApp() Flash Builder fournit la tâche Ant <fb.exportReleaseBuild>. Utilisez-la pour implémenter des générations par ligne de commande qui synchronisent les paramètres de génération d’un développeur avec une génération nocturne. Vous pouvez également utiliser la tâche <mxmlc> dans les scripts personnalisés pour la génération nocturne.
La tâche <fb.exportReleaseBuild> garantit que les paramètres de génération nocturne correspondent exactement à ceux utilisés par les développeurs pendant leur travail de la journée. Par exemple, si un développeur modifie le chemin de la bibliothèque d’un projet Flex, le nouveau chemin est écrit dans le projet Flash Builder. A son exécution par l’ordinateur de génération nocturne, la tâche <fb.exportReleaseBuild> charge le projet Flash Builder et tous ses paramètres. La tâche <fb.exportReleaseBuild> présente un autre avantage : elle prend automatiquement en charge les tâches de maintenance supplémentaires qui font normalement partie d’une génération Flash Builder. Par exemple :
• La copie de ressources, telles que les fichiers JPEG, dans le répertoire de sortie • La copie du modèle HTML, y compris le remplacement des macros en fonction des résultats de compilation (comme la largeur et la hauteur) Remarque : la tâche <fb.exportReleaseBuild> nécessite l’installation de Flash Builder sur l’ordinateur de génération nocturne.
Utilisation des projets
Si vous écrivez un script personnalisé qui fait appel à la tâche <mxmlc> (un script Ant, par exemple), vous n’avez pas besoin d’installer Flash Builder sur l’ordinateur de génération. Le SDK Flex doit toutefois s’y trouver. L’ordinateur de génération peut par conséquent se trouver sur une plateforme Linux. En revanche, l’inconvénient de cette approche est que vous disposez de deux jeux de paramètres de génération à synchroniser : le premier, utilisé par les développeurs au cours de la journée, se trouve dans Flash Builder et le second, sur l’ordinateur de génération nocturne.
1 Installez Flash Builder sur un ordinateur de génération. 2 Ecrivez build.xml avec fb.exportReleaseBuild comme cible. Par exemple : <?xml version="1.0"?> <project default="main"> <target name="main"> 3 Créez un script de génération nocturne qui demande à Eclipse de rechercher un fichier de génération et d’exécuter
Les exemples suivants indiquent build.xml comme fichier de génération, qui exécute MyTarget. Si le script de la génération nocturne se trouve sur une plateforme Macintosh, vous pouvez exécuter le script suivant : WORKSPACE="$HOME/Documents/Adobe Flash Builder" # works with either FlashBuilder.app or Eclipse.app "/Applications/Adobe Flash Builder/FlashBuilder.app/Contents/MacOS/FlashBuilder" \ Pour éviter toute ambiguïté de nom, vous pouvez spécifier un chemin d’accès complet par rapport à la racine du projet (src/app1.mxml, par exemple). Pour compiler toutes les applications, spécifiez « * » ou omettez cet attribut. Lorsque vous exécutez un projet AIR, vous ne pouvez spécifier qu’une seule application. La valeur « * » n’est pas autorisée.
Vous pouvez spécifier un chemin relatif ou absolu. Si vous spécifiez un chemin relatif, il est relatif par rapport à la racine du projet. certificate
Avertissement : l’utilisation d’une valeur littérale pour un mot de passe risque de compromettre la sécurité. timestamp
AIR généré inclut un horodatage.
être affichés. Important : pour les projets pour serveurs, vous pouvez sélectionner le dossier des services à l’exportation des fichiers source. L’exportation de fichiers implémentant des services a des implications en termes de sécurité. Ces fichiers peuvent donner accès à votre base de données, noms d’utilisateurs et mots de passe inclus. Voir Exportation des fichiers source vers la version validée d’une application.
Utilisation des projets
La tâche <fb.exportReleaseBuild> est uniquement prise en charge sur des plateformes Windows et Mac. Si vous rédigez toutefois un script de génération pour une autre plateforme, utilisez l’option -dump-config dans le compilateur mxmlc ou compc pour écrire les paramètres de configuration du compilateur dans un fichier. L’option load-config vous permettra ensuite de lire les options de configuration. Modifiez les paramètres de configuration du fichier en fonction de vos besoins. Par exemple, changez <debug>true</debug> en <debug>false</debug> pour que la génération nocturne génère une version validée. Exécution d’une génération par ligne de commande à l’aide des paramètres du compilateur Flash Builder 1 Dans Flash Builder, sélectionnez Projet > Propriétés > Compilateur Flex. 2 Dans le champ Arguments de compilateur supplémentaires, indiquez l’argument suivant :
3 Appliquez les modifications dans la fenêtre du projet.
4 Modifiez les paramètres de configuration comme il convient. 5 Dans le script de génération, exécutez le compilateur afin qu’il intègre les paramètres enregistrés du compilateur :
Certaines restrictions s’appliquent à l’exécution des générations par ligne de commande à l’aide de la tâche <fb.exportReleaseBuild>.
Dans Eclipse 3.4 sur des plateformes Mac, la génération sans affichage échoue si le chemin d’installation d’Eclipse comporte des espaces.
Flash Builder s’exécute sur des plateformes qui implémentent Java 32 bits. Pour exécuter une génération par ligne de commande sur des plateformes prenant en charge Java 64 bits (Mac OS X Snow Leopard, par exemple), ajoutez -d32 aux options de ligne de commande qui sont transmises à Java. Par exemple : java -d32 ...
Le test d’une application dans Adobe® Flash® Builder™ consiste à exécuter les fichiers SWF de l’application dans un navigateur Web ou dans la version autonome de Flash Player. En présence d’erreurs dans l’application, les outils de débogage vous permettent : de placer des points d’arrêt dans le code et de les gérer ; de contrôler l’exécution de l’application en l’interrompant, la reprenant et la terminant ; d’avancer d’un pas avec entrée ou d’avancer d’un pas sans entrée dans les instructions de code ; de sélectionner les variables critiques à contrôler ; et enfin d’évaluer les expressions de contrôle en cours d’exécution de l’application.
Utilisation des projets
Une fois les projets générés en applications (voir « Génération de projets » à la page 73), vous pouvez les exécuter et les déboguer dans Flash Builder. Utilisation de la version de débogage de Flash Player Pour utiliser la fonction de débogage de Flash Builder, vous devez exécuter la version de débogage de Flash Player. Cette version est disponible sous forme de plug-in ou de contrôle ActiveX pour navigateur ou en tant que version autonome. Elle est installée avec Flash Builder mais peut également être téléchargée à partir du site Web d’Adobe. Les programmes d’installation de la version de débogage de Flash Player se trouvent dans le répertoire flex_builder_install/Player. Vous pouvez déterminer par programmation la version de Flash Player exécutée en utilisant la méthode Capabilities.isDebugger(). Pour plus d’informations, voir Determining Flash Player version in Flex. Utilisation des configurations de lancement pour exécuter et déboguer des applications Une configuration de lancement définit le nom du projet, le fichier principal de l’application et le chemin des versions d’exécution et de débogage de l’application. Flash Builder contient une configuration de lancement d’application Flex par défaut. Cette configuration est utilisée pour créer automatiquement des configurations de lancement pour chacun de vos projets. Pour plus d’informations, voir « Gestion des configurations de lancement » à la page 94. Remarque : dans la configuration plug-in de Flash Builder, la création des configurations de lancement n’est pas automatique. Vous devez en créer une à la première exécution de l’application. Voir « Exécution des applications » à la page 92. Personnalisation des configurations de lancement Vous pouvez personnaliser les configurations de lancement que Flash Builder créé automatiquement pour vous. Vous pouvez par exemple commuter le fichier d’application principal ou modifier le chemin afin qu’il dirige vers un fichier SWF plutôt que vers le fichier d’enveloppe HTML. Cela permet d’exécuter et de déboguer les applications directement dans la version autonome de Flash Player plutôt que dans un navigateur Web. Vous pouvez en outre créer des configurations de lancement distinctes pour chaque fichier d’application du projet. Pour plus d’informations, voir « Création ou modification d’une configuration de lancement » à la page 94. Exécution et débogage des applications dans un navigateur ou dans la version autonome de Flash Player Par défaut, les chemins d’exécution et de débogage de la configuration de lancement dirigent vers les fichiers d’enveloppe HTML situés dans le dossier de sortie du projet. Les applications sont donc exécutées et déboguées dans la version Flash Player intégrée dans le navigateur Web utilisé. Vous avez toutefois la possibilité d’exécuter et de déboguer les applications dans la version autonome de Flash Player (voir « Exécution du fichier d’application SWF dans la version autonome de Flash Player » à la page 95). Vous pouvez en outre remplacer le navigateur Web standard par tout autre navigateur installé sur votre ordinateur (voir « Modification du navigateur Web par défaut » à la page 96). Remarque : les paramètres de sécurité par défaut d’Internet Explorer 6 (ou des versions ultérieures) bloquent les applications lancées à partir de Flash Builder. Pour les modifier, cliquez sur Outils > Options Internet > Avancé > Sécurité > Autoriser le contenu actif à s’exécuter dans les fichiers de la zone Ordinateur local. Une autre possibilité consiste à autoriser l’exécution de chaque page Internet Explorer après son blocage.
Utilisation des projets
La perspective Débogage Flash contient toutes les fonctions attendues d’un outil de développement puissant et complet. Les outils de débogage vous permettent :
• de déterminer comment interrompre, reprendre ou quitter l’application ; • d’avancer d’un pas avec et sans entrée dans le code ; • de contrôler des variables ; • d’évaluer des expressions. Pour plus d’informations sur les outils de débogage Flash Builder, voir « Débogage des applications » à la page 141. Pour plus d’informations sur la modification du code, voir « A propos de la modification du code dans Flash Builder » à la page 103. Activation de la perspective de débogage au niveau d’un point d’arrêt Des points d’arrêt peuvent être ajoutés à des lignes de code exécutables dans l’éditeur de code. Au lancement d’une session de débogage, l’application est exécutée jusqu’au premier point d’arrêt rencontré. A ce stade, la perspective Débogage Flash est activée. Elle vous permet d’analyser l’état de l’application et de la gérer en faisant appel aux outils de débogage. Pour plus d’informations, voir « Lancement d’une session de débogage » à la page 141. Comparaison des versions déboguées et non déboguées d’une application Flex Par défaut, Flash Builder génère des versions déboguées du fichier SWF de l’application et les enregistre dans le répertoire bin-debug du projet. Le volume de cette application est supérieur à celui d’une version non déboguée car il contient du code et des métadonnées supplémentaires utilisées par le débogueur. Pour générer une version non déboguée de l’application Flex, effectuez l’une des opérations suivantes :
Les applications sont exécutées (et déboguées) en fonction d’une configuration de lancement. La configuration de lancement d’une nouvelle application Flex ou ActionScript spécifie l’emplacement des fichiers d’application générés et du fichier principal de l’application. Les configurations de lancement peuvent être modifiées ou personnalisées. Pour plus d’informations, voir « Gestion des configurations de lancement » à la page 94. L’exécution des projets conduit à l’ouverture du fichier principal SWF de l’application dans le navigateur Web par défaut ou directement dans la version autonome de Flash Player. Pour plus d’informations sur la modification du navigateur par défaut ou sur l’exécution et le débogage dans la version autonome de Flash Player, voir « Modification du navigateur Web par défaut » à la page 96 et « Exécution du fichier d’application SWF dans la version autonome de Flash Player » à la page 95. L’exécution des projets dans Flash Builder peut être effectuée de différentes manières. Vous pouvez par exemple utiliser la commande d’exécution à partir de la barre d’outils et du menu principaux du workbench, de la vue Explorateur de packages et des menus contextuels de l’éditeur de code.
Utilisation des projets
Exécution du projet avec la configuration de lancement par défaut de l’application Flex 1 Dans l’Explorateur de packages, sélectionnez le projet que vous souhaitez exécuter. 2 Dans la barre d’outils principale du workbench, cliquez sur le bouton Exécuter.
L’application s’affiche dans le navigateur Web par défaut ou dans la version autonome de Flash Player. Vous pouvez exécuter et déboguer tout fichier de projet défini comme fichier d’application. Pour plus d’informations, voir « Gestion des fichiers d’application du projet » à la page 52. Création d’une configuration de lancement personnalisée 1 Dans l’Explorateur de packages, sélectionnez le projet que vous souhaitez exécuter et ouvrez le fichier principal de l’application dans l’éditeur. 2 Dans le menu principal, cliquez sur Exécuter > Exécuter > Autre. 3 Dans la boîte de dialogue Création, gestion et exécution des configurations, sélectionnez l’option Application Web
4 Dans la barre d’outils de la boîte de dialogue, cliquez sur le bouton Crée une nouvelle configuration de lancement. 5 Saisissez le nom de la configuration. 6 (Facultatif) Modifiez si nécessaire les propriétés de la configuration. 7 (Facultatif) Cliquez sur Exécuter pour lancer l’exécution de l’application.
1 Dans l’Explorateur de packages, sélectionnez le projet que vous souhaitez exécuter. 2 Dans le menu principal, cliquez sur Exécuter > Exécuter > Autre. 3 Sélectionnez l’application que vous souhaitez exécuter.
❖ Dans le menu principal, cliquez sur Exécuter > Exécuter > Autre. Dans la boîte de dialogue Création, gestion et exécution des configurations, sélectionnez une configuration personnalisée existante ou créez-en une. Voir « Gestion des configurations de lancement » à la page 94. L’action de la commande Exécuter de la version plug-in de Flash Builder est légèrement différente. Elle n’exécute pas le projet sélectionné, mais la dernière configuration à avoir été lancée. Vous pouvez également sélectionner une configuration parmi la liste de celles à avoir été lancées en dernier. Exécution de la dernière configuration lancée ❖ Cliquez sur le bouton Exécuter situé dans la barre d’outils principale.
Utilisation des projets
Les configurations de lancement permettent d’exécuter et de déboguer des applications. Flash Builder comporte une configuration de lancement par défaut pour les applications Flex et ActionScript. Lorsque vous exécutez ou déboguez un projet pour la première fois, le programme crée une configuration de lancement spécifique à ce projet. Vous pouvez ensuite modifier le fichier d’application par défaut spécifié dans la configuration de lancement de même que le chemin de lancement par défaut, afin que l’application soit exécutée ou déboguée dans la version autonome de Flash Player plutôt que dans un navigateur Web.
Un projet créé et généré est prêt à être exécuté ou débogué. L’exécution et le débogage des applications du projet sont contrôlés par une configuration de lancement. Par défaut, Flash Builder crée une configuration de lancement pour chaque fichier d’application du projet exécuté ou débogué pour la première fois. Les configurations se basent sur la configuration d’application Flex par défaut et peuvent être modifiées. Les configurations de lancement sont gérées dans la boîte de dialogue Création, gestion et exécution des configurations.
1 Dans l’Explorateur de packages Flex, sélectionnez un projet. 2 Ouvrez un fichier du projet dans l’éditeur de code, puis la boîte de dialogue Création, gestion et exécution des
> Déboguer > Autre.
Exécuter ou Déboguer en tant que > Déboguer.
Utilisation des projets
Ouvrir la boîte de dialogue d’exécution ou Déboguer en tant que > Ouvrir la boîte de dialogue de débogage. 3 Sélectionnez la configuration de lancement que vous souhaitez modifier.
Eclipse sont installés. A la première exécution d’un projet, Flash Builder crée par défaut une configuration de lancement spécifique au projet, reposant sur la configuration d’application Flex par défaut. Les configurations spécifiques aux applications peuvent être modifiées. Vous pouvez également créer une nouvelle configuration de lancement ou développer une nouvelle configuration à partir d’une configuration existante. 4 Adaptez les paramètres de la configuration, puis cliquez sur Exécuter ou Déboguer.
Pour les applications de bureau, vous pouvez créer des configurations de lancement qui remplaceront les configurations par défaut fournies par Flash Builder. Lors de la création ou de la modification d’une configuration de lancement pour une application de bureau, vous devez spécifier des arguments de ligne de commande, un ID d’éditeur, un profil et des paramètres de format d’écran. Pour les applications de bureau, la valeur de Profil peut être soit desktop, soit extendedDesktop. Pour créer une configuration de lancement : 1 Sélectionnez Exécuter > Exécuter > Autre.
Pour les configurations de lancement de profilage, cliquez sur Exécuter > Profil > Autre. 2 Sélectionnez le projet de bureau. Cliquez sur le bouton de création d’une configuration de lancement.
3 Sélectionnez Exécuter, Déboguer ou Profiler pour exécuter l’application avec les paramètres définis.
« Gestion des configurations de lancement » à la page 94
Les applications sont exécutées ou déboguées dans le navigateur Web par défaut. Vous pouvez toutefois en sélectionner un autre (voir « Modification du navigateur Web par défaut » à la page 96). Les applications peuvent également être exécutées ou déboguées dans la version autonome de Flash Player. Il vous suffit pour ce faire de modifier légèrement la configuration de lancement. Exécution et débogage des applications dans la version autonome de Flash Player 1 Dans la boîte de dialogue Création, gestion et exécution des configurations, sélectionnez la configuration de lancement que vous souhaitez modifier. 2 Dans l’onglet Principal, désélectionnez l’option Utiliser la valeur par défaut.
Utilisation des projets
4 Sélectionnez le fichier d’application SWF du répertoire bin-debug. Ne sélectionnez pas le fichier SWF de l’éventuel
5 Cliquez sur Ouvrir pour sélectionner le fichier et retourner à la boîte de dialogue de configuration. 6 Validez les modifications apportées et exécutez ou déboguez l’application en utilisant la configuration modifiée.
L’exécution et le débogage des applications sont effectués dans le navigateur Web défini par défaut. Vous ne pouvez pas définir un navigateur Web différent pour chaque configuration de lancement. Vous pouvez toutefois modifier le navigateur Web défini pour le workbench, ce qui aura une incidence sur l’exécution et le débogage de toutes les applications. Modification du navigateur Web par défaut 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Navigateur Web. 2 Sélectionnez un navigateur dans la liste de ceux installés sur le système.
Vous pouvez également ajouter des navigateurs à la liste, en supprimer ou éditer ceux qui y sont répertoriés. 3 Cliquez sur OK pour appliquer les modifications.
Adobe® Flash® Builder™ permet de créer, d’ajouter, d’optimiser et de déboguer des modules. Pour plus d’informations sur la rédaction de code de module, voir Creating modular applications.
Les étapes suivantes décrivent la procédure de création d’un nouveau module dans Flash Builder. Après avoir créé un nouveau module, vous pouvez le compiler. Création de modules dans Flash Builder 1 Dans Flash Builder, sélectionnez Fichier > Nouveau > Module MXML. La boîte de dialogue Création d’un(e) module MXML s’affiche. 2 Sélectionnez un répertoire parent pour le module. Les modules sont habituellement stockés dans le même
Les modules étant exécutables, ils doivent se trouver dans le dossier source du projet. 3 Entrez un nom de fichier pour le module, par exemple MyModule. 4 Entrez les propriétés Largeur, Hauteur et Présentation. 5 Indiquez si vous souhaitez ou non optimiser le module.
Utilisation des projets
Si vous activez cette option, spécifiez l’application pour laquelle le module doit être optimisé.
Si vous activez cette option, toutes les classes sont incluses dans le module, qu’elles soient définies ou non dans l’application principale, améliorant ainsi les performances de la compilation d’incrémentation. Vous pouvez en outre charger le module dans n’importe quelle application, toutes ses dépendances y étant compilées. 6 Cliquez sur Terminer.
Dans Flash Builder, vous pouvez exécuter le module comme une application ou générer le projet du module. Si les modules figurent dans le même projet que l’application, alors Flash Builder compile automatiquement les fichiers SWF pour tous les modules du projet lorsque vous exécutez l’application. Les fichiers SWF sont ensuite chargés dans l’application lors de l’exécution. Il est impossible d’exécuter le fichier SWF basé sur un module comme une application Flash autonome ou de le charger dans une fenêtre de navigateur. Il doit être chargé par une application en tant que module. Si vous exécutez le module dans Flash Builder pour le compiler, fermez Adobe Flash Player ou la fenêtre du navigateur et ignorez les erreurs éventuelles. Les modules ne doivent pas être sollicités directement par Flash Player ou par l’intermédiaire d’un navigateur. Les fichiers SWF du module et le fichier SWF de l’application principale se trouvent généralement dans le même répertoire. Flash Builder compile toutefois les modules en même temps que l’application, quel que soit leur emplacement. Les modules peuvent se situer dans le même répertoire que l’application ou dans des sous-répertoires. Vous pouvez également créer un projet Flex ou ActionScript distinct pour chaque module ou groupe de modules. Il en résulte une meilleure maîtrise de la compilation des modules, les options de compilateur de chaque projet pouvant différer de celles de l’application ou des autres modules. Cela permet également de compiler le ou les projets d’un module sans compiler l’application. Cette approche requiert toutefois la compilation manuelle de chaque module avant de compiler l’application. Une manière de procéder consiste à compiler simultanément tous les projets ouverts dans Flash Builder. Si vous compilez les modules indépendamment de l’application principale, veillez à inclure ou exclure les informations de débogage, selon que vous souhaitez déboguer l’application et les modules. Pour plus d’informations, voir « Débogage de modules dans Flash Builder » à la page 101. Le déroulement du travail dans Flash Builder est conçu pour l’association de modules avec une même application. Pour utiliser des modules dans plusieurs applications, encapsulez éventuellement le code dans une classe ou un composant de bibliothèque à inclure dans un module simple pour chaque application. Contrairement aux bibliothèques, les modules ne sont pas destinés à une utilisation dans le code commun à plusieurs applications.
Lors de la définition de l’architecture de votre projet, vous pouvez décider d’inclure des modules dans votre projet d’application, de créer un projet distinct pour chaque module ou de créer un projet distinct pour l’ensemble des modules.
Utilisation des projets
L’utilisation d’un projet pour chaque module présente les avantages suivants :
• Les projets de module peuvent disposer de paramètres de compilateur distincts, tel qu’un chemin d’accès à la bibliothèque personnalisé. Ils peuvent utiliser l’option de compilateur load-externs pour supprimer les dépendances qui se recoupent. L’utilisation d’un projet pour chaque module présente les inconvénients suivants :
• L’existence de nombreux projets dans un même espace de travail peut augmenter son encombrement. • Par défaut, lorsque vous compilez l’application, tous les projets de module ne sont pas compilés, même s’ils ont subi des modifications.
Utilisation d’un projet pour tous les modules Une approche semblable consiste à utiliser un même projet pour l’ensemble des modules, en conservant l’application dans son propre projet distinct. Certains inconvénients, liés à l’utilisation d’un même projet à la fois pour l’application et les modules, subsistent. Cette approche apporte toutefois de nombreux avantages découlant de l’utilisation d’un projet distinct pour chaque module. L’utilisation d’un projet pour l’ensemble des modules présente les avantages suivants :
• Vous pouvez compiler séparément les modules ou l’application, sans nécessité de compiler les deux simultanément. • Le projet de module peut utiliser l’option de compilateur load-externs pour supprimer les dépendances qui se recoupent. L’utilisation d’un projet de module pour l’ensemble des modules présente les inconvénients suivants :
Lors de la création d’un projet séparé pour les modules, vous modifiez le dossier de sortie du projet de module sur un répertoire utilisé par l’application. Vous supprimez également la création de fichiers d’enveloppe. Création d’un projet distinct pour les modules dans Flash Builder 1 Créez un projet principal. 2 Créez un nouveau projet pour le ou les modules. 3 Dans le menu contextuel du projet du module, sélectionnez Propriétés. La boîte de dialogue Propriétés s’ouvre. 4 Sélectionnez l’option Chemin de génération Flex.
Utilisation des projets
${DOCUMENTS}\MainProject\assets
6 Cliquez sur OK pour enregistrer vos modifications. 7 Ouvrez à nouveau les propriétés du projet et sélectionnez l’option Compilateur Flex. 8 Désélectionnez l’option Générer le fichier d’enveloppe HTML afin d’éviter que le projet du module ne génère les
9 Cliquez sur OK pour appliquer les modifications.
La compilation de plusieurs projets dans Flash Builder est une opération courante. Choisissez d’abord l’ordre de compilation souhaité, puis compilez l’ensemble des projets simultanément. Compilation simultanée de tous les projets dans Flash Builder ❖ Dans le menu principal, sélectionnez Projets > Générer tout. Flex génère alors l’ensemble des projets de l’espace de travail. Les fichiers d’application sont ajoutés au dossier de sortie de chaque projet. Si vous n’avez pas choisi l’enregistrement automatique des fichiers avant le début d’une génération, vous êtes invité à enregistrer les fichiers. Pour modifier l’ordre de génération, utilisez la boîte de dialogue Ordre de génération. La modification de l’ordre de génération n’est pas toujours nécessaire. Les projets utilisant des modules ne doivent être compilés qu’avant l’exécution de l’application de projet principale, et non lors de sa compilation. Dans la plupart des cas, l’ordre de génération par défaut ne doit pas être modifié. Si toutefois vous souhaitez éliminer les dépendances qui se recoupent, vous pouvez modifier l’ordre de génération afin de compiler d’abord l’application principale. L’option de compilateur link-report permet alors de générer le rapport de liaison. Lorsque vous compilez les modules, l’option de compilateur load-externs permet d’utiliser le rapport de liaison généré récemment par l’application principale. Pour plus d’informations sur la réduction de la taille des modules, voir « Optimisation de modules dans Flash Builder » à la page 101. Modification de l’ordre de génération des projets 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Général > Espace de travail > Ordre de génération. La boîte de dialogue Ordre de génération apparaît. 2 Désélectionnez la case à cocher Utiliser l’ordre de génération par défaut. 3 Utilisez les boutons Haut et Bas pour reclasser les projets de la liste Ordre de génération. Vous pouvez également
4 Cliquez sur OK. 5 Modifiez si nécessaire l’ordre de génération, puis cliquez sur OK.
Utilisation des projets
Si vous utilisez un projet distinct pour chaque module, vous pouvez compiler un seul module à la fois. Cela permet de gagner du temps par rapport à la compilation simultanée de tous les projets, ou par rapport à la compilation d’un seul projet contenant tous les fichiers de modules et d’application. Compilation du projet d’un seul module 1 Cliquez avec le bouton droit de la souris sur le fichier MXML du module dans le projet du module. 2 Sélectionnez Exécuter l’application. La fenêtre du lecteur ou du navigateur tente d’exécuter le module après sa
Vous serez amené, dans certaines situations, à utiliser des modules ne figurant pas dans le projet de l’application principale. Le module peut provenir d’un projet distinct, vous pouvez alors utiliser des options de configuration personnalisées. Vous pouvez également vouloir partager le module entre plusieurs applications. Ajoutez le code source du module au chemin source de l’application, puis ajoutez le module à la liste de modules de l’application afin de pouvoir l’utiliser dans le projet. Ajout d’un module préalablement compilé au projet 1 Sélectionnez l’application principale dans l’Explorateur de packages Flex. 2 Sélectionnez Projet > Propriétés > Chemin de génération Flex pour ajouter la source du module au chemin source
3 Cliquez sur le bouton Ajouter un dossier et accédez au chemin source du module. Cliquez sur OK pour sélectionner
4 Cliquez à nouveau sur OK pour enregistrer vos modifications. 5 Sélectionnez Projet > Propriétés > Modules Flex pour ajouter le module à la liste de modules de l’application. La
6 Cliquez sur le bouton Ajouter. La boîte de dialogue Ajouter un module s’affiche. 7 Utilisez le bouton Parcourir ou entrez l’emplacement du fichier MXML du module dans la zone de texte Source.
8 Sélectionnez l’un des boutons radio Taille du fichier SWF du module pour activer ou désactiver l’optimisation de
9 Cliquez sur OK pour enregistrer vos modifications. Flash Builder ajoute le module à la liste des modules disponibles
Utilisation des projets
Dans Flash Builder, vous ne sélectionnez généralement qu’une seule application par rapport à laquelle le module doit être optimisé lors de sa création initiale ou de son ajout au projet. Si vous décidez par la suite de changer l’application visée par l’optimisation du module, ou de ne pas optimiser le module, vous pouvez modifier les propriétés du module au sein du projet. Pour plus d’informations, voir Reducing module size. Optimisation de modules avec Flash Builder Cette procédure part du principe que le module et l’application se trouvent dans le même projet Flash Builder. Si les modules se situent dans un projet distinct, ajoutez manuellement les options de compilateur load-externs et linkreport. 1 Cliquez avec le bouton droit de la souris sur le projet de l’application dans l’Explorateur de package Flex et
2 Dans le volet de gauche, sélectionnez Modules Flex. 3 Sélectionnez le module dans la liste et cliquez sur le bouton Modifier. La boîte de dialogue Modifier le module
4 Pour supprimer l’optimisation, sélectionnez le bouton radio Ne pas optimiser sous Taille du fichier SWF du
Par défaut, Flash Builder génère un seul fichier SWF comprenant des symboles de débogage. Les instructions Déboguer et Exécuter fonctionnent donc toutes les deux lors de l’exécution d’une application utilisant des modules dans Flash Builder. Toutefois, l’inclusion de symboles de débogage dans le fichier SWF d’un module augmente sa taille. Pour exclure les symboles de débogage avant le déploiement, désactivez le débogage pour les modules de l’application. Pour ce faire, exportez la version validée des modules en sélectionnant Projet > Exporter vers une version validée. Pour exclure les informations de débogage des fichiers SWF dans Flash Builder, vous pouvez définir l’option debug sur false dans la zone de texte des arguments de compilateur supplémentaires, ou générer des fichiers SWF sans débogage en les exportant à l’aide de la fonctionnalité Exporter vers une version validée. Cela inclut les modules, s’ils figurent dans le projet actif. Si vous créez un projet distinct pour les modules, vous pouvez activer ou désactiver le débogage pour l’ensemble du projet sans modifier les paramètres de l’application principale.
Utilisation des projets
Lors de l’utilisation de modules dans une application AIR, le fichier SWF du module doit figurer dans le même répertoire que le fichier SWF de l’application, ou dans l’un de ses sous répertoires.
Flash Builder Dans Adobe® Flash® Builder™, la modification des codes MXML, ActionScript et CSS advient dans des éditeurs différents. Le workbench de Flash Builder intègre à la fois les projets et les documents, permettant ainsi l’ouverture automatique de l’éditeur correspondant au type de ressource. Les éditeurs de Flash Builder partagent les mêmes fonctionnalités, parmi lesquelles les indicateurs de code, la navigation, le formatage, la restructuration ainsi que d’autres fonctions d’amélioration de la productivité.
La création et le développement d’applications Flex et ActionScript a lieu dans la perspective Développement Flash qui se compose des éditeurs Flash Builder ainsi que de toutes les vues prenant en charge les opérations de modification et de création de code. La configuration de la perspective de développement dépend de l’éditeur et du mode utilisés. Lors de la création d’un projet Flex par exemple, l’éditeur MXML présente deux modes (Source et Création), contenant chacun sa propre gamme de vues. Pour une présentation générale de la perspective de développement Flash, voir « Perspective Développement Flash » à la page 8. Editeurs MXML, ActionScript et CSS Flash Builder contient trois éditeurs pour la rédaction de code MXML, ActionScript et CSS. L’éditeur MXML permet de modifier les fichiers MXML. Il se compose de deux modes : Source et Création. Le mode Source vous permet de rédiger du code MXML et d’intégrer les codes ActionScript et CSS contenus dans les balises <fx:Script> et <fx:Style>. Le mode Création vous permet de créer des applications (voir « Création d’une interface utilisateur avec Flash Builder » à la page 188). L’éditeur ActionScript permet de modifier les fichiers AS, dont les principaux fichiers des projets ActionScript ainsi que les fichiers de classe et d’interface. Pour plus d’informations, voir « Projets ActionScript » à la page 66. L’éditeur CSS permet d’écrire des fichiers CSS (Cascading Style Sheets). Pour plus d’informations, voir « Application de styles » à la page 213 et Styles and themes. Assistant de contenu MXML, ActionScript et CSS En cours de rédaction de code MXML, ActionScript et CSS, des indicateurs et des documents de référence ASDoc s’affichent afin de faciliter la saisie. Cette fonction porte le nom d’assistant de contenu. Flash Builder accélère par ailleurs le développement de code en complétant les balises MXML, en proposant une gestion automatique de l’importation, en intégrant le Guide de référence du langage Adobe Flex et en permettant de définir des couleurs et des polices différentes pour l’affichage du code dans l’espace de travail. Pour plus d’informations, voir « Aide au codage dans Flash Builder » à la page 105. Indicateurs de code pour les composants personnalisés ainsi que pour les classes et interfaces ActionScript Outre la prise en charge intégrée pour la structure Flex, des indicateurs de code sont fournis pour tous les composants personnalisés ainsi que pour les classes et les interfaces ActionScript comprises dans le projet. Pour plus d’informations, voir « Utilisation de l’assistant de contenu » à la page 108.
Flash Builder comporte des filtres et un assistant de contenu pour vous permettre d’identifier les types recommandés pour un espace de noms. Vous pouvez également faire défiler les différents filtres et paramètres afin de localiser tous les types, propriétés et événements mis à disposition par la structure Flex. Pour plus d’informations, voir « Utilisation de l’assistant de contenu » à la page 108. Génération des fonctions des accesseurs (Get et Set) Les fonctions des accesseurs Get et Set vous permettent de faire en sorte que les propriétés d’une classe restent privées pour une classe ActionScript. Les utilisateurs de la classe peuvent accéder à ces propriétés de la même façon que s’ils accédaient à une variable de classe (plutôt que d’appeler une méthode de classe). Flash Builder peut générer des fonctions d’accesseur Get et Set ActionScript pour les variables de classe. Pour plus d’informations, voir « Génération des fonctions d’accesseur » à la page 68. Simplification de la navigation dans le code Afin de faciliter l’accès aux nombreux fichiers et lignes de code que contiennent les projets, Flash Builder propose des fonctions pratiques telles que, parmi d’autres, le développement et la réduction de blocs de code, l’ouverture des sources de définitions de code externes ainsi que la recherche et l’ouverture de types de classe. De plus, la vue Structure permet d’examiner la structure du code des documents et d’en parcourir les lignes. Pour plus d’informations, voir « Navigation et organisation du code » à la page 111. Recherche de références et restructuration de code Flash Builder peut rechercher toutes les références et les déclarations correspondant aux identifiants d’un fichier, d’un projet ou d’un espace de travail donné. La recherche porte également sur les éléments reliés à partir de fichiers SWC ainsi que les entrées des chemins de bibliothèque (classes, interfaces, fonctions, variables et quelques métadonnées, par exemple). La restructuration renomme les identifiants du code tout en mettant à jour toutes les références qui y sont faites dans l’ensemble de la base de code. Pour plus d’informations, voir « Recherche de références et restructuration de code » à la page 118. Vérification automatique de la syntaxe Flash Builder génère les projets de manière incrémentielle, en vous signalant d’éventuelles erreurs au fur et à mesure que vous progressez dans votre travail. En cas d’erreurs de syntaxe en cours de rédaction de code MXML et ActionScript, des indicateurs d’erreur s’affichent dans l’éditeur à la hauteur de la ligne de code concernée et un message apparaît dans la vue Erreurs. Pour plus d’informations, voir « Application des préférences de couleurs pour la syntaxe » à la page 125. Coloration de la syntaxe La page Couleurs pour la syntaxe des Préférences définit les couleurs à appliquer au code dans les éditeurs MXML, ActionScript et CSS. Vous pouvez également y définir des options de style pour la police et en afficher un aperçu. Pour plus d’informations, voir « Comment obtenir de l’aide pour la rédaction de code » à la page 110 et « Utilisation de l’assistant de contenu » à la page 108. Editeur et intégration d’un débogueur Les éditeurs MXML et ActionScript associés à la perspective Débogage Flash facilitent le débogage du code. Par la définition de points d’arrêt, vous pouvez interrompre l’application au niveau de lignes de code susceptibles de provoquer des difficultés ou présentant une importance particulière. Au lancement d’une session de débogage, la perspective Débogage Flash s’affiche lorsque le premier point d’arrêt est atteint. Vous pouvez alors examiner l’état de l’application et isoler, puis résoudre tout problème survenant dans le code. Pour plus d’informations sur le débogage du code, voir « Débogage des applications » à la page 141.
Modification du code dans Flash Builder
Les éditeurs Flash Builder proposent plusieurs fonctions facilitant le développement de code. Assistant de contenu L’assistant de contenu est disponible dans les éditeurs MXML, ActionScript et CSS. Il fournit des indicateurs de code qui vous aident à compléter les expressions de code. Il facilite également la sélection des classes, propriétés et événements recommandés, disponibles dans un espace de noms. Pour plus d’informations, voir « A propos de l’assistant de contenu » à la page 106. Gestion automatique de l’importation Lorsque vous saisissez du code avec l’assistant de contenu, les noms complets des types sont automatiquement importés dans le document. Dans un document ActionScript, le nom complet du type est ajouté en tête de document avec les autres instructions d’importation. Dans un document MXML, l’instruction d’importation est ajoutée au bloc de script existant. En l’absence de bloc de script, Flash Builder en crée un. Les documents ActionScript offrent également la possibilité de trier les instructions d’importation. Pour plus d’informations, voir « Organisation des instructions d’importation » à la page 116. Remplissage des balises MXML Lors de la saisie de code MXML, de nombreux éléments de la syntaxe sont ajoutés automatiquement, dont les balises de fermeture, les mises en retrait et les nouvelles lignes. En outre, les balises CDATA sont automatiquement placées à l’intérieur de balises <fx:Script>. Utilisation des états d’affichage En mode Source, l’éditeur MXML facilite l’édition des états d’affichage. Lorsque des états d’affichage ont été définis à la racine de l’application, l’éditeur comporte la liste déroulante Afficher état. Servez-vous de cette liste pour mettre en évidence l’état sélectionné dans l’éditeur. L’assistant de contenu facilite également la sélection des états d’affichage pour les composants et les propriétés. Pour plus d’informations sur ce point ainsi que sur d’autres aspects de l’édition des états d’affichage, voir « Création et édition d’états d’affichage dans le code source » à la page 231. Documentation de référence ASDoc Flash Builder affiche les documents de référence ASDoc dans les éditeurs MXML et ActionScript lorsque vous utilisez un assistant de contenu ou survolez un type avec le curseur. La documentation ASDoc apparaît également dans la vue ASDoc pour les classes sélectionnées. Cette fonctionnalité prend en charge la documentation ASDoc générée par les utilisateurs. Pour plus d’informations, voir « Définition de commentaires ASDoc pour les composants personnalisés » à la page 136. Création de gestionnaires d’événement Les éditeurs Flash Builder aident l’utilisateur à créer des gestionnaires d’événement pour les composants. Pour chaque événement d’un composant, vous pouvez générer un gestionnaire d’événement entouré de balises <Script>. Ce gestionnaire est référencé par la propriété event dans la balise du composant. Pour plus d’informations, voir « Création de gestionnaires d’événement » à la page 208.
Modification du code dans Flash Builder
Le Guide de référence du langage Adobe Flex est intégré à l’éditeur et est facilement accessible en sélectionnant un élément de langage ActionScript, une balise de composant MXML ou un attribut, puis en actionnant les touches Maj+F2. Pour plus d’informations, voir « Comment obtenir de l’aide pour la rédaction de code » à la page 110. Aide pour le formatage Afin de faciliter le codage des applications, les éditeurs peuvent reformater des blocs de code et procéder à des modifications en bloc. Pour plus d’informations, voir « Formatage et modification du code » à la page 116.
Au cours de la saisie du code dans les éditeurs Flash Builder, l’assistant de contenu affiche une liste d’options de remplissage de l’expression de code (généralement désignées par indicateurs de code). Un document MXML propose par exemple une liste de balises pouvant être ajoutées à l’emplacement auquel se trouve le curseur de la souris. L’assistant de contenu affiche également la documentation de référence ASDoc disponible pour le composant MXML ou le code ActionScript que vous rédigez. La documentation ASDoc s’affiche également lors du passage du curseur de la souris sur un composant MXML ou une classe ActionScript. Si vous sélectionnez une classe dans l’éditeur, le contenu ASDoc apparaît également dans la vue ASDoc. L’assistant de contenu est disponible dans les éditeurs MXML, ActionScript et CSS. Son utilisation varie en fonction de l’éditeur. Les indicateurs s’affichent à chaque fois qu’une structure ou un langage (MXML, ActionScript et CSS) fournit des options de remplissage de l’expression en cours de rédaction. L’assistant de contenu affiche des indicateurs pour les composants MXML personnalisés et les classes ActionScript créés faisant partie du projet. Supposons que vous définissiez un composant MXML personnalisé et l’ajoutiez au projet. Les indicateurs de code s’affichent à chaque création d’une référence au composant dans l’application MXML.
Dans l’éditeur MXML, la saisie dans le cadre d’un composant MXML conduit par exemple à l’affichage d’une liste contenant toutes les propriétés de ce composant. L’exemple suivant illustre les indicateurs de code pour les propriétés d’un composant MXML.
Modification du code dans Flash Builder
Par défaut, l’assistant de contenu affiche uniquement les indicateurs correspondant aux types recommandés. Les types recommandés sont les composants disponibles dans les espaces de noms ou autres, suivant les balises englobantes. Les composants dont vous disposez dépendent de la déclaration d’espace de noms de l’application concernée ainsi que des balises englobant le point d’insertion dans l’éditeur. Dans certains contextes par exemple, seuls les composants Spark sont autorisés. D’autres contextes autorisent les composants Spark et les composants Halo. L’assistant de contenu filtre les indicateurs de code en fonction du contenu. Appuyez sur les touches Ctrl+Espace pour faire défiler les filtres pour les indicateurs de code affichés. Les filtres sont les suivants :
• Tous les composants • Propriétés Pour modifier les paramètres par défaut dans la boîte de dialogue Préférences : 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Flash Builder > Editeurs > Code MXML > Avancées. 2 Spécifiez les types d’indicateurs que vous souhaitez afficher. 3 Sélectionnez un type d’indicateur et modifiez-en la position dans le cycle de défilement en cliquant sur les boutons
Le premier type d’indicateur de la liste sera affiché en premier.
Les indicateurs de code accélèrent et facilitent la rédaction de code MXML, ActionScript et CSS. Ils s’affichent en cours de saisie du code dans l’éditeur. Affichage de l’assistant de contenu et insertion d’indicateurs de code 1 Commencez à saisir une ligne de code.
Appuyez sur Ctrl+Espace pour parcourir la liste des indicateurs de code disponibles.
Modification du code dans Flash Builder
Vous pouvez également afficher les indicateurs en cours de saisie d’une ligne de code en actionnant les touches Ctrl+Espace. 2 Parcourez la liste d’indicateurs de code en utilisant les flèches vers le haut et vers le bas. 3 Sélectionnez un indicateur de code et appuyez sur Entrée pour insérer le code dans l’éditeur.
Affichage de l’assistant de contenu et des commentaires ASDoc 1 Commencez à entrer une ligne de code qui contient une classe MXML ou ActionScript. Vous pouvez également survoler la classe avec le curseur de la souris. Au fur et à mesure que vous tapez, le contenu ASDoc correspondant à la classe apparaît à côté des indicateurs de code. Si vous passez le curseur de la souris sur une classe, seul le commentaire ASDoc apparaît. 2 Cliquez à l’intérieur du contenu ASDoc ou appuyez sur la touche F2 pour afficher le contenu dans une fenêtre
3 Lorsque vous avez terminé la lecture de la documentation, cliquez hors de la fenêtre. La fenêtre ASDoc se ferme.
Flash Builder fournit la vue Hiérarchie d’appels qui affiche tous les appelants d’une fonction, d’une variable, d’une classe ou d’un identifiant d’interface ActionScript ou MXML sélectionné. La liste des appelants est hiérarchique. Vous pouvez afficher les appelants pour chaque référence trouvée. Vous pouvez également afficher le numéro de ligne et le code de ligne de chaque appelant. Double-cliquez sur l’appelant pour ouvrir le fichier source. Ce dernier met en évidence l’appel de fonction ou la référence. Vous pouvez modifier l’orientation des appelants affichés et spécifier la portée de la recherche.
1 En mode Source de l’éditeur MXML ou de l’éditeur ActionScript, placez le point d’insertion à l’intérieur d’une
2 Dans le menu Naviguer, sélectionnez Ouvrir la hiérarchie d’appels.
3 Dans la vue Hiérarchie d’appels, développez chaque appelant pour afficher la hiérarchie des appels. 4 Double-cliquez sur un appelant pour ouvrir le fichier source à l’origine de l’appel dans l’éditeur. L’appel est mis en
1 Affichez la hiérarchie d’appels d’un élément de langage. 2 Dans le menu Hiérarchie d’appels, sélectionnez Présentation.
3 Dans le menu Hiérarchie d’appels, sélectionnez Portée de la recherche.
Modification du code dans Flash Builder
Vous pouvez créer des gestionnaires d’événement pour les composants Flex en cliquant sur le bouton Générer le gestionnaire d’événement pour les événements répertoriés dans la vue Propriétés. Vous pouvez attribuer un nom au gestionnaire d’événement avant de le créer. Si vous ne le faites pas, Flash Builder crée un nom basé sur la propriété ID du composant. En l’absence de propriété ID, Flash Builder génère un nom unique dérivé du nom du composant. Génération d’un gestionnaire d’événement pour un composant 1 Dans la vue Création de l’éditeur de code, sélectionnez un composant. 2 Dans la vue Propriétés, sélectionnez la Vue par catégories, développez la liste des événements pour l’élément
3 (Facultatif) Saisissez un nom pour le gestionnaire d’événement dans le champ Valeur. 4 Cliquez sur le bouton Générer le gestionnaire d’événement.
Remarque : vous pouvez également utiliser le menu contextuel pour créer des gestionnaires pour les principaux événements d’un composant. Par exemple, le menu contextuel d’un composant Button comporte l’option Générer un gestionnaire Click. 5 Ajoutez le code pour l’implémentation du gestionnaire d’événement à la fonction de gestionnaire d’événement
Le Guide de référence du langage Adobe Flex est intégré aux éditeurs MXML et ActionScript, vous permettant ainsi de consulter rapidement l’Aide de référence pour une balise MXML ou pour une propriété, une classe ou tout autre élément de la structure Flex. Vous pouvez également utiliser l’Aide dynamique, ancrée à proximité de la perspective en cours d’utilisation. Elle affiche les rubriques de référence et d’utilisation portant sur la balise MXML ou la classe ActionScript sélectionnée. Affichage de l’Aide de la référence du langage 1 Dans l’éditeur MXML ou ActionScript, sélectionnez un élément (un mot du code) de la structure Flex en le mettant en surbrillance ou en plaçant le curseur de la souris à l’intérieur de l’élément (ou du mot). 2 Pour ouvrir la rubrique d’aide directement dans l’afficheur de l’Aide, appuyez sur les touches Maj+F2 ou
Activation de l’aide dynamique ❖ Sélectionnez Aide > Aide dynamique.
1 Dans l’éditeur, cliquez sur le symbole de réduction (-) ou sur celui de développement (+) dans la marge de gauche.
(+) pour visionner l’ensemble du bloc dans une info-bulle.
La vue Structure appartient à la perspective Développement Flash (voir « Perspective Développement Flash » à la page 8). Elle est donc disponible au cours de la modification du code et de la création de l’application. Cette vue permet d’examiner et de parcourir plus facilement la structure des documents MXML, ActionScript et CSS. Elle présente trois modes : le mode Classe, le mode MXML et le mode CSS. En mode Classe, cette vue affiche la structure du code (classes, variables des membres, fonctions, etc.). En mode MXML, elle affiche la structure MXML (balises, composants, contrôles, etc.). En mode CSS, elle affiche les sélecteurs CSS et les propriétés imbriquées qu’ils contiennent. La sélection d’un élément dans la vue Structure permet de le localiser et de le mettre en évidence dans l’éditeur, facilitant ainsi considérablement la navigation à l’intérieur du code.
Modification du code dans Flash Builder
Lorsque vous éditez un document ActionScript (ou un code ActionScript contenu dans un document MXML), la vue Structure affiche la structure du code. Cette structure comporte les instructions d’importation, les packages, les classes, les interfaces, les variables non contenues dans les fonctions et les fonctions. En revanche, elle ne contient aucune métadonnée, aucun commentaire, aucune déclaration d’espace de noms et aucun contenu de fonction.
éléments publics ; les icônes jaunes indiquent que l’élément n’a pas été défini comme étant privé ou public. Barre d’outils de la vue Structure en mode Classe En mode Classe, la barre d’outils de la vue Structure contient les commandes de tri et de filtrage, ainsi que l’illustre l’exemple suivant :
En mode MXML, chaque élément de la vue représente une balise MXML. Les types de balise affichés sont les suivants : les composants, les contrôles, les balises non visuelles (WebService ou State), les propriétés des composants exprimées sous forme de balises enfant (contraintes de présentation, par exemple) et les balises de compilateur (Model, Array et Script).
Modification du code dans Flash Builder
Barre d’outils de la vue Structure en mode MXML En mode MXML, la barre d’outils de la vue Structure contient des commandes supplémentaires permettant de basculer de la vue MXML à la vue des classes.
Vous pouvez ouvrir la vue Structure rapide à partir des éditeurs ActionScript et MXML pour afficher la vue Structure en mode Classe. La vue Structure rapide apparaît dans une fenêtre contextuelle à l’intérieur de l’éditeur et ne se présente donc pas sous forme de vue distincte. Elle permet de parcourir et d’examiner rapidement le code.
Structure rapide afin de limiter l’affichage aux éléments contenant les caractères saisis.
Modification du code dans Flash Builder
De même que dans la vue Structure, vous pouvez sélectionner un élément afin de le localiser et de le mettre en évidence dans l’éditeur. Ouverture de la vue Structure rapide ❖ Ouvrez un document ActionScript ou MXML dans l’éditeur. Dans le menu Naviguer, sélectionnez Structure rapide. Vous pouvez également utiliser le raccourci clavier Ctrl+O. Fermeture de la vue Structure rapide ❖ L’accès à tout emplacement situé en dehors de la vue Structure rapide conduit à la fermeture de cette dernière. Elle peut également être fermée en appuyant sur la touche Echap.
Quelle que soit la complexité des applications, les projets contiennent généralement de nombreuses ressources et lignes de code. Afin de parcourir et d’examiner plus facilement les différents éléments du code, vous pouvez ouvrir la source d’une définition de code externe à partir de l’emplacement, dans le code, auquel il y est fait référence. Si vous créez par exemple un composant MXML personnalisé et l’importez dans l’application MXML, vous pouvez sélectionner la référence au composant MXML et ouvrir le fichier source dans l’éditeur. Ouverture de la source d’une définition de code 1 Dans l’éditeur, sélectionnez la référence du code. 2 Dans le menu Naviguer, sélectionnez Accéder à la définition.
Le fichier source contenant la définition du code s’ouvre dans l’éditeur. Flash Builder prend également en charge la navigation dans le code par hyperliens. Ouverture de la source d’une définition de code en utilisant la navigation par hyperliens 1 Localisez la référence du code dans l’éditeur. 2 Appuyez sur la touche Ctrl (Windows) ou la touche Cmd (Mac OS) et maintenez-la enfoncée, puis positionnez le
3 Pour atteindre la référence du code, cliquez sur l’hyperlien.
La boîte de dialogue Ouvrir un type permet de parcourir toutes les classes disponibles (y compris les classes de la structure Flex) du projet. Dans la boîte de dialogue Ouvrir un type, sélectionnez une classe pour afficher l’implémentation.
Modification du code dans Flash Builder
Elle comporte une zone de texte permettant de filtrer les classes affichées en fonction du texte ou du joker qui y est saisi. La boîte de dialogue fait appel à différentes couleurs pour signaler les types recommandés et les types exclus. Les types recommandés sont affichés en gris. Les types exclus sont affichés en marron. Les types recommandés sont les classes disponibles dans l’espace de noms par défaut d’un projet. Dans certains contextes par exemple, seuls les composants Spark sont autorisés. D’autres contextes autorisent les composants Spark et les composants Halo. Les types exclus sont les classes qui ne sont pas disponibles dans l’espace de noms par défaut pour un projet. Ouverture de la boîte de dialogue Ouvrir un type • (Parcourir les classes) Pour parcourir les classes et visionner leur implémentation : 1 Dans le menu Flash Builder, sélectionnez Naviguer > Ouvrir un type. 2 (Facultatif) Saisissez du texte ou sélectionnez des filtres pour modifier les classes visibles dans la liste. 3 Sélectionnez une classe pour en afficher le code source.
1 Sélectionnez Fichier > Nouveau > Classe ActionScript. 2 En regard du champ Superclasse, cliquez sur Parcourir. 3 (Facultatif) Saisissez du texte ou sélectionnez des filtres pour modifier les classes visibles dans la liste. 4 Sélectionnez une classe de base dans la liste.
1 Cliquez sur Fichier > Nouveau > Composant MXML. 2 Dans la liste des projets de l’espace de travail, sélectionnez un projet pour un nouveau composant MXML et
Les composants de base disponibles varient en fonction des espaces de noms configurés pour un projet. 3 En regard du champ Basé sur, cliquez sur Parcourir.
Modification du code dans Flash Builder
4 (Facultatif) Saisissez du texte ou sélectionnez des filtres pour modifier les classes visibles dans la liste. 5 Sélectionnez un composant de base dans la liste.
Vous pouvez ajouter des numéros de ligne dans l’éditeur afin de faciliter la lecture et la consultation du code. ❖ Dans le menu contextuel de la marge de l’éditeur, sélectionnez Afficher les numéros de ligne.
Les éditeurs de Flash Builder offrent des fonctions accélérant la rédaction et le formatage du code, telles que l’ajout rapide de blocs de commentaires, la mise en retrait de blocs de code ainsi que la recherche et le remplacement de texte.
L’utilisation de l’assistant de contenu dans les éditeurs MXML et ActionScript conduit à l’importation automatique dans le document des packages dans lesquels les classes se situent. Les packages sont ajoutés dans l’ordre dans lequel ils ont été saisis dans le code. Les importations qui ne sont pas utilisées ou ne sont pas nécessaires sont automatiquement supprimées. Afin de faciliter l’organisation du code dans les documents ActionScript, vous pouvez trier les instructions d’importation par ordre alphabétique. Pour ce faire, ouvrez la boîte de dialogue Préférences, sélectionnez Flash Builder > Editeurs > Code ActionScript, puis Garder les importations organisées. Tri des instructions d’importation ❖ Dans l’éditeur, ouvrez un document ActionScript contenant les instructions d’importation. Dans le menu Source, sélectionnez Organiser les importations. Vous pouvez également utiliser le raccourci clavier suivant : Ctrl+Maj+ O (Windows) ou Commande+Maj+O (Mac).
Vous pouvez ajouter ou supprimer des commentaires en utilisant les options dans le menu Source ou en faisant appel aux raccourcis clavier. Vous pouvez ajouter les types de commentaires suivants :
• Commentaires de bloc pour ActionScript (/*
3 Appuyez sur Ctrl+/ (Windows) ou Cmd+/ (Mac OS) pour ajouter ou supprimer des commentaires de style C++. 2 Appuyez sur Ctrl+Maj+C (Windows) ou Cmd+Maj+C (Mac OS) pour ajouter un commentaire.
1 Dans l’éditeur, sélectionnez au moins une ligne de code MXML. 2 Appuyez sur Ctrl+Maj+D (Windows) ou Cmd+Maj+D (Mac OS) pour ajouter un commentaire.
L’éditeur met automatiquement en forme les lignes de code en cours de saisie, améliorant ainsi la lisibilité et facilitant la rédaction. Vous pouvez également utiliser la touche de tabulation pour mettre manuellement en retrait certaines lignes de code. Lorsque vous copiez et collez des blocs de code dans Flash Builder, ce dernier met automatiquement en retrait le code en fonction de vos préférences. Pour mettre en retrait un bloc de code en une seule opération, vous pouvez utiliser les commandes Décaler vers la droite et Décaler vers la gauche de l’éditeur. Déplacement d’un bloc de code vers la gauche ou vers la droite 1 Dans l’éditeur, sélectionnez un bloc de code. 2 Cliquez sur Source > Décaler vers la droite ou Source > Décaler vers la gauche. 3 Appuyez sur la touche de tabulation ou sur Maj et la touche de tabulation pour mettre en retrait ou annuler la mise
Définition des préférences de la mise en retrait 1 Ouvrez la boîte de dialogue Préférences et sélectionnez Flash Builder > Mise en retrait.
Modification du code dans Flash Builder
1 Ouvrez le document sur lequel la recherche doit porter. 2 Utilisez l’une des méthodes suivantes :
• Sélectionnez Editer > Rechercher/Remplacer. 3 Saisissez la chaîne de texte à localiser. 4 (Facultatif) Entrez la chaîne de texte de remplacement. 5 (Facultatif) Définissez les critères de recherche avancés. 6 Cliquez sur Rechercher, Remplacer, Remplacer tout ou Remplacer/Rechercher.
Remarque : pour procéder à une recherche incrémentielle, appuyez sur Ctrl+J (Windows) ou Cmd+J (Mac OS).
Flash Builder comporte des fonctions de recherche avancées plus puissantes que les fonctions de recherche/remplacement. Afin de faciliter la compréhension de la manière dont les fonctions, variables et autres identifiants sont utilisés, Flash Builder permet de rechercher et de repérer les références ou les déclarations vers les identifiants dans les fichiers ActionScript ou MXML, les projets ou les espaces de travail. La restructuration est utilisée pour apporter des modifications au code en renommant les identifiants suivants, puis en mettant à jour toute référence y renvoyant.
• Fonctions 2 Dans l’éditeur, cliquez sur un identifiant. Toutes les occurrences sont marquées en fonction des paramètres des
Pour modifier l’apparence des références marquées, sélectionnez Général > Editeurs > Editeurs de texte > Annotations. Pour plus d’informations sur les marqueurs, voir « A propos des marqueurs » à la page 122.
Modification du code dans Flash Builder
1 En mode Source, cliquez sur un identifiant dans l’éditeur. 2 Dans le menu principal, sélectionnez Rechercher > Références ou Rechercher > Déclarations. Sélectionnez ensuite
Restructuration du code 1 En mode Source, cliquez sur un identifiant dans l’éditeur. 2 Dans le menu principal, sélectionnez Source > Restructurer > Renommer. 3 Entrez un nouveau nom.
• Tous les fichiers doivent avoir été sauvegardés. • Les projets présentant des erreurs de génération provoquent l’affichage d’un avertissement. • Le nouveau nom doit se trouver dans l’étendue, déterminée par le type de l’élément et son emplacement. Les erreurs d’occultation de noms sont également signalées.
• La référence définie dans un fichier SWC doit comprendre une connexion de la source. 4 Pour vérifier la modification apportée, cliquez sur Aperçu pour visionner la source d’origine et la source
Modification du code dans Flash Builder
Flash Builder fait appel à des icônes et à des incrustations afin de fournir des repères visuels pour les éléments de langage. Les icônes sont visibles :
• dans la vue de débogage Variables ; • dans les indicateurs des blocs de code ActionScript ; • dans la vue ASDoc ; • dans la boîte de dialogue Ouvrir un type lors de la création ou de la sélection de classes.
Les marqueurs sont des raccourcis vers les lignes de code d’un document, vers un document ou vers un dossier. Ils représentent des tâches, des signets et des problèmes. Ils sont affichés et peuvent être gérés. La sélection de marqueurs provoque l’ouverture du document associé dans l’éditeur et met éventuellement en évidence la ligne concernée du code. Pour mettre à jour les marqueurs de problèmes dans Flash Builder, vous devez enregistrer le fichier. Seuls les fichiers auxquels l’application fait référence sont vérifiés. La syntaxe d’une classe isolée qui n’est pas utilisée dans le code n’est pas contrôlée. Le workbench génère automatiquement les marqueurs de tâches et de problèmes suivants. Vous pouvez ajouter des tâches et des signets manuellement. Tâches Les marqueurs de tâches représentent un élément de travail. Les éléments de travail sont générés
« Ajout de tâches » à la page 123. Erreurs Les marqueurs d’erreurs sont générés par le compilateur et signalent différents types d’états non valides. Par exemple, les erreurs de syntaxe et les avertissements générés par le compilateur sont affichés comme marqueurs dans la vue Erreurs. Pour plus d’informations, voir « Utilisation de la vue Erreurs » à la page 125. Signets Vous pouvez ajouter manuellement des signets à une ligne de code ou à une ressource (dossier ou document).
Remarque : les vues Tâches et Signets ne sont pas affichées par défaut dans la perspective Développement Flash. Pour plus d’informations sur l’affichage de ces vues, voir « Ouverture des vues » à la page 26.
Modification du code dans Flash Builder
Les marqueurs sont à la fois des descriptions et des liens vers des éléments des ressources d’un projet. Qu’ils soient générés automatiquement par le compilateur pour signaler des erreurs dans le code ou ajoutés manuellement pour repérer des tâches ou des fragments de code, les marqueurs sont affichés et gérés dans les vues associées. Les marqueurs d’un projet sont facilement repérables dans les vues Signets, Erreurs et Tâches, à partir desquelles ils sont accessibles. Accès à l’emplacement d’un marqueur ❖ Sélectionnez un marqueur dans les vues Signets, Erreurs ou Tâches. Le fichier contenant le marqueur est localisé et affiché dans l’éditeur. Si l’emplacement du marqueur est une ligne de code, cette dernière est mise en surbrillance.
Les tâches sont des éléments de l’espace de travail créés automatiquement ou manuellement. Toutes les tâches sont affichées et gérées dans la vue Tâches (Fenêtre > Autres vues > Généralités > Tâches), ainsi que l’illustre l’exemple suivant.
1 Ouvrez un fichier dans l’éditeur, puis repérez et sélectionnez la ligne de code à laquelle vous souhaitez ajouter une tâche. Vous pouvez également sélectionner une ressource dans l’Explorateur de packages. 2 Dans la vue Tâches, cliquez sur le bouton Ajouter une tâche dans la barre d’outils. 3 Entrez le nom de la tâche et sélectionnez une priorité (Elevée, Normale, Faible), puis cliquez sur OK.
Une fois achevée, une tâche peut être marquée comme ayant été terminée et peut éventuellement être supprimée de la vue Tâches. Définition d’une tâche comme étant terminée ❖ Dans la vue Tâches, sélectionnez une tâche de la colonne, ainsi que l’illustre l’exemple suivant.
❖ Dans la vue Tâches, accédez au menu contextuel d’une tâche et sélectionnez Supprimer.
Modification du code dans Flash Builder
❖ Dans la vue Tâches, accédez au menu contextuel et sélectionnez Supprimer les tâches terminées.
Les signets permettent de repérer et rechercher facilement des éléments au sein des projets. Tous les signets sont affichés et gérés dans la vue Signets (Fenêtre > Autres vues > Généralités > Signets), ainsi que l’illustre l’exemple suivant.
1 Ouvrez un fichier dans l’éditeur, puis localisez et sélectionnez la ligne de code à laquelle vous souhaitez ajouter un signet. 2 Dans le menu principal, sélectionnez Editer > Ajouter un signet. 3 Saisissez le nom du signet et cliquez sur OK.
Remarque : ainsi que vous pouvez le constater dans l’Explorateur de packages, la ressource ne signale pas qu’elle contient un marqueur. Vous pouvez visionner et gérer tous les signets dans la vue Signets. Suppression d’un signet 1 Dans la vue Signets, sélectionnez le signet à supprimer. 2 Cliquez sur le signet avec le bouton droit de la souris (Windows) ou en appuyant sur la touche Ctrl (Mac OS), puis
Le compilateur Flash Builder détecte les erreurs de syntaxe et les signale afin d’en permettre la correction en cours de rédaction, avant d’exécuter l’application. Les couleurs de la syntaxe peuvent être personnalisées. Lorsqu’une erreur de syntaxe est détectée dans le code, elle vous est signalée de l’une des manières suivantes.
Modification du code dans Flash Builder
Double-cliquez sur le message d’erreur pour localiser et mettre en évidence la ligne de code dans l’éditeur, ainsi que l’illustre l’exemple suivant.
❖ Ouvrez la boîte de dialogue Préférences et sélectionnez Flash Builder > Editeurs > Couleurs pour la syntaxe.
Préférences (voir Préférences > Général > Apparence > Couleurs et polices ; voir également Préférences > Général > Editeurs > Editeurs de texte).
Au fur et à mesure que vous saisissez et enregistrez du code, Flash Builder le compile en arrière-plan et affiche les erreurs de syntaxe et les avertissements (erreurs) dans la vue Erreurs. L’Explorateur de packages signale les nœuds contenant des erreurs. Chaque erreur ou avertissement contient un message, le fichier et le dossier correspondants ainsi que le numéro de la ligne dans le fichier. Les erreurs demeurent affichées dans la vue Erreurs jusqu’à ce que vous les corrigiez ou qu’elles soient résolues. Accès à la ligne de code correspondant à une erreur ou à un avertissement ❖ Dans la vue Erreurs, double-cliquez sur une erreur ou sélectionnez Aller à dans le menu contextuel de l’erreur. Flash Builder ouvre un éditeur dans lequel la ligne de code contenant l’erreur est mise en évidence.
Modification du code dans Flash Builder
Le tableau suivant contient une liste de raccourcis clavier utiles pour l’édition de code. Pour obtenir une liste complète des raccourcis clavier disponibles, voir « Accès aux raccourcis clavier » à la page 33. Pour plus d’informations sur la modification ou la création de raccourcis clavier, voir « Modification des raccourcis clavier » à la page 30. Nom
Ajoute une instruction CDATA au point d’insertion afin de vous permettre d’ajouter du code ActionScript à un document MXML. Déplace le curseur vers le crochet correspondant de l’instruction de code sélectionnée. Affiche les indicateurs de code. Pour plus d’informations, voir « Utilisation de l’assistant de contenu » à la page 108. Recherche les déclarations dans la base de code. Voir « Recherche de références et restructuration de code » à la page 118.
Signale chaque occurrence dans le code de l’élément sélectionné.
Modification du code dans Flash Builder
Structure rapide de l’éditeur » à la page 113.
Active/désactive la réduction des blocs de code. Voir « Configuration, réduction et développement de blocs de code » à la page 111.
Flash Builder vous permet de personnaliser les informations par défaut contenues dans les nouveaux fichiers MXML, ActionScript et CSS. Il peut s’agir par exemple des variables définissant l’auteur et la date, des variables pour les balises et les attributs d’ouverture et de fermeture ainsi que des variables pour différentes déclarations ActionScript, pour différents préfixes d’espace de noms et pour presque tout contenu que vous souhaitez inclure dans un modèle de fichier. Les modèles de fichier sont utiles notamment pour spécifier des commentaires d’introduction et des informations de copyright. Le contenu d’un nouveau fichier est spécifié dans un modèle de fichier accessible à partir de Préférences > Flash Builder > Modèles de fichier. Des modèles sont disponibles pour les types de fichier suivants.
3 Cliquez sur Editer et modifiez le modèle.
4 Cliquez sur OK pour enregistrer les modifications.
Exportation et importation de modèles de fichier 1 Sélectionnez Préférences > Flash Builder > Modèles de fichier. 2 Développez les types de fichier et sélectionnez un modèle. 3 Cliquez sur Exporter pour exporter le modèle vers un système de fichiers ou Importer pour importer un modèle
Les modèles sont exportés dans des fichiers XML.
Modification du code dans Flash Builder
Remarque : le bouton Restaurer les valeurs par défaut rétablit les valeurs par défaut de tous les modèles de fichier. Vous ne pouvez pas restaurer les valeurs par défaut d’un seul modèle. ❖ Pour restaurer les modèles par défaut, ouvrez la fenêtre Préférences > Flash Builder > Modèles de fichier et
Modification du code dans Flash Builder
Variables des modèles pour tous les types de fichiers Variable
Pour une application de bureau, ${application} s’étend à « WindowedApplication ».
Pour une nouvelle interface qui étend l’interface IButton, génère :
Vous pouvez également créer un composant MXML directement à partir de code. Pour plus d’informations, voir Simple MXML Components.
Les raisons à l’origine de la personnalisation des composants peuvent être multiples. Vous voulez par exemple simplement ajouter certaines fonctions à un composant existant ou créer un composant réutilisable, tel que par exemple une zone de recherche ou l’affichage d’un élément dans une grille de données. Peut-être souhaitez-vous rédiger un type de composant complètement nouveau, n’existant pas dans la structure Flex. Si le composant est créé principalement à partir de composants existants, l’utilisation de MXML en facilitera la définition. Toutefois, s’il s’agit d’un type de composant entièrement nouveau, il sera préférable de le définir en tant que composant ActionScript. Pour plus d’informations, voir « Création d’une classe ActionScript » à la page 67.
Flash Builder permet de créer des composants MXML personnalisés. 1 Cliquez sur Fichier > Nouveau > Composant MXML.
2 Spécifiez le dossier parent pour le fichier du composant personnalisé.
3 Spécifiez le nom de fichier du composant.
LoginBox. 4 Dans le champ Basé sur, sélectionnez le composant de base de votre composant personnalisé.
Sélectionnez Parcourir pour ouvrir la boîte de dialogue Ouvrir un type, puis choisissez un composant. Modifiez ou effacez le composant suggéré afin d’élargir la sélection dans la boîte de dialogue Ouvrir un type. Par exemple, spécifiez spark.components. avant de cliquer sur Parcourir. Vous pouvez filtrer la sélection dans la boîte de dialogue Ouvrir un type en fonction de vos besoins. Pour plus d’informations sur l’utilisation de la boîte de dialogue Ouvrir un type, voir « Recherche et affichage des classes » à la page 114. 5 (Facultatif) Si vous basez le composant sur un conteneur, vous avez la possibilité de définir la largeur et la hauteur
Vous pouvez saisir des valeurs fixes ou des pourcentages. Vous pouvez également vider les deux champs. Lorsque vous créez une occurrence du composant, vous pouvez remplacer la largeur et la hauteur du composant dans l’occurrence. Si vous saisissez des pourcentages ou ne spécifiez aucune valeur, vous avez la possibilité de visualiser un aperçu du composant à différentes tailles. Pour ce faire, utilisez la liste déroulante située dans la barre d’outils de la vue Création de l’éditeur MXML. Pour plus d’informations, voir « Création de composants visuels » à la page 135. 6 Cliquez sur Terminer.
Si vous avez enregistré le fichier dans le projet actif ou dans le chemin source correspondant, Flash Builder affiche également le composant dans la vue Composants pour permettre son insertion rapide dans les applications. Pour plus d’informations, voir « Ajout de composants en mode Création MXML » à la page 192. Remarque : la vue Composants ne répertorie que les composants personnalisés visibles (c’est-à-dire ceux ayant hérité de la classe UIComponent). Pour plus d’informations, voir le Guide de référence du langage Adobe Flex. 7 Créez un composant personnalisé.
Vous pouvez présenter un composant personnalisé visuellement dans l’éditeur MXML à l’instar d’un fichier d’application MXML. Tous les outils du mode Création sont disponibles. Vous pouvez par exemple ajouter des contrôles enfant à partir de la vue Composants et définir les propriétés dans la vue Propriétés. Pour plus d’informations, voir « Utilisation visuelle des composants » à la page 196. La taille du composant personnalisé dans la vue Création dépend des règles suivantes :
Création de composants MXML personnalisés
Vous pouvez documenter les composants personnalisés en ajoutant des commentaires ASDoc au code qui les implémente. Les commentaires ASDoc sont ensuite disponibles dans l’assistant de contenu des éditeurs MXML et ActionScript. Pour plus d’informations, voir « Utilisation de l’assistant de contenu » à la page 108. Ajoutez des commentaires ASDoc aux fichiers source ActionScript pour fournir la documentation de référence de l’API. Vous pouvez également ajouter des commentaires ASDoc à des éléments MXML du document. Voir ASDoc pour en savoir plus sur la création de commentaires ASDoc pour vos fichiers source.
Flash Builder représente tous les composants personnalisés visibles (c’est-à-dire tous ceux ayant hérité de UIComponent) dans la vue Création de l’éditeur MXML. Vous pouvez double-cliquer sur un composant personnalisé pour en ouvrir le fichier et le modifier. 1 Ouvrez un fichier MXML utilisant un composant personnalisé. 2 En mode Création, double-cliquez sur un composant personnalisé.
Vous pouvez également sélectionner Ouvrir le composant personnalisé dans le menu contextuel. 3 Modifiez le composant personnalisé.
Distribuez les composants personnalisés en créant des projets de bibliothèque. Pour plus d’informations, voir « Projets de bibliothèque » à la page 69.
Création de projets AIR avec Flash Builder Si vous ne l’avez pas déjà fait, téléchargez et installez l’exécution AIR. 1 Ouvrez Flash Builder. 2 Sélectionnez Fichier > Nouveau > Projet Flex. 3 Entrez le nom du projet. 4 Dans Flex, les applications AIR sont considérées comme un type d’application. Vous disposez de deux options : une
Sélectionnez Application de bureau comme type d’application. 5 Spécifiez si nécessaire la technologie de serveur à utiliser avec l’application AIR. En l’absence de technologie de
6 Sélectionnez le dossier dans lequel vous souhaitez créer l’application. Le dossier affiché par défaut est bin-debug.
7 Modifiez si nécessaire les chemins source et d’accès à la bibliothèque, puis cliquez sur Terminer pour créer le projet AIR.
Remarque : si vous importez un projet Catalyst à partir d’un fichier FXP, Flash Builder importe le projet avec le type d’application Web. Vous pouvez convertir le projet en type d’application de bureau (exécutée dans Adobe AIR).
Flash Builder prend entièrement en charge le débogage des applications AIR. Pour plus d’informations sur les possibilités de débogage de Flash Builder, voir « Débogage des applications » à la page 141. 1 Dans Flash Builder, ouvrez un fichier source pour l’application (un fichier MXML, par exemple). 2 Cliquez sur le bouton Déboguer situé dans la barre d’outils principale
Builder Une fois l’application achevée et prête à être distribuée (ou testée à partir du bureau), elle doit être mise en package dans un fichier AIR. La création de packages se compose des étapes suivantes :
• Affichage du code source (en présence de l’autorisation requise) et sélection des fichiers d’application à inclure • Sélection d’un fichier AIR générique ou d’un programme d’installation natif pour l’installation de l’application • Signature numérique de l’application AIR par un certificat commercial de signature de code ou par la création et l’application d’une signature autosignée
Mise en package d’une application AIR 1 Ouvrez le projet et vérifiez que l’application ne présente aucune erreur de compilation ni d’exécution. 2 Sélectionnez Projet > Exporter vers une version validée. 3 Si plusieurs projets et applications sont ouverts dans Flash Builder, sélectionnez le projet AIR à assembler. 4 Vous pouvez également sélectionner Activer l’affichage de la source pour permettre aux utilisateurs de visionner le
Important : pour les projets pour serveurs, vous pouvez sélectionner le dossier des services à l’exportation des fichiers source. L’exportation de fichiers implémentant des services a des implications en termes de sécurité. Ces fichiers peuvent donner accès à votre base de données, noms d’utilisateurs et mots de passe inclus. Voir Exportation des fichiers source avec version validée d’une application. 5 Sélectionnez l’option Exporter vers un fichier AIR ou l’option Exporter vers le programme d’installation natif.
L’option Exporter vers un fichier AIR crée un fichier de programme d’installation générique permettant l’installation de l’application sur les plates-formes Windows ou Mac OS X. L’option Exporter vers le programme d’installation natif crée un programme d’installation pour la plate-forme cible (Windows ou Mac OS X). 6 Vous avez également la possibilité de renommer le fichier AIR généré. Dès que vous êtes prêt à poursuivre, cliquez
Développement d’applications AIR avec Flash Builder
Les certificats numériques délivrés par des autorités de certification telles que VeriSign, Thawte, GlobalSign et ChosenSecurity valident votre identité d’éditeur auprès des utilisateurs et vérifient que le fichier d’installation n’a pas été modifié depuis sa signature. Les certificats numériques autosignés sont utilisés dans le même but, mais se distinguent par le fait qu’ils ne présentent aucune validation par un tiers. Vous pouvez également assembler l’application AIR sans signature numérique en créant un fichier AIR intermédiaire (.airi). La validité de ce type de fichier est limitée. Il ne peut en effet pas être installé. Il est utilisé dans les procédures de test (effectuées par les développeurs) et peut être lancé avec l’outil de ligne de commande AIR ADT. AIR destine cette fonctionnalité aux environnements de développement au sein desquels la signature est prise en charge par un développeur ou une équipe spécifique. Cette manière de procéder augmente le degré de sécurité de gestion des certificats numériques. Pour plus d’informations sur la signature des applications, voir Signature numérique d’un fichier AIR dans la documentation AIR. Signature numérique d’une application AIR Vous pouvez apposer une signature numérique sur une application AIR en sélectionnant le certificat numérique existant ou en créant un nouveau certificat autosigné. 1 Sélectionnez Projet > Exporter vers une version validée.
Cliquez sur Suivant. 2 Sélectionnez l’option Exporter et signer un fichier AIR avec un certificat numérique. 3 Si vous disposez déjà d’un certificat numérique, cliquez sur Parcourir pour y accéder, puis sélectionnez-le. 4 Pour créer un certificat numérique autosigné, cliquez sur Créer. 5 Spécifiez les informations requises et cliquez sur OK. 6 (Facultatif) Cliquez sur Suivant. Sélectionnez les fichiers de sortie qui devront être inclus dans le fichier AIRI
Par défaut, tous les fichiers sont inclus. 7 Cliquez sur Terminer pour créer le fichier AIR.
Vous pouvez créer un fichier AIRI intermédiaire et le signer ultérieurement. Utilisez cette option uniquement lorsque vous procédez à des tests. 1 Sélectionnez Projet > Exporter vers une version validée. Cliquez sur Suivant. 2 Sélectionnez l’option Exporter vers un fichier AIRI intermédiaire à signer ultérieurement. 3 (Facultatif) Cliquez sur Suivant. Sélectionnez les fichiers de sortie qui devront être inclus dans le fichier AIRI
2 Entrez un nom de projet. 3 Activez l’option Inclure les bibliothèques Adobe AIR, puis cliquez sur Suivant.
4 Modifiez si nécessaire le chemin de génération, puis cliquez sur Terminer. Pour plus d’informations sur la création
Débogage des applications Le débogage est similaire à l’exécution des applications. Il diffère toutefois par la possibilité de contrôler le code en cas d’arrêt de l’application, de surveiller des variables importantes ou de tester les corrections apportées au code. L’exécution et le débogage font appel à une configuration pour contrôler la manière dont les applications sont lancées. Le débogage d’une application consiste à exécuter la version déboguée du fichier d’application. Pour une présentation générale des outils de débogage disponibles dans la perspective de débogage Flash, voir « Perspective Débogage Flash » à la page 16. Dans certains cas, le programme vous invite à consulter le fichier journal Eclipse. Pour plus d’informations, voir « Erreurs d’environnement Eclipse dans le fichier journal » à la page 76.
Pour lancer une session de débogage, exécutez la configuration de lancement de l’application dans la perspective Débogage Flash. Débogage d’une application 1 Dans l’Explorateur de packages, sélectionnez le projet que vous souhaitez déboguer. 2 Cliquez sur le bouton Déboguer de la barre d’outils principale.
Déboguer. Si le projet n’a pas encore été généré, Adobe® Flash® Builder™ le génère et l’exécute en mode de débogage. 3 L’application est affichée dans le navigateur Web par défaut ou dans la version autonome de Flash Player. Vous
4 La perspective Débogage Flash est activée dans le workbench à chaque point d’arrêt rencontré.
L’action de la commande Déboguer de la version plug-in de Flash Builder est légèrement différente. Elle n’exécute pas le projet sélectionné, mais débogue la dernière configuration à avoir été lancée. Vous pouvez également sélectionner une configuration parmi la liste de celles qui ont été lancées en dernier.
Les points d’arrêt permettent d’interrompre l’exécution de l’application pour analyser le code et utiliser les outils de débogage Flash Builder afin de corriger les erreurs. Les points d’arrêt sont ajoutés dans l’éditeur de code et gérés dans la vue Points d’arrêt lorsque vous déboguez les applications. Ils sont placés au niveau des lignes de code exécutables. Le débogueur ne s’arrête qu’aux points d’arrêt situés sur les lignes présentant les éléments suivants :
• Toute ligne de code exécutable dans un fichier ActionScript Vous pouvez définir des points d’arrêt en cours de rédaction du code ou pendant le débogage. Positionnement d’un point d’arrêt dans l’éditeur de code 1 Ouvrez un fichier de projet contenant du code ActionScript. 2 Localisez la ligne de code sur laquelle vous souhaitez placer un point d’arrêt et double-cliquez sur la barre de repère
La barre de repère longe le côté gauche de l’éditeur de code. Un point d’arrêt est ajouté à la barre de repère ainsi qu’à la liste de la vue Points d’arrêt de la perspective Débogage Flash. A chaque fois que le débogueur rencontre un point d’arrêt, l’application est interrompue et la perspective Débogage Flash est affichée. La ligne de code est signalée par un point d’arrêt et mise en surbrillance dans l’éditeur de code. Les commandes de débogage vous permettent d’interagir avec le code (voir « Gestion de la session de débogage dans la vue Débogage » à la page 144). Suppression d’un point d’arrêt dans l’éditeur de code ❖ Dans la barre de repère, double-cliquez sur un point d’arrêt. Le point d’arrêt est supprimé de la barre de repère ainsi que de la vue Points d’arrêt de la perspective Débogage Flash. Les points d’arrêt sont gérés dans la vue Points d’arrêt. Vous pouvez supprimer un ou tous les points d’arrêt de la liste ou les désactiver, puis les réactiver ultérieurement (voir « Gestion des points d’arrêt dans la vue Points d’arrêt » à la page 143).
Vous pouvez spécifier les conditions régissant l’interruption de l’exécution du débogueur par les points d’arrêt. La définition d’un point d’arrêt conditionnel consiste à spécifier une expression ActionScript qui sera évaluée au cours de la session de débogage. Les points d’arrêt conditionnels stoppent l’exécution lorsque l’une des conditions suivantes est remplie :
• La valeur de l’expression change. • Le nombre d’occurrences spécifié a été atteint.
Débogage, test et surveillance des applications
1 Dans le menu contextuel d’un point d’arrêt, cliquez sur Propriétés du point d’arrêt. 2 Dans la boîte de dialogue qui s’ouvre, spécifiez les paramètres suivants :
Activez ou désactivez le point d’arrêt.
Sélectionnez l’option Activer la condition et saisissez une expression ActionScript à évaluer. Voir « Exemples d’expressions » à la page 147. Remarque : Flash Builder vérifie la syntaxe de l’expression et vous en signale les erreurs. La présence d’un opérateur d’affectation dans l’expression déclenche l’affichage d’un avertissement.
Spécifiez à quel moment l’exécution doit être stoppée : lorsque la condition a la valeur « true » ou lorsque la valeur de la condition change.
La vue Points d’arrêt vous permet de gérer les points d’arrêt au cours d’une session de débogage. Vous pouvez les supprimer, les désactiver et les activer ou les ignorer. Les commandes disponibles dans la barre d’outils de la vue Points d’arrêt sont les suivantes (de gauche à droite).
Ignorer tous les points d’arrêt
Débogage, test et surveillance des applications
Vous pouvez supprimer un seul, plusieurs ou tous les points d’arrêt de la vue en utilisant les commandes de la barre d’outils. ❖ Sélectionnez un ou plusieurs points d’arrêt dans la liste, puis cliquez sur Supprimer les points d’arrêt sélectionnés.
Suppression de tous les points d’arrêt de la vue Points d’arrêt ❖ Dans la vue Points d’arrêt, cliquez sur Supprimer tous les points d’arrêt.
La vue Débogage est le centre de contrôle de la perspective Débogage Flash. Elle permet de contrôler l’exécution d’une application, d’interrompre, de reprendre ou de terminer l’application ainsi que d’avancer d’un pas dans le code avec ou sans entrée. Les commandes disponibles dans la barre d’outils de la vue Débogage sont les suivantes (de gauche à droite).
Débogage, test et surveillance des applications
La vue Console affiche la sortie des instructions trace du code ActionScript ainsi que les rétroactions du débogueur (états, avertissements, erreurs, etc.). Les commandes disponibles dans la barre d’outils de la vue Console sont les suivantes (de gauche à droite). Bouton/commande
La vue Variables affiche les variables définies par le cadre de pile actuellement sélectionné (dans la vue Débogage). Les variables simples (nom et valeur) sont affichées sur une seule ligne. Les icônes affichées avec les variables fournissent des informations sur le type de la variable. Les variables complexes peuvent être développées pour en afficher les membres. La vue Variables permet de contrôler les variables en les ajoutant à la vue Expressions. Elle permet également de modifier la valeur des variables au cours de la session de débogage. Vous pouvez également y définir des points de contrôle (voir « Utilisation des points de contrôle » à la page 149). Tous les membres de super-classes sont groupés dans un nœud d’arborescence distinct. Par défaut, seuls les membres de la classe actuelle sont affichés. Cela permet de limiter le nombre de variables affichées dans la vue. Les commandes disponibles dans la barre d’outils de la vue Variables sont les suivantes (de gauche à droite).
Débogage, test et surveillance des applications
1 Sélectionnez la variable que vous souhaitez modifier. 2 Cliquez avec le bouton droit de la souris (Windows) ou en maintenant la touche Ctrl enfoncée (Mac OS) pour
3 Saisissez la nouvelle valeur et cliquez sur OK.
Les variables modifiées sont affichées en rouge.
❖ Pour localiser une variable ou un membre de variable dans la vue Variables, sélectionnez la vue, puis commencez
La vue Variables fait appel à des icônes et à des incrustations pour fournir des informations visuelles sur le type des variables affichées. Pour obtenir une liste des icônes avec leurs significations respectives, voir « Icônes représentant les éléments de langage » à la page 120.
Accédez à la vue Expressions pour contrôler les variables sélectionnées dans la vue Variables et pour ajouter et évaluer des expressions de contrôle en cours de débogage des applications. En cours de débogage, vous pouvez analyser et modifier la valeur des variables contrôlées. Vous pouvez également ajouter des expressions de contrôle. Il s’agit d’expressions de code évaluées à chaque interruption du débogage. Les expressions de contrôle sont utiles pour contrôler les variables susceptibles de dépasser l’étendue et de ne pas être visibles dans la vue lorsque vous avancez d’un pas avec entrée dans une fonction différente. Les commandes disponibles dans la barre d’outils de la vue Expressions sont les suivantes (de gauche à droite) :
Débogage, test et surveillance des applications
Le débogueur de Flash Builder prend en charge une large gamme d’expressions simples et complexes. Le tableau suivant répertorie des exemples d’expressions pouvant être évaluées en cours de session de débogage. Cette liste d’expressions prises en charge n’est pas exhaustive et est fournie uniquement à titre indicatif.
Débogage, test et surveillance des applications
• Les objets insérés ne sont pas pris en charge. • Le mot-clé super n’est pas pris en charge. • Les noms de classe complets ne sont pas pris en charge. Par exemple, vous ne pouvez pas évaluer mx.controls.Button. Vous pouvez faire référence au nom de classe non qualifié. Par exemple, vous pouvez spécifier que Button fait référence à mx.controls.Button. En présence d’un nom de classe ambigu (deux classes portant le même nom dans deux packages différents), il vous est impossible de contrôler quelle classe est évaluée. Vous pouvez cependant spécifier : getDefinitionByName("mx.controls.Button")
Débogage, test et surveillance des applications
Par exemple, vous ne pouvez pas évaluer myxml.(@id=='3')).
Au cours du débogage d’une application, vous pouvez définir des points de contrôle pour des occurrences spécifiques de variables. Ils auront pour tâche d’interrompre l’exécution à tout changement de valeur de la variable contrôlée. Les points de contrôle étant définis pour l’occurrence spécifique d’une variable, ils ne peuvent pas être placés dans l’éditeur de code. Ils sont donc définis à partir de la vue Variables au cours de la session de débogage. Pour la définition des points de contrôle, veillez aux points suivants :
• Vous ne pouvez pas définir des points de contrôle sur les getter, mais vous pouvez en définir sur les champs des getter. Par exemple, vous ne pouvez pas définir un point de contrôle sur width, mais vous pouvez en définir un sur _width.
{ ❖ Deux méthodes permettent de définir un point de contrôle au cours d’une session de débogage :
Débogage, test et surveillance des applications
La vue Variables affiche une icône représentant un crayon en regard de la variable pour laquelle un point de contrôle a été défini. Remarque : si vous tentez de définir un point de contrôle pour un getter, une boîte de dialogue s’ouvre. Elle suggère une variable valide pour le point d’arrêt. Si vous supprimez la variable suggérée, la boîte de dialogue répertorie toutes les variables valides de l’objet.
La commande Exécuter jusqu’à la ligne permet de quitter une boucle au cours d’une session de débogage. En cours de débogage, vous constaterez peut-être que le code est exécuté en boucle à plusieurs reprises. Pour quitter cette boucle, faites appel à la commande Exécuter jusqu’à la ligne située dans le menu Exécuter.
L’environnement de test FlexUnit permet de générer et de modifier des tests reproduisibles pouvant être exécutés à partir de scripts ou directement dans Flash Builder. Flash Builder prend en charge les structures « open source » FlexUnit 4 et FlexUnit 1. Procédez comme suit :
Les assistants de Flash Builder vous guident tout au long de la création de scripts et de suites de tests en générant du code stub pour les tests.
Vous pouvez exécuter des scripts et des suites de tests de différentes manières à partir de Flash Builder ou en dehors de l’environnement Flash Builder. Les résultats des tests sont affichés dans une application de test. Flash Builder ouvre la vue Résultat des tests unitaires FlexUnit permettant d’analyser l’exécution du test.
Dans le panneau Résultats des tests, double-cliquez sur un test pour en ouvrir l’implémentation. Le panneau Détails des tests ayant échoué répertorie la source et le numéro de la ligne correspondant à l’échec. S la source répertoriée se trouve dans l’espace de travail en cours d’utilisation, double-cliquez sur son nom pour accéder directement à l’échec.
Vous pouvez créer des classes de scripts de tests et des suites de scripts de tests unitaires FlexUnit pour les types de projets suivants :
• Projet ActionScript • Projet de bibliothèque Flex • Le dossier src d’un projet Flex pour la classe • Un package pour la classe • Les classes à tester • Les méthodes à tester pour chaque classe spécifiée Une suite de scripts de tests unitaires FlexUnit est une série de tests basés sur des classes de scripts déjà créées, des méthodes spécifiées dans ces classes et d’autres suites de scripts de tests.
Lors de la création d’une classe de scripts de tests unitaires FlexUnit, Flash Builder génère un fichier ActionScript pour la classe de scripts de tests et le place dans un package de scripts de tests. La procédure suivante part du principe que vous avez créé un projet Flash Builder, dans lequel vous souhaitez générer et exécuter des tests unitaires FlexUnit. 1 Sélectionnez le projet Flex, puis Nouveau > Classe de script de tests dans le menu contextuel.
2 Dans l’assistant de création d’une classe de script de tests, indiquez si vous souhaitez créer une classe de style
3 Attribuez-lui un nom. 4 (Facultatif) Spécifiez un dossier source et un package pour la classe de script de tests ou validez les paramètres par
Le dossier source par défaut est le dossier src du projet en cours. Le package par défaut est flexUnitTests, qui correspond au niveau supérieur de la structure de packages par défaut du projet. 5 (Facultatif) Activez la case Sélectionner la classe à tester et recherchez la classe voulue. Cliquez sur Suivant. 6 (Facultatif) Sélectionnez les méthodes que vous souhaitez tester. 7 Cliquez sur Terminer.
Cette procédure part du principe que vous avez déjà créé des classes de script de tests. 1 Sélectionnez le projet Flex, puis créez une suite de script de tests à partir des menus contextuels en sélectionnant
2 Dans l’assistant de création d’une classe de suite de tests, indiquez si vous souhaitez créer une classe de style
3 Nommez la suite de tests. 4 Recherchez ensuite, dans les suites et les scripts de tests, les classes et les méthodes à inclure dans la suite de tests.
Vous pouvez personnaliser les classes de suite et de script de tests FlexUnit par défaut créées par Flash Builder. Flash Builder fait appel à des modèles de fichiers pour créer les versions par défaut de ces fichiers.
Débogage, test et surveillance des applications
Modèles de fichier > FlexUnit. Les classes de suite et de script de tests FlexUnit 1 et FlexUnit 4 correspondent à des modèles distincts. Pour plus d’informations sur la modification des modèles de fichiers par défaut, voir « Personnalisation des modèles de fichier » à la page 127. Remarque : FlexUnitCompilerApplication.mxml et FlexUnitApplication.mxml dérivent du modèle pour applications MXML Web ou de bureau. Le modèle utilisé dépend de la configuration du projet Flex : pour une application Web (s’exécute dans Adobe® Flash® Player) ou une application de bureau (s’exécute dans Adobe AIR®).
Référence de langage « open source » pour FlexUnit Documentation « open source » pour FlexUnit SWF générés pour le test unitaire FlexUnit. Dans les deux cas, les résultats des tests s’affichent dans la vue Résultat des tests unitaires FlexUnit. Vous pouvez également configurer et enregistrer un test unitaire FlexUnit avant de l’exécuter. Par défaut, les tests FlexUnit sont exécutés dans la perspective Débogage Flash. Vous pouvez les lancer à partir des perspectives de développement et de profilage Flash. Dans ce cas, Flash Builder basculera toutefois vers la perspective de débogage à l’exécution du test. Vous pouvez modifier la perspective par défaut des tests FlexUnit. Ouvrez la fenêtre des préférences et accédez à Flash Builder > FlexUnit.
Lorsque vous créez un script de test FlexUnit, Flash Builder crée l’application de compilation FlexUnit suivante et une application FlexUnit :
• FlexUnitApplication.mxml Flash Builder utilise ces applications lors de la compilation et de l’exécution des tests FlexUnit. Flash Builder place les applications dans le répertoire src du projet. Cette application contient des références à tous les scripts et à toutes les suites de tests FlexUnit générés par Flash Builder. Ce dernier place tous les tests FlexUnit à l’intérieur des balises <fx:Declarations> de cette application. Vous ne serez généralement pas amené à éditer ou à modifier ce fichier directement. Actualisez l’application de compilation FlexUnit dans les circonstances suivantes :
Si vous créez une classe de script de tests sans utiliser l’assistant de création de script de tests, actualisez FlexUnitCompilerApplication.mxml. Placez le nouveau script de tests dans le package avec les autres scripts.
• Vous supprimez un script de tests.
Débogage, test et surveillance des applications
1 Si la vue Résultat des tests unitaires FlexUnit n’est pas ouverte, vous pouvez y accéder en sélectionnant Fenêtres >
Vous lancerez généralement l’exécution à partir du menu contextuel d’un projet ou d’un script de test individuel. Vous pouvez toutefois également lancer les tests en accédant au menu Exécuter, en cliquant sur le bouton Exécuter ou en sélectionnant le bouton Exécuter des tests unitaires FlexUnit dans la vue Résultat des tests unitaires FlexUnit. L’exécution à partir du menu Exécuter de Flash Builder entraîne l’ouverture d’une boîte de dialogue de configuration du test, dans laquelle vous pouvez sélectionner les classes de test et les méthodes à exécuter. Les scripts de tests pour les projets de bibliothèque ne peuvent pas être exécutés à partir du menu Exécuter de Flash Builder. Flash Builder fournit les raccourcis clavier suivants pour faciliter le lancement des tests FlexUnit :
Dans le menu Exécuter ou dans la liste déroulante du bouton Exécuter, sélectionnez Exécuter > Tests FlexUnit. 2 (Menu Exécuter de Flash Builder) Dans la boîte de dialogue Exécution d’une configuration de test unitaire
3 Visionnez les résultats des tests.
Une application s’ouvre pour afficher des informations sur les tests et en indiquer la fin. Le panneau Résultat des tests unitaires FlexUnit s’ouvre et affiche les résultats des tests. Voir « Affichage des résultats de l’exécution d’un test FlexUnit » à la page 154. Exécution de tests FlexUnit individuels : 1 Dans l’Explorateur de projets, accédez au package flexUnitTest :
2 Visionnez les résultats des tests.
Une application s’ouvre pour afficher des informations sur les tests et en indiquer la fin.
Débogage, test et surveillance des applications
Cette procédure part du principe que vous avez déjà exécuté un test unitaire FlexUnit dans Flash Builder et que Flash Builder est en cours d’exécution. 1 Copiez le fichier SWF généré pour un test du dossier bin-debug du projet vers un dossier situé en dehors de votre
Vous pouvez copier le fichier SWF généré automatiquement ou un fichier SWF provenant d’un test unitaire FlexUnit que vous avez précédemment enregistré et configuré. 2 Exécutez la copie du fichier SWF.
La vue Résultat des tests unitaires FlexUnit s’ouvre dans Flash Builder et affiche les résultats du test.
1 Ouvrez la boîte de dialogue Exécution d’une configuration de test unitaire FlexUnit.
• Dans la vue Résultat des tests unitaires FlexUnit, cliquez sur le bouton Exécuter des tests unitaires FlexUnit. Si cette vue n’est pas ouverte, vous pouvez y accéder en sélectionnant Fenêtre > Autres vues > Flash Builder > Résultat des tests unitaires FlexUnit. 2 Dans la boîte de dialogue Configuration de test, sélectionnez les scripts et les méthodes à enregistrer comme
Remarque : la boîte de dialogue Configuration de test n’est pas disponible si vous exécutez un test à partir du menu contextuel de l’Explorateur de packages. 3 (Facultatif) Sélectionnez Charger pour importer une configuration précédemment sauvegardée dans un fichier XML. 4 Cliquez sur Enregistrer.
Vous pouvez utiliser le fichier XML dans les scripts de génération pour exécuter le test. Vous pouvez générer un fichier SWF à partir du fichier MXML. Ce fichier SWF peut servir à effectuer des tests en dehors de l’environnement Flash Builder. Pour générer le fichier SWF, le fichier MXML est généralement copié dans le dossier src du projet.
Le panneau de la vue Résultat des tests unitaires FlexUnit affiche les résultats d’un test unitaire FlexUnit, en détaillant les échecs. Vous pouvez parcourir les résultats, filtrer l’affichage, écrire les résultats dans un fichier et charger les résultats à partir d’un fichier. Vous pouvez également relancer les tests, annuler un test en cours d’exécution et effacer les résultats de la vue. Si cette vue n’est pas ouverte, vous pouvez y accéder en sélectionnant Fenêtre > Autres vues > Flash Builder > Résultat des tests unitaires FlexUnit.
Débogage, test et surveillance des applications
Ce panneau répertorie tous les tests de la série, en indiquant si le test a échoué ou réussi. Double-cliquez sur un test de la liste pour y accéder dans l’éditeur ActionScript.
Sélectionnez un test dans le panneau Résultats des tests pour afficher les détails de l’échec. Chaque détail indique le fichier source et la méthode, y compris le numéro de la ligne correspondant à l’échec. Si le fichier source appartient à l’espace de travail, double-cliquez dans la liste pour accéder à l’échec dans l’éditeur ActionScript.
Le menu de la vue Résultat des tests unitaires FlexUnit donne accès aux fonctions suivantes.
Masquage du panneau Détails des tests ayant échoué. Limitation de l’affichage aux tests ayant échoué
• Annulation d’un test en cours d’exécution • Enregistrement des résultats ou de la configuration d’un test • Chargement des résultats précédemment enregistrés dans un fichier • Suppression des résultats du panneau • Réexécution du test actuel. Vous pouvez choisir : • d’exécuter tous les tests ; • d’exécuter uniquement les échecs ; • d’exécuter le test sélectionné. • Actualisation de la configuration FlexUnit Si vous avez modifié un test ou avez ajouté ou supprimé des tests, cliquez sur le bouton d’actualisation pour charger la nouvelle configuration FlexUnit.
Utilisez le bouton Exécuter des tests unitaires FlexUnit pour configurer et exécuter des tests FlexUnit.
Le Moniteur de réseau est un outil ingénieux permettant de surveiller et de déboguer les applications accédant aux services de données. Le Moniteur de réseau permet d’analyser les données transmises entre une application et un service de données. Il examine également les données XML, AMF et JSON envoyées avec les protocoles SOAP, AMF, HTTP et HTTPS. Le Moniteur de réseau est disponible dans les vues Flash de développement et de débogage.
Débogage, test et surveillance des applications
Le Moniteur de réseau peut être activé individuellement pour chaque projet Flex. L’état du moniteur (activé ou désactivé) s’applique à toutes les applications de ce projet. Il est impossible d’activer ou de désactiver le Moniteur de réseau pour des applications individuelles. Par défaut, le Moniteur de réseau n’est pas activé. Activez le Moniteur de réseau en sélectionnant l’icône Activer le moniteur dans la barre d’outils de la vue du Moniteur. Activation du Moniteur de réseau Pour effectuer cette procédure, vous devez vous trouvez dans la perspective de développement ou de débogage Flash. 1 Si la vue Moniteur de réseau n’est pas ouverte, sélectionnez Fenêtre dans le menu Flash Builder, puis Autres vues >
2 Si le Moniteur de réseau n’est pas activé, cliquez sur l’icône Activer le moniteur dans la barre d’outils de la vue
Cette icône permet de l’activer et de le désactiver.
Pour surveiller l’application, activez le Moniteur de réseau et exécutez la version de développement ou de débogage de l’application. En général, le Moniteur de réseau capture et stocke toutes les données d’événements jusqu’à ce que vous quittiez l’application ou effaciez les données de manière explicite. Les événements s’affichent dans l’ordre chronologique.
1 Exécutez la version de développement ou de débogage de l’application qui accède aux services distants. 2 Pour chaque accès à un service distant, le Moniteur de réseau répertorie les éléments suivants :
• Service • Demande d’un service • Heure de la réponse • Temps écoulé 3 Sélectionnez un en-tête de colonne pour trier les données renvoyées en fonction des valeurs de ladite colonne.
4 Sélectionnez les onglets de requête et de paramètres situés au bas du moniteur pour afficher les détails de
Les données envoyées dans la requête, ainsi que les autres informations concernant la requête, peuvent être visualisées à partir de ces onglets. 5 Sélectionnez les onglets de réponse et de résultats situés au bas du moniteur pour afficher les détails de la réponse.
6 Double-cliquez sur une entrée pour accéder au code source de l’opération.
Débogage, test et surveillance des applications
Certains événements toutefois sont déclenchés en dehors de la portée du Moniteur de réseau. Dans ce cas, le Moniteur ne trouvera pas le code source Flex. 7 Cliquez sur le bouton Enregistrer de la barre d’outils du Moniteur de réseau pour inscrire toutes les informations
Remarque : utilisez le fichier XML généré pour étudier les données hors ligne. Il est impossible d’importer des données de ce fichier vers le Moniteur de réseau. 8 Cliquez sur l’icône Effacer dans la barre d’outils du Moniteur de réseau pour en supprimer toutes les informations.
Vous pouvez interrompre, puis reprendre, la surveillance du réseau. L’interruption et la reprise d’une session s’appliquent à toutes les applications du projet Flex. Par exemple, il est impossible d’interrompre l’application d’un projet et de continuer la surveillance d’une autre. 1 Cliquez sur le bouton Interrompre dans la barre d’outils du Moniteur de réseau pour interrompre la surveillance
2 Cliquez sur le bouton Reprendre pour continuer la surveillance de la session.
Pour arrêter la surveillance d’une session, désactivez le Moniteur de réseau. 1 (Facultatif) Fermez le Moniteur de réseau.
2 Cliquez sur le bouton Activer le moniteur.
Remarque : la désactivation du Moniteur de réseau s’applique à toutes les applications du projet Flex.
Pour surveiller les appels passés par protocole HTTPS, modifiez la préférence par défaut du Moniteur de réseau en activant l’option Ignorer les vérifications de sécurité SSL. Ouvrez la boîte de dialogue Préférences et accédez à Flash Builder > Moniteur de réseau.
Le volet de gauche du Moniteur de réseau fournit des informations sur la source des données. Il affiche les informations suivantes :
• Le type de service affiché : Par exemple RemoteService, HTTPService ou WebService.
• Le nom de l’opération appelée à partir du service de données
Débogage, test et surveillance des applications
Les données des demandes et réponses peuvent être visionnées en structure arborescente, dans une vue brute ou en affichage hexadécimal. Passez d’un affichage à l’autre en sélectionnant l’icône correspondante.
Affiche les données XML, JSON et AMF en structure arborescente. L’arborescence est la vue par défaut.
Vous pouvez enregistrer les données du Moniteur de réseau dans un fichier XML. Pour ce faire, cliquez sur le bouton Enregistrer de la vue Moniteur de réseau.
Vous pouvez surveiller plusieurs applications en même temps. Il existe deux scénarios possibles pour surveiller plusieurs applications :
Vous pouvez uniquement disposer d’un Moniteur de réseau par projet Flex. Lors de la surveillance de plusieurs applications d’un même projet, les événements de toutes les applications s’affichent dans le moniteur en fonction de l’heure à laquelle ils surviennent. Le moniteur ne permet pas de filtrer les événements selon une application spécifique.
Vous pouvez ouvrir un Moniteur de réseau pour chaque projet Flex actif. Chaque Moniteur de réseau est indépendant : il affiche uniquement les événements de son projet spécifique. L’interruption ou la désactivation d’un Moniteur de réseau dans un projet ne s’applique pas aux moniteurs d’autres projets.
La surveillance des données du réseau présente les deux restrictions suivantes :
ActionScript ou de bibliothèque.
Le profileur d’Adobe® Flex® d’Adobe Flash® Builder™ vous permet d’identifier les goulets d’étranglement des performances et les fuites de mémoire des applications avec lesquelles vous interagissez. Il est disponible uniquement avec Flash Builder Premium.
Le profileur d’Adobe Flex détecte tout ralentissement des performances ainsi que les fuites de mémoire de vos applications. Le profileur est lancé à partir d’Adobe Flash Builder. Il enregistre les données concernant l’état de l’application avec laquelle vous interagissez, notamment le nombre d’objets, leur taille, le nombre d’appels de méthode et le temps passé dans ces appels. Le profilage d’une application peut vous aider à comprendre les éléments suivants. Fréquence des appels Vous pouvez dans certains cas vous rendre compte que certaines méthodes faisant appel à un
Durée de la méthode Le profileur peut vous indiquer le temps passé dans une méthode particulière, ou, si la méthode
Piles d’appels En suivant la pile d’appels d’une méthode, vous pouvez voir l’intégralité du chemin que poursuit
Nombre d’occurrences (allocation d’objet) Si vous constatez que le même objet est créé plusieurs fois alors que seul un nombre spécifique d’occurrences est requis, vous pouvez envisager de mettre en œuvre un patron Singleton, pour autant que vous n’ayez vraiment besoin que d’un seul de ces objets. Vous pouvez également appliquer d’autres techniques visant à réduire l’allocation excessive d’objets. Si le nombre d’objets est important, mais nécessaire, vous pouvez optimiser l’objet même afin de réduire sa ressource Agrégat et l’utilisation qu’il fait de la mémoire. Taille de l’objet Si vous remarquez que certains objets sont de taille disproportionnée, vous pouvez tenter de les optimiser pour réduire leur encombrement mémoire. Cette opération s’avère particulièrement utile si vous optimisez des objets créés de nombreuses fois dans l’application. Récupération de place Lors de la comparaison d’instantanés de profilage, vous pouvez vous rendre compte que certains objets qui ne sont plus requis par l’application restent stockés dans la mémoire. Pour prévenir ces fuites de mémoire, vous pouvez ajouter une logique qui supprime toute référence restante à ces objets.
Avant de faire appel au profileur, vous devez décider du type de profilage que vous allez effectuer : profilage des performances ou profilage de la mémoire. Le profilage des performances est le processus de recherche des méthodes de l’application qui s’exécutent lentement et qui peuvent être améliorées. Une fois identifiées, ces zones à problèmes peuvent être optimisées pour accélérer l’exécution de l’application et pour que celle-ci réponde plus rapidement aux interactions de la part de l’utilisateur. Lors du profilage des performances, vous cherchez généralement deux choses : une méthode appelée une seule fois mais qui met plus de temps à s’exécuter que des méthodes similaires, ou une méthode qui ne met pas autant de temps à s’exécuter, mais qui est appelée de nombreuses fois. Les données de profilage des performances permettent d’identifier les méthodes que vous optimisez par la suite. Vous trouverez peut-être que le fait de réduire le nombre d’appels à une méthode est plus efficace que la restructuration du code au sein de la méthode. Le profilage de la mémoire est l’examen de la quantité de mémoire qu’utilise chaque objet ou type d’objet de l’application. Les données de profilage de la mémoire s’utilisent de diverses façons : pour voir si des objets sont plus volumineux que nécessaire, pour voir si trop d’objets d’un même type existent et pour identifier des objets qui ne sont pas nettoyés dans la mémoire (fuites de mémoire). Grâce aux données de profilage de la mémoire, vous pouvez tenter de réduire la taille des objets, le nombre des objets créés ou permettre le nettoyage des objets dans la mémoire en supprimant les références à ces objets. Le profilage de la mémoire peut ralentir les performances de l’application car il fait appel à une plus grande quantité de mémoire que le profilage des performances. N’effectuez le profilage de la mémoire que lorsque cela s’avère nécessaire. Il convient souvent d’effectuer à la fois un profilage des performances et un profilage de la mémoire pour trouver la source des problèmes de performances. Le profilage des performances permet d’identifier les méthodes qui entraînent une allocation de mémoire excessive et un allongement des temps d’exécution. Vous pouvez ensuite recourir au profilage de la mémoire afin d’identifier les fuites de mémoire dans ces méthodes. Lorsque vous savez le type de profilage que vous allez effectuer, vous pouvez démarrer le profileur.
Le profileur seul n’améliore ni la taille, ni la vitesse, ni les performances perçues d’une application. Après avoir utilisé le profileur pour identifier les méthodes et classes qui posent problèmes, consultez les ressources suivantes dans la documentation Flex, qui vous aideront à améliorer l’application :
En analysant les données d’échantillonnage, le profileur peut afficher toutes les opérations effectuées dans l’application et enregistrer leur délai d’exécution. Il consigne également l’utilisation de la mémoire et les traces de pile et affiche les données dans une série de vues, ou panneaux. Les appels de méthode sont classés par durée d’exécution et nombre d’appels, ainsi que par nombre d’objets créés dans la méthode. Le profileur calcule également les valeurs cumulées des données. Par exemple, si vous consultez des statistiques liées aux méthodes, les données cumulées comprennent le temps et la mémoire alloués au cours de cette méthode, ainsi que le temps et la mémoire alloués au cours de toutes les méthodes appelées à partir de cette méthode. Vous pouvez effectuer une analyse plus poussée des appels de méthode suivants, jusqu’à trouver la source des problèmes de performances.
Le profileur utilise les API ActionScript définies dans le packageflash.sampler.*. Ce package contient les classes Sample, StackFrame, NewObjectSample et DeleteObjectSample. Vous pouvez faire appel aux méthodes et aux classes contenues dans ce package pour écrire votre propre application de profileur ou pour inclure un sous-ensemble de fonctionnalités de profilage dans vos applications. Outre les classes du package flash.sampler.*, le profileur utilise les méthodes contenues dans la classe System.
Le profileur enregistre généralement des données sur les méthodes de la classe dont l’exécution était en cours au moment de l’instantané d’échantillonnage. Il arrive toutefois que le profileur enregistre également des actions internes de Flash Player. Ces actions, consignées entre crochets, sont notamment [keyboardEvent], [mark] et [sweep]. Par exemple, si [keyboardEvent] se trouve dans la liste des méthodes avec une valeur de 100, vous savez que le lecteur a effectué une action interne liée à cet événement au moins 100 fois au cours de la période d’interaction. Le tableau suivant décrit les actions internes de Flash Player qui apparaissent dans les données de profilage. Action
Utilisation du profileur Le profileur nécessite Flash Player version 9.0.124 ou une version ultérieure. Vous pouvez profiler des applications qui ont été compilées pour Flex 2, Flex 2.0.1 et Flex 3. Vous pouvez utiliser le profileur pour profiler des applications ActionScript 3.0 créées avec Flash Authoring, ainsi que des applications de bureau exécutées sur Adobe® AIR™. Le profileur a besoin d’informations de débogage dans l’application que vous êtes en train de profiler. Lorsque vous compilez une application et que vous lancez le profileur, Flash Builder inclut par défaut les informations de débogage dans l’application. Vous pouvez inclure explicitement les informations de débogage dans n’importe quelle application en définissant l’option débug du compilateur sur true. Si vous exportez une application par le biais de l’option Exporter vers une version validée, l’application ne contient aucune information de débogage.
Vous pouvez profiler des applications que vous êtes en train de créer dans Flash Builder. Flash Builder inclut des informations de débogage lors de la compilation et de l’exécution d’une application lors d’une session de débogage. Vous pouvez également profiler dans Flash Builder des applications externes que vous n’êtes pas en train de développer, mais dont le fichier SWF est disponible avec une URL ou dans le système de fichiers. Le fichier SWF d’une application doit contenir des informations de débogage pour que vous puissiez la profiler. Pour plus d’informations, voir « Profilage d’applications externes » à la page 167.
1 Fermez toutes les occurrences du navigateur. 2 Ouvrez l’application dans Flash Builder. 3 Cliquez sur le bouton Profiler nom_application dans la barre d’outils principale. Flash Builder vous informe que
4 Cliquez sur le bouton OK. Flash Builder compile l’application et la lance dans une fenêtre de navigateur distincte.
Profilage des applications Flex
Le tableau suivant présente les options disponibles. Paramètre
Vous ne pouvez pas modifier cette valeur. Vous pouvez toutefois profiler une application s’exécutant sur un ordinateur distinct. Voir « Profilage d’applications externes » à la page 167.
Utilisez cette option pour détecter des fuites de mémoire ou un nombre excessif de créations d’objets. Si vous êtes en train d’effectuer le profilage des performances, vous pouvez désélectionner cette option. L’option Activer le profilage de la mémoire est sélectionnée par défaut.
L’option Surveiller les données de mémoire active est sélectionnée par défaut.
L’option Générer des traces de pile d’allocation d’objets est désactivée par défaut. Elle doit être activée pour pouvoir afficher les informations liées au suivi des allocations dans la vue Références de l’objet ou Suivi des allocations.
Si vous êtes en train d’effectuer le profilage de la mémoire, vous pouvez désélectionner cette option. L’option Activer le profilage des performances est sélectionnée par défaut.
6 Vous pouvez maintenant commencer à interagir avec l’application et à examiner les données du profileur.
Profilage des applications Flex
Une fois que vous avez démarré le profileur, vous pouvez interrompre et redémarrer les applications dans la vue Profiler. Sélectionnez une application puis sélectionnez l’action à effectuer sur cette application. L’exemple suivant illustre la vue Profiler avec plusieurs applications. Une application est en cours d’exécution ; toutes les autres sont fermées.
1 Sélectionnez l’application dans la vue Profiler. 2 Cliquez sur le bouton Arrêter pour mettre fin à la session de profilage. Cette opération ne ferme pas le navigateur
3 Pour retourner à la perspective Développement Flex, sélectionnez Développement Flex dans la liste déroulante de
Le tableau suivant présente les boutons de la barre d’outils du profileur. Bouton
Pour plus d’informations sur la récupération de place, voir « A propos de la récupération de place » à la page 182. Prendre un instantané de Enregistre l’utilisation que fait une application de la mémoire pour que la mémoire vous puissiez la consulter ou la comparer à d’autres instantanés. Cette option est active uniquement si le nom d’une application est sélectionné, que celle-ci est en cours d’exécution et si vous sélectionnez Activer le profilage de la mémoire dans la boîte de dialogue de lancement. Le profileur ajoute de nouveaux instantanés de la mémoire en tant qu’enfants de l’application sélectionnée dans la vue Profiler. Pour ouvrir le nouvel instantané de mémoire dans la vue Instantané de la mémoire, double-cliquez sur l’entrée d’instantané de la mémoire. La récupération de place se fait implicitement avant l’enregistrement d’instantanés de la mémoire. En d’autres termes, un clic sur le bouton Prendre un instantané de la mémoire équivaut à un clic sur le bouton Lancer la récupération de place puis à un clic sur le bouton Prendre un instantané de la mémoire. Pour plus d’informations sur l’utilisation des instantanés de mémoire, voir « Utilisation de la vue Instantané de la mémoire » à la page 171.
Cette option est active uniquement si deux instantanés de mémoire sont sélectionnés et que l’option Activer le profilage de la mémoire est sélectionnée dans la boîte de dialogue de lancement. Pour plus d’informations sur la vue Objets vagabonds, voir « Utilisation de la vue Objets vagabonds » à la page 180.
Suivi des allocations. Cette option est active uniquement si deux instantanés de mémoire sont sélectionnés et que l’option Activer le profilage de la mémoire est sélectionnée dans la boîte de dialogue de lancement. Pour plus d’informations sur la vue Suivi des allocations, voir « Utilisation de la vue Suivi des allocations » à la page 173.
Cette option est active uniquement si le nom d’une application est sélectionné, que celle-ci est en cours d’exécution, et si vous sélectionnez Activer le profilage de la mémoire dans la boîte de dialogue de lancement. Généralement, vous cliquez sur ce bouton, vous interagissez avec l’application, puis vous cliquez sur le bouton Capturer le profil de performance pour obtenir un instantané des performances de l’application à partir du moment où vous réinitialisez les données. Pour plus d’informations sur la vue Profil de performance, voir « Utilisation de la vue Profil de performance » à la page 176.
Cette option est active uniquement si le nom d’une application est sélectionné, que celle-ci est en cours d’exécution, et si vous sélectionnez Activer le profilage de la mémoire dans la boîte de dialogue de lancement. Pour ouvrir la vue Profil de performance, double-cliquez sur l’entrée d’instantané des performances. Pour plus d’informations sur la vue Profil de performance, voir « Utilisation de la vue Profil de performance » à la page 176.
Cette option est activée uniquement si un instantané de performances ou de mémoire est sélectionné.
L’option Enregistrer est également disponible à partir du menu de la vue Profiler. Cette option est active uniquement si le nom d’une application est sélectionné.
Affiche la méthode sélectionnée.
Enregistrement et chargement des données de profilage Une fois le profileur exécuté, vous pouvez enregistrer les données afin de comparer un instantané de la session de profilage en cours avec un instantané pris après avoir apporté des modifications au code. Vous pouvez ainsi déterminer si vous avez identifié les causes responsables des problèmes et si les modifications apportées améliorent les performances et l’utilisation de la mémoire par l’application. Lors de l’enregistrement des données de profilage, vous enregistrez toutes les données de l’application dans ce profil, à savoir tous les profils de performance, les instantanés de la mémoire et le suivi des allocations. Flash Builder enregistre ces informations dans un groupe de fichiers binaires à l’emplacement que vous spécifiez. Enregistrement des données de profilage 1 Sélectionnez l’application dans la vue Profiler. 2 Ouvrez la liste déroulante dans la vue Profiler et sélectionnez Enregistrer. La boîte de dialogue Rechercher un
3 Choisissez un emplacement pour enregistrer les données de profil et cliquez sur OK. Vous devez créer un dossier
Récupération des données de profilage enregistrées 1 Sélectionnez la vue Données de profilage enregistrées. 2 Cliquez sur le bouton Ouvrir. La boîte de dialogue Rechercher un dossier apparaît. 3 Recherchez le dossier contenant les données de profilage de l’application, puis cliquez sur OK. Flash Builder affiche
Vous ne pouvez pas supprimer les données d’application enregistrées depuis Flash Builder. Suppression des données de profilage 1 Sélectionnez l’instantané de l’application dans la vue Profiler. 2 Cliquez sur le bouton Supprimer.
Profilage des applications Flex
Vous pouvez définir certaines préférences du profileur de manière telle à ce que les paramètres s’appliquent à toutes les sessions de profilage. Ces paramètres vous permettent de définir le Flash Player/navigateur dans lequel vous profilez l’application, ainsi que les filtres par défaut et le numéro de port sur lequel l’application est disponible, si l’application profilée s’exécute sur un serveur. Définition des préférences de Flash Builder pour plusieurs sessions de profilage ❖ Ouvrez la boîte de dialogue Préférences et sélectionnez Flash Builder > Profileur. Sélectionnez les options du menu Profileur pour y accéder. Le tableau suivant répertorie les préférences que vous pouvez définir. Option de menu
L’exécution des applications dans la version autonome de Flash Player peut produire des résultats inattendus, plus particulièrement si l’application utilise des services distants ou des appels réseau. Profilage d’une application externe 1 Placez-vous dans la perspective Profil Flash. 2 Sélectionnez Profiler > Profiler une application externe. La boîte de dialogue Profiler une application externe
3 Sélectionnez l’option (par défaut) Lancer l’application sélectionnée puis cliquez sur le bouton Nouveau. La boîte de 5 Cliquez sur le bouton Lancer. Si vous avez indiqué une URL comme emplacement de l’application, Flash Builder
Si vous avez spécifié un fichier SWF qui a été compilé sans informations de débogage, Flash Builder retourne une erreur. Recompilez l’application avec l’option debug du compilateur définie sur true, puis relancez-la.
Le profileur Flex se compose de plusieurs vues (ou panneaux) présentant de différentes manières les données de profilage. Le tableau suivant présente chacune de ces vues. Vue
Données de profilage enregistrées
Pour plus d’informations, voir « Enregistrement et chargement des données de profilage » à la page 166.
Pour plus d’informations, voir « Affichage des informations dans la vue Objets actifs » à la page 169.
Objets actifs, mise à jour en continu. La vue Instantané de la mémoire affiche le nombre d’objets référencés et utilisés dans l’application et la quantité de mémoire que chaque type d’objets utilisait à ce moment-là. Deux instantanés de la mémoire pris à des moments différents sont comparés en vue de déterminer les fuites de mémoire qui existent entre les deux moments. Vous pouvez afficher la vue Instantané de la mémoire en cliquant sur le bouton Prendre un instantané de la mémoire puis en double-cliquant sur l’instantané de mémoire dans la vue Profiler. Pour plus d’informations, voir « Utilisation de la vue Instantané de la mémoire » à la page 171. Objets vagabonds
Vous pouvez afficher la vue Objets vagabonds en sélectionnant deux instantanés de mémoire et en cliquant sur le bouton Objets vagabonds. Pour plus d’informations, voir « Utilisation de la vue Objets vagabonds » à la page 180.
Profilage des applications Flex
Pour plus d’informations, voir « Utilisation de la vue Suivi des allocations » à la page 173.
Vous pouvez afficher la vue Références de l’objet en double-cliquant sur le nom d’une classe dans la vue Instantané de la mémoire ou Objets vagabonds. Pour plus d’informations, voir « Utilisation de la vue Références de l’objet » à la page 172.
Vous pouvez afficher la vue Statistiques de l’objet en double-cliquant sur une entrée de la vue Suivi des allocations. Pour plus d’informations, voir « Utilisation de la vue Statistiques de l’objet » à la page 175.
Cliquez ensuite sur le nom d’une méthode dans la table pour ouvrir la vue Statistiques de la méthode, qui vous permet de détecter les goulets d’étranglement des performances. Vous pouvez afficher la vue Profil de performance en double-cliquant sur l’un des instantanés des performances dans la vue Profiler. Pour plus d’informations, voir « Utilisation de la vue Profil de performance » à la page 176.
Vous pouvez afficher la vue Statistiques de la méthode en double-cliquant sur une ligne de la vue Profil de performance ou en y sélectionnant une méthode et en cliquant sur le bouton Ouvrir les statistiques de la méthode. Pour plus d’informations, voir « Identification des caractéristiques des performances des méthodes » à la page 178.
Pour plus d’informations, voir « Utilisation du graphique Utilisation de la mémoire » à la page 181.
La vue Objets actifs affiche des informations concernant les classes utilisées par l’application en cours. Cette vue montre les classes qui sont instanciées, le nombre créé, combien se trouvent dans la mémoire et la quantité de mémoire que les objets actifs occupent. Le profileur met à jour en continu les données dans la vue Objets actifs à mesure que vous profilez l’application. Vous n’avez pas besoin d’actualiser la vue ou de garder le focus dessus pour mettre à jour les données. Pour pouvoir utiliser la vue Objets actifs, vous devez activer le profilage de la mémoire au démarrage du profileur. C’est la valeur par défaut. Si vous fermez la vue Objets actifs et que vous voulez la rouvrir, déployez la liste déroulante dans la vue Profiler et sélectionnez Surveiller les objets actifs.
Profilage des applications Flex
Pour plus d’informations sur l’exécution et l’analyse des résultats du nettoyage de la mémoire, voir « A propos de la récupération de place » à la page 182. Vous pouvez limiter les données affichées dans la vue Objets actifs grâce aux filtres du profileur. Pour plus d’informations, voir « A propos des filtres du profileur » à la page 186.
Profilage des applications Flex
La vue Instantané de la mémoire propose des informations concernant l’utilisation des objets et de la mémoire de l’application à un moment donné. A la différence de la vue Objets actifs, les données de la vue Instantané de la mémoire ne sont pas mises à jour en continu. Pour pouvoir utiliser la vue Instantané de la mémoire, vous devez activer le profilage de la mémoire au démarrage du profileur. C’est la valeur par défaut.
1 Démarrez une session de profilage. 2 Interagissez avec votre application jusqu’à atteindre un point dans l’état de l’application où vous voulez prendre un
3 Sélectionnez l’application dans la vue Profiler. 4 Cliquez sur le bouton Prendre un instantané de la mémoire.
5 Pour afficher les données dans l’instantané de mémoire, double-cliquez sur l’instantané de mémoire dans la vue
L’exemple suivant illustre la vue Instantané de la mémoire.
Si le champ Package est vide, la classe se trouve dans le package global ou le package non nommé.
Vous pouvez enregistrer des instantanés de la mémoire pour comparer l’état d’une application au cours d’une session de profilage différente. Pour plus d’informations, voir « Enregistrement et chargement des données de profilage » à la page 166. Lorsque vous double-cliquez sur une ligne de la vue Instantané de la mémoire, le profileur affiche la vue Références de l’objet. Cette vue affiche les traces de pile correspondant aux occurrences de la classe en cours. Vous pouvez consulter les traces de pile pour les occurrences de la classe en cours dans la vue Références de l’objet. Pour plus d’informations sur la vue Références de l’objet, voir « Utilisation de la vue Références de l’objet » à la page 172. Vous pouvez également spécifier quelles données afficher dans la vue Instantané de la mémoire grâce aux filtres du profileur. Pour plus d’informations, voir « A propos des filtres du profileur » à la page 186.
La vue Références de l’objet affiche les traces de pile pour les classes qui ont été instanciées dans l’application. Pour ouvrir la vue Références de l’objet, double-cliquez sur le nom d’une classe dans les vues Instantané de la mémoire ou Objets vagabonds. La vue Références de l’objet propose des informations concernant les occurrences de la classe sélectionnée. La vue Références de l’objet affiche les données dans deux tables : Occurrences et Suivi des allocations. La table Occurrences répertorie tous les objets contenant des références à l’objet actuel. Le nombre entre parenthèses après le nom de la classe est le nombre total de références à l’objet en cours. Vous ne pouvez pas voir le nombre de références futures d’un objet. Si aucun objet ne contient de références à l’objet spécifié, aucun objet n’est répertorié dans cette table. Cela ne devrait pas se produire, car l’objet en question doit être nettoyé de la mémoire s’il ne possède aucune référence. L’exemple suivant illustre la table Occurrences de la vue Références de l’objet.
Profilage des applications Flex
L’exemple suivant illustre la table Suivi des allocations de la vue Références de l’objet.
Vous pouvez ouvrir le code source de la classe sélectionnée en double-cliquant sur une classe dans cette table.
La vue Suivi des allocations indique les méthodes qui ont été appelées entre deux instantanés de mémoire et la quantité de mémoire consommée lors de ces appels de méthode. Pour ouvrir la vue Suivi des allocations, sélectionnez deux instantanés de mémoire puis cliquez sur le bouton Afficher le suivi des allocations. Pour plus d’informations sur l’enregistrement d’un instantané de la mémoire, voir « Utilisation de la vue Instantané de la mémoire » à la page 171.
Profilage des applications Flex
Ces informations peuvent vous aider à optimiser les performances. Une fois que vous avez identifié des méthodes qui créent un nombre excessif d’objets, vous pouvez optimiser ces zones à problème. Pour pouvoir utiliser la vue Suivi des allocations, vous devez activer le suivi des allocations au démarrage du profileur. Cette option est désactivée par défaut. L’exemple suivant illustre la vue Suivi des allocations.
Profilage des applications Flex
Vous pouvez limiter les données affichées dans la vue Suivi des allocations grâce aux filtres du profileur. Pour plus d’informations, voir « A propos des filtres du profileur » à la page 186.
La vue Statistiques de l’objet propose des statistiques concernant les performances du groupe d’objets sélectionné. Cette vue permet d’identifier quelles méthodes appellent un nombre disproportionné d’autres méthodes. Elle indique également la quantité de mémoire que les objets instanciés dans ces appels de méthode consomment. Vous pouvez faire appel à la vue Statistiques de l’objet pour identifier d’éventuelles fuites de mémoire et d’autres sources de problèmes de performances dans votre application. Pour accéder à la vue Statistiques de l’objet, sélectionnez deux instantanés de mémoire dans la vue Profiler et affichez la comparaison dans la vue Suivi des allocations. Double-cliquez ensuite sur une ligne pour afficher les informations dans la vue Statistiques de l’objet. La vue comporte trois sections :
Le nombre d’objets dans cette liste correspond au nombre d’objets spécifié dans la colonne Occurrences propres de la vue Suivi des allocations.
Suivi des allocations. L’exemple suivant illustre le récapitulatif de méthodes et les tables Occurrences propres et Occurrences de l’appelé de la vue Statistiques de l’objet.
Profilage des applications Flex
Le processus de profilage des performances conserve une liste des méthodes et des informations concernant ces méthodes qui ont été appelées entre le moment où vous supprimez les données de performances et le moment où vous capturez les nouvelles données. Cet écart de temps est désigné par le terme de période d’interaction.
Profilage des applications Flex
Génération d’un profil de performance 1 Activez le profilage des performances et démarrez une session de profilage. 2 Interagissez avec l’application jusqu’à atteindre le point où vous voulez commencer le profilage. 3 Cliquez sur le bouton Réinitialiser les données de performance. 4 Interagissez avec l’application et effectuez les actions à profiler. 5 Cliquez sur le bouton Capturer le profil de performance.
Réinitialiser les données de performance, le profil de performance contiendra toutes les données capturées depuis le premier démarrage de l’application. 6 Double-cliquez sur le profil de performance dans la vue Profiler.
Durée propre moyenne
à la page 178. Vous pouvez limiter les données affichées dans la vue Profil de performance grâce aux filtres du profileur. Pour plus d’informations, voir « A propos des filtres du profileur » à la page 186. Vous pouvez enregistrer les profils de performances pour une utilisation ultérieure. Pour plus d’informations, voir « Enregistrement et chargement des données de profilage » à la page 166.
La vue Statistiques de la méthode présente les caractéristiques des performances de la méthode sélectionnée. Vous pouvez faire appel à la vue Statistiques de la méthode pour identifier des goulets d’étranglement dans l’application. En affichant, par exemple, les temps d’exécution d’une méthode, vous pouvez voir les méthodes qui prennent un temps disproportionné pour s’exécuter. Vous pouvez ensuite optimiser de manière sélective ces méthodes. Pour plus d’informations, voir « Utilisation de la vue Profil de performance » à la page 176. Affichage des informations concernant les méthodes dans la vue Statistiques de la méthode 1 Double-cliquez sur une ligne dans la vue Profil de performance ou sélectionnez une méthode dans cette même vue. 2 Cliquez sur le bouton Ouvrir les statistiques de la méthode.
Profilage des applications Flex
Vous pouvez aussi utiliser les boutons Précédent, Suivant et Valeur par défaut du profileur pour parcourir la pile d’appels. Vous pouvez limiter les données affichées dans la vue Statistiques de la méthode grâce aux filtres du profileur. Pour plus d’informations, voir « A propos des filtres du profileur » à la page 186.
La vue Objets vagabonds présente les différences entre deux instantanés de mémoire de l’application que vous profilez. Les différences que cette vue illustre sont le nombre d’occurrences d’objets dans la mémoire et la quantité de mémoire que ces objets utilisent. Ces données sont utiles pour identifier les fuites de mémoire. Le laps de temps écoulé entre deux instantanés de la mémoire est l’intervalle d’instantanés. Pour ouvrir la vue Objets vagabonds, sélectionnez deux instantanés de mémoire et cliquez sur le bouton Objets vagabonds. Pour plus d’informations sur l’enregistrement d’un instantané de la mémoire, voir « Utilisation de la vue Instantané de la mémoire » à la page 171. L’exemple suivant illustre la vue Objets vagabonds.
Par exemple, si la classe Strings occupe 2 031 053 octets dans le premier instantané et 2 029 899 dans le second, la valeur de ce champ est 1 154 octets.
Le graphique Utilisation de la mémoire présente la mémoire utilisée par l’application que vous profilez. Cette valeur est différente de l’utilisation de la mémoire de Flash Player et son navigateur. La raison en est que cette valeur ne comprend pas l’utilisation de la mémoire de l’agent du profileur ou du navigateur. Elle correspond uniquement à la somme des objets actifs de l’application profilée. En conséquence, si vous comparez la valeur de l’utilisation de la mémoire dans ce graphique à la quantité de mémoire que le navigateur utilise telle qu’indiquée, par exemple, dans le Gestionnaire des tâches de Windows, vous obtenez des résultats très différents. L’image suivante illustre un graphique de la vue Utilisation de la mémoire.
La valeur de Mémoire maximale correspond à la quantité la plus élevée de mémoire que cette application a utilisée au cours de la session de profilage en cours. Le graphique Utilisation de la mémoire montre l’état de la mémoire de l’application au cours des 100 dernières secondes. Vous ne pouvez pas configurer ce nombre et vous ne pouvez pas enregistrer de données historiques pour le diagramme.
Profilage des applications Flex
La récupération de place est l’action de supprimer de la mémoire des objets qui ne sont plus nécessités. La mémoire utilisée par des occurrences n’ayant plus de références à ces objets doit être désallouée pendant ce processus. Flash Player nettoie la mémoire en fonction des besoins au cours du cycle de vie d’une application. Le déréférencement d’un objet ne déclenche pas le nettoyage de la mémoire. Ainsi, lorsque vous supprimez toutes les références à un objet, le nettoyage de la mémoire ne désalloue pas nécessairement la mémoire pour cet objet. Cet objet devient une cible potentielle du nettoyage de la mémoire. Le fait de cliquer sur le bouton Lancer la récupération de place ne garantit pas que tous les objets susceptibles d’être nettoyés le soient. La récupération de place est généralement déclenchée par l’allocation de mémoire à de nouvelles ressources. En effet, lorsque de nouvelles ressources nécessitent de la mémoire qui n’est pas disponible dans l’allocation actuelle, la fonction de récupération de place s’exécute et libère de la mémoire signalée pour la désallocation. Par conséquent, la suppression de toutes les références à la mémoire ne signifie pas qu’elle sera nettoyée immédiatement, mais bien qu’elle le sera probablement lors de la création et de l’utilisation d’autres occurrences. Si une application est inactive, vous pouvez consulter l’allocation de sa mémoire. Même si certains objets sont marqués pour le nettoyage, l’utilisation de la mémoire d’une application inactive ne change pas tant que vous ne commencez pas à interagir avec elle. Flash Player alloue la mémoire en blocs de plusieurs octets, et non octet par octet. Si une partie d’un bloc est marquée pour le nettoyage sans que d’autres parties le soient, le bloc n’est pas libéré. La récupération de place tente d’associer les parties de la mémoire non utilisées dans des blocs plus volumineux pouvant être nettoyés, mais cela ne se produit pas systématiquement à chaque tentative de récupération. La récupération de place se fait implicitement avant l’enregistrement d’instantanés de la mémoire. En d’autres termes, un clic sur le bouton Prendre un instantané de la mémoire équivaut à un clic sur le bouton Lancer la récupération de place puis à un clic sur le bouton Prendre un instantané de la mémoire. Exécution de la récupération de place pendant le profilage d’une application ❖ Sélectionnez l’application dans la vue Profiler, puis cliquez sur le bouton Lancer la récupération de place. Vous pouvez analyser l’efficacité de ce processus en comparant deux instantanés de mémoire, avant et après le nettoyage de la mémoire.
Le profileur propose différentes techniques d’identification des zones à problèmes des applications.
L’un des problèmes les plus courants auxquels les développeurs d’applications sont confrontés est celui des fuites de mémoire. Celles-ci prennent souvent la forme d’objets qui ont été créés dans un laps de temps donné mais qui n’ont pas été récupérés.
Profilage des applications Flex
Vous pouvez également examiner les chemins menant aux occurrences d’un objet pour déterminer si un chemin possède une référence arrière à la récupération de place (racine de la RP). Une occurrence dont la libération était attendue mais qui possède des références à la racine de la RP indique une perte de mémoire. Dans ce cas, modifiez le code de l’application de manière à supprimer toute référence à la racine de la RP. Une occurrence ne possédant plus aucune référence à la racine de la RP est prête à faire l’objet d’une récupération de place. Flash Player libère finalement cette mémoire. Une autre façon de localiser les fuites de mémoire consiste à comparer deux instantanés de mémoire dans la vue Objets vagabonds, afin de déterminer quels objets se trouvent toujours dans la mémoire après une série particulière d’événements. Ce processus est décrit dans la présente section. Il est courant, pour nettoyer les liens de la mémoire, de faire appel aux méthodes disconnect(), clearInterval() et removeEventListener(). Recherche d’une référence arrière à la racine de la RP pour une occurrence 1 Créez un instantané de la mémoire. Voir « Création et affichage d’un instantané de la mémoire » à la page 171. 2 Spécifiez le nombre de chemins de référence arrière à rechercher.
Afficher tous les chemins de références arrière. 3 Double-cliquez sur une classe dans la vue Instantané de la mémoire pour ouvrir la vue Références de l’objet. 4 Développez les chemins répertoriés et regardez s’il existe une référence arrière à la racine de la RP.
1 Créez deux instantanés de la mémoire. Voir « Création et affichage d’un instantané de la mémoire » à la page 171. 2 Sélectionnez les deux instantanés de mémoire à comparer.
Vous pouvez seulement comparer deux instantanés de mémoire en même temps. 3 Cliquez sur le bouton Rechercher les objets vagabonds.
à voir créée pendant ce laps de temps ou une classe que vous pensiez voir détruite pendant ce laps de temps, examinez l’application pour détecter si ces éléments peuvent être à l’origine d’une fuite de mémoire. 4 Pour déterminer la façon dont un objet de la vue Rechercher les objets vagabonds a été instancié, double-cliquez
Profilage des applications Flex
Répétez ces étapes un certain nombre de fois (3, 7 ou un autre nombre premier) dans l’application. Prenez un second instantané de mémoire pour le comparer à l’instantané de départ. Dans la vue Rechercher les objets vagabonds, vous trouverez peut-être des objets vagabonds dotés d’occurrences au nombre de multiples de 3 ou de 7. Ces objets présentent probablement des fuites. Double-cliquez sur les classes pour consulter les traces de pile de chacune des occurrences. Un autre moyen consiste à répéter la séquence d’étapes sur une longue période et d’attendre que l’utilisation de la mémoire atteigne son maximum. Si elle n’augmente pas après cela, il n’y a aucune fuite de mémoire pour cet ensemble d’étapes. Parmi d’autres causes, les écouteurs d’événement en attente sont souvent à l’origine de fuites de mémoire. La méthode removeEventListener() permet de supprimer un écouteur d’événement qui n’est plus utilisé. Pour plus d’informations, voir Object creation and destruction dans Utilisation d’Adobe Flex 4.
En analysant les temps d’exécution des méthodes et la quantité de mémoire allouée pendant ces appels de méthode, vous pouvez déterminer à quels niveaux les ralentissements des performances surviennent. Cette opération est utile notamment pour identifier le temps d’exécution des méthodes appelées fréquemment, plutôt que celui des méthodes qui le sont rarement. Détermination de la fréquence des appels de méthodes 1 Démarrez une session de profilage et veillez à activer le profilage des performances lors de la configuration du profileur sur l’écran de démarrage. 2 Sélectionnez l’application dans la vue Profiler. 3 Interagissez avec l’application jusqu’à atteindre le point où vous voulez commencer à analyser le nombre d’appels
4 Cliquez sur le bouton Réinitialiser les données de performance. Toutes les données de performance sont alors
5 Interagissez avec l’application jusqu’à atteindre le point où vous voulez vérifier le nombre d’appels de méthode
6 Cliquez sur le bouton Capturer le profil de performance. 7 Double-cliquez sur le profil de performance dans la vue Profiler. 8 Dans la vue Profil de performance, triez les données selon la colonne Méthode et localisez votre méthode dans la
La valeur figurant dans la colonne Appels correspond au nombre de fois que cette méthode a été appelée au cours de cet intervalle d’échantillonnage. Il s’agit de l’écart de temps qui sépare le moment où vous avez cliqué sur Réinitialiser les données de performance et le moment où vous avez cliqué sur Capturer le profil de performance.
Profilage des applications Flex
Comparez le temps mis par chaque méthode pour s’exécuter au temps que mettent à s’exécuter toutes les méthodes appelées par une méthode particulière. En règle générale, si la durée propre ou la durée propre moyenne d’une méthode est élevée ou élevée par rapport à celle d’autres méthodes, observez de plus près la façon dont la méthode est implémentée et tentez de réduire le temps d’exécution. De la même façon, si la durée propre ou la durée propre moyenne d’une méthode est faible, mais que la durée cumulée ou la durée cumulée moyenne est élevé, observez les méthodes que cette méthode appelle pour localiser les goulets d’étranglement.
Un moyen d’identifier les zones à problèmes d’une application consiste à déterminer à quels niveaux un nombre excessif d’objets est créé. La création d’une occurrence d’un objet peut consommer un grand nombre de ressources, plus particulièrement si cet objet se trouve dans la liste d’affichage. L’ajout d’un objet à la liste d’affichage peut engendrer un grand nombre d’appels des méthodes de style et de présentation, ce qui risque de ralentir l’application. Dans certains cas, vous pouvez restructurer le code afin de réduire le nombre d’objets créés. Une fois que vous avez déterminé si la création de certains objets est superflue, vous pouvez décider s’il est raisonnable ou utile de réduire le nombre d’occurrences de cette classe. Vous pouvez par exemple déterminer la taille des objets, car les objets volumineux présentent généralement le plus grand potentiel d’optimisation. Pour savoir quels objets sont créés en nombre important, vous pouvez comparer les instantanés de mémoire de l’application à deux moments. Affichage du nombre d’occurrences d’une classe spécifique 1 Démarrez une session de profilage et veillez à activer le profilage de la mémoire lors de la configuration du profileur sur l’écran de démarrage. 2 Interagissez avec l’application jusqu’à atteindre l’endroit dont vous souhaitez prendre un instantané de la mémoire. 3 Cliquez sur le bouton Prendre un instantané de la mémoire. Le profileur ajoute un nouvel instantané de la mémoire
4 Dans la vue Profiler, double-cliquez sur l’instantané de la mémoire pour l’ouvrir. 5 Pour afficher le nombre d’occurrences d’une classe particulière, ainsi que la quantité de mémoire que ces
Pour plus d’informations sur la vue Instantané de la mémoire, voir « Utilisation de la vue Instantané de la mémoire » à la page 171. Localisation d’occurrences d’allocation excessive d’objets 1 Démarrez une session de profilage et veillez à activer le profilage de la mémoire lors de la configuration du profileur sur l’écran de démarrage. 2 Interagissez avec l’application jusqu’à atteindre le premier endroit dont vous souhaitez prendre un instantané de la
3 Cliquez sur le bouton Prendre un instantané de la mémoire.
Profilage des applications Flex
5 Cliquez à nouveau sur le bouton Prendre un instantané de la mémoire.
6 Sélectionnez les deux instantanés de mémoire à comparer.
Vous ne pouvez comparer que deux instantanés de mémoire à la fois. 7 Cliquez sur le bouton Afficher le suivi des allocations.
La quantité de données contenue dans une vue du profileur peut quelquefois être considérable et le niveau de détail trop important. Les actions internes de Flash Player peuvent occulter les données qui vous intéressent véritablement, telles que vos propres méthodes et classes. En outre, Flash Player crée et détruit de nombreux objets sans votre intervention directe. Vous pouvez par conséquent constater que des milliers de chaînes ou de tableaux sont utilisés dans votre application. Vous pouvez définir des filtres dans les vues suivantes :
• Instantané de la mémoire • Profil de performance • Statistiques de la méthode • Suivi des allocations Vous pouvez définir quels packages doivent figurer dans les vues du profileur grâce aux filtres. Il existe deux types de filtres. Filtres d’exclusion Les filtres d’exclusion indiquent au profileur qu’il doit exclure de ses vues les packages qui correspondent aux motifs de sa liste de motifs. Si vous faites appel, par exemple, à des commandes de création de graphiques, mais que vous ne voulez pas les profiler, vous pouvez ajouter le motif mx.charts.* au filtre d’exclusion. Vous pouvez également exclure des éléments intégrés globaux, ce qui comprend les classes globales String et Array. Filtres d’inclusion Les filtres d’exclusion indiquent au profileur qu’il doit inclure dans ses vues uniquement les
Les exclusions par défaut sont les classes flash.*.*, spark.*.*, mx.*.*, ainsi que les classes d’infrastructure Flex dans le package global ou non nommé, ce qui comprend les classes globales String et Array. Cela signifie que les inclusions par défaut sont des classes personnalisées se trouvant dans le package non nommé et des classes personnalisées dans des packages hors infrastructure (telles que com.mycompany.MyClass). Vous pouvez exclure les classes personnalisées se trouvant dans le package non nommé à partir des données de profilage. Pour ce faire, ajoutez « * » à la liste d’exclusion.
Profilage des applications Flex
Nombre maximal de chemins de références arrière à rechercher L’option Nombre maximal de chemins de références
Définition de préférences de filtres par défaut ❖ Ouvrez la boîte de dialogue Préférences et sélectionnez Flash Builder > Profileur > Filtres d’inclusion ou Filtres d’exclusion. Lors de l’affichage des données du profileur, celui-ci applique d’abord les filtres d’exclusion, puis les filtres d’inclusion. Supposons que vous définissiez le filtre d’exclusion sur mx.controls.*, mais que vous définissiez le filtre d’inclusion sur mx.*.*. Le profileur n’affiche aucune information concernant les classes du package mx.controls, même si leur motif correspond à la liste de motifs d’inclusion, car ce package est exclu. Supposons également que vous définissiez le filtre d’exclusion sur mx.*.* et le filtre d’inclusion sur mx.controls.*. Le profileur n’affiche aucune information concernant les classes du package mx.controls.* car elles ont été exclues avant l’inclusion du package. Lorsque vous filtrez certains points de données, les valeurs de pourcentage des colonnes sont ajustées afin de refléter uniquement le pourcentage de données non filtrées. Le profileur conserve les filtres d’une session de profilage à l’autre pour la même application. Les paramètres de filtres ne sont pas hérités par les vues secondaires. Par exemple, si vous appliquez un filtre aux données contenues dans la vue Instantané de la mémoire, puis accédez à la vue Références de l’objet en double-cliquant sur une méthode, la vue Références de l’objet n’applique pas le même filtre. Déterminer si les données sont filtrées 1 Cliquez sur le bouton Filtres ou examinez le titre des tables de données. Si des filtres sont appliqués, l’en-tête de la colonne Package est Package (filtré). 2 (Facultatif) Réinitialisez les filtres aux valeurs par défaut en cliquant sur le bouton Restaurer les valeurs par défaut.
A propos de la structure des interfaces utilisateur dans Flex Les éléments constituants des interfaces utilisateur dans Flex sont les conteneurs et les contrôles MXML. Un conteneur est une région rectangulaire qui permet d’organiser et de mettre en forme les contrôles, d’autres conteneurs et les composants personnalisés. Un contrôle est un composant d’interface utilisateur tel que Button, TextArea ou ComboBox. Les composants personnalisés sont ceux que vous avez définis dans des fichiers MXML ou ActionScript distincts et que vous incluez dans votre application. Remarque : vous pouvez également ajouter à votre application des ressources créées avec Adobe Flash® Professional®. Voir « Création et modification de composants Flash » à la page 194.
Flex 4 comporte de nouveaux composants Spark, définis dans les packages spark.*. Les composants MX, qui étaient disponibles dans les versions précédentes de Flex, sont définis dans les packages mx.*. La principale différence entre les composants Spark et les composants MX réside dans l’utilisation des styles CSS et dans l’habillage. Pour plus d’informations sur l’utilisation de composants visuels dans une application, voir Visual components.
Bien que les conteneurs MX fournissent la plupart des options de présentation offertes par les conteneurs Spark, Adobe recommande d’utiliser les conteneurs Spark. Pour plus d’informations sur l’utilisation de conteneurs pour présenter une application, voir Introduction to containers.
Les applications dans Flex sont généralement constituées d’un fichier d’application MXML (fichier doté d’un conteneur <s:Application> comme balise parent) et d’un ou de plusieurs composants définis dans des fichiers MXML, des fichiers ActionScript ou des fichiers de composants Flash (fichiers SWC) distincts. Vous pouvez insérer des conteneurs et contrôles directement dans le fichier d’application MXML ou dans des fichiers MXML distincts pour créer des composants personnalisés et les insérer ensuite dans le fichier d’application.
Une structure basée sur des composants est utile si votre interface utilisateur est composée d’éléments fonctionnels distincts. Par exemple, votre présentation peut comporter un élément qui extrait et affiche un catalogue de produits, un autre élément qui extrait et affiche des informations concernant tous les produits sur lesquels l’utilisateur peut cliquer dans le catalogue et un élément qui permet à l’utilisateur d’ajouter le produit sélectionné à un panier d’achats. Cette interface utilisateur peut être structurée sous la forme de trois composants personnalisés ou sous la forme d’une association de composants personnalisés et de contrôles insérés directement dans la présentation.
Création d’une interface utilisateur avec Flash Builder
éléments d’interface utilisateur dans des fichiers de composants personnalisés séparés, que vous insérez par la suite dans le fichier d’application MXML. Composant personnalisé 1 Composant
Cette présentation utilise le positionnement absolu. Tous les enfants du conteneur sont positionnés explicitement ou à l’aide de contraintes. Cette présentation est celle appliquée par défaut à tous les conteneurs, à l’exception de HGroup et VGroup.
Cette présentation positionne les enfants sur une seule ligne horizontale.
Adobe recommande d’utiliser les conteneurs Spark.
Les conteneurs Spark peuvent avoir des composants visuels Spark et MX comme enfants. Les composants de navigateur MX ne peuvent toutefois pas avoir des composants Spark comme enfants. Les composants de navigateur MX comptent parmi d’autres les conteneurs ViewStack, TabNavigator et Accordion, ainsi que les composants TabBar ou ButtonBar et des composants similaires. Certains composants implémentés dans MX n’ont pas d’équivalents dans Spark. Dans ce cas, les composants MX sont répertoriés comme composants recommandés dans la vue Composants et dans l’assistant de contenu.
« Vue Composants » à la page 192 « A propos de l’assistant de contenu » à la page 106
Flash Builder vous permet d’ajouter des composants à une application ainsi que d’en définir la taille, de les modifier ou de les supprimer. Vous pouvez également ajouter et modifier des composants personnalisés définis dans des fichiers MXML et ActionScript distincts.
Création d’une interface utilisateur avec Flash Builder
1 En mode Création de l’éditeur MXML, ouvrez le fichier MXML dans lequel vous voulez insérer le composant.
MXML peut être le fichier de l’application principale (fichier doté d’un conteneur Application) ou un fichier de composant MXML personnalisé. 2 Dans la vue Composants, localisez le composant à ajouter.
Pour plus d’informations, voir « Vue Composants » à la page 192. 3 Faites glisser un composant de la vue Composants vers le fichier MXML.
La vue Composants s’affiche lorsque vous accédez au mode Création de l’éditeur MXML. Faites-en glisser les composants vers la zone de création pour définir la présentation de votre application. Cette vue affiche par défaut les composants recommandés pour un projet. La version du SDK Flex d’un projet détermine quels composants sont répertoriés comme composants recommandés. Lors de la création d’un projet par exemple, Flash Builder utilise par défaut le SDK Flex 4. Les composants recommandés pour le SDK Flex 4 sont les composants Spark. Les composants MX ne possédant aucun équivalent Spark sont également répertoriés dans la liste des composants recommandés.
Création d’une interface utilisateur avec Flash Builder
Graphiques. La catégorie Personnaliser contient les composants définis dans des fichiers MXML et ActionScript distincts. Pour plus d’informations, voir « Création de composants MXML personnalisés » à la page 134. Remarque : la vue Composants répertorie les composants visibles. Modification de l’affichage des composants dans la vue Composants Accédez au menu de la vue Composants pour en modifier l’affichage. 1 Pour afficher tous les composants, désélectionnez Afficher uniquement les composants recommandés.
2 Pour afficher les noms qualifiés complets des classes, sélectionnez Afficher les noms qualifiés complets des classes.
En mode Source de l’éditeur MXML, les indicateurs de code vous assistent lors de l’ajout de conteneurs et de contrôles Flex standard à l’interface utilisateur. Dans Flash Builder, tout comme dans Eclipse, les indicateurs de code sont désignés par le terme Assistant de contenu. L’assistant de contenu de Flash Builder vous aide à insérer des composants recommandés. L’exemple suivant illustre comment utiliser les indicateurs de code pour insérer un conteneur <s:VGroup> dans un conteneur <s:HGroup>. HGroup étant un composant Spark, l’assistant privilégie l’utilisation d’un conteneur VGroup à celle de <mx:VBox>. 1 Ouvrez un fichier MXML en mode Source dans l’éditeur MXML.
2 Placez le point d’insertion dans la balise de conteneur parent.
<s:HGroup> insertion point here </s:HGroup> Dans cet exemple, VGroup est recommandé, contrairement à VBox qui ne l’est pas.
Création d’une interface utilisateur avec Flash Builder
L’assistant de contenu peut également suggérer des propriétés, des événements, des effets et des styles. Appuyez sur les touches Ctrl+Espace pour parcourir les recommandations de l’assistant de contenu. Vous pouvez modifier le type et l’ordre des recommandations de l’assistant de contenu. Dans la boîte de dialogue Préférences, sélectionnez Flash Builder > Editeurs > Code MXML > Avancées.
« A propos de l’assistant de contenu » à la page 106 « Création de composants MXML personnalisés » à la page 134
Adobe Flash® Professional CS5 crée des applications compatibles avec Adobe Flash Player 10. Les applications Adobe prennent également en charge Flash Player 10, ce qui signifie que vous pouvez importer dans vos applications des ressources issues de Flash Professional CS5. Vous pouvez créer des contrôles, des conteneurs, des habillages et d’autres ressources dans Flash Professional CS5, puis les importer dans vos applications sous la forme de fichiers SWC. Pour plus d’informations sur la création de composants à l’aide de Flash Professional CS5, voir Extensions pour la création d’habillages Flex et kit de composants Flex pour Flash Professional. La vue Création de l’éditeur Flash Builder vous permet d’insérer un nouveau composant Flash en ajoutant un espace réservé pour un composant ou un conteneur Flash. Vous pouvez appeler Flash Professional CS5 à partir de Flash Builder pour créer le composant ou conteneur. Vous pouvez également appeler Flash Professional CS5 pour modifier les composants Flash créés précédemment. Si l’application contient un composant SWFLoader destiné à lancer des fichiers d’animation Flash, vous pouvez démarrer Flash Professional CS5 pour créer ou modifier les fichiers FLA et SWF associés.
1 Dans l’éditeur Flash Builder, sélectionnez la vue Création et assurez-vous que la vue Composants est visible. 2 Dans le dossier Personnaliser de la vue Composants, faites glisser soit un Nouveau composant Flash soit un
Création d’une interface utilisateur avec Flash Builder
3 Dans le menu contextuel ou dans la Vue standard des Propriétés du fichier, sélectionnez Créer dans Adobe Flash.
Adobe Flash. 4 Dans la boîte de dialogue qui s’ouvre, précisez le nom de la classe et du fichier SWC, puis cliquez sur Créer pour
5 Dans Flash Professional CS5, modifiez le composant ou conteneur. Sélectionnez Terminer lorsque vous avez fini
Cette procédure suppose que vous avez déjà inséré un composant ou un conteneur Flash dans Flash Builder. 1 Dans la vue Création de l’éditeur Flash Builder, sélectionnez le composant ou le conteneur Flash à modifier. 2 Dans le menu contextuel ou dans la Vue standard des Propriétés Flex, sélectionnez Editer dans Adobe Flash.
3 Dans Flash Professional CS5, modifiez le composant ou conteneur. Sélectionnez Terminer lorsque vous avez fini
Cette procédure suppose que l’application contient un composant SWFLoader. 1 Dans la vue Création de l’éditeur Flex, sélectionnez le composant SWFLoader. 2 A partir du menu contextuel du composant ou de la Vue standard de la fenêtre Propriétés, lancez Flash
• Sélectionnez Editer dans Adobe Flash pour modifier l’animation Flash associée au composant SWFLoader. 3 Une fois que vous avez fini de modifier l’animation, sélectionnez Terminer pour retourner à Flash Builder.
Vous pouvez ajouter à l’interface utilisateur des composants Flash créés avec Adobe Flash CS3 Professional. Remarque : pour pouvoir créer des composants Flex dans Flash CS3, vous devez installer le kit de composants Flex pour Flash CS3. Pour plus d’informations, consultez l’article Importing Flash CS3 Assets into Flex. 1 Vérifiez que le composant Flash est enregistré dans le chemin d’accès à la bibliothèque du projet en cours.
Pour définir ou découvrir le chemin d’accès à la bibliothèque, sélectionnez le projet dans l’Explorateur de packages, puis sélectionnez Projet > Propriétés. Dans la boîte de dialogue Propriétés, sélectionnez la catégorie Chemin de génération Flex, puis cliquez sur l’onglet Chemin d’accès à la bibliothèque. Pour plus d’informations, voir « Génération manuelle de projets » à la page 81. Il est également possible de définir le chemin d’accès à la bibliothèque dans le fichier de configuration flexconfig.xml d’Adobe LiveCycle Data Services ES®.
Création d’une interface utilisateur avec Flash Builder
Actualiser (l’icône verte contenant des flèches) pour afficher le composant après l’avoir inséré.
Flash Builder vous permet de travailler visuellement avec les composants dans l’éditeur MXML pour que vous puissiez voir l’aspect de votre application à mesure que vous la construisez. L’éditeur MXML possède deux modes : le mode Source pour la rédaction de code et le mode Création pour le développement visuel des applications.
Le mode Création vous permet d’afficher, de sélectionner, de déplacer, de redimensionner, de faire défiler, d’agrandir ou d’effectuer un panoramique des éléments dans la zone de création.
1 Si le fichier MXML n’est pas déjà ouvert dans l’éditeur MXML, double-cliquez sur le fichier dans l’Explorateur de
2 Si l’éditeur MXML affiche le code source, cliquez sur Création dans la partie supérieure de la zone de l’éditeur.
Le basculement entre les modes Source et Création affiche ou masque automatiquement les vues liées à la création, telles que Composants, Propriétés et Etats. Pour activer et désactiver ce comportement, accédez à la boîte de dialogue Préférences et sélectionnez Flash Builder > Editeurs > Mode Création et enfin l’option Afficher automatiquement les vues liées à la création.
❖ Cliquez sur le bouton Mode Sélection (en forme de flèche) sur la droite de la barre d’outils de l’éditeur. Ce mode
Sélection. Cliquez sur un composant et faites-le glisser jusqu’à l’emplacement voulu. Vous pouvez aussi le faire glisser pour le redimensionner et cliquer dessus pour le sélectionner.
❖ Cliquez sur le bouton Mode Panoramique sur le côté droit de la barre d’outils de l’éditeur. Appuyez sur H pour
Création d’une interface utilisateur avec Flash Builder
Il existe plusieurs façons d’utiliser l’outil de zoom. Vous pouvez sélectionner des pourcentages dans le menu principal et le menu contextuel, cliquer sur le bouton Mode Zoom sur la barre d’outils ou utiliser des raccourcis clavier. Le pourcentage d’agrandissement en cours est toujours affiché dans la barre d’outils.
Vous pouvez recourir aux raccourcis clavier suivants dans la zone de création :
• Zoom arrière : Ctrl+- (Commande+- sous Mac OS) Pour connaître d’autres raccourcis clavier, sélectionnez Aide > Assistant de touches. • Cliquez sur l’arrière-plan de la page et dessinez un rectangle chevauchant les composants. • Dans la vue Structure (Fenêtre > Structure), appuyez sur la touche Ctrl tout en cliquant sur (Commande-clic sous Macintosh) les composants dans le contrôle d’arborescence.
• Cliquez sur le conteneur d’arrière-plan. • Cliquez sur un composant désélectionné. • Cliquez dans la marge grise encadrant le composant racine.
Vous pouvez changer la position des composants visuellement en fonction de la propriété layout du conteneur parent. Si le conteneur parent spécifie que le positionnement est absolu, vous pouvez faire glisser les composants pour les repositionner. Dans le cas contraire, les composants repositionnés appliquent les règles de présentation du conteneur parent. Par défaut, les conteneurs Spark font appel à la propriété BasicLayout qui autorise le positionnement absolu. Pour certains conteneurs MX, vous pouvez également définir la propriété layout sur absolute. Pour plus d’informations, voir MX layout containers.
Création d’une interface utilisateur avec Flash Builder
1 En mode Création de l’éditeur MXML, sélectionnez le composant dans la présentation et faites-le glisser vers une
Le composant est placé en fonction des règles de présentation du conteneur parent. Si le conteneur bénéficie du positionnement absolu, vous pouvez faire glisser les composants et les positionner n’importe où dans le conteneur. Par exemple, si vous déplacez un conteneur VGroup dans un conteneur HGroup, le conteneur VGroup est placé à l’horizontale avec les autres conteneurs enfant (s’ils existent). 2 En mode Création, sélectionnez le conteneur parent du composant et modifiez ses propriétés de présentation dans
Dans certains cas, vous pouvez changer la position des composants enfant en modifiant les propriétés du conteneur parent. Vous pouvez par exemple utiliser les propriétés verticalGap et horizontalGap du conteneur pour définir l’espacement entre les composants enfant et la propriété direction pour préciser une présentation à lignes ou à colonnes.
« Conteneurs Spark et MX » à la page 188 « Définition de contraintes de présentation pour les composants » à la page 207
En mode Création, vous pouvez modifier la taille d’un composant en faisant glisser la poignée de redimensionnement, en sélectionnant des options dans les menus ou en modifiant ses propriétés dans la vue Propriétés. Remarque : utilisez une présentation basée sur contrainte pour spécifier la manière dont un composant est redimensionné dynamiquement lors du redimensionnement d’un conteneur. Pour plus d’informations, voir « Définition de contraintes de présentation pour les composants » à la page 207. Dimensionnement d’un composant visuellement ❖ En mode Création de l’éditeur MXML, cliquez sur le composant et faites glisser la poignée de dimensionnement pour le redimensionner.
• Si l’alignement est activé, lorsque vous effectuez le redimensionnement, des lignes d’accrochage s’affichent pour vous aider à aligner les bords du composant avec les composants voisins. Pour activer ou désactiver l’alignement dans le menu principal, sélectionnez > Activer l’accrochage. Harmonisation de la largeur ou de la hauteur de deux composants ou plus 1 En mode Création, sélectionnez deux composants ou plus. 2 Dans le menu Création, sélectionnez l’une des options de dimensionnement suivantes : Rendre de la même largeur Définit la propriété width de tous les composants sélectionnés sur celle du composant que vous avez sélectionné en premier.
Création d’une interface utilisateur avec Flash Builder
Dans le cas contraire, tous les composants sont définis avec la même largeur ou hauteur de pixel. Dimensionnement d’un composant en modifiant ses propriétés 1 En mode Création, sélectionnez le composant. Pour définir la taille de plusieurs composants simultanément, appuyez sur la touche Ctrl en cliquant (ou Maj-clic sous Mac OS) sur ces composants. 2 Dans la vue Propriétés (Fenêtre > Propriétés), définissez la propriété height ou width du ou des composants
La vue Propriétés propose trois vues pour l’affichage des propriétés d’un composant : une vue standard sous forme de formulaire, une vue par catégories sous forme de tableau et une vue alphabétique sous forme de tableau. Vous pouvez passer d’une vue à l’autre en cliquant sur les boutons correspondants dans la barre d’outils.
Lorsque vous faites glisser un composant visuellement dans un conteneur doté du positionnement absolu, le composant peut s’accrocher dans la bonne position selon l’endroit vers lequel vous le faites glisser par rapport aux composants existants. Les composants peuvent s’aligner à la verticale ou à l’horizontale. Par défaut, les conteneurs Spark font appel à la propriété BasicLayout qui autorise le positionnement absolu. Pour certains conteneurs MX, vous pouvez également définir la propriété layout sur absolute. Pour plus d’informations, voir Using Layout Containers. Vous pouvez désactiver l’alignement pour un composant ou pour tous les composants. Activation ou désactivation de l’accrochage ❖ Le fichier MXML étant ouvert en mode Création dans l’éditeur MXML, sélectionnez (ou désélectionnez) Création > Activer l’accrochage. Activation ou désactivation de l’accrochage dans les Préférences 1 Ouvrez la boîte de dialogue Préférences. 2 Sélectionnez Flash Builder > Editeurs > Mode Création dans le panneau latéral de la boîte de dialogue Préférences. 3 Sélectionnez ou désélectionnez l’option Activer l’accrochage.
Vous pouvez aligner visuellement les composants les uns par rapport aux autres dans un conteneur doté du positionnement absolu. Par défaut, les conteneurs Spark font appel à la propriété BasicLayout qui autorise le positionnement absolu. Pour certains conteneurs MX, vous pouvez également définir la propriété layout sur absolute. Vous pouvez également centrer les composants dans un conteneur grâce à une présentation basée sur des contraintes. Pour plus d’informations, voir « Définition de contraintes de présentation pour les composants » à la page 207.
Création d’une interface utilisateur avec Flash Builder
1 En mode Création de l’éditeur MXML, sélectionnez deux composants ou plus dans le conteneur. Pour plus d’informations, voir « Sélection de plusieurs composants dans un fichier MXML » à la page 197. 2 Sélectionnez l’une des options d’alignement suivantes dans le menu Création. Aligner à gauche Positionne tous les composants sélectionnés de manière que leur bord gauche s’aligne avec celui
Aligner les centres à la verticale Positionne tous les composants sélectionnés de manière que leur centre s’aligne à
Aligner à droite Positionne tous les composants sélectionnés de manière que leur bord droit s’aligne avec celui du
Aligner en haut Positionne tous les objets sélectionnés de manière que leur bord supérieur s’aligne avec celui du
Aligner les centres à l’horizontale Positionne tous les composants sélectionnés de manière que leur centre s’aligne
Aligner en bas Positionne tous les composants sélectionnés de manière que leur bord inférieur s’aligne avec celui
Aligner les lignes de base Positionne tous les composants sélectionnés de manière que leur ligne de base de texte
Pour les objets dépourvus de contraintes de présentation, Flash Builder ajuste la propriété x pour changer l’alignement vertical et la propriété y pour modifier l’alignement horizontal. Pour les objets dépourvus de contraintes de présentation, Flash Builder ajuste les contraintes gauche et droite pour changer l’alignement vertical et les contraintes de haut et bas pour modifier l’alignement horizontal. Seules les contraintes existantes sont modifiées ; aucune nouvelle contrainte n’est ajoutée. Supposons, par exemple, que le composant A possède une contrainte gauche et aucune contrainte droite, et que le composant B soit doté d’une contrainte gauche et d’une droite. Si vous sélectionnez les composants A et B et que vous sélectionnez Création > Aligner les centres à la verticale, Flash Builder ajuste la contrainte gauche de l’objet A et les contraintes gauche et droite de l’objet B pour les aligner. La contrainte de droite non spécifiée de l’objet A reste non spécifiée.
Vous pouvez ajuster la position de composants dans un conteneur doté du positionnement absolu en les déplaçant d’un ou de dix pixels à la fois en utilisant les touches de direction. Ajustement des composants d’un pixel ❖ Sélectionnez un ou plusieurs composants en mode Création de l’éditeur MXML et appuyez sur l’une des touches de direction. Ajustement des composants de dix pixels ❖ Sélectionnez un ou plusieurs composants en mode Création de l’éditeur MXML et appuyez sur l’une des touches de direction tout en maintenant la touche Maj enfoncée. Maintenez la touche de direction enfoncée pour continuer à déplacer le composant.
Création d’une interface utilisateur avec Flash Builder
Vous pouvez définir visuellement les propriétés de composants dans la zone de création ou dans la vue Propriétés. Modification du texte affiché par un composant ❖ Pour éditer le texte affiché par un composant tel qu’un contrôle Label ou TextInput, double-cliquez sur le composant et saisissez vos modifications. Changement du texte dans le champ ID Lorsque vous modifiez du texte dans le champ ID, vous êtes invité à mettre à jour toutes les références de l’espace de travail avec le nouvel identifiant. Vous pouvez définir la suppression de cette boîte de dialogue à la page Mode Création des Préférences : 1 Ouvrez la fenêtre Préférences. 2 Sélectionnez Flash Builder > Editeurs > Mode Création. 3 Sélectionnez ou désélectionnez Toujours mettre à jour les références lors de la modification des ID dans la vue
Définition des autres propriétés d’un composant ❖ Sélectionnez un composant et définissez-en les propriétés dans la vue du même nom (Fenêtre > Autres vues > Flash Dernière mise à jour le 29/4/2010
Création d’une interface utilisateur avec Flash Builder
1 Le fichier MXML étant ouvert en mode Création, sélectionnez la vue Structure.
En mode Source, seul le premier composant sélectionné dans la vue Structure apparaît comme étant sélectionné dans l’éditeur.
Flash Builder affiche par défaut les bordures des conteneurs en mode Création de l’éditeur MXML. Vous pouvez toutefois les masquer. ❖ Sélectionnez Création > Afficher les bordures des conteneurs.
1 Vérifiez que les deux fichiers MXML sont ouverts en mode Création de l’éditeur MXML. 2 Sélectionnez des composants dans l’un des fichiers. Cliquez ensuite sur Editer > Copier. 3 Accédez à l’autre fichier, cliquez à l’intérieur d’un conteneur et sélectionnez Editer > Coller.
Vous pouvez supprimer des composants de l’interface utilisateur. Sélectionnez un composant, puis procédez de l’une des manières suivantes :
Création d’une interface utilisateur avec Flash Builder
• Dans le menu Editer de Flash Builder, sélectionnez Supprimer.
Vous pouvez appliquer des contraintes à un composant pour en ajuster automatiquement la taille et la position dans le conteneur lorsque l’utilisateur redimensionne la fenêtre de l’application. Les contraintes de présentation sont généralement définies en mode Création de l’éditeur MXML. Vous pouvez également définir des contraintes de présentation pour un composant en modifiant ses propriétés en mode Source.
Flex prend en charge les présentations basées sur des contraintes. Ce type de présentation est disponible avec les conteneurs qui prennent en charge le positionnement absolu. Pour les conteneurs Spark, le positionnement absolu est pris en charge par la présentation par défaut (BasicLayout). L’application de présentations basées sur des contraintes se traduit pas l’ancrage d’un ou de plusieurs côtés d’un composant aux bords d’un conteneur ou de sa région de contrainte. Vous pouvez également définir le décalage du composant par rapport à l’ancrage. Lorsqu’un conteneur est redimensionné par l’utilisateur, la taille et la position de ses composants sont déterminées par les points d’ancrage définis.
Dans l’exemple suivant, tous les contrôles bénéficient d’un positionnement absolu dans un conteneur, soit en les faisant glisser, soit en définissant les coordonnées x et y dans la vue Propriétés. Les flèches du schéma indiquent de quelle manière les contraintes, définies conformément aux points énumérés ci-dessous, influent sur le comportement des contrôles en cas de redimensionnement de la présentation. <s:Panel>
Les contrôles TextInput A et TextInput B s’étirent à l’horizontale lorsque la présentation est agrandie. Le contrôle TextArea C s’étire à l’horizontale et à la verticale. Le contrôle Button se déplace vers le bas et vers la droite.
Pour créer une présentation basée sur des contraintes, utilisez un conteneur prenant en charge le positionnement absolu. Pour les conteneurs Spark, définissez la propriété layout sur BasicLayout. La propriété par défaut BasicLayout est appliquée à tout conteneur Spark pour lequel aucune propriété layout n’a été définie. Pour les conteneurs MX, la présentation absolute ne peut être appliquée qu’à Application, Canvas et Panel. Pour le conteneur Canvas, absolute est la présentation par défaut. Pour les conteneurs MX Application et Panel, définissez la propriété layout sur absolute pour appliquer le positionnement absolu. La propriété layout="absolute" des conteneurs MX remplace la règle de présentation du conteneur et vous permet de faire glisser les composants et de les positionner n’importe où dans le conteneur.
Vous pouvez définir des contraintes provoquant l’ancrage à des régions de contrainte horizontales et verticales. Les contraintes avancées sont utiles dans les situations suivantes :
Remarque : les conteneurs HGroup et VGroup imbriqués permettent d’obtenir des résultats proches de ceux obtenus avec les contraintes avancées. Pour les présentations basées sur des contraintes avancées, définissez des régions ConstraintColumn et ConstraintRow. Ancrez les composants aux bords ou au centre de ces régions. Les colonnes de contraintes sont disposées dans le conteneur de gauche à droite et les lignes de contraintes du haut vers le bas. Les régions de contraintes peuvent être définies par des dimensions de pixels fixes (largeur ou hauteur) ou sous la forme d’un pourcentage d’espace dans le conteneur parent. L’ensemble de colonnes et de lignes de contraintes peut posséder un mélange de dimensions fixes et de pourcentage. Les composants situés dans un conteneur parent peuvent être ancrés au conteneur, à des régions de contraintes ou à toute association de conteneurs et de régions de contraintes. Utilisez l’éditeur MXML en mode Source pour spécifier des contraintes avancées.
Création d’une interface utilisateur avec Flash Builder
Vous pouvez définir une présentation basée sur des contraintes pour les composants d’un conteneur doté de positionnement absolu. Remarque : les contraintes de présentation définies par des colonnes et lignes de contraintes peuvent être spécifiées uniquement par l’édition du code source. 1 Assurez-vous que le fichier MXML contient un conteneur doté du positionnement absolu. 2 En mode Création de l’éditeur MXML, faites glisser un composant de la vue Composants vers le conteneur. 3 Positionnez le composant dans le conteneur en le déplaçant dans la zone de création ou en définissant ses propriétés x et y dans la vue Propriétés (Fenêtre > Propriétés).
5 Dans la vue Propriétés, accédez à l’outil de contraintes dans la catégorie Présentation. 6 En vous servant du tableau suivant comme guide, cochez les cases de contraintes pour obtenir l’effet voulu lorsque
Effet Déplacer le composant à l’horizontale et à la verticale
Centrer le composant à l’horizontale et à la verticale
60 pixels du bord droit. Si l’utilisateur redimensionne l’application, le composant s’étire ou se comprime pour conserver ces distances par rapport aux bords de la fenêtre de l’application. Flash Builder exprime ces contraintes en code MXML comme suit : <s:TextInput y="160" left="90" right="60"/>
Création d’une interface utilisateur avec Flash Builder
Les applications Flex sont orientées événements. Les composants de l’interface utilisateur réagissent à divers événements, par exemple lorsqu’un utilisateur clique sur un bouton ou lorsque l’initialisation d’un objet est terminée. Les gestionnaires d’événement, rédigés en code ActionScript, définissent la manière dont les composants réagissent à l’événement. Remarque : vous pouvez également générer des gestionnaires d’événement pour des éléments non visibles, tels que RemoteObject et HTTPService. Flash Builder assiste l’utilisateur par la génération des fonctions des gestionnaires d’événement pour un composant. Dans la fonction générée, rédigez le code qui définit le comportement du composant en réponse à l’événement. L’assistance pour la génération des gestionnaires d’événement est accessible :
• à partir du menu contextuel d’un élément en mode Création de l’éditeur MXML ; • à partir du menu contextuel d’un élément en mode Source de l’éditeur MXML.
Lorsque Flash Builder génère une fonction de gestionnaire d’événement, il place le gestionnaire d’événement dans le premier bloc Script du fichier. La fonction est placée à la fin du bloc Script. Le gestionnaire d’événement généré a un accès protégé et accepte la sous-classe appropriée de la classe Event comme seul paramètre. Flash Builder génère soit un nom unique pour le gestionnaire d’événement en fonction du nom de la classe du composant, soit un nom personnalisé pour le gestionnaire d’événement spécifié. Si vous ne précisez pas de nom personnalisé, le nom est généré selon le processus suivant :
• Si aucune propriété ID n’est définie pour le composant, Flash Builder génère un nom unique, basé sur le nom de la classe du composant. Vous devez fournir le corps du gestionnaire d’événement. Le bloc de code suivant contient un gestionnaire d’événement généré pour un contrôle Button. . . . <fx:Script> <
Notice Facile