ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
Pointing to the desktop directory
Adobe AIR 1.0 and later
You can point a File object to the desktop. The following code sets a File object to point to an AIR Test subdirectory
of the desktop:
var file:File = File.desktopDirectory.resolvePath("AIR Test");
Pointing to the application storage directory
Adobe AIR 1.0 and later
You can point a File object to the application storage directory. For every AIR application, there is a unique associated
path that defines the application storage directory. This directory is unique to each application and user. You can use
this directory to store user-specific, application-specific data (such as user data or preferences files). For example, the
following code points a File object to a preferences file, prefs.xml, contained in the application storage directory:
var file:File = File.applicationStorageDirectory;
file = file.resolvePath("prefs.xml");
The application storage directory location is typically based on the user name and the application ID. The following
file system locations are given here to help you debug your application. You should always use the
File.applicationStorage property or app-storage: URI scheme to resolve files in this directory:
On Mac OS — varies by AIR version:
AIR 3.2 and earlier: /Users/user name/Library/Preferences/applicationID/Local Store/
AIR 3.3 and later: path/Library/Application Support/applicationID/Local Store, where path is either
/Users/username/Library/Containers/bundle-id/Data (sandboxed environment) or /Users/username (
when running outside a sandboxed environment)
For example (AIR 3.2):
/Users/babbage/Library/Preferences/com.example.TestApp/Local Store
On Windows—In the documents and Settings directory, in:
C:\Documents and Settings\user name\Application Data\applicationID\Local Store\
For example:
C:\Documents and Settings\babbage\Application Data\com.example.TestApp\Local Store
On Linux—In:
/home/user name/.appdata/applicationID/Local Store/
For example:
/home/babbage/.appdata/com.example.TestApp/Local Store
On Android—In:
/data/data/androidPackageID/applicationID/Local Store
For example:
/data/data/air.com.example.TestApp/com.example.TestApp/Local Store
On AIR for TV devices, the location is described in “Directory view for AIR for TV applications” on page 670.
Last updated 6/6/2012
672