Using the Shu Packager

This page describes how to use the Shu Packager to create Shu-enabled applications for distribution to your end-users.

Shu

  • Step 1 : Create your AIR app with Shu inside

    Package your AIR application together, including the Shu application in the root of your package.

    For example, on the Mac: 

      adt –package -storetype pkcs12 -keystore sampleCert.pfx 
        myApp.air myApp.xml myApp.swf Shu.app

    Or on Windows: 

      adt –package -storetype pkcs12 -keystore sampleCert.pfx 
        myApp.air myApp.xml myApp.swf Shu.exe

    Please note: The Shu application must not be renamed. That is, it must be called Shu.app on Mac and Shu.exe on Windows when you package it into your AIR application.

  • Step 2 : Setup the Shu Packager

    The Shu Packager bundles the Adobe AIR installer into your application. It is necessary to point the Shu Packager to the location of the AIR installer on your hard drive. You may do this by choosing 'Help -> Set AIR Installer Location...' from the menu.

    The Adobe AIR installer can be downloaded from here, following the receival of your license.

    The file to be downloaded is that linked to under the sections titled:

    “Adobe AIR Runtime Installer files: For use with a native installer or through CD/DVD redistribution using the Adobe AIR side-car configuration. Please refer to following documentation for details on files used.”

    On Mac, the downloaded .dmg should be unarchived, and the Shu Packager should be pointed to the resulting location of the 'Adobe AIR Installer.app' on your system. The filename must be called exactly this ( 'Adobe AIR Installer.app' ), or the Shu Packager will not recognise it.

    On Windows, you need simply point the Shu Packager to the location of the downloaded zip file, i.e. AIR_Win_installer_files.zip . You do not need to unarchive the file. The file must be called exactly AIR_Win_installer_files.zip, or the Shu Packager will not recognise it.

  • Step 3 : Create the Installer

    The Shu Packager creates an Installer for your application. To do this, start up the Packager and drag your .air file into the area marked for packaging. This creates the installer for your Shu-enabled application. It is created in the same directory as that of the .air file you are packaging.

  • Step 4 : Distribute!

    The Installer can now be distributed to your end-users. They simply need to run the Installer and it will install the AIR framework, if required, and will also install your AIR application and Shu-enable it.

    • Shu SA and Shu SA Lite

    • Step 1 : Setup the Shu Packager

      The Shu Packager bundles the AIR framework into your application. It is necessary to point the Shu Packager to the location of the AIR framework on your hard drive. You may do this by choosing 'Help -> Set AIR Location...' from the menu.

    • Step 2 : Create the Shu-enabled application

      The Shu Packager produces your Shu-enabled application. Start up the Packager and drag your .air file into the area marked for packaging. The Shu-enabled application is created in the same directory as that of the .air file you are packaging.

    • Step 3 : Distribute!

      The application can now be distributed to your end-users. Whether it is on a CD-ROM, a network share, or their desktop, they simply need to double-click the application to run it.