flexAan de slag met flex


Opmerkingen

Apache Flex is een open source applicatie-framework samengesteld door de Apache Foundation . Het biedt een omgeving waar u SWF-toepassingen kunt bouwen die vervolgens op elke Flash-runtime kunnen worden uitgevoerd of met Adobe Air kunnen worden gecompileerd om native op mobiele omgevingen (Android, iOS, BlackBerry) en desktopomgevingen zoals Windows en OSX te worden uitgevoerd.

Een Flex-toepassing bestaat uit twee componenten: MXML-layoutbestanden die de gebruikersinterface en ActionScript3- code beschrijven om de functionaliteit te bieden. Deze twee soorten bestanden worden gecompileerd in een enkele SWF voor implementatie.

Flex-applicaties hebben toegang tot alle belangrijke applicatieservers (Java, PHP, Ruby, .NET, etc.) via REST, SOAP, JSON, JMS en AMF.

De Apache Flex SDK wordt geleverd met een grote set van skinnable gebruikersinterfacecomponenten met een volledige componentenlevenscyclus, een set services (HTTPService, WebService, RemoteObject) en een set managers voor zaken als Styling, Skinning, Layout, Localization, etc.

Flex heeft ook toegankelijkheidsondersteuning en een automatisering-testraamwerk.

Apache Flex is een volledig open-source project en maakt gebruik van de Apache License v. 2.0 . Hiermee kunt u de SDK en alle uitgangen van de SDK gebruiken voor persoonlijk en commercieel gebruik zonder enige beperkingen.

Een typisch gebruik is het bouwen van een rijke, interactieve, op een browser gebaseerde frontend voor een webtoepassing waarvan de back-end Java of .NET zou zijn en verbinding maakt met gegevensservices via die toepassingsserver.

Apache Flex en Apache zijn handelsmerken van The Apache Software Foundation.

versies

Versie Publicatiedatum
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

Hallo wereld (wordt uitgevoerd in toepassing)

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

Hallo wereld (draait in 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>
 

Installatie of instellingen (Apache Flex)

Er zijn twee manieren om de Apache Flex SDK in te stellen. U kunt het meegeleverde Apache Flex SDK-installatieprogramma gebruiken, een Adobe AIR-toepassing die het proces automatiseert (op Windows of OS X / macOS). Of u kunt het handmatig installeren, wat uiteraard een groter comfort met uw platform vereist, maar meer flexibiliteit biedt met de installatiedetails.

Apache Flex SDK installeren met het Apache Flex-installatieprogramma

  1. Download het installatieprogramma binair voor uw besturingssysteem (Windows, Mac of Linux).
  2. Voer het installatieprogramma uit
  3. Selecteer de versie van de SDK die u wilt downloaden. Het Apache Flex-project suggereert dat u de nieuwste versie downloadt.
  4. Selecteer de Flash Player-versie. Het Flex-project suggereert dat u het als standaard laat staan. Klik op Volgende .
  5. Selecteer een map waarin u de SDK wilt installeren. Klik op Volgende .
  6. Controleer alle licentieovereenkomsten. Klik op installeren .
  7. Wacht tot het installatieprogramma de Apache Flex SDK heeft gedownload en geïnstalleerd.

Apache Flex SDK handmatig installeren

OPMERKING: dit kan een langdurig en betrokken proces zijn.

Bereid uw systeem voor

  1. Download en installeer de nieuwste Java JDK
  2. Download en installeer de nieuwste versie van Ant
  3. Download en installeer de nieuwste versie van Git
  4. Download en installeer de nieuwste JUnit

Stel de mapstructuur in

  1. Maak de volgende mapstructuur op uw computer voor de Flex SDK, meestal opgeslagen in de hoofdmap of de map Documenten.
/ApacheFlex
/ApacheFlex/dependencies
/ApacheFlex/source
 

Download bron

  1. Open een terminal en wijzig de map in:
/ApacheFlex/source
 
  1. Voer de volgende git-opdracht uit om de Flex SDK-bron te downloaden:
git clone https://git-wip-us.apache.org/repos/asf/flex-sdk.git flex-sdk
 
  1. Voer de volgende git-opdracht uit om de TLF-bron te downloaden:
git clone https://git-wip-us.apache.org/repos/asf/flex-tlf.git flex-tlf
 
  1. Ga naar de map flex-sdk:
/ApacheFlex/source/flex-sdk
 
  1. Schakel over naar de 'ontwikkel'-tak (optioneel):
git checkout develop
 

Bewerk de omgevingseigenschappen

Om de buildscripts te laten werken, moet u de omgevingsvariabelen instellen . Het omgevingseigenschappenbestand bevat de omgevingsvariabelen die verwijzen naar de locaties van de afhankelijkheden die u tijdens het proces zult gebruiken. Deze worden door de verschillende buildscripts gebruikt om de SDK uit te voeren en te compileren. U zult extra omgevingsvariabelen toevoegen in de rest van deze zelfstudie. Wanneer u het build-script later uitvoert, valideert het script de aangeboden paden en wordt u gewaarschuwd als deze onjuist zijn.

  1. Maak het omgevingseigenschappenbestand:

Maak in de map flex-sdk een kopie van het bestand env-template.properties en noem het env.properties .

Aangezien u Java en Ant al hebt geïnstalleerd, stelt u het pad van die in door het volgende aan het einde van het bestand env.properties voegen:

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

env.ANT_HOME=/Applications/Ant/bin
 
  1. Voeg vervolgens het pad toe aan de TLF-map:
env.TLF_HOME=/ApacheFlex/source/flex-tlf
 

Vereiste afhankelijkheden toevoegen

Adobe AIR SDK

  1. Download de Air SDK Flex-editie ( download de versie die speciaal voor Flex is gemaakt ).
  2. Uitpakken naar:
/ApacheFlex/dependencies/AIRSDK/4.0
 

waarbij de uiteindelijke mapnaam verwijst naar de versie van de AIR SDK die u hebt gedownload.

  1. Stel de omgevingsvariabele AIR_HOME op het AIR SDK-pad dat u in de vorige stap hebt gekozen. Bijvoorbeeld,
env.ANT_HOME=/ApacheFlex/dependencies/AIRSDK/4.0
 

Adobe Flash Player-projector

  1. Download de Flash Player-projector
  2. Voer het installatieprogramma uit. Het installatieprogramma van Content Debugger van de projector wordt nergens (voor mij tenminste) geïnstalleerd. Nadat u het installatieprogramma hebt uitgevoerd, moet u het naar de gewenste locatie kopiëren. Kopieer dit in dit geval naar de /ApacheFlex/dependencies/player . Opmerking: voeg op OSX '.app / Inhoud / MacOS / Flash Player Debugger' toe aan het pad naar de Flash Player.
/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
 
  1. Stel de omgevingsvariabele FLASHPLAYER_DEBUGGER op het installatiepad van de projector.
env.FLASHPLAYER_DEBUGGER=/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
 

Mogelijk kunt u ook de Flash Player-plug-in gebruiken. Deze bevindt zich meestal hier: / Bibliotheek / Internet-plug-ins / Flash Player / Het volledige pad zou zijn: / Bibliotheek / Internet-plug-ins / Flash Player.app/Contents/MacOS/Flash Player Debugger

Adobe Flash Player playerglobal.swc

  1. Playerglobal.swc downloaden - Dit is op dezelfde pagina als de inhouddebugger die u zojuist hebt gedownload.
  2. Kopieer het naar:
/ApacheFlex/dependencies/PlayerGlobal/player/12.0
 

waarbij het nummer overeenkomt met de versie die u downloadt.

  1. Naam van gekopieerd bestand wijzigen in 'playerglobal.swc'
  2. Stel de omgevingsvariabele PLAYERGLOBAL_HOME op:
env.PLAYERGLOBAL_HOME=/ApacheFlex/Dependencies/PlayerGlobal/player
 

Adobe Pixel Bender Toolkit

  1. Pixel Bender downloaden voor Windows of voor Mac
  2. Pixel Bender installeren. Wanneer u het programma installeert, kunt u de installatielocatie kiezen. Kopieer deze locatie voordat u installeert.
  3. Stel de omgevingsvariabele PIXELBENDER_HOME op de installatiemap.

Systeem voorbereiden

Voor het testen moet het mm.cfg bestand van de Adobe Flash Player de juiste eigenschappen hebben ingesteld en een FlashPlayerTrust bestand moet lokale SWF's toegang geven tot lokale bestanden.

  1. Open het mm.cfg bestand in een editor. De locatie van het mm.cfg bestand is afhankelijk van uw besturingssysteem. Zie deze pagina .
  2. Als het niet bestaat, start u handmatig de mm.cfg van Adobe Flash Player Projector en zou het op dat moment de mm.cfg moeten maken.
  3. Voeg toe of controleer of de volgende vermeldingen in het bestand staan:
ErrorReportingEnable=1
TraceOutputFileEnable=1
 
  1. In dezelfde map als het mm.cfg-bestand bevindt zich de map FlashPlayerTrust.
  2. Open die map en maak een nieuw tekstbestand met de naam ApacheFlex.cfg.
  3. Voeg in dat bestand de bovenliggende map van Apache Flex SDK toe. Bijvoorbeeld:
#Path to Apache Flex Source
/ApacheFlex/source
 
  1. Bewaar het bestand.

Stel de build-eigenschappen in

  1. In de map flex-sdk bevindt zich het bestand met buildeigenschappen. Dit bevat de versienummers van de software die u hebt gedownload.
  2. Open dit bestand en stel de volgende waarden in op de versie van de Flash Player en AIR SDK die u gebruikt:
# Flash player version for which player global swc to use
playerglobal.version = 12.0

# AIR version number
air.version = 4.0
 

Deze waarden worden gebruikt bij het samenstellen van het pad naar de SDK. Dus als je playerglobal.swc in de volgende map hebt opgeslagen: /ApacheFlex/dependencies/PlayerGlobal/player/12.0 zou de waarde van playerglobal.version 12.0 zijn.

Opmerking: aangezien deze waarde het pad bouwt, moet u de volledige waarde 12.0 gebruiken in plaats van 12 als uw pad het pad bevat.

Opmerking: als u een nieuwe versie van de Flash Player gebruikt die nog niet wordt genoemd in de versie van de Flex SDK waarmee u werkt, wordt mogelijk het volgende bericht weergegeven: Fout: configuratievariabele 'swf-version' waarde bevat onbekend token 'playerglobal .swfversion 'U moet het bestand /ApacheFlex/source/flex-sdk/frameworks/build.xml bijwerken met een bijgewerkte /ApacheFlex/source/flex-sdk/frameworks/build.xml .