Developing AIR applications

Adobe ColdFusion Builder provides you with tools to create Adobe® AIR® projects, debug, package, and digitally sign Adobe AIR applications.

Create an AIR project

  1. Select File > New > Project.

  2. In the Create Project wizard, select HTML Projects > Adobe AIR Project, and click Next.

  3. Enter the project name and the location of the files in the project.

  4. Specify the HTML start page that contains the sandbox application code. You can also select non-application sandbox code. Click Next.

  5. Specify the following properties of the application XML file, and click Next.

    • ID: Unique application ID that is the identifier string for the application.

    • Name: Application name

    • Filename: Name of the file and folder where the application is installed

    • Version: Application version

    • Icon: Icon files that represent the application. If you don't specify an icon, the operating system uses a default icon.

  6. Specify the window style, dimension, sizing options, and click Next.

  7. Select the AIR frameworks to import into the project, and click Next.

  8. Select the Ajax JavaScript libraries that you want to import, and click Finish to create your AIR project.

Run and debug an AIR application

  1. From the Navigator view, open the source file (Application.XML) for the application.

  2. Click Run on the main toolbar to launch the AIR application.

  3. To debug the application, click in the workbench toolbar.

The application launches and runs in the ADL application (AIR Debugger Launcher). The ColdFusion debugger catches any breakpoints or runtime errors and you can debug the application like any other ColdFusion application. For more information, see Debugging Applications

Package and digitally sign an AIR application

When your application is complete and ready to be distributed, you package it into an AIR file. Packaging consists of the following steps:

  1. From the Navigator view, right-click the AIR project that you want to package, and click Export.

  2. In the Export wizard, select Adobe AIR > Adobe AIR Package, and click Next.

  3. Select the AIR project and the application descriptor file.

  4. You can select the default AIR SDK or configure a different Adobe AIR SDK, and click Next. To configure a different AIR SDK, click Configure Adobe AIR SDKs, and select an AIR SDK. You can also add a new AIR SDK, or edit and remove an existing AIR SDK.

  5. You can digitally sign your AIR application by selecting an existing digital certificate or by creating a self-signed certificate. Digitally signing your AIR application provides assurance to the users that the application has been signed with a trusted certificate and displays the publisher identity.

    1. Select Digitally Sign Exported AIR Application.

    2. Select an existing digital certificate, or click Configure Certificates to select a different digital certificate. Click Add to create a self-signed certificate.

    3. Specify the password for your digital certificate.

    4. If you select TimeStamp AIR Package, when signing the installation package, the AIR Developer Tool (ADT) automatically contacts a time-stamp authority to verify the time. The time-stamp information is included in the AIR file. An AIR file that includes a verified time stamp can be installed at any point in the future.

    5. Select Migrate AIR Application to migrate an AIR application to a new certificate. When you do so, sign the AIR file with both new and old certificates. Select the previous certificate from which you want to migrate and the previous certificate password.

    You also have the option of packaging your AIR application without a digital signature. To do so, deselect Digitally Sign Exported AIR Application. When you package your AIR application without a digital signature, an intermediate AIR file (.airi) is created. An intermediate AIR file cannot be deployed or installed. It is generally used for testing (by the developer) and can be launched using the AIR ADT command-line tool.

  6. Click Next to optionally select files to exclude from the exported AIR file. By default, all the files are included.

  7. Click Finish to generate the AIR file.