Adobe Integrated Runtime (AIR) for JavaScript Developers Pocket Reference

50 | Chapter 3: Working with JavaScript and HTML Within AIR

Unsupported URI schemes

In the Beta build of Adobe AIR, the commonly usedmailto://
and feed:// URI schemes are not available.

At the time that the book was written, it had not yet been
determined whether and/or how these URI schemes would
be available for the 1.0 release.

AIR URI Schemes

Adobe AIR provides a number of additional URIs that make
it easy to reference files and content within specific areas of
the users system (Table 3-2).

Here is a simple example of the app-resource AIR URI:

app-resource:/foo/test.html

This references a file nametest.htmlin thefoodirectory that
was installed with the application.

Table 3-1. Supported URI schemes

URI scheme Description

http:// URI that points to a resource accessed via the standard HTTP protocol.

This is fully supported within Adobe AIR.

https:// URI that points to a resource accessed via a protocol encrypted with

SSL/TLS. This is fully supported within Adobe AIR.

file:// URI that points to a resource on the local or a networked file system.

ftp:// URI that points to a resource accessed with the FTP protocol.

In the Adobe AIR Beta, requests for files will work correctly, while

requests for directories return an empty page with no directory listing.

Table 3-2. Adobe AIR URI schemes

URI Description

app-resource:/ Provides a reference to the root content directory of the

application. This should be used when referencing content

included within the AIR file.

app-storage:/ Provides a reference to an application-specific storage area on

the user’s system. This area is useful for storing user-specific

application settings and content.