flexIniziare con flex


Osservazioni

Apache Flex è un framework di applicazioni open source curato da Apache Foundation . Fornisce un ambiente in cui è possibile creare applicazioni SWF che possono essere eseguite su qualsiasi runtime Flash o compilate con Adobe Air per eseguire nativamente su ambienti mobili (Android, iOS, BlackBerry) e ambienti desktop come Windows e OSX.

Un'applicazione Flex è composta da due componenti: i file di layout MXML che descrivono l'interfaccia utente e il codice ActionScript3 per fornire la funzionalità. Questi due tipi di file sono compilati in un singolo SWF per l'implementazione.

Le applicazioni Flex possono accedere a tutti i principali server di applicazioni (Java, PHP, Ruby, .NET, ecc.) Tramite REST, SOAP, JSON, JMS e AMF.

Apache Flex SDK è dotato di un ampio set di componenti dell'interfaccia utente personalizzabili con un ciclo di vita completo dei componenti, un set di servizi (HTTPService, WebService, RemoteObject) e un set di Managers per cose come Styling, Skinning, Layout, Localizzazione, ecc.

Flex ha anche il supporto per l'accessibilità e un framework per il test di automazione.

Apache Flex è un progetto completamente open source e utilizza Apache License v. 2.0 . Ciò consente di utilizzare l'SDK e le uscite dell'SDK per uso personale e commerciale praticamente senza restrizioni.

Un tipico utilizzo è la creazione di un front-end ricco e interattivo basato su browser per un'applicazione Web il cui back-end sia Java o .NET e che si connetta ai servizi di dati attraverso quel server di applicazioni.

Apache Flex e Apache sono marchi registrati di Apache Software Foundation.

Versioni

Versione Data di rilascio
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 (corre in applicazione)

<?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 (funziona nel browser)

<?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>
 

Installazione o configurazione (Apache Flex)

Esistono due modi per configurare Apache Flex SDK. È possibile utilizzare Apache Flex SDK Installer fornito, un'applicazione Adobe AIR che automatizza il processo (su Windows o OS X / macOS). Oppure puoi installarlo manualmente, il che ovviamente richiede un maggiore comfort con la tua piattaforma, ma offre maggiore flessibilità con i dettagli di installazione.

Installazione di Apache Flex SDK utilizzando Apache Flex Installer

  1. Scarica il file binario del programma di installazione per il tuo sistema operativo (Windows, Mac o Linux).
  2. Esegui il programma di installazione
  3. Seleziona la versione dell'SDK che desideri scaricare. Il progetto Apache Flex suggerisce di scaricare l'ultima versione rilasciata.
  4. Seleziona la versione di Flash Player. Il progetto Flex suggerisce di lasciarlo come predefinito. Fare clic su Avanti .
  5. Seleziona una directory in cui installare l'SDK. Fare clic su Avanti .
  6. Controlla tutti i contratti di licenza. Fai clic su Installa .
  7. Attendi che il programma di installazione scarichi e installi Apache Flex SDK.

Installazione manuale di Apache Flex SDK

NOTA: questo può essere un processo lungo e coinvolto.

Prepara il tuo sistema

  1. Scarica e installa l'ultimo JDK Java
  2. Scarica e installa l'ultima versione di Ant
  3. Scarica e installa l'ultima versione di Git
  4. Scarica e installa l'ultimo JUnit

Imposta la struttura delle cartelle

  1. Creare la seguente struttura di directory sul computer per Flex SDK, di solito archiviata nella directory root o Documents.
/ApacheFlex
/ApacheFlex/dependencies
/ApacheFlex/source
 

Scarica fonte

  1. Apri un terminale e cambia la directory in:
/ApacheFlex/source
 
  1. Eseguire il seguente comando git per scaricare l'origine Flex SDK:
git clone https://git-wip-us.apache.org/repos/asf/flex-sdk.git flex-sdk
 
  1. Eseguire il seguente comando git per scaricare la sorgente TLF:
git clone https://git-wip-us.apache.org/repos/asf/flex-tlf.git flex-tlf
 
  1. Passare alla directory flex-sdk:
/ApacheFlex/source/flex-sdk
 
  1. Passare al ramo "sviluppo" (facoltativo):
git checkout develop
 

Modifica le proprietà dell'ambiente

Affinché gli script di build funzionino è necessario impostare le variabili di ambiente . Il file delle proprietà dell'ambiente contiene le variabili di ambiente che indicano le posizioni delle dipendenze che verranno utilizzate durante il processo. Questi sono usati dai vari script di compilazione per eseguire e compilare l'SDK. Aggiungerai ulteriori variabili d'ambiente attraverso il resto di questo tutorial. Quando esegui lo script di build in un secondo momento, lo script convaliderà i percorsi forniti e ti avviserà se non sono corretti.

  1. Creare il file delle proprietà dell'ambiente:

Nella directory flex-sdk creare una copia del file env-template.properties e denominarlo env.properties .

Poiché hai già installato Java e Ant, imposta il percorso di quelli aggiungendo quanto segue alla fine del file env.properties :

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

env.ANT_HOME=/Applications/Ant/bin
 
  1. Successivamente aggiungere il percorso alla directory TLF:
env.TLF_HOME=/ApacheFlex/source/flex-tlf
 

Aggiungi dipendenze richieste

Adobe AIR SDK

  1. Scarica l'Air SDK Flex Edition ( assicurati di scaricare l'edizione appositamente realizzata per Flex ).
  2. Estrai in:
/ApacheFlex/dependencies/AIRSDK/4.0
 

dove il nome della directory finale si riferisce alla versione dell'SDK AIR scaricata.

  1. Impostare la variabile di ambiente AIR_HOME sul percorso di AIR SDK selezionato nel passaggio precedente. Per esempio,
env.ANT_HOME=/ApacheFlex/dependencies/AIRSDK/4.0
 

Adobe Flash Player Projector

  1. Scarica il proiettore Flash Player
  2. Esegui il programma di installazione. Il programma di installazione di Projector Content Debugger non si installa in alcun luogo (almeno per me). Una volta eseguito il programma di installazione, è necessario copiarlo nella posizione desiderata. In questo caso, copialo nella /ApacheFlex/dependencies/player . Nota: su OSX, aggiungere ".app / Contents / MacOS / Flash Player Debugger" al percorso di Flash Player.
/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
 
  1. Impostare la variabile di ambiente FLASHPLAYER_DEBUGGER sul percorso di installazione del proiettore.
env.FLASHPLAYER_DEBUGGER=/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
 

Potresti anche essere in grado di utilizzare il plug-in di Flash Player. Di solito si trova qui: / Libreria / Internet Plug-in / Flash Player / Il percorso completo sarebbe: / Libreria / Plug-in Internet / Flash Player.app/Contents/MacOS/Flash Player Debugger

Adobe Flash Player playerglobal.swc

  1. Scarica playerglobal.swc : si trova nella stessa pagina del debugger dei contenuti appena scaricato.
  2. Copia su:
/ApacheFlex/dependencies/PlayerGlobal/player/12.0
 

dove il numero corrisponde alla versione scaricata.

  1. Rinomina il file copiato in "playerglobal.swc"
  2. Imposta la variabile di ambiente PLAYERGLOBAL_HOME su:
env.PLAYERGLOBAL_HOME=/ApacheFlex/Dependencies/PlayerGlobal/player
 

Adobe Pixel Bender Toolkit

  1. Scarica Pixel Bender per Windows o per Mac
  2. Installa Pixel Bender. Quando installi il programma ti dà la possibilità di scegliere il percorso di installazione. Copia questo percorso prima di installare.
  3. Impostare la variabile di ambiente PIXELBENDER_HOME nella directory di installazione.

Preparare il sistema

Per il test, il file mm.cfg di Adobe Flash Player deve avere le proprietà appropriate e un file FlashPlayerTrust deve consentire FlashPlayerTrust file SWF locali di accedere ai file locali.

  1. Apri il file mm.cfg in un editor. La posizione del file mm.cfg dipende dal tuo sistema operativo. Vedi questa pagina .
  2. Se non esiste, lancia manualmente il debugger del contenuto di Adobe Flash Player Projector e dovrebbe creare mm.cfg in quel momento.
  3. Aggiungi o verifica che le seguenti voci siano nel file:
ErrorReportingEnable=1
TraceOutputFileEnable=1
 
  1. Nella stessa directory del file mm.cfg si trova la directory FlashPlayerTrust.
  2. Apri quella directory e crea un nuovo file di testo chiamato ApacheFlex.cfg.
  3. In quel file aggiungi la directory genitore di Apache Flex SDK. Per esempio:
#Path to Apache Flex Source
/ApacheFlex/source
 
  1. Salva il file.

Imposta le proprietà di costruzione

  1. Nella directory flex-sdk è presente il file delle proprietà di build. Questo contiene i numeri di versione del software scaricato.
  2. Apri questo file e imposta i seguenti valori alla versione di Flash Player e AIR SDK che stai utilizzando:
# Flash player version for which player global swc to use
playerglobal.version = 12.0

# AIR version number
air.version = 4.0
 

Questi valori vengono utilizzati nella creazione del percorso dell'SDK. Quindi, se hai salvato il file playerglobal.swc nella seguente directory: /ApacheFlex/dependencies/PlayerGlobal/player/12.0 il valore di playerglobal.version sarebbe 12.0.

Nota: poiché questo valore crea il percorso, assicurati di utilizzare il valore completo, 12.0, anziché 12 se il percorso lo contiene.

Nota: se si sta utilizzando una nuova versione di Flash Player che non è ancora menzionata nella versione di Flex SDK con cui si sta lavorando, è possibile che venga visualizzato il messaggio: Errore: la variabile di configurazione 'swf-version' contiene un token sconosciuto 'playerglobal .swfversion 'Dovrai aggiornare il file /ApacheFlex/source/flex-sdk/frameworks/build.xml con un codice di controllo della versione aggiornato.