Build

Summary
Build
Development ToolsThe tools being used in the development of µSprite.
Build FlashTo build generated graphics follow the instructions in the doc pages and readme files in doc/samples.
Build Adobe AIRThe steps required to build an Adobe AIR package for µSprite.
DocumentationThe autotelicum souce code documentation is generated with NaturalDocs.

Development Tools

The tools being used in the development of µSprite.

Adobe Flex SDKRequired to compile ActionScript with the Flash API
Flex Compiler ShellSpeeds up the Java-based Flex compiler
DarcsA distributed patch-oriented revision control system
Natural DocsDocumentation generator from readable comments
Komodo EditMulti-platform multi-language text editor with macros
PythonHandy and portable script language for utilities and macros
asUnitUnit testing with test template generator

Build Flash

To build generated graphics follow the instructions in the doc pages and readme files in doc/samples.

The steps required to build µSprite manually.

1Download and install the Adobe Flex SDK 3
2Download and unpack the latest µSprite tarball
3Open a console or commandline window
4Change directory to mSprite
5Type: mxmlc mSprite.as
6Change directory to muSprite
7Type: mxmlc muSprite.as

If you have Python 2.4+ with distutils installed then you can use the build.py script in the µSprite tarball.

The produced swf files are placed in the doc/assets directory.  Start µSprite with mSprite or muSprite.  If you start mSprite then you get theme color selection.  If you start muSprite then you get a random theme color.

If your OS does not support unpacking of tarballs automatically, then you can use a free utility such as ZipGenius on Windows.

The process should be the same on Mac OS X, Linux and Windows, read the Flex Build and Deploy manual if you experience difficulties.

Use the Flex compiler shell fcsh from Adobe for a 10-20x speedup if you compile repeatedly.

Build Adobe AIR

The steps required to build an Adobe AIR package for µSprite.

From the directory where you unpacked the execute

mxmlc +configname=air -optimize airSprite/airSprite.as
adt -package downloads/muSprite.air airSprite/airSprite-app.xml airSprite/airSprite.swf icons/smallIcon.png icons/mediumIcon.png icons/largeIcon.png icons/hugeIcon.png

The package is placed in downloads, the Flash content file is in airSprite.  You can test the AIR version without building a package or installing it; change to the airSprite directory and launch like this

adl airSprite-app.xml .. -- ../doc/samples/[SampleName].as

Documentation

The autotelicum souce code documentation is generated with NaturalDocs.

There are two reasons that NaturalDocs is used instead of Adobe asDoc

  • NaturalDocs provides search functionality on the generated html documentation.
  • NaturalDocs comments are easily readable in the sourcecode where it is most often read when the sourcecode is open source.  No @-sign keywords or html tags to reduce source readability.

To generate documentation download and install Natural Docs 1.4 from http://www.naturaldocs.org

If your operating system does not include perl then download and install it from http://www.perl.com or for windows try http://www.activestate.com/ActivePerl.

From the autotelicum source project directory execute

perl [NaturalDocs-install-path]/NaturalDocs -i readme -i libraries -i airSprite -i muSprite -i mSprite -img ReferenceManualSetup -o HTML doc/ReferenceManual -p ReferenceManualSetup -s Default DocStyle -do

You can document in javaDoc/asDoc style if you prefer and still generate searchable documentation with NaturalDocs.

The autotelicum documentation is in a style that is compatible with FlashDevelop tooltips.  FlashDevelop is a text editor that is unfortunately not capable of running on either Mac OS X or Linux but it implements tooltips and code-completion nicely for as2 and as3.

To enable tooltips in FlashDevelop, add libraries to the Tools/Global Classpaths dialog with the path where you installed the autotelicum package (i.e.  D:\[µSprite-install-path]\libraries).  This step is required because FlashDevelop does not recognize source-path instructions in normal [application name]-config.xml files.

Close