When using Potomac in an AIR application, Potomac will load bundles from the remote location specified in the appManifest.xml. Another important feature of AIR support is Potomac’s bundle caching.

AIR Bundle Caching
When bundles are downloaded remotely, Potomac saves those bundles to the local app-storage directory (under a sub-directory named ‘bundles’). In subsequent sessions, Potomac will attempt to use this local bundle cache rather than download the bundle swfs remotely.

In cases where the remote location is inaccessible (i.e. the user is offline), Potomac will always use the local bundle cache (if available).

Updating Bundles
Potomac determines whether the cache is up-to-date by comparing the version attribute of the remote and cached bundles. Therefore, to update a bundle on the remote server and ensure the new version is downloaded, developers will need to set and update the version property found in the bundle.xml.

Development Support
When running inside FlexBuilder/FlashBuilder, Potomac will always load bundles locally from /bin-debug. This ensures that the AIR application is picking up the bundles in the FlashBuilder workspace rather than remote or cached bundles.