ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
Platform Directory type Typical file system location
Windows Application C:\Program Files\filename
Application-storage C:\Documents and
settings\userName\ApplicationData\applicationID\Local Store
Desktop C:\Documents and settings\userName\Desktop
Documents C:\Documents and settings\userName\My Documents
Temporary C:\Documents and settings\userName\Local
Settings\Temp\randomString.tmp
User C:\Documents and settings\userName
The actual native paths for these directories vary based on the operating system and computer configuration. The
paths shown in this table are typical examples. You should always use the appropriate static File class properties to refer
to these directories so that your application works correctly on any platform. In an actual AIR application, the values
for applicationID and filename shown in the table are taken from the application descriptor. If you specify a
publisher ID in the application descriptor, then the publisher ID is appended to the application ID in these paths. The
value for userName is the account name of the installing user.
Directory view for AIR for TV applications
To provide security to the system files on AIR for TV devices, an AIR application can access only a limited set of
directories. AIR for TV prohibits the application from accessing any other directories. Furthermore, AIR for TV
isolates each user’s user-specific data for each AIR application.
The AIR application uses directory names that are only for ActionScript 3.0 use. These names do not represent actual
directories on the device. AIR for TV maps these ActionScript 3.0 directory names to actual device directories. This mapping
protects AIR for TV applications from maliciously or inadvertently accessing local files that do not belong to them.
The ActionScript 3.0 directory names are:
/app/ The read-only application directory for the running AIR application.
/app-storage/ The read-write application storage directory for the running AIR application.
/home/ The read-write user directory.
/tmp/ The read-write temporary directory for the running AIR application.
/volumes/ The read-only directory containing zero or more read-write subdirectories that represent mounted
volumes.
If an application tries to access a prohibited directory, the runtime throws an exception that ActionScript code can
catch.
The following table shows the File.nativePath value for various File properties and methods. The values reflect the
application’s limited view of the device’s file system.
Last updated 6/6/2012
670