AIR for Android でネイティブパスを取得する場合、 File.applicationStorageDirectory （プライベート記憶領域）と、 File.applicationDirectory （アプリケーションディレクトリ）で取得する方法を変える必要があるよってお話しです。

※ AIR 3.1 のお話しです。

以下ちょっと長いので読むのが面倒な人は、、

これだけ覚えておきましょう。

AIR for Android は アプリケーションディレクトリ（File#applicationDirectory）のファイルは「/android_asset/ほにゃらら」で、プライベート記憶領域（File#applicationStorageDirectory）のファイルは「File.applicationStorageDirectory.resolvePath(ほにゃらら).nativePath」になります。

URL にする場合は、それぞれ「file:///android_asset/ほにゃらら」と「new File(File.applicationStorageDirectory.resolvePath(ほにゃらら).nativePath).url」で取得できます。

以下は原因とかちょっと詳しい解説です。特に必要なければ読まなくてOK。

File.applicationStorageDirectory （プライベート記憶領域）

File.applicationStorageDirectory のファイルは nativePath プロパティの値でネイティブパスが取得できます。

trace(File.applicationStorageDirectory.resolvePath("example.html").nativePath);

上のコードでは Android のプライベート記憶領域である「/data/data/air.[アプリケーションID].debug/[アプリケーションID].debug/Local Store/example.html」が取得できます。（デバッグ実行の場合）

File.applicationDirectory （アプリケーションディレクトリ）

File.applicationDirectory の場合、なんと Android では nativePath プロパティの値が正しく取得できません。

trace(File.applicationDirectory.resolvePath("example.html").nativePath);

上のコードは ""（空文字）になってしまいます。（null ではないです。）

trace(File.applicationDirectory.nativePath);

も同じです。
※ AIR for iOS の場合は正しく取得できます。

• File.applicationDirectory.nativePath
• File.applicationDirectory.resolvePath("example.html").nativePath

どちらもKARA!

公式のドキュメントを見てもどこにも書いてないです。書いてあるかもしれないけど見つけられなかったです。

どうやら、File.applicationDirectory の場合のみ、nativePath プロパティの値を正しく取得することができないようです。
エラーにもならないのでハマります。

※ .resolvePath("example.html") までは正常に処理されます。

URL への変換

StageWebView#loadURL(url:String) にローカルの HTML ファイルを読み込ませるようなとき、File.applicationDirectory の場合は、

var url:String = "file:///android_asset/" + "example.html";

として、

"file:///android_asset/example.html"

のような URL を作成します。

File.applicationStorageDirectory の場合は、

var url:String = new File(File.applicationStorageDirectory.resolvePath("example.html").nativePath).url;

とすることで

"file:///data/data/air.[アプリケーションID].debug/[アプリケーションID].debug/Local Store/example.html"

のような URL が作成できます。これを StageWebView 等に読み込ませれば OK。

まとめ

まとめると次のようなコードになります。

// ↓ このファイルを取得したい！
var fileName:String = "example.html";
 
// 取得する URL 文字列
var url:String;
 
// File.applicationStorageDirectory の中のファイルなら...
if ([applicationStoregeDirectory の場合])
{
    url = new File(File.applicationStorageDirectory.resolvePath(fileName).nativePath).url;
}
 
// File.applicationDirectory の中のファイルなら...
else
{
    // Android 端末なら...
    if (isAndroid)
    {
        url = "file:///android_asset/" + fileName;
    }
 
    // Android 端末以外なら...
    else
    {
        url = new File(File.applicationDirectory.resolvePath(fileName).nativePath).url;
    }
}
 
// StageWebView に読み込ませてしまえ
var webView:StageWebView = new StageWebView;
webView.stage = stage;
webView.viewport = rect;
webView.loadURL(url);

もうひとつまとめ

表にするとこんな感じ。（見辛い）

File.applicationDirectory

File.applicationStorageDirectory

さて、なんでこんな面倒なことになってんでしょう？