Appendix B. Apollo Command-Line Tools
The Apollo SDK provides the following command-line tools:
- AMXMLC
A command-line wrapper for the MXMLC compiler that configures the compiler to use Apollo classes.
- ADL
Use this tool to launch and test an Apollo application without having to install it.
- ADT
Use this tool to package an Apollo application into a redistributable AIR file.
These tools are also available in the Apollo Extensions for Flex Builder. They are installed in the bin subdirectory.
This Appendix lists the options for each of the command-line tools.
For an example of using these tools, see Chapter 2.
AMXMLC
AMXMLC is a simple wrapper for the MXMLC Flex compiler, which links in the appropriate Apollo-specific libraries.
Usage is the same as MXMLC:
amxmlc myTestApp.mxml
This shell script is included in the bin directory of the Apollo SDK directory.
The first argument passed to the compiler is the location of the MXML file to compile (myTestApp.mxml in the previous example).
There are a number of other options for the MXMLC compiler. For details on these, see:
| http://livedocs.macromedia.com/flex/201/html/compilers_123_24.html |
ADL
ADL is a command-line tool that launches an Apollo application, based on it’s application.xml file, without requiring that the application be installed. This is useful for testing and debugging the application.
Typically, you want to call the ADL tool passing one parameter: the path to the application descriptor file (the application .xml file):
adl application.xml
The full syntax of the ADL command is:
adl ( -runtime <path-to-runtime-dir> )? <path-to-app-xml> <path-to-root-dir>? ( -- ... )?
Here is a description of the command-line arguments for ADL:
|
Option |
Description |
|
|
Optional argument that specifies the directory that contains the Apollo runtime that should be used. |
|
|
The application.xml descriptor file for the application that should be launched. |
|
|
Optional argument that specifies the directory that contains the application.xml descriptor file |
|
|
Any arguments specified after this argument will be passed to the application as startup/command-line arguments. |
ADT
ADT is a command-line tool that packages Apollo applications into redistributable AIR files. The Apollo runtime can then install the Apollo application from that AIR file.
Typically, you want to call the ADT tool in the following way:
adt -package HelloWorld.air application.xml HelloWorld.swf
In this example, the ADT tool creates an AIR file named HelloWorld.air based on the application.xml application descriptor file.
The syntax of the ADT command is the following:
adt -package <air-file> <app-xml> <fileOrDir>* ( -C <dir> <fileOrDir>+ )*
Here are the command-line options for ADT:
|
Option |
Description |
|
|
The first argument must be |
|
|
The relative or absolute path to the AIR to be created by ADT. |
|
|
The relative or absolute path to the appliction.xml descriptor file for the application. |
|
|
One or more file or directory names identifying other files to be included in the package. Each successive file or directory name should be separated by a space. If a directory name is specified, then all of the files in that directory and its subdirectories will be included. However, files that are marked hidden in the file system will be ignored. If any of the files listed is the same as the file specified in the These files and directories will be copied into the application install directory when the application is installed. |
|
|
This changes the root directory path for subsequent files or directories listed in the command line. |