ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with the file system
Supported AIR URL schemes
Adobe AIR 1.0 and later
In AIR, you can use any of the following URL schemes in defining the url property of a File object:
URL scheme Description
file Use to specify a path relative to the root of the file system. For example:
file:///c:/AIR Test/test.txt
The URL standard specifies that a file URL takes the form file:///. As a special
case, can be the empty string, which is interpreted as "the machine from which the URL is being
interpreted." For this reason, file URLs often have three slashes (///).
app Use to specify a path relative to the root directory of the installed application (the directory that contains
the application.xml file for the installed application). For example, the following path points to an images
subdirectory of the directory of the installed application:
app:/images
app-storage Use to specify a path relative to the application store directory. For each installed application, AIR defines
a unique application store directory, which is a useful place to store data specific to that application. For
example, the following path points to a prefs.xml file in a settings subdirectory of the application store
directory:
app-storage:/settings/prefs.xml
Finding the relative path between two files
Adobe AIR 1.0 and later
You can use the getRelativePath() method to find the relative path between two files:
var file1:File = File.documentsDirectory.resolvePath("AIR Test");
var file2:File = File.documentsDirectory
file2 = file2.resolvePath("AIR Test/bob/test.txt");
trace(file1.getRelativePath(file2)); // bob/test.txt
The second parameter of the getRelativePath() method, the useDotDot parameter, allows for .. syntax to be
returned in results, to indicate parent directories:
var file1:File = File.documentsDirectory;
file1 = file1.resolvePath("AIR Test");
var file2:File = File.documentsDirectory;
file2 = file2.resolvePath("AIR Test/bob/test.txt");
var file3:File = File.documentsDirectory;
file3 = file3.resolvePath("AIR Test/susan/test.txt");
trace(file2.getRelativePath(file1, true)); // ../..
trace(file3.getRelativePath(file2, true)); // ../../bob/test.txt
Obtaining canonical versions of file names
Adobe AIR 1.0 and later
File and path names are not case sensitive on Windows and Mac OS. In the following, two File objects point to the
same file:
Last updated 6/6/2012
677