flexKomma igång med flex


Anmärkningar

Apache Flex är en öppen källkodsram ramad av Apache Foundation . Det ger en miljö där du kan bygga SWF-applikationer som sedan kan köras på vilken Flash-runtime som helst eller kompileras med Adobe Air för att exekvera nativt i mobila miljöer (Android, iOS, BlackBerry) och stationära miljöer som Windows och OSX.

En Flex-applikation består av två komponenter: MXML-layoutfiler som beskriver UI och ActionScript3- koden för att tillhandahålla funktionaliteten. Dessa två typer av filer sammanställs till en enda SWF för distribution.

Flex-applikationer kan komma åt alla större applikationsservrar (Java, PHP, Ruby, .NET, etc.) genom REST, SOAP, JSON, JMS och AMF.

Apache Flex SDK kommer med stora uppsättningar av skinnbara användargränssnittskomponenter med en komplett komponent livscykel, en uppsättning tjänster (HTTPService, WebService, RemoteObject) och en uppsättning av Managers för saker som Styling, Skinning, Layout, Localization, etc.

Flex har också tillgänglighetsstöd och ett ramverk för automatiseringstest.

Apache Flex är ett helt öppen källkodsprojekt och använder Apache License v. 2.0 . Detta gör att du kan använda SDK och alla utgångar från SDK för personligt och kommersiellt bruk med praktiskt taget inga begränsningar.

En typisk användning är att bygga en rik, interaktiv webbläsarbaserad frontend till en webbapplikation vars backend skulle vara Java eller .NET och ansluta till datatjänster via den applikationsservern.

Apache Flex och Apache är varumärken som tillhör Apache Software Foundation.

versioner

Version Utgivningsdatum
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 (körs i ansökan)

<?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 (körs i webbläsaren)

<?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 eller installation (Apache Flex)

Det finns två sätt att konfigurera Apache Flex SDK. Du kan använda den medföljande Apache Flex SDK Installer, en Adobe AIR-applikation som automatiserar processen (på Windows eller OS X / macOS). Eller så kan du installera det manuellt vilket uppenbarligen kräver större komfort med din plattform men ger mer flexibilitet med installationsinformationen.

Installera Apache Flex SDK med Apache Flex-installationsprogrammet

  1. Ladda ner installationsprogrammet binärt för ditt operativsystem (Fönster, Mac eller Linux).
  2. Kör installationsprogrammet
  3. Välj den version av SDK som du vill ladda ner. Apache Flex-projektet föreslår att du laddar ner den senaste versionen.
  4. Välj Flash Player-version. Flex-projektet föreslår att du lämnar det som standard. Klicka på Nästa .
  5. Välj en katalog där du vill att SDK ska installeras. Klicka på Nästa .
  6. Kontrollera alla licensavtal. Klicka på Installera .
  7. Vänta tills installationsprogrammet laddar ner och installerar Apache Flex SDK.

Installera Apache Flex SDK manuellt

OBS: Det här kan vara en lång och involverad process.

Förbered ditt system

  1. Ladda ner och installera den senaste Java JDK
  2. Ladda ner och installera den senaste versionen av Ant
  3. Ladda ner och installera den senaste versionen av Git
  4. Ladda ner och installera den senaste JUnit

Ställ in mappstrukturen

  1. Skapa följande katalogstruktur på din dator för Flex SDK, vanligtvis lagrad i rot- eller dokumentkatalogen.
/ApacheFlex
/ApacheFlex/dependencies
/ApacheFlex/source
 

Hämta källkod

  1. Öppna en terminal och ändra katalogen till:
/ApacheFlex/source
 
  1. Kör följande git-kommando för att ladda ner Flex SDK-källan:
git clone https://git-wip-us.apache.org/repos/asf/flex-sdk.git flex-sdk
 
  1. Kör följande git-kommando för att ladda ner TLF-källan:
git clone https://git-wip-us.apache.org/repos/asf/flex-tlf.git flex-tlf
 
  1. Byt till flex-sdk-katalogen:
/ApacheFlex/source/flex-sdk
 
  1. Byt till "utveckla" grenen (valfritt):
git checkout develop
 

Redigera miljöegenskaperna

För att byggskripten ska fungera måste du ställa in miljövariablerna . Miljöegenskapsfilen innehåller miljövariabler som pekar på platserna för beroenden du kommer att använda under hela processen. Dessa används av de olika build-skript för att köra och sammanställa SDK. Du lägger till ytterligare miljövariabler genom resten av denna handledning. När du kör build-skriptet senare validerar skriptet de tillhandahållna banorna och varnar dig om de är felaktiga.

  1. Skapa filen för miljöegenskaper:

flex-sdk en kopia av filen env-template.properties i flex-sdk katalogen och namnge den env.properties .

Eftersom du redan har installerat Java och Ant, ställer du in sökvägen för dem genom att lägga till följande i slutet av filen env.properties :

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

env.ANT_HOME=/Applications/Ant/bin
 
  1. Lägg sedan till sökvägen till TLF-katalogen:
env.TLF_HOME=/ApacheFlex/source/flex-tlf
 

Lägg till erforderliga beroenden

Adobe AIR SDK

  1. Ladda ner Air SDK Flex Edition ( Se till att ladda ner den utgåvan som är speciellt gjord för Flex ).
  2. Extrahera till:
/ApacheFlex/dependencies/AIRSDK/4.0
 

där det slutliga katalognamnet hänvisar till versionen av AIR SDK som du laddade ner.

  1. Ställ in AIR_HOME miljövariabeln till den AIR SDK-sökväg du valde i föregående steg. Till exempel,
env.ANT_HOME=/ApacheFlex/dependencies/AIRSDK/4.0
 

Adobe Flash Player-projektor

  1. Ladda ner Flash Player-projektorn
  2. Kör installationsprogrammet. Projector Content Debugger-installationsprogrammet installeras inte någonstans (åtminstone för mig). När du har installerat installationsprogrammet måste du kopiera det till den plats du vill ha. I detta fall kopierar du det till /ApacheFlex/dependencies/player . Obs: i OSX lägg till '.app / Contents / MacOS / Flash Player Debugger' till sökvägen till Flash Player.
/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
 
  1. Ställ in FLASHPLAYER_DEBUGGER på installationsvägen för projektorn.
env.FLASHPLAYER_DEBUGGER=/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
 

Du kanske också kan använda Flash Player-insticksprogrammet. Det finns vanligtvis här: / Bibliotek / Internet-plugin-program / Flash Player / Hela sökvägen skulle vara: / Library / Internet Plug-ins / Flash Player.app/Contents/MacOS/Flash Player Debugger

Adobe Flash Player playerglobal.swc

  1. Ladda ner playerglobal.swc - Det här är på samma sida som innehållsfelsökaren du just har laddat ner.
  2. Kopiera det till:
/ApacheFlex/dependencies/PlayerGlobal/player/12.0
 

där numret motsvarar den version du laddar ner.

  1. Byt namn på den kopierade filen till 'playerglobal.swc'
  2. Ställ in PLAYERGLOBAL_HOME på:
env.PLAYERGLOBAL_HOME=/ApacheFlex/Dependencies/PlayerGlobal/player
 

Adobe Pixel Bender Toolkit

  1. Ladda ner Pixel Bender för Windows eller Mac
  2. Installera Pixel Bender. När du installerar programmet ger det dig möjlighet att välja installationsplats. Kopiera den här platsen innan du installerar.
  3. Ställ in PIXELBENDER_HOME i installationskatalogen.

Förbered systemet

För testning måste Adobe Flash Player- mm.cfg filen ha rätt egenskaper och en FlashPlayerTrust fil måste tillåta lokala SWF: er att komma åt lokala filer.

  1. Öppna mm.cfg filen i en redigerare. Platsen för mm.cfg filen beror på ditt operativsystem. Se den här sidan .
  2. Om det inte finns, starta Adobe Flash Player Projector innehållsfelsökare manuellt och det bör skapa mm.cfg vid den tiden.
  3. Lägg till eller verifiera att följande poster finns i filen:
ErrorReportingEnable=1
TraceOutputFileEnable=1
 
  1. I samma katalog som mm.cfg-filen är FlashPlayerTrust-katalogen.
  2. Öppna den katalogen och skapa en ny textfil som heter ApacheFlex.cfg.
  3. Lägg till den överordnade katalogen till Apache Flex SDK i den filen. Till exempel:
#Path to Apache Flex Source
/ApacheFlex/source
 
  1. Spara filen.

Ställ in Byggegenskaper

  1. I flex-sdk-katalogen är filen för byggegenskaper. Detta innehåller versionnumren för programvaran som du laddade ner.
  2. Öppna den här filen och ställ in följande värden på den version av Flash Player och AIR SDK som du använder:
# Flash player version for which player global swc to use
playerglobal.version = 12.0

# AIR version number
air.version = 4.0
 

Dessa värden används för att bygga vägen till SDK. Så om du sparat playerglobal.swc i följande katalog: /ApacheFlex/dependences/PlayerGlobal/player/12.0 skulle värdet på playerglobal.version vara 12,0.

Obs! Eftersom detta värde bygger sökvägen måste du använda det fulla värdet, 12.0, istället för 12 om din sökväg innehåller den.

Obs: Om du använder en ny version av Flash Player som ännu inte nämns i versionen av Flex SDK som du arbetar med kan du få meddelandet: Fel: konfigurationsvariabeln 'swf-version' värde innehåller okänt token 'playerglobal .swfversion 'Du måste uppdatera filen /ApacheFlex/source/flex-sdk/frameworks/build.xml med en uppdaterad versionskontrollkod.