openEventsPlatformApp/plugins/cordova-plugin-file/doc/ja/index.md
plugins/cordova-plugin-file/doc/ja/index.mdRaw
1<!---
2 Licensed to the Apache Software Foundation (ASF) under one
3 or more contributor license agreements. See the NOTICE file
4 distributed with this work for additional information
5 regarding copyright ownership. The ASF licenses this file
6 to you under the Apache License, Version 2.0 (the
7 "License"); you may not use this file except in compliance
8 with the License. You may obtain a copy of the License at
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
12 Unless required by applicable law or agreed to in writing,
13 software distributed under the License is distributed on an
14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 KIND, either express or implied. See the License for the
16 specific language governing permissions and limitations
17 under the License.
18-->
19
20# cordova-plugin-file
21
22このプラグインは、デバイス上のファイルへの読み取り/書き込みアクセスを許可するファイル API を実装します。
23
24このプラグインを含む、いくつかの仕様に基づいています：、HTML5 File API の<http://www.w3.org/TR/FileAPI/>
25
26（今は亡き) ディレクトリとシステムは、最新の拡張機能: <http://www.w3.org/TR/2012/WD-file-system-api-20120417/>プラグインのコードのほとんどはときに、以前の仕様に書かれていたが現在は： <http://www.w3.org/TR/2011/WD-file-system-api-20110419/>
27
28FileWriter 仕様も実装しています: <http://dev.w3.org/2009/dap/file-system/file-writer.html>
29
30使用法を参照してください HTML5 岩 ' 優秀な[ファイルシステム記事][1]。
31
32 [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/
33
34他のストレージ オプションの概要については、コルドバの[ストレージ ・ ガイド][2]を参照してください。.
35
36 [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html
37
38このプラグインでは、グローバル `cordova.file` オブジェクトを定義します。
39
40グローバル スコープではあるがそれがないまで `deviceready` イベントの後です。
41
42 document.addEventListener("deviceready", onDeviceReady, false);
43 function onDeviceReady() {
44 console.log(cordova.file);
45 }
46
47
48## インストール
49
50 cordova plugin add cordova-plugin-file
51
52
53## サポートされているプラットフォーム
54
55* アマゾン火 OS
56* アンドロイド
57* ブラックベリー 10
58* Firefox の OS
59* iOS
60* Windows Phone 7 と 8 *
61* Windows 8 *
62* ブラウザー
63
64* *`FileReader.readAsArrayBuffer` も `FileWriter.write(blob)` もこれらのプラットフォームはサポートしていません*。
65
66## ファイルを保存する場所
67
68V1.2.0、現在重要なファイル システム ディレクトリへの Url を提供しています。 各 URL はフォーム *file:///path/to/spot/* で、`window.resolveLocalFileSystemURL()` を使用する `DirectoryEntry` に変換することができます。.
69
70* `cordova.file.applicationDirectory`-読み取り専用のディレクトリは、アプリケーションがインストールされています。（*iOS*、*アンドロイド*、*ブラックベリー 10*)
71
72* `cordova.file.applicationStorageDirectory`-アプリケーションのサンド ボックス; のルート ディレクトリiOS でこの場所が読み取り専用 （特定のサブディレクトリが [のような `/Documents` ] は、読み取り/書き込み)。 内に含まれるすべてのデータは、アプリケーションにプライベートです。 （ *iOS*、*アンドロイド*、*ブラックベリー 10*)
73
74* `cordova.file.dataDirectory`内部メモリを使用して、アプリケーションのサンド ボックス内で永続なプライベート データ ストレージ （外部メモリを使用する必要がある場合使用して Android 上で `.externalDataDirectory` )。 IOS は、このディレクトリは iCloud と同期されません (使用する `.syncedDataDirectory` )。 （*iOS*、*アンドロイド*、*ブラックベリー 10*)
75
76* `cordova.file.cacheDirectory`-キャッシュされたデータ ファイルやアプリに簡単に再作成できる任意のファイルのディレクトリ。 ストレージ デバイスが不足したときに、OS がこれらのファイルを削除可能性があります、それにもかかわらず、アプリはここにファイルを削除する OS に依存しないでください。 （*iOS*、*アンドロイド*、*ブラックベリー 10*)
77
78* `cordova.file.externalApplicationStorageDirectory`外部ストレージのアプリケーション領域。（*アンドロイド*)
79
80* `cordova.file.externalDataDirectory`-外部ストレージ上のアプリ固有のデータ ファイルを配置する場所。（*アンドロイド*)
81
82* `cordova.file.externalCacheDirectory`外部ストレージにアプリケーション キャッシュ。（*アンドロイド*)
83
84* `cordova.file.externalRootDirectory`-外部ストレージ (SD カード) ルート。（*アンドロイド*、*ブラックベリー 10*)
85
86* `cordova.file.tempDirectory`-OS をクリアすることができます temp ディレクトリが。 このディレクトリ; オフに OS に依存しません。アプリが常に該当するファイルを削除します。 (*iOS*)
87
88* `cordova.file.syncedDataDirectory`-（例えば iCloud) に同期する必要がありますアプリケーション固有のファイルを保持します。(*iOS*)
89
90* `cordova.file.documentsDirectory`-ファイル、アプリケーションにプライベートは他のアプリケーション (Office ファイルなど） を意味です。(*iOS*)
91
92* `cordova.file.sharedDirectory`すべてのアプリケーション (*ブラックベリー 10*にグローバルに使用できるファイル)
93
94## ファイル ・ システム ・ レイアウト
95
96技術的に実装の詳細、非常にどのように `cordova.file.*` プロパティは、実際のデバイス上の物理パスにマップを知っておくと便利することができます。
97
98### iOS ファイル システムのレイアウト
99
100| デバイス ・ パス | `cordova.file.*` | `iosExtraFileSystems` | r/w ですか？ | 永続的なですか？ | OS を消去します | 同期 | プライベート |
101|:------------------------------------ |:--------------------------- |:--------------------- |:--------:|:--------:|:----------:|:------:|:------:|
102| `/var/モバイル/アプリケーション/< UUID >/` | applicationStorageDirectory | - | r | N/A | N/A | N/A | はい |
103| `appname.app/` | ディレクトリ | バンドル | r | N/A | N/A | N/A | はい |
104| `www/` | - | - | r | N/A | N/A | N/A | はい |
105| `Documents/` | documentsDirectory | ドキュメント | r/w | はい | いいえ | はい | はい |
106| `NoCloud/` | - | ドキュメント nosync | r/w | はい | いいえ | いいえ | はい |
107| `Library` | - | ライブラリ | r/w | はい | いいえ | はいですか？ | はい |
108| `NoCloud/` | dataDirectory | ライブラリ nosync | r/w | はい | いいえ | いいえ | はい |
109| `Cloud/` | syncedDataDirectory | - | r/w | はい | いいえ | はい | はい |
110| `Caches/` | cacheDirectory | キャッシュ | r/w | はい * | はい * * *| | いいえ | はい |
111| `tmp/` | tempDirectory | - | r/w | いいえ * * | はい * * *| | いいえ | はい |
112
113* アプリを再起動し、アップグレードとの間でファイルを保持が、OS を希望するたびにこのディレクトリを削除することができます。アプリを削除可能性があります任意のコンテンツを再作成することができる必要があります。
114
115* * ファイル アプリケーション再起動を渡って続くことがありますが、この動作に依存しないでください。 ファイルは、更新を維持するは保証されません。 アプリが該当する場合このディレクトリからファイルを削除する必要があります、これらのファイルが削除されるとき (または場合でも)、OS は保証しません。
116
117* * *| OS はそれ、必要だと感じているときにこのディレクトリの内容を消去可能性がありますが、これに依存しません。 この適切なディレクトリに、アプリケーションをオフにする必要があります。
118
119### 人造人間ファイル ・ システム ・ レイアウト
120
121| デバイス ・ パス | `cordova.file.*` | `AndroidExtraFileSystems` | r/w ですか？ | 永続的なですか？ | OS を消去します | プライベート |
122|:--------------------------------- |:----------------------------------- |:------------------------- |:--------:|:--------:|:---------:|:------:|
123| `file:///android_asset/` | ディレクトリ | | r | N/A | N/A | はい |
124| `/データ/データ/< app id >/` | applicationStorageDirectory | - | r/w | N/A | N/A | はい |
125| `cache` | cacheDirectory | キャッシュ | r/w | はい | はい * | はい |
126| `files` | dataDirectory | ファイル | r/w | はい | いいえ | はい |
127| `Documents` | | ドキュメント | r/w | はい | いいえ | はい |
128| `< sd カード >/` | externalRootDirectory | sd カード | r/w | はい | いいえ | いいえ |
129| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | はい | いいえ | いいえ |
130| `cache` | externalCacheDirectry | 外部キャッシュ | r/w | はい | いいえ * * | いいえ |
131| `files` | externalDataDirectory | 外部ファイル | r/w | はい | いいえ | いいえ |
132
133* OS このディレクトリを定期的に消去可能性がありますが、この動作に依存しないでください。 アプリケーションの必要に応じてこのディレクトリの内容をオフにします。 ユーザーは手動でキャッシュを削除する必要があります、このディレクトリの内容が削除されます。
134
135* * OS はこのディレクトリは自動的にクリアされません自分でコンテンツを管理するために責任があります。 ユーザは手動でキャッシュを消去する必要があります、ディレクトリの内容が削除されます。
136
137**注**: 外部記憶装置をマウントできない場合は、`cordova.file.external*` プロパティを `null`.
138
139### ブラックベリー 10 ファイル ・ システム ・ レイアウト
140
141| デバイス ・ パス | `cordova.file.*` | r/w ですか？ | 永続的なですか？ | OS を消去します | プライベート |
142|:------------------------------------------------- |:--------------------------- |:--------:|:--------:|:---------:|:------:|
143| `file:///accounts/1000/appdata/< app id >/` | applicationStorageDirectory | r | N/A | N/A | はい |
144| `app/native` | ディレクトリ | r | N/A | N/A | はい |
145| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | いいえ | はい | はい |
146| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | はい | いいえ | はい |
147| `file:///accounts/1000/removable/sdcard` | externalRemovableDirectory | r/w | はい | いいえ | いいえ |
148| `file:///accounts/1000/shared` | sharedDirectory | r/w | はい | いいえ | いいえ |
149
150*注*: すべてのパスは/accounts/1000-enterprise 基準に境界を動作するようにアプリケーションを展開するとき。
151
152## Android の癖
153
154### Android の永続的なストレージの場所
155
156Android のデバイスに永続的なファイルを格納する複数の有効な場所があります。 さまざまな可能性について広範な議論のための [このページ][3] を参照してください。
157
158 [3]: http://developer.android.com/guide/topics/data/data-storage.html
159
160以前のバージョンのプラグインは、デバイスの SD カード （または同等のストレージ パーティション） マウントされていたと主張したかどうかに基づいて、起動時に一時と永続的なファイルの場所を選ぶでしょう。 SD カードがマウントされている場合、または大規模な内部ストレージ パーティションが利用可能な場合 (ようネクサス デバイス上） し、永続的なファイルは、その領域のルートに格納されます。 これはすべての Cordova アプリ見ることができる利用可能なファイルのすべてのカードに意味しました。
161
162SD カードがない場合、以前のバージョンがデータを格納する `/data/data/<packageId>`、お互いからアプリを分離するが、まだ原因可能性がありますユーザー間で共有するデータ。
163
164内部ファイルの保存場所やアプリケーションの `config.xml` ファイルに優先順位を持つ以前のロジックを使用してファイルを保存するかどうかを選択することが可能です今。 これを行うに、`config.xml` に次の 2 行のいずれかを追加します。
165
166 <preference name="AndroidPersistentFileLocation" value="Internal" />
167
168 <preference name="AndroidPersistentFileLocation" value="Compatibility" />
169
170
171この行がなければファイル プラグインはデフォルトとして `Compatibility` を使用します。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。
172
173アプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用して、このプラグインのバージョンし、永続的なファイルシステムに保存されているファイルには `Compatibility` を設定する必要があります。 自分のアプリケーションをアップグレードする既存のユーザーを彼らの装置によって、以前に保存されたファイルにアクセスすることができることがあることを意味する「内部」に場所をスイッチングします。
174
175アプリケーションは、新しい、または永続的なファイルシステムにファイルが格納され以前は決して場合、`内部` 設定一般的に推奨されます。
176
177## iOS の癖
178
179* `cordova.file.applicationStorageDirectory`読み取り専用;ルート ディレクトリ内のファイルを保存しようは失敗します。 他の 1 つを使用して `cordova.file.*` iOS のため定義されているプロパティ (のみ `applicationDirectory` と `applicationStorageDirectory` は読み取り専用)。
180* `FileReader.readAsText(blob, encoding)`
181 * `encoding`パラメーターはサポートされていませんし、utf-8 エンコーディングが常に有効です。
182
183### iOS の永続的なストレージの場所
184
185IOS デバイスに永続的なファイルを格納する 2 つの有効な場所がある: ドキュメントとライブラリのディレクトリ。 プラグインの以前のバージョンは、唯一のこれまでドキュメント ディレクトリに永続的なファイルを格納されます。 これは、ディレクトリの目的は、輸出のための完全なドキュメントを作成するのではなくなかったがしばしば意図されていたり、特に多数の小さいファイルを処理するアプリケーションの場合、iTunes に表示されているすべてのアプリケーションのファイルを作るの副作用があった。
186
187ドキュメントまたはアプリケーションの `config.xml` ファイルに優先順位のライブラリ ディレクトリにファイルを保存するかどうかを選択することが可能です今。 これを行うに、`config.xml` に次の 2 行のいずれかを追加します。
188
189 <preference name="iosPersistentFileLocation" value="Library" />
190
191 <preference name="iosPersistentFileLocation" value="Compatibility" />
192
193
194この行がなければファイル プラグインはデフォルトとして `Compatibility` を使用します。優先タグが存在し、これらの値の 1 つではない場合、アプリケーションは起動しません。
195
196アプリケーションは、ユーザーに以前出荷されている場合、古い (前 1.0） を使用して、このプラグインのバージョンし、永続的なファイルシステムに保存されているファイルには `Compatibility` を設定する必要があります。 自分のアプリケーションをアップグレードする既存のユーザーを以前に保存されたファイルにアクセスすることができるだろうことを意味する `Library` に場所をスイッチングします。
197
198アプリケーションは、新しい、または永続的なファイルシステムにファイルが格納され以前は決して場合、`Library` 設定一般的に推奨されます。
199
200## Firefox OS 癖
201
202ファイル システム API Firefox OS でネイティブ サポートされていないと、indexedDB の上にシムとして実装されています。
203
204* 空でないディレクトリを削除するときに失敗しません
205* ディレクトリのメタデータをサポートしていません
206* 方法 `copyTo` と `moveTo` ディレクトリをサポートしていません
207
208次のデータ パスがサポートされています: * `applicationDirectory` - `xhr` を使用して、アプリケーションと共にパッケージ化されるローカル ファイルを取得します。 * `dataDirectory` - 永続的なアプリケーション固有のデータ ファイル。 * `cacheDirectory` - アプリケーションの再起動後も維持する必要がありますキャッシュ ファイル (アプリはここにファイルを削除する OS に依存しないでください)。
209
210## ブラウザーの癖
211
212### 共通の癖と発言
213
214* 各ブラウザーはサンド ボックス化されたファイルシステムを使用します。IE と Firefox IndexedDB をベースとして使用します。すべてのブラウザーは、パスにディレクトリの区切り記号としてスラッシュを使用します。
215* ディレクトリ エントリは連続して作成されなければなりません。 たとえば、コール `fs.root.getDirectory ('dir1 dir2'、{create:true}、successCallback、解り)` dir1 が存在しなかった場合は失敗します。
216* プラグインは、永続的なストレージ アプリケーションの最初の起動時に使用するユーザーのアクセス許可を要求します。
217* プラグインは、`cdvfile://localhost` (ローカル リソース) をサポートしているだけです。すなわち外部リソースは、`cdvfile` を介してサポートされていません.
218* プラグインに [制限」のファイル システム API の 8.3 命名規則][4] に従っていません。.
219* Blob およびファイル ' `close` 関数はサポートされていません。
220* `FileSaver` と `BlobBuilder` このプラグインでサポートされていないスタブを持っていません。
221* プラグインは、`requestAllFileSystems` をサポートしません。この関数は、仕様で行方不明にも。
222* ディレクトリ内のエントリを使用すると削除されません `create: true` 既存ディレクトリのフラグ。
223* コンス トラクターで作成されたファイルはサポートされていません。代わりに entry.file メソッドを使用する必要があります。
224* 各ブラウザーは blob URL 参照の独自のフォームを使用します。
225* `readAsDataURL` 関数はサポートされてがクロムメッキで mediatype エントリ名の拡張子によって異なります、IE でメディアの種類は、常に空 （`text-plain` に従って、仕様と同じである）、Firefox でメディアの種類は常に `アプリケーションまたはオクテット-ストリーム`。 たとえば、コンテンツが場合 `abcdefg` し Firefox を返します `データ: アプリケーション/オクテット ストリーム、base64、YWJjZGVmZw = =`、すなわちを返します `データ:; base64、YWJjZGVmZw = =`、クロムを返します `データ: < エントリ名の拡張子によって mediatype >; base64、YWJjZGVmZw = =`.
226* `toInternalURL` フォーム `file:///persistent/path/to/entry` （Firefox、IE） のパスを返します。 クロムの `cdvfile://localhost/persistent/file` フォームのパスを返します.
227
228 [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions
229
230### クロムの癖
231
232* デバイスの準備ができているイベント後クローム ファイルシステムはすぐに準備ができています。回避策としては `filePluginIsReady` イベントにサブスクライブできます。例:
233
234 javascript
235 window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);
236
237
238`window.isFilePluginReadyRaised` 関数を使用して、イベントが既に発生したかどうかを確認できます。 -Chrome に window.requestFileSystem 一時と永続的なファイル ・ システムのクォータの制限はありません。 -クロム内の永続ストレージを増加する `window.initPersistentFileSystem` メソッドを呼び出す必要があります。 永続的な記憶域のクォータは、既定では 5 MB です。 クロムが必要です `--許可-ファイル-アクセス--ファイルから` `file:///` プロトコル経由でサポート API に引数を実行します。 -`ファイル` オブジェクト フラグを使用する場合ない変更されます `{create:true}` 既存の `エントリ` を取得するとき。 -イベント `cancelable` プロパティを設定するクロムの場合は true。 これは [仕様][5] に反して。 -クロムメッキで `網` 関数を返します `ファイルシステム：`-アプリケーションのホストによってパスのプレフィックスします。 たとえば、`filesystem:file:///persistent/somefile.txt`、`filesystem:http://localhost:8080/persistent/somefile.txt`。 -`toURL` の関数の結果にはディレクトリ エントリ場合末尾にスラッシュが含まれていません。 クロムは、スラッシュ後塵 url を持つディレクトリが正しく解決されるも。 -`resolveLocalFileSystemURL` メソッドは、受信 `url` が `ファイルシステム` のプレフィックスが必要です。 たとえば、`resolveLocalFileSystemURL` の `url` パラメーター フォーム `filesystem:file:///persistent/somefile.txt` で人造人間フォーム `file:///persistent/somefile.txt` とは対照的にする必要があります。 -廃止された `toNativeURL` 関数はサポートされていません、スタブはありません。 -`setMetadata` 関数は、仕様に記載されていないありサポートされていません。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた SYNTAX_ERR(code: 8) の非実在しないファイルシステムの依頼を。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた PATH_EXISTS_ERR(code: 12)、排他的なファイルまたはディレクトリを作成しようとするが既に存在します。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた NO_MODIFICATION_ALLOWED_ERR(code: 6) ルート ・ ファイル ・ システムで removeRecursively を呼び出すをしようとして。 -INVALID_MODIFICATION_ERR （コード: 9) の代わりにスローされた NOT_FOUND_ERR(code: 1) [moveto] ディレクトリが存在しないをしようとして。
239
240 [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html
241
242### IndexedDB ベース インプレ癖 （Firefox と IE）
243
244* `.` `です。` はサポートされていません。
245* IE は `file:///` をサポートしていません-モード;ホスト モードのみがサポートされている (http://localhost:xxxx) です。
246* Firefox のファイルシステムのサイズは無制限ですが各 50 MB の拡張機能がユーザーのアクセス許可を要求します。 IE10 は最大 10 mb の複合 AppCache と IndexedDB を求めず、サイトごとに 250 mb の最大値まで増加を許可するかどうかをたずねられますそのレベルに当ればファイルシステムの実装で使用することができます。 `RequestFileSystem` 関数の `size` パラメーターは、Firefox と IE のファイルシステムには影響しません。
247* `readAsBinaryString` 関数の仕様に記載されていない、IE でサポートされていないと、スタブを持っていません。
248* `file.type` は、常に null です。
249* 削除された DirectoryEntry インスタンスのコールバックの結果を使用してエントリを作成しないでください。それ以外の場合は、'ハンギングのエントリ' が表示されます。
250* ちょうど書かれていた、ファイルを読むことができます前にこのファイルの新しいインスタンスを取得する必要があります。
251* `setMetadata` 関数は、仕様に記載されていない `modificationTime` フィールド変更のみをサポートします。
252* `copyTo` と `moveTo` 関数ディレクトリをサポートしていません。
253* ディレクトリのメタデータはサポートされていません。
254* 両方の Entry.remove と directoryEntry.removeRecursively は空でないディレクトリを削除するときを失敗しない - 削除されるディレクトリ コンテンツと共にを掃除している代わりに。
255* `abort` し、`truncate` 機能はサポートされていません。
256* 進行状況イベントは起動しません。たとえば、このハンドラーがない実行されます。
257
258 javascript
259 writer.onprogress = function() { /*commands*/ };
260
261
262## ノートをアップグレードします。
263
264このプラグインのデベロッパー、公開された仕様に合うように、`認証` と `DirectoryEntry` の構造が変更されました。
265
266プラグインの前 (pre 1.0.0) バージョンはデバイス絶対ファイル場所 `エントリ` オブジェクトの `fullPath` プロパティに格納されます。これらのパスはようになります通常
267
268 /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
269 /storage/emulated/0/path/to/file (Android)
270
271
272これらのパスはまた `Entry` オブジェクトの `toURL()` メソッドによって返されます。
273
274デベロッパー、`fullPath` 属性は *HTML ファイルシステムのルートに対する相対パス* のファイルへのパス。 したがって、上記のパスは今両方の `fullPath` と `FileEntry` オブジェクトで表される
275
276 /path/to/file
277
278
279デバイス絶対パスとアプリケーション動作以前 `Entry` オブジェクトの `fullPath` プロパティを使用してこれらのパスを取得した場合は、代わりに `entry.toURL()` を使用するコードを更新する必要があります。
280
281下位互換性、`resolveLocalFileSystemURL()` メソッドは、デバイス絶対パスを受け入れるし、は、`TEMPORARY` または `PERSISTENT` ファイル ・ システム内でそのファイルが存在する限り、それに対応する `Entry` オブジェクトを返します。
282
283これは特に以前デバイス絶対パスを使用してファイル転送のプラグインで問題となっている （そしてまだそれらを受け入れることができます）。 それがデバイス上のファイルで動作するプラグインを得る問題を解決する必要があります `entry.toURL()` で `entry.fullPath` を置き換えるので、ファイルシステムの Url で正常に動作にアップデートされました。
284
285V1.1.0 の `toURL()` の戻り値に変更されました (\[CB-6394\] (https://issues.apache.org/jira/browse/CB-6394) を参照) を絶対 'file://' で始まる URL を返します。 可能な限り。 確保するために、' cdvfile:'-`toInternalURL()` を今すぐ使用できます URL。 このメソッドは、フォームのファイルシステムの Url を返します今
286
287 cdvfile://localhost/persistent/path/to/file
288
289
290これはファイルを一意に識別するために使用できます。
291
292## エラー コードと意味のリスト
293
294エラーがスローされると、次のコードのいずれかが使用されます。
295
296| コード | 定数 |
297| ---:|:----------------------------- |
298| 1 | `NOT_FOUND_ERR` |
299| 2 | `SECURITY_ERR` |
300| 3 | `ABORT_ERR` |
301| 4 | `NOT_READABLE_ERR` |
302| 5 | `ENCODING_ERR` |
303| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
304| 7 | `INVALID_STATE_ERR` |
305| 8 | `SYNTAX_ERR` |
306| 9 | `INVALID_MODIFICATION_ERR` |
307| 10 | `QUOTA_EXCEEDED_ERR` |
308| 11 | `TYPE_MISMATCH_ERR` |
309| 12 | `PATH_EXISTS_ERR` |
310
311## (省略可能) プラグインを構成します。
312
313利用可能なファイルシステムのセットは構成されたプラットフォームをすることができます。IOS と Android の両方を認識します。 <preference> タグ `config.xml` をインストールするファイルシステムの名前します。既定では、すべてのファイル システムのルートが有効になります。
314
315 <preference name="iosExtraFilesystems" value="library,library-nosync,documents,documents-nosync,cache,bundle,root" />
316 <preference name="AndroidExtraFilesystems" value="files,files-external,documents,sdcard,cache,cache-external,root" />
317
318
319### アンドロイド
320
321* `files`： アプリケーションの内部ファイルのストレージ ディレクトリ
322* `files-external`: アプリケーションの外部のファイルのストレージ ディレクトリ
323* `sdcard`：、グローバル外部ストレージ ディレクトリをファイル (これは SD カードのルートがインストールされている場合)。 これを使用するには、`android.permission.WRITE_EXTERNAL_STORAGE` 権限が必要です。
324* `cache`： アプリケーションの内部キャッシュ ディレクトリ
325* `cache-external`： 外部キャッシュのアプリケーションのディレクトリ
326* `root`： デバイス全体のファイルシステム
327
328アンドロイドを「ファイル」ファイルシステム内の"ドキュメント/"サブディレクトリを表す"ドキュメント"という名前の特殊なファイルシステムもサポートしています。
329
330### iOS
331
332* `library`: ライブラリのアプリケーションのディレクトリ
333* `documents`: ドキュメントのアプリケーションのディレクトリ
334* `cache`: キャッシュのアプリケーションのディレクトリ
335* `bundle`: アプリケーションバンドル;アプリ自体 (読み取りのみ) ディスク上の場所
336* `root`： デバイス全体のファイルシステム
337
338既定では、ライブラリとドキュメント ディレクトリを iCloud に同期できます。 2 つの追加のファイルシステム、`library-nosync` および `documents-nosync` を表す、特別な非同期ディレクトリ内を要求することもできます、`/Library` または `Documents/` ファイルシステム。