flexCommencer avec flex


Remarques

Apache Flex est un framework d'application open source conçu par Apache Foundation . Il fournit un environnement dans lequel vous pouvez créer des applications SWF qui peuvent être exécutées sur n'importe quel environnement d'exécution Flash ou compilées avec Adobe Air pour s'exécuter nativement sur des environnements mobiles (Android, iOS, BlackBerry) et des environnements de bureau tels que Windows et OSX.

Une application Flex comprend deux composants: les fichiers de mise en page MXML décrivant l'interface utilisateur et le code ActionScript3 pour fournir les fonctionnalités. Ces deux types de fichiers sont compilés dans un seul fichier SWF pour le déploiement.

Les applications Flex peuvent accéder à tous les principaux serveurs d'applications (Java, PHP, Ruby, .NET, etc.) via REST, SOAP, JSON, JMS et AMF.

Le SDK Apache Flex comprend un grand nombre de composants d'interface utilisateur habillables avec un cycle de vie complet des composants, un ensemble de services (HTTPService, WebService, RemoteObject) et un ensemble de gestionnaires tels que Styling, Skinning, Layout, Localization, etc.

Flex prend également en charge l'accessibilité et un cadre de test d'automatisation.

Apache Flex est un projet totalement open-source et utilise la licence Apache v. 2.0 . Cela vous permet d'utiliser le SDK et toutes les sorties du SDK pour une utilisation personnelle et commerciale sans aucune restriction.

Une utilisation typique consiste à créer une interface frontale riche et interactive, basée sur un navigateur, sur une application Web dont le backend serait Java ou .NET et à se connecter aux services de données via ce serveur d'applications.

Apache Flex et Apache sont des marques commerciales de Apache Software Foundation.

Versions

Version Date de sortie
Apache Flex SDK 4.15 2016-01-11
Apache Flex SDK 4.14.1 2015-03-31
Apache Flex SDK 4.14.0 2015-02-03
Apache Flex SDK 4.13.0 2014-07-28
Apache Flex SDK 4.12.1 2014-05-03
Apache Flex SDK 4.12.0 2014-03-10
Apache Flex SDK 4.11.0 2013-10-28
Apache Flex SDK 4.10.0 2013-08-06
Apache Flex SDK 4.9.0 2013-02-28

Hello World (fonctionne dans l'application)

<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                       xmlns:s="library://ns.adobe.com/flex/spark" 
                       xmlns:mx="library://ns.adobe.com/flex/mx">

    <s:Label text="Hello World!" />

</s:WindowedApplication>
 

Hello World (fonctionne dans le navigateur)

<?xml version="1.0" encoding="utf-8"?>
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" 
    xmlns:s="library://ns.adobe.com/flex/spark" 
    xmlns:mx="library://ns.adobe.com/flex/mx">

    <s:Label text="Hello World!" />

</s:Application>
 

Installation ou configuration (Apache Flex)

Il existe deux manières de configurer le SDK Apache Flex. Vous pouvez utiliser Apache Flex SDK Installer fourni, une application Adobe AIR qui automatise le processus (sous Windows ou OS X / macOS). Ou vous pouvez l'installer manuellement, ce qui nécessite évidemment un plus grand confort avec votre plate-forme mais offre plus de flexibilité avec les détails de l'installation.

Installation d'Apache Flex SDK à l'aide d'Apache Flex Installer

  1. Téléchargez le programme d' installation de votre système d'exploitation (Windows, Mac ou Linux).
  2. Exécutez le programme d'installation
  3. Sélectionnez la version du SDK que vous souhaitez télécharger. Le projet Apache Flex suggère de télécharger la dernière version publiée.
  4. Sélectionnez la version de Flash Player. Le projet Flex suggère de le laisser par défaut. Cliquez sur Suivant .
  5. Sélectionnez un répertoire dans lequel vous souhaitez installer le SDK. Cliquez sur Suivant .
  6. Vérifiez tous les contrats de licence. Cliquez sur Installer .
  7. Attendez que le programme d'installation télécharge et installe le SDK Apache Flex.

Installation manuelle d'Apache Flex SDK

NOTE: Cela peut être un processus long et complexe.

Préparez votre système

  1. Téléchargez et installez le dernier Java JDK
  2. Téléchargez et installez la dernière version de Ant
  3. Téléchargez et installez la dernière version de Git
  4. Téléchargez et installez la dernière version de JUnit

Configurer la structure des dossiers

  1. Créez la structure de répertoires suivante sur votre ordinateur pour le SDK Flex, généralement stockée dans le répertoire racine ou Documents.
/ApacheFlex
/ApacheFlex/dependencies
/ApacheFlex/source
 

Télécharger la source

  1. Ouvrez un terminal et changez le répertoire en:
/ApacheFlex/source
 
  1. Exécutez la commande git suivante pour télécharger la source Flex SDK:
git clone https://git-wip-us.apache.org/repos/asf/flex-sdk.git flex-sdk
 
  1. Exécutez la commande git suivante pour télécharger la source TLF:
git clone https://git-wip-us.apache.org/repos/asf/flex-tlf.git flex-tlf
 
  1. Accédez au répertoire flex-sdk:
/ApacheFlex/source/flex-sdk
 
  1. Passez à la branche "développer" (facultatif):
git checkout develop
 

Modifier les propriétés de l'environnement

Pour que les scripts de génération fonctionnent, vous devez définir les variables d'environnement . Le fichier de propriétés d'environnement contient les variables d'environnement qui indiquent l'emplacement des dépendances que vous utiliserez tout au long du processus. Ceux-ci sont utilisés par les différents scripts de génération pour exécuter et compiler le SDK. Vous allez ajouter des variables d'environnement supplémentaires tout au long de ce didacticiel. Lorsque vous exécuterez le script de génération ultérieurement, le script validera les chemins fournis et vous avertira s’ils sont incorrects.

  1. Créez le fichier de propriétés de l'environnement:

Dans le répertoire flex-sdk , créez une copie du fichier env-template.properties et nommez-le env.properties .

Comme vous avez déjà installé Java et Ant, définissez le chemin d'accès en ajoutant les éléments suivants à la fin du fichier env.properties :

env.JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/Current/Commands/java

env.ANT_HOME=/Applications/Ant/bin
 
  1. Ensuite, ajoutez le chemin au répertoire TLF:
env.TLF_HOME=/ApacheFlex/source/flex-tlf
 

Ajouter des dépendances requises

SDK Adobe AIR

  1. Téléchargez le fichier Air SDK Flex Edition ( veillez à télécharger l'édition spécialement conçue pour Flex ).
  2. Extraire vers:
/ApacheFlex/dependencies/AIRSDK/4.0
 

où le nom du répertoire final fait référence à la version du kit SDK AIR que vous avez téléchargé.

  1. Définissez la variable d'environnement AIR_HOME sur le chemin AIR SDK que vous avez choisi à l'étape précédente. Par exemple,
env.ANT_HOME=/ApacheFlex/dependencies/AIRSDK/4.0
 

Adobe Flash Player Projecteur

  1. Télécharger le projecteur Flash Player
  2. Exécutez le programme d'installation. Le programme d'installation de Projector Content Debugger ne s'installe nulle part (pour moi au moins). Une fois que vous exécutez le programme d'installation, vous devez le copier à l'emplacement souhaité. Dans ce cas, copiez-le dans le /ApacheFlex/dependencies/player . Remarque: sous OSX, ajoutez «.app / Contents / MacOS / Flash Player Debugger» au chemin d'accès à Flash Player.
/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
 
  1. Définissez la variable d'environnement FLASHPLAYER_DEBUGGER sur le chemin d'installation du projecteur.
env.FLASHPLAYER_DEBUGGER=/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
 

Vous pouvez également utiliser le plug-in Flash Player. Il se trouve généralement ici: / Bibliothèque / Plug-ins Internet / Flash Player / Le chemin complet serait: / Bibliothèque / Plug-ins Internet / Flash Player.app/Contents/MacOS/Flash Player Debugger

Adobe Flash Player playerglobal.swc

  1. Download playerglobal.swc - Ceci est sur la même page que le débogueur de contenu que vous venez de télécharger.
  2. Copiez-le dans:
/ApacheFlex/dependencies/PlayerGlobal/player/12.0
 

où le numéro correspond à la version que vous téléchargez.

  1. Renommez le fichier copié en 'playerglobal.swc'
  2. Définissez la variable d'environnement PLAYERGLOBAL_HOME sur:
env.PLAYERGLOBAL_HOME=/ApacheFlex/Dependencies/PlayerGlobal/player
 

Adobe Pixel Bender Toolkit

  1. Télécharger Pixel Bender pour Windows ou pour Mac
  2. Installez Pixel Bender. Lorsque vous installez le programme, vous avez la possibilité de choisir l'emplacement d'installation. Copiez cet emplacement avant d'installer.
  3. Définissez la variable d'environnement PIXELBENDER_HOME sur le répertoire d'installation.

Préparer le système

Pour tester, le fichier mm.cfg Adobe Flash Player doit avoir les propriétés appropriées et un fichier FlashPlayerTrust doit permettre aux fichiers SWF locaux d'accéder aux fichiers locaux.

  1. Ouvrez le fichier mm.cfg dans un éditeur. L'emplacement du fichier mm.cfg dépend de votre système d'exploitation. Voir cette page
  2. S'il n'existe pas, lancez manuellement le débogueur de contenu Adobe Flash Player Projector et celui-ci devrait créer le mm.cfg à ce moment.
  3. Ajoutez ou vérifiez que les entrées suivantes se trouvent dans le fichier:
ErrorReportingEnable=1
TraceOutputFileEnable=1
 
  1. Dans le même répertoire que le fichier mm.cfg se trouve le répertoire FlashPlayerTrust.
  2. Ouvrez ce répertoire et créez un nouveau fichier texte appelé ApacheFlex.cfg.
  3. Dans ce fichier, ajoutez le répertoire parent du SDK Apache Flex. Par exemple:
#Path to Apache Flex Source
/ApacheFlex/source
 
  1. Enregistrez le fichier.

Définir les propriétés de construction

  1. Dans le répertoire flex-sdk se trouve le fichier de propriétés de génération. Ceci contient les numéros de version du logiciel que vous avez téléchargé.
  2. Ouvrez ce fichier et définissez les valeurs suivantes sur la version du lecteur Flash et du kit SDK AIR que vous utilisez:
# Flash player version for which player global swc to use
playerglobal.version = 12.0

# AIR version number
air.version = 4.0
 

Ces valeurs sont utilisées dans la construction du chemin d'accès au SDK. Donc, si vous avez enregistré playerglobal.swc dans le répertoire suivant: /ApacheFlex/dependencies/PlayerGlobal/player/12.0, la valeur de playerglobal.version serait 12.0.

Remarque: Étant donné que cette valeur génère le chemin, veillez à utiliser la valeur complète 12.0 au lieu de 12 si votre chemin le contient.

Remarque: Si vous utilisez une nouvelle version de Flash Player qui n'est pas encore mentionnée dans la version du kit de développement Flex que vous utilisez, vous pouvez obtenir le message suivant: Erreur: la variable de configuration 'swf-version' contient un jeton inconnu 'playerglobal .swfversion 'Vous devrez mettre à jour le fichier /ApacheFlex/source/flex-sdk/frameworks/build.xml avec un code de vérification de version mis à jour.