The World In A State of Flex http://unitedmindset.com/jonbcampos Jonathan Campos's Blog about Flex and the Flash Platform Wed, 24 Feb 2010 22:52:42 +0000 http://wordpress.org/?v=2.9.2 en hourly 1 Connect Pro Available in iTunes Store http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/kX1LW96Z0c0/ http://unitedmindset.com/jonbcampos/2010/02/24/connect-pro-available-in-itunes-store/#comments Wed, 24 Feb 2010 22:42:41 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1362 This new Adobe Product release allows for full interaction with Adobe Connect for iPad and iPhone devices. So now you can watch, list, and interact with real-time presentations from your mobile device. More information and key features provided in the following video.

Oh… and it’s FREE!

Hint: Search “Adobe Connect” to find the app.

Sorry, it's a video and HTML5 just isn't there yet.

More details at the Adobe Connect Pro Blog Site.

Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/02/24/connect-pro-available-in-itunes-store/feed/ 0 http://unitedmindset.com/jonbcampos/2010/02/24/connect-pro-available-in-itunes-store/ The Master Flex ANT File http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/D_HNGhrKgpc/ http://unitedmindset.com/jonbcampos/2010/02/09/the-master-flex-ant-file/#comments Tue, 09 Feb 2010 15:00:32 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1098 When this is all done and running, listen closely. Somewhere in the distance you can here “I HAVE THE POWER!“. Trust me, it’s being said – or maybe that’s just me.

Seriously though, at this point you have one bad-ass ANT build file that will work right into your continuous integration script. Now you can make a release quality build, document it, and run both unit tests and automated tests against your application.

Final Touches
One final task I would include in this master build file is the zipped up application with all of the information from the deploy folder – all packaged up and ready to ship. This simple addition is the last thing to take place, the code is included below.

1
2
3
4
5
    <target name="zipApplication">
        <zip destfile="${Deploy.dir}/${Application.name}.zip">
            <fileset dir="${Deploy.dir}" />
        </zip>
    </target>

This target selects a specific folder (the deploy folder) and zips it up into a single file with the same name of the Application.

The Final Application

Get Adobe Flash player
The final application – view source enabled.

Recreating My Projects
Below is a zip file of all the projects that were created for this series and a short explanation of what can be found in each project.

Unit Test Project Folder
The Unit Test Project Folder
This project includes the FlexUnit tasks and the required SWCs to run the TestRunner from Flex/Flash Builder. On top of that, this project includes the build and property scripts to run the unit tests from ANT without the application.


Application Project Folder
The Main Project Folder
This project includes the master build.xml and build.properties files along with the necessary code to run the basic application and FlexMonkey tests. The build file is dependent on both the library and unit test projects to be able to run completely. The main project though can be run in Flex/Flash Builder without the other libraries.


Library Project Folder
Library Project Folder
This project includes the code necessary for the “SuperLabel” component and flextasks. In addition to the base project I have included the build scripts to build the actual library by itself without the main application.

Finally we have the project files all zipped up into one file for your consumption.
Projects – Zip Folder containing the Library, Application, and Unit Test Projects.

Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/02/09/the-master-flex-ant-file/feed/ 2 http://unitedmindset.com/jonbcampos/2010/02/09/the-master-flex-ant-file/ Run FlexMonkey Tests from ANT http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/MXdOzfANaf0/ http://unitedmindset.com/jonbcampos/2010/02/04/run-flexmonkey-tests-from-ant/#comments Thu, 04 Feb 2010 15:00:03 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1115 flexmonkey Like FlexUnit tests I am going to assume a few things:
1) You already have a working understanding of FlexMonkey.
2) You already have a build script set up (or have read the previous posts in this series.
3) You already have a properties file you are using (or setting all the properties directly into the build script.

If you do not know about FlexMonkey, FlexMonkey is:
FlexMonkey is a testing framework for Flex apps that provides for the capture, replay and verification of Flex UI functionality. FlexMonkey can record and playback Flex UI interactions, and generates ActionScript-based testing scripts that can easily be included within a continuous integration process. It uses the Flex Automation API and was created by extending Adobe’s sample automation adapter, AutoQuick.

For more information visit the Flex Monkey Project Home Site.

Unlike FlexUnit where it is run from a pretty little project, FlexMonkey has a lot of moving parts and requires quite a bit of setup. If you are running the automated tests from their AIR application then the process is pretty simple and all you have to do is hit the run button and you get all the information you need immediately.

However, setting up your application to run with FlexMonkey via ANT be prepared for a lot of setup and making sure everything fits just right. What I am really going to highlight here is what files to make sure to have and at what version.

The SDK version that your Application is built with is very important with FlexMonkey. You MUST be building with at least Flex 3.3 or you will be unable to run your application.

Keep Things In Order
The order of the previous steps didn’t really matter. Unit Test before building the application? Sure. Build your wrapper at the end? Why not. But now we do need to make sure that the application is made prior to running the automation test. I know this seems overly obvious, but I felt that it needed to be said that you had to have a build application to test on. This isn’t so with FlexUnit tests as the application required to run and the code are separate from the main application. Now with the automated tests we need to run against the main compiled application.

Gather the Parts
You can always pull the required parts from my main app, but if you are going to look for them, this is the list that you will need to put together. I would recommend including all this under one folder in your main project so that again the code for your FlexMonkey test isn’t cluttering up the main application.
flexmonkeyfolder
For most of these files I just went straight to their current source and pulled them from a project titled MonkeyAccessories. This is where you can get the MonkeyTestLauncher (html/swf), AC_OETags, AirMonkeyLibrary (for AIR builds), fluint, monkey-ant-task.jar, and MonkeyFlexUnitLibrary.

The remainder of the files are created either by the FlexMonkey AIR Application or by you. When you create a new FlexMonkey project you can select the location for the project to be hosted. This give you the monkeyTestProject and monkeyTestSuites. Then as you make your tests you will be adding in snapshot files into your snapshots folder. Also, the testSuites folder and it’s contents are created when you select to generate AS3 in the FlexMonkey App. The generated code you “can” edit, but you probably should. More than likely you will never have to go into these folders. Finally there s the test module for your project. This is used if you are running under targeting the specific swf or monkey agent mode (in your project properties).

You can name this module however you like and is used to run the automated test in the MonkeyTestLauncher provided by FlexMonkey.

Here is the code for my module, ANTBuildProjectTestModule.mxml:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<?xml version="1.0" encoding="utf-8"?>
<mx:Module implements="net.digitalprimates.fluint.modules.ITestSuiteModule" xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:Script>
        <![CDATA[
            import testSuites.mainTestSuite.mainTestSuite;
           
            public function getTestSuites():Array
            {
                var suiteArray:Array = [];
                suiteArray.push(new mainTestSuite());
                return suiteArray;
            }
        ]]>
    </mx:Script>
</mx:Module>

You’ll notice that the module implements an interface provided for you in the MonkeyFlexUnitLibrary and then set the array of testSuites to run from your generated AS3 tests.

With your flexMonkey folder all set up we can now start working with our ANT build file.

The FlexMonkey Steps
To run the FlexMonkey ANT build tasks we will need to add these additional steps after the application has been build.

  • Clean and Create the FlexMonkey Report Folder
  • Compile the FlexMonkey Tester Module
  • Copy Launcher Files into Test Folder
  • Run Automated Test

Defining The Monkey Launcher ANT Task
In the earlier steps we were able to use a simple set of jar files to get all the tasks we need added to our build script. Not so with FlexMonkey. Below is the code necessary to run FlexMonkey specific tasks.

1
2
3
4
5
6
7
8
9
10
11
    <!-- Location of the Monkey ant tasks -->
    <path id="libraries">
       <fileset dir="${FlexMonkey.dir}/${FlexMonkeyLibs.dir}">
          <include name="**/*.jar"/>
       </fileset>
    </path>
   
    <!-- Define the Monkey launcher ant task -->
    <taskdef name="monkey-test-launcher"
       classname="com.gorillalogic.flexmonkey.anttask.MonkeyTestLauncherAntTask"
       classpathref="libraries" />

And the additional properties added in build.properties…

1
2
3
4
#flexmonkey jar location
FlexMonkey.dir=${basedir}/flexMonkey
#flexmonkey jar location
FlexMonkeyLibs.dir=${FlexMonkey.dir}/libs

Now we can access the monkey-test-launcher task later in our build script.

Clean and Create the FlexMonkey Report Folder
Again, we are creating a new folder, only after deleting it to make sure the contents are new…

1
2
3
4
5
6
7
8
9
    <target name="cleanFlexMonkeyReport" description="Cleans the Report file">
        <echo>Deleting FlexMonkey Report Directory...</echo>
        <delete dir="${FlexMonkeyReport.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted FlexMonkey Report Directory</echo>
        <echo>Creating FlexMonkey Report Directory...</echo>
        <mkdir dir="${FlexMonkeyReport.dir}" />
        <echo>Created FlexMonkey Report Directory</echo>
    </target>

And the additional properties added in build.properties…

1
2
#report output file
FlexMonkeyReport.dir=${basedir}/flexMonkeyReport

Compile the FlexMonkey Tester Module
Just as if we were building the application we need to build the module that includes our generated AS3 code provided to us from the FlexMonkey application.
We output this file to our test folder so that it is cleaned up after the build is complete.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
    <target name="compileFlexMonkeyTester">
        <echo>Compiling FlexMonkey Tester To Test</echo>
        <mxmlc file="${FlexMonkeySrc.dir}/${FlexMonkeyModule.name}.mxml"
            incremental="false"
            actionscript-file-encoding="UTF-8"
            output="${FlexMonkeyModule.file}"
            debug="${Debug.Boolean}"
            keep-generated-actionscript="false">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <compiler.source-path path-element="${FlexMonkeySrc.dir}" />
            <compiler.library-path dir="${FlexMonkeyLibs.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
        </mxmlc>
        <echo>Compiled FlexMonkey Tester To Test</echo>
    </target>

And the additional properties added in build.properties…

1
2
3
4
5
6
#flexmonkey module
FlexMonkeyModule.name=ANTBuildProjectTestModule
#flexmonkey module
FlexMonkeyModule.file=${Test.dir}/${FlexMonkeyModule.name}.swf
#flexmonkey src location
FlexMonkeySrc.dir=${FlexMonkey.dir}/src

Copy Launcher Files into Test Folder
Now we need to do some moving around of files to get ready for the final build. We wouldn’t want our version of the MonkeyTestLauncher to get corrupted in any way, so we move a copy into the test folder – again, this will be cleaned at the end of the build. While researching this I also found that some users experienced bugs/hangs/strange behavior when the swf file to test was located in a folder different from the compiled module and the MonkeyTestLauncher. So in this step we will also create a copy of this application and move it into our test folder. Now with all the ingredients assembled we are ready to shake & bake.

1
2
3
4
5
6
7
8
9
10
    <target name="copyLauncherToTestFolder">
        <echo>Copy Launcher to Test</echo>
        <copy todir="${Test.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${FlexMonkeyLauncher.dir}"/>
        </copy>
        <echo>Copied Launcher to Test</echo>
        <echo>Copy App to Test</echo>
        <copy todir="${Test.dir}" overwrite="true" file="${Deploy.dir}/${Application.name}${timestamp}.swf"/>
        <echo>Copied App to Test</echo>
    </target>

And the additional properties added in build.properties…

1
2
#flexmonkey launch
FlexMonkeyLauncher.dir=${FlexMonkey.dir}/launcher

Run Automated Test
We have now assembled all of our files into the test folder, which when the build is complete will be wiped and not take any room on our drives.
Now we get to use the monkey-test-launcher task that we defined earlier, all we need to tell it is where to find the launcher application, the target swf (the main app that we are testing), the module that includes our generated AS3 test suite instructions, our snapshot directory with any necessary snapshots required to check against, the toDir (output directory) for the junit reports, and finally a flag to stop the build script if a failure is discovered – haltonfailure.

Once the monkey-test-launcher task is complete we again take the junit formatted reports and build a pretty human readable report by using the junitreport task.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
    <target name="runAutomatedTest">
        <monkey-test-launcher
            timeout="0"
            launcher="${FlexMonkeyLauncher.file}"
            targetSwf="${Test.dir}/${Application.name}${timestamp}.swf"
            testModuleSwf="${FlexMonkeyModule.file}"
            snapshotDir="${Snapshots.dir}"
            toDir="${FlexMonkeyReport.dir}"
            haltonfailure="false"/>
       
        <junitreport todir="${FlexMonkeyReport.dir}">
            <fileset dir="${FlexMonkeyReport.dir}">
                <include name="TEST-*.xml"/>
            </fileset>
            <report format="frames" todir="${FlexMonkeyReport.dir}/html"/>
        </junitreport>
    </target>

And the additional properties added in build.properties…

1
2
3
4
#snapshots
Snapshots.dir=${FlexMonkey.dir}/snapshots
#flexmonkey launcher app
FlexMonkeyLauncher.file=${Test.dir}/MonkeyTestLauncher.html

Do It!
Go on! Put it all together and try it out. You’ll be tickled pink to watch the build script open and close windows and run your test applications.

Current File
We are now done putting together our entire build script with all the bells and whistles. There is still on more post with all the source code, make sure to check it out in case you don’t like typing or copying & pasting.

Currently your build script should look similar to this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
<?xml version="1.0" encoding="UTF-8"?>
<project name="Build File" basedir="." default="compileProject">
   
    <!-- Set Up ================================================= -->
   
    <!-- file description -->
    <description>Build Script</description>
   
    <!--location of property file -->
    <property file="./build.properties"
        description="properities for builds" />
   
    <!-- timestamp -->
    <tstamp>
        <format property="timestamp" pattern="yyyyMMdd" />
    </tstamp>
   
    <!-- additional tasks -->
    <taskdef resource="flexTasks.tasks" classpath="${FlexTasks.file}"/>
    <taskdef resource="flexUnitTasks.tasks" classpath="${FlexUnitTasks.file}"/>
   
    <!-- ======================================================== -->
   
   
    <!-- Compile Project ======================================== -->
    <target name="compileProject"
        depends="cleanDeploy,buildWrapper,buildCustomWrapper,copyNonEmbeddedFiles,compileLibraries,runFlexUnitTests,compileApplication,runFlexMonkeyTests,asDocs,cleanTempDirectories"
        description="compiles application"/>
   
    <!-- Build Wrappers ========================================= -->
    <target name="buildWrapper">
        <echo>Building Wrapper...</echo>
        <html-wrapper title="${Application.name}"
            height="100%" width="100%"
            bgcolor="#FFFFFF" file="${Application.name}.html"
            application="${Application.name}"
            swf="${Application.name}${timestamp}"
            version-major="${Major.version}"
            version-minor="${Minor.version}"
            version-revision="${Revision.version}"
            history="true"
            template="express-installation"
            output="${Deploy.dir}" />
        <echo>Built Wrapper</echo>
    </target>
   
    <target name="buildCustomWrapper">
        <echo>Building Custom Wrapper...</echo>
        <copy file="${Template.file}" tofile="${Deploy.dir}/${Output.file}" overwrite="true">
            <filterchain>
                <replacetokens>
                    <token key="version_major" value="${Major.version}"/>
                    <token key="version_minor" value="${Minor.version}"/>
                    <token key="version_revision" value="${Revision.version}"/>
                    <token key="application" value="${Application.name}"/>
                    <token key="width" value="100%"/>
                    <token key="height" value="100%"/>
                    <token key="bgcolor" value="#FFFFFF"/>
                    <token key="swf" value="${Application.name}${timestamp}"/>
                </replacetokens>
            </filterchain>
        </copy>
        <echo>Built Custom Wrapper</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- Compile Application ==================================== -->
    <target name="compileApplication">
        <echo>Compiling SWF To Deploy</echo>
        <mxmlc file="${Src.dir}/${Application.name}.mxml"
            incremental="false"
            actionscript-file-encoding="UTF-8"
            output="${Deploy.dir}/${Application.name}${timestamp}.swf"
            debug="${Debug.Boolean}"
            keep-generated-actionscript="false">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <default-background-color>0xFFFFFF</default-background-color>
            <metadata>
                <creator>Jonathan Campos</creator>
                <publisher>UnitedMindset</publisher>
                <language>EN</language>
            </metadata>
            <compiler.source-path path-element="${Src.dir}" />
            <compiler.library-path dir="${basedir}/${DeploySWC.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
        </mxmlc>
        <echo>Compiled SWF To Deploy</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- NONEMBEDDED FILES ====================================== -->
    <target name="copyNonEmbeddedFiles">
        <echo>Deleting Deploy Assets Directory...</echo>
        <delete dir="${DeployAssets.dir}" failOnError="false" includeEmptyDirs="true" />
        <echo>Deleted Deploy Assets Directory</echo>
        <echo>Creating Assets Folder</echo>
        <mkdir dir="${DeployAssets.dir}"/>
        <echo>Created Assets Folder</echo>
        <echo>Copy Nonembedded Resources To Deploy</echo>
        <copy todir="${DeployAssets.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${Assets.dir}"/>
        </copy>
        <echo>Copied Nonembedded Resources To Deploy</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- COMPILE LIBRARIES ====================================== -->
    <target name="compileLibraries" depends="cleanDeploySWCs,copyPrecompiledSWCs,compileLibrary" />

    <target name="cleanDeploySWCs">
        <echo>Deleting Deploy SWC Directory...</echo>
        <delete dir="${DeploySWC.dir}" failOnError="false" includeEmptyDirs="true"/>
        <echo>Deleted Deploy SWC Directory</echo>
        <echo>Creating Deploy SWC Directory...</echo>
        <mkdir dir="${DeploySWC.dir}"/>
        <echo>Created Deploy SWC Directory</echo>
    </target>

    <target name="copyPrecompiledSWCs">
        <echo>Copying to Deploy SWC Directory...</echo>
        <copy todir="${DeploySWC.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${ApplicationLibs.dir}"/>
        </copy>
        <echo>Copied to Deploy SWC Directory...</echo>
    </target>
   
    <target name="compileLibrary" description="compiles the Library">
        <echo>Compiling Library SWC To Deploy SWC Folder</echo>
        <compc debug="${Debug.Boolean}" output="${DeploySWC.dir}/${Library.name}.swc">
            <source-path path-element="${LibrarySrc.dir}"/>
            <include-sources dir="${LibrarySrc.dir}" includes="*"/>
            <compiler.library-path dir="${LibraryLibs.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
            <metadata>
                <creator>Jonathan Campos</creator>
                <publisher>UnitedMindset</publisher>
                <language>EN</language>
            </metadata>
        </compc>
        <echo>Compiled Library SWC To Deploy SWC Folder</echo>
    </target>
   
    <!-- Clean Up =============================================== -->
    <target name="cleanDeploy" description="Cleans the deploy file">
        <echo>Deleting Deploy Directory...</echo>
        <delete dir="${Deploy.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted Deploy Directory</echo>
        <echo>Creating Deploy Directory...</echo>
        <mkdir dir="${Deploy.dir}" />
        <echo>Created Deploy Directory</echo>
    </target>
   
    <target name="cleanTempDirectories">
        <echo>Deleting Deploy SWC Directory...</echo>
        <delete dir="${DeploySWC.dir}" failOnError="false" includeEmptyDirs="true"/>
        <echo>Deleted Deploy SWC Directory</echo>
       
        <echo>Deleting Test Directory...</echo>
        <delete dir="${Test.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted Test Directory</echo>
    </target>

    <!-- ======================================================== -->
   
    <!-- ASDOC ================================================== -->
    <target name="asDocs" depends="cleanASDoc,compileASDoc" description="build of asdocs" />

    <!-- Delete the existing output folder and files and then regenerate the output folder -->
    <target name="cleanASDoc">
        <echo>Deleting ASDoc Directory...</echo>
        <delete dir="${Asdoc.dir}" failOnError="false" includeEmptyDirs="true" />
        <echo>Deleted ASDoc Directory</echo>
        <echo>Creating ASDoc Directory...</echo>
        <mkdir dir="${Asdoc.dir}" />
        <echo>Created ASDoc Directory</echo>
    </target>

    <!-- Run the ASDoc executable and generate the ASDocs to the new output folder -->
    <target name="compileASDoc">
        <echo>ASDoc Compiling...</echo>
        <exec executable="${AsDocs.executable}" failonerror="true">
            <arg line="-doc-sources '${AppClasses.dir}'" />
            <arg line="-doc-sources '${LibrarySrc.dir}'" />
            <arg line="-external-library-path '${LibrarySrc.dir}'" />
            <arg line="-external-library-path '${Library.dir}/${LibraryLibs.dir}'" />
            <arg line="-main-title '${Main.title}'" />
            <arg line="-window-title '${Window.title}'" />
            <arg line="-output '${Asdoc.dir}'" />
            <arg line="-footer '${Footer.text}'" />
        </exec>
        <echo>ASDoc Compile Complete</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- FlexUnit =============================================== -->
    <target name="runFlexUnitTests"
        description="run flexunit tests"
        depends="cleanFlexUnitReport,cleanTest,compileTestRunner,executeTestRunner"/>
   
    <target name="cleanFlexUnitReport" description="Cleans the Report file">
        <echo>Deleting FlexUnit Report Directory...</echo>
        <delete dir="${FlexUnitReport.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted FlexUnit Report Directory</echo>
        <echo>Creating FlexUnit Report Directory...</echo>
        <mkdir dir="${FlexUnitReport.dir}" />
        <echo>Created FlexUnit Report Directory</echo>
    </target>
   
    <target name="cleanTest" description="Cleans the Test file">
        <echo>Deleting Test Directory...</echo>
        <delete dir="${Test.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted Test Directory</echo>
        <echo>Creating Test Directory...</echo>
        <mkdir dir="${Test.dir}" />
        <echo>Created Test Directory</echo>
    </target>
   
    <target name="compileTestRunner">
        <echo>Compiling Test Runner SWF To Test</echo>
        <mxmlc file="${TestRunnerSrc.dir}/${TestRunner.name}.mxml"
            output="${Test.dir}/${TestRunner.name}.swf">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <compiler.source-path path-element="${Src.dir}" />
            <compiler.library-path dir="${basedir}/" append="true">
                <include name="${DeploySWC.dir}"/>
            </compiler.library-path>
            <compiler.library-path dir="${TestRunnerLib.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
            <compiler.verbose-stacktraces>true</compiler.verbose-stacktraces>
            <compiler.headless-server>true</compiler.headless-server>
        </mxmlc>
        <echo>Compiled Test Runner SWF To Test</echo>
    </target>
   
    <target name="executeTestRunner" description="executes the test runner app">
        <echo>Running Test Runner SWF</echo>
        <flexunit swf="${Test.dir}/${TestRunner.name}.swf"
            toDir="${FlexUnitReport.dir}"
            haltonfailure="false"
            verbose="true"
            localTrusted="true"/>
        <echo>Ran Test Runner SWF</echo>
       
        <echo>Generate Readable Tests</echo>
        <junitreport todir="${FlexUnitReport.dir}">
            <fileset dir="${FlexUnitReport.dir}">
                <include name="TEST-*.xml"/>
            </fileset>
            <report format="frames" todir="${FlexUnitReport.dir}/html"/>
        </junitreport>
        <echo>Generated Readable Tests</echo>
    </target>
   
    <!-- ======================================================== -->
   
    <!-- FlexMonkey ============================================= -->
    <target name="runFlexMonkeyTests"
            description="run flexmonkey tests"
            depends="cleanFlexMonkeyReport,
        compileFlexMonkeyTester,
        copyLauncherToTestFolder,runAutomatedTest"/>
   
    <!-- Location of the Monkey ant tasks -->
    <path id="libraries">
       <fileset dir="${FlexMonkey.dir}/${FlexMonkeyLibs.dir}">
          <include name="**/*.jar"/>
       </fileset>
    </path>
   
    <!-- Define the Monkey launcher ant task -->
    <taskdef name="monkey-test-launcher"
       classname="com.gorillalogic.flexmonkey.anttask.MonkeyTestLauncherAntTask"
       classpathref="libraries" />
   
    <target name="cleanFlexMonkeyReport" description="Cleans the Report file">
        <echo>Deleting FlexMonkey Report Directory...</echo>
        <delete dir="${FlexMonkeyReport.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted FlexMonkey Report Directory</echo>
        <echo>Creating FlexMonkey Report Directory...</echo>
        <mkdir dir="${FlexMonkeyReport.dir}" />
        <echo>Created FlexMonkey Report Directory</echo>
    </target>
   
    <target name="compileFlexMonkeyTester">
        <echo>Compiling FlexMonkey Tester To Test</echo>
        <mxmlc file="${FlexMonkeySrc.dir}/${FlexMonkeyModule.name}.mxml"
            incremental="false"
            actionscript-file-encoding="UTF-8"
            output="${FlexMonkeyModule.file}"
            debug="${Debug.Boolean}"
            keep-generated-actionscript="false">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <compiler.source-path path-element="${FlexMonkeySrc.dir}" />
            <compiler.library-path dir="${FlexMonkeyLibs.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
        </mxmlc>
        <echo>Compiled FlexMonkey Tester To Test</echo>
    </target>
   
    <target name="copyLauncherToTestFolder">
        <echo>Copy Launcher to Test</echo>
        <copy todir="${Test.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${FlexMonkeyLauncher.dir}"/>
        </copy>
        <echo>Copied Launcher to Test</echo>
        <echo>Copy App to Test</echo>
        <copy todir="${Test.dir}" overwrite="true" file="${Deploy.dir}/${Application.name}${timestamp}.swf"/>
        <echo>Copied App to Test</echo>
    </target>

    <target name="runAutomatedTest">
        <monkey-test-launcher
            timeout="0"
            launcher="${FlexMonkeyLauncher.file}"
            targetSwf="${Test.dir}/${Application.name}${timestamp}.swf"
            testModuleSwf="${FlexMonkeyModule.file}"
            snapshotDir="${Snapshots.dir}"
            toDir="${FlexMonkeyReport.dir}"
            haltonfailure="false"/>
       
        <junitreport todir="${FlexMonkeyReport.dir}">
            <fileset dir="${FlexMonkeyReport.dir}">
                <include name="TEST-*.xml"/>
            </fileset>
            <report format="frames" todir="${FlexMonkeyReport.dir}/html"/>
        </junitreport>
    </target>
    <!-- ======================================================== -->
   
</project>

And your properties:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
#####################################################################
#
#  Compiler Properties
#
#####################################################################

# Flex SDK File Location
FLEX_HOME=C:/Program Files/Adobe/Flex Builder 3 Plug-in/sdks/3.3
#flextasks jar location
FlexTasks.file=flexTasks/flexTasks.jar
#deploy directory
Deploy.dir=deploy
#source directory
Src.dir=src
#debug flag
Debug.Boolean=false
#application name
Application.name=ANTBuildProject
#version major
Major.version=9
#version minor
Minor.version=0
#version revision
Revision.version=124
#Template File
Template.file=index.template.html
#Output HTML File
Output.file=index.html
#Assets
Assets.dir=${Src.dir}/assets
#Assets
DeployAssets.dir=${Deploy.dir}/assets
#Deploy SWC Directory
DeploySWC.dir=deploySWC
#Library Directory
Library.dir=C:/workspace/ANTBuildLibrary
#Library Libs
LibraryLibs.dir=${Library.dir}/libs
#Library Src
LibrarySrc.dir=${Library.dir}/src
#library name
Library.name=ANTBuildLibrary
#Application Libs
ApplicationLibs.dir=${basedir}/libs

#####################################################################
#
#  ASDoc Properties
#
#####################################################################
#asdoc output
Asdoc.dir=asdoc
#the location of asdocs on your computer
AsDocs.executable=${FLEX_HOME}/bin/asdoc.exe
#Asdoc Footer Text
Footer.text=Some legal jargon
#window title
Window.title=Window Title
#main title
Main.title=Main Title
#the location of your application classes on your computer
AppClasses.dir=${basedir}/src

#####################################################################
#
#  FlexUnit Properties
#
#####################################################################
#report output file
FlexUnitReport.dir=${basedir}/flexUnitReport
#test dir
Test.dir=${basedir}/test
#flextasks jar location
FlexUnitTasks.file=flexTasks/flexUnitTasks-4.0.0.jar
#Test Runner Dir
TestRunner.dir=C:/workspace/AntBuildUnitTest
TestRunnerSrc.dir=${TestRunner.dir}/src
TestRunnerLib.dir=${TestRunner.dir}/libs
#Test Runner Dir
TestRunner.name=ANTBuildUnitTest

#####################################################################
#
#  FlexMonkey Properties
#
#####################################################################
#flexmonkey jar location
FlexMonkey.dir=${basedir}/flexMonkey
#flexmonkey jar location
FlexMonkeyLibs.dir=${FlexMonkey.dir}/libs
#flexmonkey src location
FlexMonkeySrc.dir=${FlexMonkey.dir}/src
#report output file
FlexMonkeyReport.dir=${basedir}/flexMonkeyReport
#flexmonkey launch
FlexMonkeyLauncher.dir=${FlexMonkey.dir}/launcher
#flexmonkey launcher app
FlexMonkeyLauncher.file=${Test.dir}/MonkeyTestLauncher.html
#flexmonkey module
FlexMonkeyModule.name=ANTBuildProjectTestModule
#flexmonkey module
FlexMonkeyModule.file=${Test.dir}/${FlexMonkeyModule.name}.swf
#snapshots
Snapshots.dir=${FlexMonkey.dir}/snapshots
Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/02/04/run-flexmonkey-tests-from-ant/feed/ 1 http://unitedmindset.com/jonbcampos/2010/02/04/run-flexmonkey-tests-from-ant/ RIA Job Trends 2010 http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/SRWhO4iG3Rg/ http://unitedmindset.com/jonbcampos/2010/02/03/ria-job-trends-2010/#comments Wed, 03 Feb 2010 15:00:31 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1312 Last year around this time I was asked to make a presentation on RIA trends to developers. With the down economy (something just don’t change do they?) people in the group were really interested in the job trends for some of the different RIA development languages. Using indeed.com I was able to find the following stats.

I’ve made some updates to this to make it a bit more specific in the search. Hopefully the new results are more reflective of the actual current environment.


Breaking out the individual sections you will see…

Adobe Flex (Macromedia Flex)
Keeping strong and great growth!

Microsoft Silverlight
Wow! Look at that growth!

OpenLaszlo
It jumped for a bit, but I think this is the last year to include this chart.

Ajax (Specifically Dojo and JQuery)
Ajax is a hard one to include. Not because I don’t believe that it is an RIA technology, but because of how encompassing the word is. For this I will break it down to Dojo & JQuery, two of the specific frameworks. Similar to how Actionscript is to Flex, Javascript is to Dojo/JQuery. I would argue that Dojo/JQuery are the most popular Javascript framework for creating RIAs.

JavaFx
Last year it was the new kid on the block and has had it’s ups and downs.

New Additions
This year I wanted to add a few more to my search. Obviously there are other technologies that go into RIAs, but to just say “Flash” or “HTML” would definitely get a different result then what we are looking for. And yes, I didn’t include any server-side technologies as I am focusing on front-end pieces. Though they are also important in the RIA stack.

Objective-C
Had to include this in there as a representative of the iPhone Apps market.

GWT (Google Web Toolkit)
By request, the addition of GWT. Again, strong growths as in all RIA sectors.

And Finally, the Superchart with all the technologies together. This just tells me that RIA technologies are just growing immensely.

And finally, the salary trend comparison for each:

Salary Comparison

Salary Comparison

Salary Trends

Salary Trends

Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/02/03/ria-job-trends-2010/feed/ 15 http://unitedmindset.com/jonbcampos/2010/02/03/ria-job-trends-2010/ Run Flex Unit Tests from ANT http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/p14-IX3IoMs/ http://unitedmindset.com/jonbcampos/2010/02/02/run-flex-unit-tests-from-ant/#comments Tue, 02 Feb 2010 15:00:04 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1096 If you have any troubles understanding this post, make sure to revisit some of the older in this series as I assume you already have your build file and properties file set up.

Advanced Continuous Integration Topic Number 2: Automated Unit Testing.

This magic behind this is brought to you from the good guys at FlexUnit.org. They have made it possible to have the Flex (or AS3) Tester App output information to the FlexUnitTask.jar through a CIListener to be output to pretty little report files that can be read from ANT or humans.

This is not a post on how to write a unit test, best practices on unit tests, or how to set up FlexUnit with your project, I am going to assume you already understand that part.

With other languages running Unit Tests is relatively straight forward. You write your test, you run your test. What makes running Unit Tests more difficult in the Flash Player is the runtime environment. To actually run your tests you need to start up the Flash Player runtime environment and run within the Flash Player. Which means you have to compile you code, run it in Flash Player, and then output the results somewhere that they can be read by ANT to give you the results. Not an easy task, but that is what we are going to cover.

So first, you have your separate FlexUnit Project.

Get Adobe Flash player
This project runs the FlexUnit Test Runner to run the Unit Tests that you’ve created for your code.

This particular application have intentional faults so that you can see both success and fault responses. Typically you would work to have no failed tests.

I make this a completely separate project from my main application specifically because I want to keep my main application as clean from clutter and additional code as possible. Can you combine the two? Yes. Do I? No. You may think that having the second application wouldn’t add much clutter, but I personally feel when you are dealing with Enterprise applications – and therefore many developers – the more simplistic that you can make your code base the better. With many developers – each of different skill levels – you don’t want to overload some developers that might have a harder time understanding the full set of code and tests and everything else. On top of that, you can have your bug testers work with an application without getting the ability to hurt your core application code. Again, the separation of code and duties will help you scale.

You can hit View Source and see the unit tests that I have created and also get an ANT build file to run just the FlexUnit Project in ANT.

Our Next Steps
If you have started this series from the beginning our ANT file currently builds the library, builds the application into a deploy folder, copies the non-embedded assets into the deploy folder, builds our html-wrappers into the deploy folder, and also builds our ASDocs from our library and also our application into an asdoc folder.

Now we are going to add the following steps into the build.

  • Clean and create a test folder to hold the built test application
  • Clean and create a report directory to hold your flexunit reports
  • Compile the test runner application
  • Execute the test runner application
  • Generate the readable reports from the test
  • Clean up (destroy) the test folder and the compiled test runner application

The first two parts are simple, we’ve done it multiple times already.
Added into your build file.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
    <target name="cleanFlexUnitReport" description="Cleans the Report file">
        <echo>Deleting FlexUnit Report Directory...</echo>
        <delete dir="${FlexUnitReport.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted FlexUnit Report Directory</echo>
        <echo>Creating FlexUnit Report Directory...</echo>
        <mkdir dir="${FlexUnitReport.dir}" />
        <echo>Created FlexUnit Report Directory</echo>
    </target>
   
    <target name="cleanTest" description="Cleans the Test file">
        <echo>Deleting Test Directory...</echo>
        <delete dir="${Test.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted Test Directory</echo>
        <echo>Creating Test Directory...</echo>
        <mkdir dir="${Test.dir}" />
        <echo>Created Test Directory</echo>
    </target>

Added into your properties file.

1
2
3
4
#report output file
FlexUnitReport.dir=${basedir}/flexUnitReport
#test dir
Test.dir=${basedir}/test

Compile The Test Runner Application
Now we have the the folders necessary to hold all of our output, now we need to compile the test runner application. This part is going to be very similar to building the application because we will again be using functionality provided to us by flexTasks.jar.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
    <target name="compileTestRunner">
        <echo>Compiling Test Runner SWF To Test</echo>
        <mxmlc file="${TestRunnerSrc.dir}/${TestRunner.name}.mxml"
            output="${Test.dir}/${TestRunner.name}.swf">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <compiler.source-path path-element="${Src.dir}" />
            <compiler.library-path dir="${basedir}/" append="true">
                <include name="${DeploySWC.dir}"/>
            </compiler.library-path>
            <compiler.library-path dir="${TestRunnerLib.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
            <compiler.verbose-stacktraces>true</compiler.verbose-stacktraces>
            <compiler.headless-server>true</compiler.headless-server>
        </mxmlc>
        <echo>Compiled Test Runner SWF To Test</echo>
    </target>

Here we set up the task and compile the project with any required libraries from the unit test project along with any libraries from our main application – so all dependencies are included, and the source code from the unit test project – our actual tests. The swf output from this compile task is placed into our test folder which later will be destroyed after it is no longer needed.

Here are the build properties added because of this task.

1
2
3
4
5
6
#Test Runner Dir
TestRunner.dir=C:/workspace/AntBuildUnitTest
TestRunnerSrc.dir=${TestRunner.dir}/src
TestRunnerLib.dir=${TestRunner.dir}/libs
#Test Runner Dir
TestRunner.name=ANTBuildUnitTest

Executing The Test Runner
For this next part we need to add some additional capabilities to our ANT build file via the flexUnitTasks jar.

We will accomplish this addition the same way we added in the flexTasks.jar in the beginning. At the top of our build file, under the flexTasks.jar taskdef tag, add:

1
<taskdef resource="flexUnitTasks.tasks" classpath="${FlexUnitTasks.file}"/>

And in your properties just include the path to the file.

1
2
#flextasks jar location
FlexUnitTasks.file=flexTasks/flexUnitTasks-4.0.0.jar

Now with the flexUnitTasks jar added to our build file, we can use the flexunit task. This task allows us to run the compiled test runner application and output the results to a folder of our choice.

Once you have the generated output, you can use the the compatible (and built in) junitreport task to create nice to read xml reports.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
    <target name="executeTestRunner" description="executes the test runner app">
        <echo>Running Test Runner SWF</echo>
        <flexunit swf="${Test.dir}/${TestRunner.name}.swf"
            toDir="${FlexUnitReport.dir}"
            haltonfailure="false"
            verbose="true"
            localTrusted="true"/>
        <echo>Ran Test Runner SWF</echo>
       
        <echo>Generate Readable Tests</echo>
        <junitreport todir="${FlexUnitReport.dir}">
            <fileset dir="${FlexUnitReport.dir}">
                <include name="TEST-*.xml"/>
            </fileset>
            <report format="frames" todir="${FlexUnitReport.dir}/html"/>
        </junitreport>
        <echo>Generated Readable Tests</echo>
    </target>

One thing I want to point out is the haltonfailure option. I set mine to false so that the build script keeps running, but you can also set this to true so that the build script fails immediately if an error in your unit tests come up. Dependent on your situation, this would be the only flag you may want to change.

Current File
There is only one more major task left to really make build file complete, automated testing, the brother of unit testing – a little bit different, equally important.

Currently your build script should look similar to this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
<?xml version="1.0" encoding="UTF-8"?>
<project name="Build File" basedir="." default="compileProject">
   
    <!-- Set Up ================================================= -->
   
    <!-- file description -->
    <description>Build Script</description>
   
    <!--location of property file -->
    <property file="./build.properties"
        description="properities for builds" />
   
    <!-- timestamp -->
    <tstamp>
        <format property="timestamp" pattern="yyyyMMdd" />
    </tstamp>
   
    <!-- additional tasks -->
    <taskdef resource="flexTasks.tasks" classpath="${FlexTasks.file}"/>
    <taskdef resource="flexUnitTasks.tasks" classpath="${FlexUnitTasks.file}"/>
   
    <!-- ======================================================== -->
   
   
    <!-- Compile Project ======================================== -->
    <target name="compileProject"
        depends="cleanDeploy,buildWrapper,buildCustomWrapper,copyNonEmbeddedFiles,compileLibraries,runFlexUnitTests,compileApplication,asDocs,cleanTempDirectories,zipApplication"
        description="compiles application"/>
   
    <!-- Build Wrappers ========================================= -->
    <target name="buildWrapper">
        <echo>Building Wrapper...</echo>
        <html-wrapper title="${Application.name}"
            height="100%" width="100%"
            bgcolor="#FFFFFF" file="${Application.name}.html"
            application="${Application.name}"
            swf="${Application.name}${timestamp}"
            version-major="${Major.version}"
            version-minor="${Minor.version}"
            version-revision="${Revision.version}"
            history="true"
            template="express-installation"
            output="${Deploy.dir}" />
        <echo>Built Wrapper</echo>
    </target>
   
    <target name="buildCustomWrapper">
        <echo>Building Custom Wrapper...</echo>
        <copy file="${Template.file}" tofile="${Deploy.dir}/${Output.file}" overwrite="true">
            <filterchain>
                <replacetokens>
                    <token key="version_major" value="${Major.version}"/>
                    <token key="version_minor" value="${Minor.version}"/>
                    <token key="version_revision" value="${Revision.version}"/>
                    <token key="application" value="${Application.name}"/>
                    <token key="width" value="100%"/>
                    <token key="height" value="100%"/>
                    <token key="bgcolor" value="#FFFFFF"/>
                    <token key="swf" value="${Application.name}${timestamp}"/>
                </replacetokens>
            </filterchain>
        </copy>
        <echo>Built Custom Wrapper</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- Compile Application ==================================== -->
    <target name="compileApplication">
        <echo>Compiling SWF To Deploy</echo>
        <mxmlc file="${Src.dir}/${Application.name}.mxml"
            incremental="false"
            actionscript-file-encoding="UTF-8"
            output="${Deploy.dir}/${Application.name}${timestamp}.swf"
            debug="${Debug.Boolean}"
            keep-generated-actionscript="false">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <default-background-color>0xFFFFFF</default-background-color>
            <metadata>
                <creator>Jonathan Campos</creator>
                <publisher>UnitedMindset</publisher>
                <language>EN</language>
            </metadata>
            <compiler.source-path path-element="${Src.dir}" />
            <compiler.library-path dir="${basedir}/${DeploySWC.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
        </mxmlc>
        <echo>Compiled SWF To Deploy</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- NONEMBEDDED FILES ====================================== -->
    <target name="copyNonEmbeddedFiles">
        <echo>Deleting Deploy Assets Directory...</echo>
        <delete dir="${DeployAssets.dir}" failOnError="false" includeEmptyDirs="true" />
        <echo>Deleted Deploy Assets Directory</echo>
        <echo>Creating Assets Folder</echo>
        <mkdir dir="${DeployAssets.dir}"/>
        <echo>Created Assets Folder</echo>
        <echo>Copy Nonembedded Resources To Deploy</echo>
        <copy todir="${DeployAssets.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${Assets.dir}"/>
        </copy>
        <echo>Copied Nonembedded Resources To Deploy</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- COMPILE LIBRARIES ====================================== -->
    <target name="compileLibraries" depends="cleanDeploySWCs,copyPrecompiledSWCs,compileLibrary" />

    <target name="cleanDeploySWCs">
        <echo>Deleting Deploy SWC Directory...</echo>
        <delete dir="${DeploySWC.dir}" failOnError="false" includeEmptyDirs="true"/>
        <echo>Deleted Deploy SWC Directory</echo>
        <echo>Creating Deploy SWC Directory...</echo>
        <mkdir dir="${DeploySWC.dir}"/>
        <echo>Created Deploy SWC Directory</echo>
    </target>

    <target name="copyPrecompiledSWCs">
        <echo>Copying to Deploy SWC Directory...</echo>
        <copy todir="${DeploySWC.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${ApplicationLibs.dir}"/>
        </copy>
        <echo>Copied to Deploy SWC Directory...</echo>
    </target>
   
    <target name="compileLibrary" description="compiles the Library">
        <echo>Compiling Library SWC To Deploy SWC Folder</echo>
        <compc debug="${Debug.Boolean}" output="${DeploySWC.dir}/${Library.name}.swc">
            <source-path path-element="${LibrarySrc.dir}"/>
            <include-sources dir="${LibrarySrc.dir}" includes="*"/>
            <compiler.library-path dir="${LibraryLibs.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
            <metadata>
                <creator>Jonathan Campos</creator>
                <publisher>UnitedMindset</publisher>
                <language>EN</language>
            </metadata>
        </compc>
        <echo>Compiled Library SWC To Deploy SWC Folder</echo>
    </target>
   
    <!-- Clean Up =============================================== -->
    <target name="cleanDeploy" description="Cleans the deploy file">
        <echo>Deleting Deploy Directory...</echo>
        <delete dir="${Deploy.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted Deploy Directory</echo>
        <echo>Creating Deploy Directory...</echo>
        <mkdir dir="${Deploy.dir}" />
        <echo>Created Deploy Directory</echo>
    </target>
   
    <target name="cleanTempDirectories">
        <echo>Deleting Deploy SWC Directory...</echo>
        <delete dir="${DeploySWC.dir}" failOnError="false" includeEmptyDirs="true"/>
        <echo>Deleted Deploy SWC Directory</echo>
       
        <echo>Deleting Test Directory...</echo>
        <delete dir="${Test.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted Test Directory</echo>
    </target>

    <!-- ======================================================== -->
   
    <!-- ASDOC ================================================== -->
    <target name="asDocs" depends="cleanASDoc,compileASDoc" description="build of asdocs" />

    <!-- Delete the existing output folder and files and then regenerate the output folder -->
    <target name="cleanASDoc">
        <echo>Deleting ASDoc Directory...</echo>
        <delete dir="${Asdoc.dir}" failOnError="false" includeEmptyDirs="true" />
        <echo>Deleted ASDoc Directory</echo>
        <echo>Creating ASDoc Directory...</echo>
        <mkdir dir="${Asdoc.dir}" />
        <echo>Created ASDoc Directory</echo>
    </target>

    <!-- Run the ASDoc executable and generate the ASDocs to the new output folder -->
    <target name="compileASDoc">
        <echo>ASDoc Compiling...</echo>
        <exec executable="${AsDocs.executable}" failonerror="true">
            <arg line="-doc-sources '${AppClasses.dir}'" />
            <arg line="-doc-sources '${LibrarySrc.dir}'" />
            <arg line="-external-library-path '${LibrarySrc.dir}'" />
            <arg line="-external-library-path '${Library.dir}/${LibraryLibs.dir}'" />
            <arg line="-main-title '${Main.title}'" />
            <arg line="-window-title '${Window.title}'" />
            <arg line="-output '${Asdoc.dir}'" />
            <arg line="-footer '${Footer.text}'" />
        </exec>
        <echo>ASDoc Compile Complete</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- FlexUnit =============================================== -->
    <target name="runFlexUnitTests"
        description="run flexunit tests"
        depends="cleanFlexUnitReport,cleanTest,compileTestRunner,executeTestRunner"/>
   
    <target name="cleanFlexUnitReport" description="Cleans the Report file">
        <echo>Deleting FlexUnit Report Directory...</echo>
        <delete dir="${FlexUnitReport.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted FlexUnit Report Directory</echo>
        <echo>Creating FlexUnit Report Directory...</echo>
        <mkdir dir="${FlexUnitReport.dir}" />
        <echo>Created FlexUnit Report Directory</echo>
    </target>
   
    <target name="cleanTest" description="Cleans the Test file">
        <echo>Deleting Test Directory...</echo>
        <delete dir="${Test.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted Test Directory</echo>
        <echo>Creating Test Directory...</echo>
        <mkdir dir="${Test.dir}" />
        <echo>Created Test Directory</echo>
    </target>
   
    <target name="compileTestRunner">
        <echo>Compiling Test Runner SWF To Test</echo>
        <mxmlc file="${TestRunnerSrc.dir}/${TestRunner.name}.mxml"
            output="${Test.dir}/${TestRunner.name}.swf">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <compiler.source-path path-element="${Src.dir}" />
            <compiler.library-path dir="${basedir}/" append="true">
                <include name="${DeploySWC.dir}"/>
            </compiler.library-path>
            <compiler.library-path dir="${TestRunnerLib.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
            <compiler.verbose-stacktraces>true</compiler.verbose-stacktraces>
            <compiler.headless-server>true</compiler.headless-server>
        </mxmlc>
        <echo>Compiled Test Runner SWF To Test</echo>
    </target>
   
    <target name="executeTestRunner" description="executes the test runner app">
        <echo>Running Test Runner SWF</echo>
        <flexunit swf="${Test.dir}/${TestRunner.name}.swf"
            toDir="${FlexUnitReport.dir}"
            haltonfailure="false"
            verbose="true"
            localTrusted="true"/>
        <echo>Ran Test Runner SWF</echo>
       
        <echo>Generate Readable Tests</echo>
        <junitreport todir="${FlexUnitReport.dir}">
            <fileset dir="${FlexUnitReport.dir}">
                <include name="TEST-*.xml"/>
            </fileset>
            <report format="frames" todir="${FlexUnitReport.dir}/html"/>
        </junitreport>
        <echo>Generated Readable Tests</echo>
    </target>
   
    <!-- ======================================================== -->
   
</project>

And your properties:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
#####################################################################
#
#  Compiler Properties
#
#####################################################################

# Flex SDK File Location
FLEX_HOME=C:/Program Files/Adobe/Flex Builder 3 Plug-in/sdks/3.3
#flextasks jar location
FlexTasks.file=flexTasks/flexTasks.jar
#deploy directory
Deploy.dir=deploy
#source directory
Src.dir=src
#debug flag
Debug.Boolean=false
#application name
Application.name=ANTBuildProject
#version major
Major.version=9
#version minor
Minor.version=0
#version revision
Revision.version=124
#Template File
Template.file=index.template.html
#Output HTML File
Output.file=index.html
#Assets
Assets.dir=${Src.dir}/assets
#Assets
DeployAssets.dir=${Deploy.dir}/assets
#Deploy SWC Directory
DeploySWC.dir=deploySWC
#Library Directory
Library.dir=C:/workspace/ANTBuildLibrary
#Library Libs
LibraryLibs.dir=${Library.dir}/libs
#Library Src
LibrarySrc.dir=${Library.dir}/src
#library name
Library.name=ANTBuildLibrary
#Application Libs
ApplicationLibs.dir=${basedir}/libs

#####################################################################
#
#  ASDoc Properties
#
#####################################################################
#asdoc output
Asdoc.dir=asdoc
#the location of asdocs on your computer
AsDocs.executable=${FLEX_HOME}/bin/asdoc.exe
#Asdoc Footer Text
Footer.text=Some legal jargon
#window title
Window.title=Window Title
#main title
Main.title=Main Title
#the location of your application classes on your computer
AppClasses.dir=${basedir}/src

#####################################################################
#
#  FlexUnit Properties
#
#####################################################################
#report output file
FlexUnitReport.dir=${basedir}/flexUnitReport
#test dir
Test.dir=${basedir}/test
#flextasks jar location
FlexUnitTasks.file=flexTasks/flexUnitTasks-4.0.0.jar
#Test Runner Dir
TestRunner.dir=C:/workspace/AntBuildUnitTest
TestRunnerSrc.dir=${TestRunner.dir}/src
TestRunnerLib.dir=${TestRunner.dir}/libs
#Test Runner Dir
TestRunner.name=ANTBuildUnitTest

You’ll notice the one place I didn’t spend time showing the changes is the main targets, including the compileProject target. As I add functionality I automatically write in this functionality to the main compileProject target and make up unique subtarget. How you set up your file and it’s parts is up to you.

Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/02/02/run-flex-unit-tests-from-ant/feed/ 4 http://unitedmindset.com/jonbcampos/2010/02/02/run-flex-unit-tests-from-ant/ Netflix API in Tour De Flex http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/gCAh6u4Zqo8/ http://unitedmindset.com/jonbcampos/2010/01/30/netflix-api-in-tour-de-flex/#comments Sat, 30 Jan 2010 17:09:23 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1288 tourdeflex

Just quickly throwing this out. This week 2 examples of the Netflix AS3 API were added to Tour De Flex. These two examples show off some basic service calls and authentication. Hope this helps others if they are wanting to create an application with Netflix/Video information.

Here on this blog you will see some more examples coming shortly and hopefully a few working apps using different popular Flex frameworks. If you have any questions feel free to ask.

netflix
You can also see the announcement here.

Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/01/30/netflix-api-in-tour-de-flex/feed/ 2 http://unitedmindset.com/jonbcampos/2010/01/30/netflix-api-in-tour-de-flex/ Building ASDocs with ANT http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/O1dyKdC6vVc/ http://unitedmindset.com/jonbcampos/2010/01/28/building-asdocs-with-ant/#comments Thu, 28 Jan 2010 15:00:08 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1093 In this running series of creating an ANT script to run your Flex based life I feel like we’ve reached some midway point. We have our application being built off of a Flex Library, building the default Adobe html-wrapper along with our own custom wrapper while keeping the non-embedded assets intact.

Now I feel is a good time to start taking care of the more advanced parts of our discussion: documentation, unit tests, and automated testing. Right now, documentation.

As your code base continues to grow the ability for new developers to look over all of your code to understand what is going on is going to shrink exponentially. That is why we include documentation within our code, and we use ASDocs to pull out that documentation and format it into a pretty set of html files.

In this post I’m not going to explain ASDocs as I have explained ASDocs in this post about Actionscript Components and this post about MXML Components.

With all of your components successfully documented it’s time to use the ASDoc tool to actually build html files. This executable runs off of command line and therefore can be run via ANT or Maven also. Since we are discussing ANT I will show you that code.

The idea here is to clean out the old ASDoc folder and rewrite the asdocs. For this we will need two targets and one main target with two dependents.

The Main ASDoc Target

1
2
<!-- asdoc main -->
<target name="asDocs" depends="cleanASDoc,compileASDoc" description="build of asdocs" />

The Clean Script

1
2
3
4
5
6
7
8
9
    <!-- Delete the existing output folder and files and then regenerate the output folder -->
    <target name="cleanASDoc">
        <echo>Deleting ASDoc Directory...</echo>
        <delete dir="${Asdoc.dir}" failOnError="false" includeEmptyDirs="true" />
        <echo>Deleted ASDoc Directory</echo>
        <echo>Creating ASDoc Directory...</echo>
        <mkdir dir="${Asdoc.dir}" />
        <echo>Created ASDoc Directory</echo>
    </target>

The ASDoc Executable Script

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
    <!-- Run the ASDoc executable and generate the ASDocs to the new output folder -->
    <target name="compileASDoc">
        <echo>ASDoc Compiling...</echo>
        <exec executable="${AsDocs.executable}" failonerror="true">
            <arg line="-doc-sources '${AppClasses.dir}'" />
            <arg line="-doc-sources '${LibrarySrc.dir}'" />
            <arg line="-external-library-path '${LibrarySrc.dir}'" />
            <arg line="-external-library-path '${Library.dir}/${LibraryLibs.dir}'" />
            <arg line="-main-title '${Main.title}'" />
            <arg line="-window-title '${Window.title}'" />
            <arg line="-output '${Asdoc.dir}'" />
            <arg line="-footer '${Footer.text}'" />
        </exec>
        <echo>ASDoc Compile Complete</echo>
    </target>

The executable tag points our exec task to the proper executable file ready for arguments just like running in command line. Within this block you will see a variety of argument lines, we will go through each of those one at a time so they all make sense.

  • doc-sources – a path to the source files to document. I’ve included multiple of these to document both the application and the library, you can use one or multiple of these lines.
  • external-library-path – a path to additional libraries to include but not document. This is important because without it the build will fail if your code requires additional swcs to run. I’ve included multiple of these to document both the application and the library, you can use one or multiple of these lines.
  • main-title – the main title at the top of all ASDoc pages.
  • window-title – prefix title of the window
  • output – output directory
  • footer – footer of each ASDoc page

To properly make this build I’ve added a few properties to my build.properties file. The additions are below:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
#####################################################################
#
#  ASDoc Properties
#
#####################################################################
#asdoc output
Asdoc.dir=asdoc
#the location of asdocs on your computer
AsDocs.executable=${FLEX_HOME}/bin/asdoc.exe
#Asdoc Footer Text
Footer.text=Some legal jargon
#window title
Window.title=Window Title
#main title
Main.title=Main Title
#the location of your application classes on your computer
AppClasses.dir=${basedir}/src

Our Current Project
Use view source to see our entire project along with build scripts and build properties.

Get Adobe Flash player

 Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/01/28/building-asdocs-with-ant/feed/ 3 http://unitedmindset.com/jonbcampos/2010/01/28/building-asdocs-with-ant/ Building a Library and Application with ANT http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/88YC960pIiw/ http://unitedmindset.com/jonbcampos/2010/01/26/building-a-library-and-application-with-ant/#comments Tue, 26 Jan 2010 15:00:05 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1091 Now we have two ANT build files, one for the project and one for the library. What if we want the build file to build the library, store the swc, and then build the application with the newly created swc. These are the next steps we need to take to ensure a brand new clean build each time we make our application.

This is the step that things get a bit hairy – at least more so then it was in the past. Our current steps look like:

Now we need to go a bit further and do some better cleanup then we were doing previously. In this step we will also become much more tied to the computer that is running the build file. I say this because we will be reaching cross projects and no longer is everything going to be simple paths from the base directory. This isn’t an issue and can all be handled in the build.properties for every environment, but still just another hurdle. When we end this step our build process will look like this:

*Denotes new functionality

Make new temporary folder to store generated SWCs
Starting (following the earlier defined order) with creating a new temporary folder to hold the dependent SWC files that we will create in the ANT files. Later we will delete this file, but we need to hold all our SWC files into one location to simplify the build process.

1
2
3
4
5
6
7
8
    <target name="cleanDeploySWCs">
        <echo>Deleting Deploy SWC Directory...</echo>
        <delete dir="${DeploySWC.dir}" failOnError="false" includeEmptyDirs="true"/>
        <echo>Deleted Deploy SWC Directory</echo>
        <echo>Creating Deploy SWC Directory...</echo>
        <mkdir dir="${DeploySWC.dir}"/>
        <echo>Created Deploy SWC Directory</echo>
    </target>

For this we need to add a new ANT variable in the build.properties.

1
2
#Deploy SWC Directory
DeploySWC.dir=deploySWC

Copy SWCs that the application depends on into temp folder
Next let’s copy all of the files that the Flex application is expecting into our newly created temporary folder.

1
2
3
4
5
6
7
    <target name="copyPrecompiledSWCs">
        <echo>Copying to Deploy SWC Directory...</echo>
        <copy todir="${DeploySWC.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${ApplicationLibs.dir}"/>
        </copy>
        <echo>Copied to Deploy SWC Directory...</echo>
    </target>

And the new build.properties additions.

1
2
#Application Libs
ApplicationLibs.dir=libs

Build Library, outputting into temp folder
In this step we will be making a modified version of the Library ANT build script that we used earlier, while also defining the location of the library. When we compile the library it’s output will result in the SWC file being placed in the temporary folder that we created earlier. This will be the final SWC necessary to build our application.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
    <target name="compileLibrary" description="compiles the Library">
        <echo>Compiling Library SWC To Deploy SWC Folder</echo>
        <compc debug="${Debug.Boolean}" output="${DeploySWC.dir}/${Library.name}.swc">
            <source-path path-element="${LibrarySrc.dir}"/>
            <include-sources dir="${LibrarySrc.dir}" includes="*"/>
            <compiler.library-path dir="${LibraryLibs.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
            <metadata>
                <creator>Jonathan Campos</creator>
                <publisher>UnitedMindset</publisher>
                <language>EN</language>
            </metadata>
        </compc>
        <echo>Compiled Library SWC To Deploy SWC Folder</echo>
    </target>

Additional Properties

1
2
3
4
5
6
7
8
#Library Directory
Library.dir=C:/workspace/ANTBuildLibrary
#Library Libs
LibraryLibs.dir=${Library.dir}/libs
#Library Src
LibrarySrc.dir=${Library.dir}/src
#library name
Library.name=ANTBuildLibrary

Build the application
With all the SWCs compiled and put together we can now build the application. You will notice that there is one small change in the application target to include a library folder file.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
    <target name="compileApplication">
        <echo>Compiling SWF To Deploy</echo>
        <mxmlc file="${Src.dir}/${Application.name}.mxml"
            incremental="false"
            actionscript-file-encoding="UTF-8"
            output="${Deploy.dir}/${Application.name}${timestamp}.swf"
            debug="${Debug.Boolean}"
            keep-generated-actionscript="false">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <default-background-color>0xFFFFFF</default-background-color>
            <metadata>
                <creator>Jonathan Campos</creator>
                <publisher>UnitedMindset</publisher>
                <language>EN</language>
            </metadata>
            <compiler.source-path path-element="${Src.dir}" />
            <compiler.library-path dir="${basedir}/${DeploySWC.dir}" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
        </mxmlc>
        <echo>Compiled SWF To Deploy</echo>
    </target>

Clean up (delete) temp folder
With our application created and safely sitting in our deploy folder, we just need to clean up (delete) the temporary folder that we created previously so that it isn’t loitering in our project.

1
2
3
4
5
    <target name="cleanTempDirectories">
        <echo>Deleting Deploy SWC Directory...</echo>
        <delete dir="${DeploySWC.dir}" failOnError="false" includeEmptyDirs="true"/>
        <echo>Deleted Deploy SWC Directory</echo>
    </target>

Your Current Build File

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
<?xml version="1.0" encoding="UTF-8"?>
<project name="Build File" basedir="." default="compileProject">
   
    <!-- Set Up    ============================================== -->
   
    <!-- file description -->
    <description>Build Script</description>
   
    <!--location of property file -->
    <property file="./build.properties"
        description="properities for builds" />
   
    <!-- timestamp -->
    <tstamp>
        <format property="timestamp" pattern="yyyyMMdd" />
    </tstamp>
   
    <!-- additional tasks -->
    <taskdef resource="flexTasks.tasks" classpath="${FlexTasks.file}"/>
   
    <!-- ======================================================== -->
   
   
    <!-- Compile Project    ===================================== -->
    <target name="compileProject"
        depends="cleanDeploy,buildWrapper,buildCustomWrapper,copyNonEmbeddedFiles,compileLibraries,compileApplication,cleanTempDirectories"
        description="compiles application"/>
   
    <target name="cleanDeploy" description="Cleans the deploy file">
        <echo>Deleting Deploy Directory...</echo>
        <delete dir="${Deploy.dir}" failOnError="false"
            includeEmptyDirs="true" />
        <echo>Deleted Deploy Directory</echo>
        <echo>Creating Deploy Directory...</echo>
        <mkdir dir="${Deploy.dir}" />
        <echo>Created Deploy Directory</echo>
    </target>
   
    <target name="buildWrapper">
        <echo>Building Wrapper...</echo>
        <html-wrapper title="${Application.name}"
            height="100%" width="100%"
            bgcolor="#FFFFFF" file="${Application.name}.html"
            application="${Application.name}"
            swf="${Application.name}${timestamp}"
            version-major="${Major.version}"
            version-minor="${Minor.version}"
            version-revision="${Revision.version}"
            history="true"
            template="express-installation"
            output="${Deploy.dir}" />
        <echo>Built Wrapper</echo>
    </target>
   
    <target name="buildCustomWrapper">
        <echo>Building Custom Wrapper...</echo>
        <copy file="${Template.file}" tofile="${Deploy.dir}/${Output.file}" overwrite="true">
            <filterchain>
                <replacetokens>
                    <token key="version_major" value="${Major.version}"/>
                    <token key="version_minor" value="${Minor.version}"/>
                    <token key="version_revision" value="${Revision.version}"/>
                    <token key="application" value="${Application.name}"/>
                    <token key="width" value="100%"/>
                    <token key="height" value="100%"/>
                    <token key="bgcolor" value="#FFFFFF"/>
                    <token key="swf" value="${Application.name}${timestamp}"/>
                </replacetokens>
            </filterchain>
        </copy>
        <echo>Built Custom Wrapper</echo>
    </target>
   
   
    <target name="compileApplication">
        <echo>Compiling SWF To Deploy</echo>
        <mxmlc file="${Src.dir}/${Application.name}.mxml"
            incremental="false"
            actionscript-file-encoding="UTF-8"
            output="${Deploy.dir}/${Application.name}${timestamp}.swf"
            debug="${Debug.Boolean}"
            keep-generated-actionscript="false">
            <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>
            <default-background-color>0xFFFFFF</default-background-color>
            <metadata>
                <creator>Jonathan Campos</creator>
                <publisher>UnitedMindset</publisher>
                <language>EN</language>
            </metadata>
            <compiler.source-path path-element="${Src.dir}" />
            <compiler.library-path dir="${basedir}/" append="true">
                <include name="${DeploySWC.dir}"/>
            </compiler.library-path>
        </mxmlc>
        <echo>Compiled SWF To Deploy</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- NONEMBEDDED FILES ====================================== -->
    <target name="copyNonEmbeddedFiles">
        <echo>Deleting Deploy Assets Directory...</echo>
        <delete dir="${DeployAssets.dir}" failOnError="false" includeEmptyDirs="true" />
        <echo>Deleted Deploy Assets Directory</echo>
        <echo>Creating Assets Folder</echo>
        <mkdir dir="${DeployAssets.dir}"/>
        <echo>Created Assets Folder</echo>
        <echo>Copy Nonembedded Resources To Deploy</echo>
        <copy todir="${DeployAssets.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${Assets.dir}"/>
        </copy>
        <echo>Copied Nonembedded Resources To Deploy</echo>
    </target>
    <!-- ======================================================== -->
   
    <!-- COMPILE LIBRARIES ====================================== -->
    <target name="compileLibraries" depends="cleanDeploySWCs,copyPrecompiledSWCs,compileLibrary" />

    <target name="cleanDeploySWCs">
        <echo>Deleting Deploy SWC Directory...</echo>
        <delete dir="${DeploySWC.dir}" failOnError="false" includeEmptyDirs="true"/>
        <echo>Deleted Deploy SWC Directory</echo>
        <echo>Creating Deploy SWC Directory...</echo>
        <mkdir dir="${DeploySWC.dir}"/>
        <echo>Created Deploy SWC Directory</echo>
    </target>

    <target name="copyPrecompiledSWCs">
        <echo>Copying to Deploy SWC Directory...</echo>
        <copy todir="${DeploySWC.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${ApplicationLibs.dir}"/>
        </copy>
        <echo>Copied to Deploy SWC Directory...</echo>
    </target>
   
    <target name="compileLibrary" description="compiles the Library">
        <echo>Compiling Library SWC To Deploy SWC Folder</echo>
        <compc debug="${Debug.Boolean}" output="${DeploySWC.dir}/${Library.name}.swc">
            <source-path path-element="${LibrarySrc.dir}"/>
            <include-sources dir="${LibrarySrc.dir}" includes="*"/>
            <compiler.library-path dir="${LibraryLibs.dir}/" append="true">
                <include name="*.swc"/>
            </compiler.library-path>
            <metadata>
                <creator>Jonathan Campos</creator>
                <publisher>UnitedMindset</publisher>
                <language>EN</language>
            </metadata>
        </compc>
        <echo>Compiled Library SWC To Deploy SWC Folder</echo>
    </target>
   
    <!-- Clean Up =============================================== -->
    <target name="cleanTempDirectories">
        <echo>Deleting Deploy SWC Directory...</echo>
        <delete dir="${DeploySWC.dir}" failOnError="false" includeEmptyDirs="true"/>
        <echo>Deleted Deploy SWC Directory</echo>
    </target>

    <!-- ======================================================== -->
   
</project>

Your Current build.properties

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
###############################################################################
#
#  Compiler Properties
#
###############################################################################

# Flex SDK File Location
FLEX_HOME=C:/Program Files/Adobe/Flex Builder 3 Plug-in/sdks/3.5
#flextasks jar location
FlexTasks.file=flexTasks/flexTasks.jar
#deploy directory
Deploy.dir=deploy
#source directory
Src.dir=src
#debug flag
Debug.Boolean=false
#application name
Application.name=ANTBuildProject
#version major
Major.version=9
#version minor
Minor.version=0
#version revision
Revision.version=124
#Template File
Template.file=index.template.html
#Output HTML File
Output.file=index.html
#Assets
Assets.dir=${Src.dir}/assets
#Assets
DeployAssets.dir=${Deploy.dir}/assets
#Deploy SWC Directory
DeploySWC.dir=deploySWC
#Library Directory
Library.dir=C:/workspace/ANTBuildLibrary
#Library Libs
LibraryLibs.dir=${Library.dir}/libs
#Library Src
LibrarySrc.dir=${Library.dir}/src
#library name
Library.name=ANTBuildLibrary
#Application Libs
ApplicationLibs.dir=libs
Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/01/26/building-a-library-and-application-with-ant/feed/ 3 http://unitedmindset.com/jonbcampos/2010/01/26/building-a-library-and-application-with-ant/ Including Assets Files with ANT http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/raFegIGHZzg/ http://unitedmindset.com/jonbcampos/2010/01/21/including-assets-files-with-ant/#comments Thu, 21 Jan 2010 15:20:52 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1094 Building off of the last few posts, we are continuing to build our one big ANT file that will build your amazing Enterprise Application.

As you are building your application you probably also have a set of assets that aren’t embedded in your final SWF file. Flex/Flash Builder automatically adds this file into your bin and release files, but we need our build script to do the same. Achieving this trick is pretty simple.

Our new target to copy these nonembedded assets is a simple step if we follow some guidelines. By putting our assets into one folder system rather than throughout our application’s packages we can quickly copy the entire folder right over.

1
2
3
4
5
6
7
8
9
10
11
12
13
    <target name="copyNonEmbeddedFiles">
        <echo>Deleting Deploy Assets Directory...</echo>
        <delete dir="${DeployAssets.dir}" failOnError="false" includeEmptyDirs="true" />
        <echo>Deleted Deploy Assets Directory</echo>
        <echo>Creating Assets Folder</echo>
        <mkdir dir="${DeployAssets.dir}" />
        <echo>Created Assets Folder</echo>
        <echo>Copy Nonembedded Resources To Deploy</echo>
        <copy todir="${DeployAssets.dir}" includeemptydirs="false" overwrite="true">
            <fileset dir="${Assets.dir}" />
        </copy>
        <echo>Copied Nonembedded Resources To Deploy</echo>
    </target>

This code clears out any old folders and copies the assets from your assets folder to your deploy directory. To make all this complete we just need to add a few lines into our build.properties.

1
2
3
4
#Assets
Assets.dir=${Src.dir}/assets
#Assets
DeployAssets.dir=${Deploy.dir}/assets

If you have reading these posts in order, you can now build a project, build a library, build your custom and default html wrappers, and now include your non-embedded assets. I think we are doing pretty good so far.

Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/01/21/including-assets-files-with-ant/feed/ 9 http://unitedmindset.com/jonbcampos/2010/01/21/including-assets-files-with-ant/ Building a Custom HTML Wrapper with ANT http://feedproxy.google.com/~r/TheWorldInAStateOfFlex/~3/YMEq-HMEIGs/ http://unitedmindset.com/jonbcampos/2010/01/20/building-a-custom-html-wrapper-with-ant/#comments Wed, 20 Jan 2010 15:40:14 +0000 Jonathan Campos http://unitedmindset.com/jonbcampos/?p=1095 In the last part of this series you left with the ability to automatically generate your html-wrapper with the FlexTasks.jar provided html-wrapper task. This is extremely helpful, yet troublesome if you need even the smallest change to the html wrapper provided.

In many applications you’ll probably want the application focused by default, this javascript reliant functionality is not provided in the html-wrapper templates and there is no way to change the template files when using the html-wrapper FlexTask task. Now we need to create a custom wrapper and use ANT to produce it everytime we build our application.

Make The Template
First, you need to make the template that you will be using for your html file. Here is mine:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
<!-- saved from url=(0014)about:internet -->
<html lang="en">

<!--
Smart developers always View Source.

This application was built using Adobe Flex, an open source framework
for building rich Internet applications that get delivered via the
Flash Player or to desktops via Adobe AIR.

Learn more about Flex at http://flex.org
// -->

<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<!--  BEGIN Browser History required section -->
<link rel="stylesheet" type="text/css" href="history/history.css" />
<!--  END Browser History required section -->

<title>@application@</title>
<script src="AC_OETags.js" language="javascript"></script>

<!--  BEGIN Browser History required section -->
<script src="history/history.js" language="javascript"></script>
<!--  END Browser History required section -->

<style>
body { margin: 0px; overflow:hidden }
</style>
<script language="JavaScript" type="text/javascript">
<!--
// -----------------------------------------------------------------------------
// Globals
// Major version of Flash required
var requiredMajorVersion = @version_major@;
// Minor version of Flash required
var requiredMinorVersion = @version_minor@;
// Minor version of Flash required
var requiredRevision = @version_revision@;
// -----------------------------------------------------------------------------
// -->
</script>
</head>

<body scroll="no" onLoad="@application@.focus()">
<script language="JavaScript" type="text/javascript">
<!--
// Version check for the Flash Player that has the ability to start Player Product Install (6.0r65)
var hasProductInstall = DetectFlashVer(6, 0, 65);

// Version check based upon the values defined in globals
var hasRequestedVersion = DetectFlashVer(requiredMajorVersion, requiredMinorVersion, requiredRevision);

if ( hasProductInstall && !hasRequestedVersion ) {
    // DO NOT MODIFY THE FOLLOWING FOUR LINES
    // Location visited after installation is complete if installation is required
    var MMPlayerType = (isIE == true) ? "ActiveX" : "PlugIn";
    var MMredirectURL = window.location;
   document.title = document.title.slice(0, 47) + " - Flash Player Installation";
   var MMdoctitle = document.title;

    AC_FL_RunContent(
        "src", "playerProductInstall",
        "FlashVars", "MMredirectURL="+MMredirectURL+'&MMplayerType='+MMPlayerType+'&MMdoctitle='+MMdoctitle+"",
        "width", "@width@",
        "height", "@height@",
        "align", "middle",
        "id", "@application@",
        "quality", "high",
        "bgcolor", "@bgcolor@",
        "name", "@application@",
        "allowScriptAccess","sameDomain",
        "SeamlessTabbing","false",             
        "type", "application/x-shockwave-flash",
        "pluginspage", "http://www.adobe.com/go/getflashplayer"
    );
} else if (hasRequestedVersion) {
    // if we've detected an acceptable version
    // embed the Flash Content SWF when all tests are passed
    AC_FL_RunContent(
            "src", "@swf@",
            "width", "@width@",
            "height", "@height@",
            "align", "middle",
            "id", "@application@",
            "quality", "high",
            "bgcolor", "@bgcolor@",
            "name", "@application@",
            "allowScriptAccess","sameDomain",  
            "SeamlessTabbing","false",                     
            "type", "application/x-shockwave-flash",
            "pluginspage", "http://www.adobe.com/go/getflashplayer"
    );
 } else {  // flash is too old or we can't detect the plugin
   var alternateContent = 'Alternate HTML content should be placed here. '
    + 'This content requires the Adobe Flash Player. '
    + '<a href=http://www.adobe.com/go/getflash/>Get Flash</a>';
   document.write(alternateContent);  // insert non-flash content
 }
// -->
</script>

<noscript>
    <object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
            id="@application@" width="@width@" height="@height@"
            codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab">
            <param name="movie" value="@swf@.swf" />
            <param name="quality" value="high" />
            <param name="bgcolor" value="#ffffff" />
            <param name="allowScriptAccess" value="sameDomain" />      
            <param name="SeamlessTabbing" value="false"/>              
            <param name='flashVars' value='j_username=<%= user %>&j_password=<%= cred %>'/>                
            <embed src="@swf@.swf" quality="high" bgcolor="@bgcolor@"
                width="@width@" height="@height@" name="@application@" align="middle"
                play="true"
                loop="false"
                quality="high"
                allowScriptAccess="sameDomain"
                type="application/x-shockwave-flash"
                pluginspage="http://www.adobe.com/go/getflashplayer" >
            </embed>
    </object>
</noscript>
</body>
</html>

I titled this file index.template.html so that future devs know that this is the template for the index file. Pretty simple right.

If you look through the HTML code you will see many new notations that look like: @width@. These are tokens used by ANT, and can quickly be replaced by ANT using a replacetoken task.

The buildCustomWrapper Target
Now we just need to add in a new target to handle taking the template, replacing the tokens with variables from the build.properties.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
    <target name="buildCustomWrapper">
        <echo>Building Custom Wrapper...</echo>
        <copy file="${Template.file}" tofile="${Deploy.dir}/${Output.file}" overwrite="true">
            <filterchain>
                <replacetokens>
                    <token key="version_major" value="${Major.version}"/>
                    <token key="version_minor" value="${Minor.version}"/>
                    <token key="version_revision" value="${Revision.version}"/>
                    <token key="application" value="${Application.name}"/>
                    <token key="width" value="100%"/>
                    <token key="height" value="100%"/>
                    <token key="bgcolor" value="#FFFFFF"/>
                    <token key="swf" value="${Application.name}${timestamp}"/>
                </replacetokens>
            </filterchain>
        </copy>
        <echo>Built Custom Wrapper</echo>
    </target>

That’s it. It’s really simple. We just add a few more variables into our build.properties and we are set.

1
2
3
4
#Template File
Template.file=index.template.html
#Output HTML File
Output.file=index.html

Continue adding the names of these new targets into your compileProject depends and your build file will continue to build all of your targets in order.

I usually keep the base html-wrapper template build along with my custom wrapper so that I can use the Adobe created express install scripts and history scripts.

Share/Bookmark]]> http://unitedmindset.com/jonbcampos/2010/01/20/building-a-custom-html-wrapper-with-ant/feed/ 1 http://unitedmindset.com/jonbcampos/2010/01/20/building-a-custom-html-wrapper-with-ant/