openEventsPlatformApp/plugins/cordova-plugin-file/doc/es/index.md
plugins/cordova-plugin-file/doc/es/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
22Este plugin implementa una API de archivo que permite acceso de lectura/escritura a los archivos que residen en el dispositivo.
23
24Este plugin se basa en varias especificaciones, incluyendo: el HTML5 archivo API <http://www.w3.org/TR/FileAPI/>
25
26Los directorios (ahora extinto) y sistema de extensiones más recientes: <http://www.w3.org/TR/2012/WD-file-system-api-20120417/> aunque la mayor parte del código del plugin fue escrito cuando una especificación anterior era actual: <http://www.w3.org/TR/2011/WD-file-system-api-20110419/>
27
28También implementa la especificación de FileWriter: <http://dev.w3.org/2009/dap/file-system/file-writer.html>
29
30Para el uso, por favor, consulte 'HTML5 Rocks excelente [FileSystem artículo.][1]
31
32 [1]: http://www.html5rocks.com/en/tutorials/file/filesystem/
33
34Para tener una visión general de otras opciones de almacenamiento, consulte [Guía de almacenamiento Cordova][2].
35
36 [2]: http://cordova.apache.org/docs/en/edge/cordova_storage_storage.md.html
37
38Este plugin define global `cordova.file` objeto.
39
40Aunque en el ámbito global, no estará disponible hasta después de la `deviceready` evento.
41
42 document.addEventListener("deviceready", onDeviceReady, false);
43 function onDeviceReady() {
44 console.log(cordova.file);
45 }
46
47
48## Instalación
49
50 cordova plugin add cordova-plugin-file
51
52
53## Plataformas soportadas
54
55* Amazon fire OS
56* Android
57* BlackBerry 10
58* Firefox OS
59* iOS
60* Windows Phone 7 y 8 *
61* Windows 8 *
62* Explorador
63
64* *No son compatibles con estas plataformas `FileReader.readAsArrayBuffer` ni `FileWriter.write(blob)` .*
65
66## Donde almacenar los archivos
67
68A partir de v1.2.0, URLs a directorios de sistema de archivos importantes son proporcionadas. Cada dirección URL está en la forma *file:///path/to/spot/*y se puede convertir en un `DirectoryEntry` usando`window.resolveLocalFileSystemURL()`.
69
70* `cordova.file.applicationDirectory`-Directorio Read-only donde está instalada la aplicación. (*iOS*, *Android*, *BlackBerry 10*)
71
72* `cordova.file.applicationStorageDirectory`-Directorio del entorno limitado de la aplicación; en iOS esta ubicación es de sólo lectura (pero subdirectorios específicos [como `/Documents` ] son de lectura y escritura). Todos los datos contenidos dentro es privado para la aplicación. ( *iOS*, *Android*, *BlackBerry 10*)
73
74* `cordova.file.dataDirectory`-Almacenamiento de datos persistente y privadas dentro de entorno limitado de la aplicación utilizando la memoria interna (en Android, si necesitas usar memoria externa, use `.externalDataDirectory` ). En iOS, este directorio no está sincronizado con iCloud (utilice `.syncedDataDirectory` ). (*iOS*, *Android*, *BlackBerry 10*)
75
76* `cordova.file.cacheDirectory`-Directorio para los archivos de datos almacenados en caché o los archivos que su aplicación puede volver a crear fácilmente. El sistema operativo puede borrar estos archivos cuando el dispositivo se agota en almacenamiento de información, sin embargo, aplicaciones no deben confiar en el sistema operativo para eliminar los archivos de aquí. (*iOS*, *Android*, *BlackBerry 10*)
77
78* `cordova.file.externalApplicationStorageDirectory`-Espacio aplicación de almacenamiento externo. (*Android*)
79
80* `cordova.file.externalDataDirectory`¿Dónde poner los archivos de datos específicos de la aplicación de almacenamiento externo. (*Android*)
81
82* `cordova.file.externalCacheDirectory`-Caché aplicación de almacenamiento externo. (*Android*)
83
84* `cordova.file.externalRootDirectory`-Raíz de almacenamiento externo (tarjeta SD). (*Android*, *BlackBerry 10*)
85
86* `cordova.file.tempDirectory`-Directorio temporal que puede borrar el sistema operativo en sí. No confíe en el sistema operativo para borrar este directorio; su aplicación siempre debe eliminar archivos según corresponda. (*iOS*)
87
88* `cordova.file.syncedDataDirectory`-Contiene los archivos de la aplicación específica que deben ser sincronizados (e.g. a iCloud). (*iOS*)
89
90* `cordova.file.documentsDirectory`-Archivos privados a la aplicación, pero que son significativos para otra aplicación (por ejemplo archivos de Office). (*iOS*)
91
92* `cordova.file.sharedDirectory`-Archivos disponibles globalmente para todas las aplicaciones (*BlackBerry 10*)
93
94## Diseños de sistema de archivo
95
96Aunque técnicamente un detalle de la implementación, puede ser muy útil saber cómo la `cordova.file.*` mapa de propiedades en trazados físicos en un dispositivo real.
97
98### iOS diseño de sistema de archivo
99
100| Ruta de dispositivo | `Cordova.file.*` | `iosExtraFileSystems` | ¿r/w? | ¿persistente? | OS despeja | sincronización | privado |
101|:-------------------------------------------- |:--------------------------- |:--------------------- |:-----:|:-------------:|:----------:|:--------------:|:-------:|
102| `/ var/mobile/Applications/< UUID > /` | applicationStorageDirectory | - | r | N / A | N / A | N / A | Sí |
103| `appname.app/` | applicationDirectory | Bundle | r | N / A | N / A | N / A | Sí |
104| `www/` | - | - | r | N / A | N / A | N / A | Sí |
105| `Documents/` | documentsDirectory | documentos | r/w | Sí | No | Sí | Sí |
106| `NoCloud/` | - | documentos-nosync | r/w | Sí | No | No | Sí |
107| `Library` | - | Biblioteca | r/w | Sí | No | ¿Sí? | Sí |
108| `NoCloud/` | dataDirectory | Biblioteca-nosync | r/w | Sí | No | No | Sí |
109| `Cloud/` | syncedDataDirectory | - | r/w | Sí | No | Sí | Sí |
110| `Caches/` | cacheDirectory | caché | r/w | Sí * | Si * * *| | No | Sí |
111| `tmp/` | tempDirectory | - | r/w | No * * | Si * * *| | No | Sí |
112
113* Archivos persisten a través de la aplicación se reinicia y actualizaciones, pero este directorio puede ser despejó cuando el OS desea. Su aplicación debe ser capaz de recrear cualquier contenido que puede ser eliminado.
114
115* * Archivos pueden persistir a través de la aplicación se reinicia, pero no confiar en este comportamiento. Los archivos no se garantizan que persisten a través de actualizaciones. Su aplicación debe eliminar los archivos de este directorio cuando es aplicable, como el sistema operativo no garantiza cuando (o incluso si) estos archivos se quitan.
116
117* * *| OS la puede borrar el contenido de este directorio cuando se siente que es necesario, pero no dependen de éste. Debe borrar este directorio según sea apropiado para su aplicación.
118
119### Disposición del sistema Android File
120
121| Ruta de dispositivo | `Cordova.file.*` | `AndroidExtraFileSystems` | ¿r/w? | ¿persistente? | OS despeja | privado |
122|:----------------------------------------- |:----------------------------------- |:------------------------- |:-----:|:-------------:|:----------:|:-------:|
123| `File:///android_asset/` | applicationDirectory | | r | N / A | N / A | Sí |
124| `/Data/data/< id de aplicación > /` | applicationStorageDirectory | - | r/w | N / A | N / A | Sí |
125| `cache` | cacheDirectory | caché | r/w | Sí | Sí * | Sí |
126| `files` | dataDirectory | archivos | r/w | Sí | No | Sí |
127| `Documents` | | documentos | r/w | Sí | No | Sí |
128| `< sdcard > /` | externalRootDirectory | sdcard | r/w | Sí | No | No |
129| `Android/data/<app-id>/` | externalApplicationStorageDirectory | - | r/w | Sí | No | No |
130| `cache` | externalCacheDirectry | caché-externo | r/w | Sí | No * * | No |
131| `files` | externalDataDirectory | archivos externos | r/w | Sí | No | No |
132
133* El sistema operativo puede eliminar periódicamente este directorio, pero no dependen de este comportamiento. Borrar el contenido de este directorio según sea apropiado para su aplicación. El contenido de este directorio debe un usuario purga la caché manualmente, se eliminan.
134
135* * El sistema operativo no borra este directorio automáticamente; Usted es responsable de administrar el contenido mismo. Deberá el usuario purga la caché manualmente, se extraen los contenidos del directorio.
136
137**Nota**: Si no se puede montar de almacenamiento externo, el `cordova.file.external*` Propiedades`null`.
138
139### Disposición del sistema blackBerry 10 archivo
140
141| Ruta de dispositivo | `Cordova.file.*` | ¿r/w? | ¿persistente? | OS despeja | privado |
142|:------------------------------------------------------------- |:--------------------------- |:-----:|:-------------:|:----------:|:-------:|
143| `File:///accounts/1000/AppData/ < id de aplicación > /` | applicationStorageDirectory | r | N / A | N / A | Sí |
144| `app/native` | applicationDirectory | r | N / A | N / A | Sí |
145| `data/webviews/webfs/temporary/local__0` | cacheDirectory | r/w | No | Sí | Sí |
146| `data/webviews/webfs/persistent/local__0` | dataDirectory | r/w | Sí | No | Sí |
147| `File:///accounts/1000/Removable/sdcard` | externalRemovableDirectory | r/w | Sí | No | No |
148| `File:///accounts/1000/shared` | sharedDirectory | r/w | Sí | No | No |
149
150*Nota*: cuando se implementa la aplicación al trabajo de perímetro, todos los caminos son relativos a /accounts/1000-enterprise.
151
152## Rarezas Android
153
154### Ubicación de almacenamiento persistente Android
155
156Hay múltiples ubicaciones válidas para almacenar archivos persistentes en un dispositivo Android. Vea [esta página][3] para una extensa discusión de las distintas posibilidades.
157
158 [3]: http://developer.android.com/guide/topics/data/data-storage.html
159
160Las versiones anteriores del plugin elegiría la ubicación de los archivos temporales y persistentes en el arranque, basado en si el dispositivo afirmó que fue montado en la tarjeta SD (o partición de almacenamiento equivalente). Si fue montada en la tarjeta SD, o una partición de gran almacenamiento interno estaba disponible (como en dispositivos de Nexus,) y luego los archivos persistentes se almacenaría en la raíz de ese espacio. Esto significaba que todas las apps Cordova podían ver todos los archivos disponibles en la tarjeta.
161
162Si la tarjeta SD no estaba disponible, entonces versiones anteriores podría almacenar datos debajo de `/data/data/<packageId>` , que aísla las apps del otro, pero puede todavía causa datos para ser compartido entre los usuarios.
163
164Ahora es posible elegir si desea almacenar archivos en la ubicación de almacenamiento del archivo interno, o usando la lógica anterior, con una preferencia en de la aplicación `config.xml` archivo. Para ello, añada una de estas dos líneas a `config.xml` :
165
166 < nombre de preferencia = "AndroidPersistentFileLocation" value = "Internal" / >< nombre de preferencia = "AndroidPersistentFileLocation" value = "Compatibilidad" / >
167
168
169Sin esta línea, se utilizará el archivo plugin `Compatibility` como valor predeterminado. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.
170
171Si su solicitud se ha enviado previamente a los usuarios, usando un mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces debería establecer la preferencia en `Compatibility` . Cambiar la ubicación para "Internal" significa que los usuarios existentes que actualización su aplicación pueden ser incapaces de acceder a sus archivos previamente almacenadas, dependiendo de su dispositivo.
172
173Si su solicitud es nuevo, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, entonces el `Internal` generalmente se recomienda el ajuste.
174
175## iOS rarezas
176
177* `cordova.file.applicationStorageDirectory`es de sólo lectura; intentar almacenar archivos en el directorio raíz fallará. Utilice uno de los `cordova.file.*` las propiedades definidas para iOS (sólo `applicationDirectory` y `applicationStorageDirectory` son de sólo lectura).
178* `FileReader.readAsText(blob, encoding)`
179 * El `encoding` no se admite el parámetro, y codificación UTF-8 es siempre en efecto.
180
181### iOS ubicación de almacenamiento persistente
182
183Hay dos ubicaciones válidas para almacenar archivos persistentes en un dispositivo iOS: el directorio de documentos y el directorio de biblioteca. Las versiones anteriores del plugin sólo almacenan archivos persistentes en el directorio de documentos. Esto tenía el efecto secundario de todos los archivos de la aplicación haciendo visible en iTunes, que era a menudo involuntarios, especialmente para aplicaciones que manejan gran cantidad de archivos pequeños, en lugar de producir documentos completos para la exportación, que es la finalidad del directorio.
184
185Ahora es posible elegir si desea almacenar archivos en los documentos o directorio de bibliotecas, con preferencia en de la aplicación `config.xml` archivo. Para ello, añada una de estas dos líneas a `config.xml` :
186
187 <preference name="iosPersistentFileLocation" value="Library" />
188
189 <preference name="iosPersistentFileLocation" value="Compatibility" />
190
191
192Sin esta línea, se utilizará el archivo plugin `Compatibility` como valor predeterminado. Si una etiqueta de preferencia está presente y no es uno de estos valores, no se iniciará la aplicación.
193
194Si su solicitud se ha enviado previamente a los usuarios, usando un mayor (1.0 pre) versión de este plugin y archivos almacenados en el sistema de ficheros persistente, entonces debería establecer la preferencia en `Compatibility` . Cambiar la ubicación de `Library` significa que los usuarios existentes que actualización su aplicación sería incapaces de acceder a sus archivos previamente almacenadas.
195
196Si su solicitud es nuevo, o nunca antes ha almacenado archivos en el sistema de ficheros persistente, entonces el `Library` generalmente se recomienda el ajuste.
197
198## Firefox OS rarezas
199
200La API de sistema de archivo de forma nativa no es compatible con Firefox OS y se implementa como una cuña en la parte superior indexedDB.
201
202* No falla cuando eliminar directorios no vacía
203* No admite metadatos para directorios
204* Los métodos `copyTo` y `moveTo` no son compatibles con directorios
205
206Se admiten las siguientes rutas de datos: * `applicationDirectory` -usa `xhr` para obtener los archivos locales que están envasados con la aplicación. * `dataDirectory` - Para archivos de datos específicos de aplicación persistente. * `cacheDirectory` -En caché archivos que deben sobrevivir se reinicia la aplicación (aplicaciones no deben confiar en el sistema operativo para eliminar archivos aquí).
207
208## Navegador rarezas
209
210### Rarezas y observaciones comunes
211
212* Cada navegador utiliza su propio sistema de ficheros un espacio aislado. IE y Firefox utilizan IndexedDB como base. Todos los navegadores utilizan diagonal como separador de directorio en un camino.
213* Las entradas de directorio deben crearse sucesivamente. Por ejemplo, la llamada `fs.root.getDirectory (' dir1/dir2 ', {create:true}, successCallback, errorCallback)` se producirá un error si no existiera dir1.
214* El plugin solicita permiso de usuario para usar almacenamiento persistente en el primer comienzo de la aplicación.
215* Plugin soporta `cdvfile://localhost` (recursos locales) solamente. Es decir, no se admiten los recursos externos vía `cdvfile`.
216* El plugin no sigue ["Archivo sistema API 8.3 nombrando restricciones"][4].
217* BLOB y archivo ' `close` la función no es compatible.
218* `FileSaver` y `BlobBuilder` no son compatibles con este plugin y no tengo recibos.
219* El plugin no es compatible con `requestAllFileSystems`. Esta función también está desaparecida en las especificaciones.
220* No se quitarán las entradas de directorio Si utilizas `create: true` bandera de directorio existente.
221* No se admiten archivos creados mediante el constructor. Debe utilizar método entry.file en su lugar.
222* Cada navegador utiliza su propia forma de blob URL referencias.
223* se admite la función `readAsDataURL`, pero el mediatype en cromo depende de la extensión de nombre de entrada, mediatype en IE siempre está vacío (que es lo mismo como `plain-text` según la especificación), el mediatype en Firefox siempre es `application/octet-stream`. Por ejemplo, si el contenido es `abcdefg` entonces Firefox devuelve `datos: aplicación / octet-stream; base64, YWJjZGVmZw ==`, es decir devuelve `datos:; base64, YWJjZGVmZw ==`, cromo devuelve `datos: < mediatype dependiendo de la extensión de nombre de la entrada >; base64, YWJjZGVmZw ==`.
224* `toInternalURL` devuelve la ruta de la forma `file:///persistent/path/to/entry` (Firefox, IE). Cromo devuelve la ruta de acceso en el formulario `cdvfile://localhost/persistent/file`.
225
226 [4]: http://www.w3.org/TR/2011/WD-file-system-api-20110419/#naming-restrictions
227
228### Rarezas de Chrome
229
230* Filesystem de Chrome no es inmediatamente después de evento ready dispositivo. Como solución temporal puede suscribirse al evento `filePluginIsReady`. Ejemplo:
231
232 javascript
233 window.addEventListener('filePluginIsReady', function(){ console.log('File plugin is ready');}, false);
234
235
236Puede utilizar la función `window.isFilePluginReadyRaised` para verificar si ya se provoca el evento. -window.requestFileSystem temporal y persistente filesystem cuotas no están limitadas en cromo. -Para aumentar el almacenamiento persistente en cromo necesitas llamar el método `window.initPersistentFileSystem`. Cuota de almacenamiento persistente es de 5 MB por defecto. -Chrome requiere `--permitir-archivo-acceso-de-archivos` ejecutar argumento al soporte API mediante protocolo `file:///`. -`Archivo` objeto no cambiará si utilizas bandera `{create:true}` cuando una `entrada` de existente. -eventos `cancelable` propiedad está establecida en true en cromo. Esto es contrario a la [Especificación][5]. -función de `toURL` en Chrome devuelve `filesystem:`-prefijo camino dependiendo de host de la aplicación. Por ejemplo, `filesystem:file:///persistent/somefile.txt`, `filesystem:http://localhost:8080/persistent/somefile.txt`. -resultado de la función de `toURL` no contiene barra en caso de entrada en el directorio. Cromo resuelve directorios con urls slash-siguió correctamente sin embargo. -método `resolveLocalFileSystemURL` requiere la entrantes `url` que tienen prefijo `filesystem`. Por ejemplo, el parámetro de `url` para `resolveLocalFileSystemURL` debería estar en la forma `filesystem:file:///persistent/somefile.txt` en comparación con la forma `file:///persistent/somefile.txt` en Android. -Obsoleto `toNativeURL` función no es compatible y no tiene un trozo. -función de `setMetadata` no es indicada en las especificaciones y no admite. -INVALID_MODIFICATION_ERR (código: 9) se lanza en lugar de SYNTAX_ERR(code: 8) a petición de un sistema de ficheros inexistentes. -INVALID_MODIFICATION_ERR (código: 9) se lanza en vez de PATH_EXISTS_ERR(code: 12) en intentar exclusivamente crear un archivo o directorio, que ya existe. -INVALID_MODIFICATION_ERR (código: 9) se lanza en lugar de NO_MODIFICATION_ALLOWED_ERR(code: 6) para tratar de llamar a removeRecursively en el sistema de archivos raíz. -INVALID_MODIFICATION_ERR (código: 9) se lanza en vez de NOT_FOUND_ERR(code: 1) en tratar de moveTo directorio que no existe.
237
238 [5]: http://dev.w3.org/2009/dap/file-system/file-writer.html
239
240### Impl base IndexedDB rarezas (IE y Firefox)
241
242* `.` y `..` no son compatibles.
243* IE no soporta `file:///`-modo; modo alojado sólo es compatible (http://localhost:xxxx).
244* Tamaño del sistema de archivos de Firefox no es limitada pero cada extensión de 50 MB solicitará un permiso de usuario. IE10 permite hasta 10mb de combinados AppCache y IndexedDB utilizados en la implementación del sistema de ficheros sin preguntar, cuando llegas a ese nivel que se le preguntará si desea permitir que ser aumentada hasta un máximo de 250 mb por sitio. Para que `size` parámetro para la función `requestFileSystem` no afecta sistema de ficheros en Firefox y IE.
245* la función `readAsBinaryString` no se indica en las especificaciones y no compatible con IE y no tiene un trozo.
246* `file.type` siempre es null.
247* No debe crear entrada utilizando DirectoryEntry resultado de devolución de llamada de instancia que fue borrado. De lo contrario, obtendrá una entrada' colgar'.
248* Antes de que se puede leer un archivo, el cual fue escrito sólo que necesitas una nueva instancia de este archivo.
249* la función `setMetadata`, que no es indicada en las especificaciones soporta sólo el cambio de campo `modificationTime`.
250* `copyTo` y `moveTo` funciones no son compatibles con directorios.
251* Metadatos de directorios no es compatible.
252* Tanto Entry.remove y directoryEntry.removeRecursively no fallan al retirar no vacía directorios - directorios de ser eliminados se limpian junto con contenido en su lugar.
253* `abort` y `truncate` las funciones no son compatibles.
254* eventos de progreso no están despedidos. Por ejemplo, este controlador no ejecutará:
255
256 javascript
257 writer.onprogress = function() { /*commands*/ };
258
259
260## Actualización de notas
261
262En v1.0.0 de este plugin, han cambiado las estructuras `FileEntry` y `DirectoryEntry`, para estar más acorde con las especificaciones publicadas.
263
264Versiones anteriores (pre-1.0.0) del plugin almacenan el dispositivo-absoluto-archivo-ubicación en la propiedad `fullPath` de objetos de `entrada`. Estos caminos típicamente parecería
265
266 /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
267 /storage/emulated/0/path/to/file (Android)
268
269
270Estas rutas también fueron devueltos por el método `toURL()` de los objetos de `entrada`.
271
272Con v1.0.0, el atributo `fullPath` es la ruta del archivo, *relativo a la raíz del sistema de archivos HTML*. Así, los caminos más arriba sería ahora ambos ser representado por un objeto `FileEntry` con un `fullPath` de
273
274 /path/to/file
275
276
277Si su aplicación funciona con dispositivo-absoluto-caminos, y previamente obtenido esos caminos a través de la propiedad `fullPath` de objetos de `Entry`, deberá actualizar el código para utilizar `entry.toURL()` en su lugar.
278
279Para atrás compatibilidad, el método `resolveLocalFileSystemURL()` a aceptar un dispositivo-absoluto-trayectoria y devolverá un objeto de `Entry` correspondiente que, mientras exista ese archivo dentro de los sistemas de ficheros `TEMPORARY` o la `PERSISTENT`.
280
281Esto ha sido particularmente un problema con el plugin de transferencia de archivos, que anteriormente utilizado dispositivo-absoluto-caminos (y todavía puede aceptarlas). Ha sido actualizado para funcionar correctamente con sistema de ficheros URLs, para reemplazar `entry.fullPath` con `entry.toURL()` debe resolver cualquier problema conseguir ese plugin para trabajar con archivos en el dispositivo.
282
283En v1.1.0 el valor devuelto por `toURL()` fue cambiado (consulte \[CB-6394\] (https://issues.apache.org/jira/browse/CB-6394)) para devolver una dirección URL absoluta 'file://'. siempre que sea posible. Para asegurar una ' cdvfile:'-URL ahora puede utilizar `toInternalURL()`. Este método devolverá ahora filesystem URLs de la forma
284
285 cdvfile://localhost/persistent/path/to/file
286
287
288que puede utilizarse para identificar el archivo únicamente.
289
290## Lista de códigos de Error y significados
291
292Cuando se produce un error, uno de los siguientes códigos se utilizará.
293
294| Código | Constante |
295| ------:|:----------------------------- |
296| 1 | `NOT_FOUND_ERR` |
297| 2 | `SECURITY_ERR` |
298| 3 | `ABORT_ERR` |
299| 4 | `NOT_READABLE_ERR` |
300| 5 | `ENCODING_ERR` |
301| 6 | `NO_MODIFICATION_ALLOWED_ERR` |
302| 7 | `INVALID_STATE_ERR` |
303| 8 | `SYNTAX_ERR` |
304| 9 | `INVALID_MODIFICATION_ERR` |
305| 10 | `QUOTA_EXCEEDED_ERR` |
306| 11 | `TYPE_MISMATCH_ERR` |
307| 12 | `PATH_EXISTS_ERR` |
308
309## Configurando el Plugin (opcional)
310
311El conjunto de los sistemas de ficheros disponibles puede ser configurado por plataforma. Tanto iOS y Android reconocen un <preference> etiqueta en el `archivo config.xml` que nombra a los sistemas de archivos para ser instalado. De forma predeterminada, se activan todas las raíces del sistema de archivos.
312
313 <preference name="iosExtraFilesystems" value="library,library-nosync,documents,documents-nosync,cache,bundle,root" />
314 <preference name="AndroidExtraFilesystems" value="files,files-external,documents,sdcard,cache,cache-external,root" />
315
316
317### Android
318
319* `files`: directorio de almacenamiento de archivo interno de la aplicación
320* `files-external`: directorio de almacenamiento de archivo externo de la aplicación
321* `sdcard`: el directorio de almacenamiento de archivo externo global (esta es la raíz de la tarjeta SD, si uno está instalado). Debe tener el permiso de `android.permission.WRITE_EXTERNAL_STORAGE` a usar esto.
322* `cache`: directorio de memoria caché interna de la aplicación
323* `cache-external`: directorio de caché externo de la aplicación
324* `root`: el sistema de archivos de todo el dispositivo
325
326Android también es compatible con un sistema de archivos especial llamado "documents", que representa un subdirectorio "/Documents/" dentro del sistema de archivos "archivos".
327
328### iOS
329
330* `library`: directorio de bibliotecas de la aplicación
331* `documents`: directorio de documentos de la aplicación
332* `cache`: directorio de caché de la aplicación
333* `bundle`: paquete de la aplicación; la ubicación de la aplicación en sí mismo en el disco (sólo lectura)
334* `root`: el sistema de archivos de todo el dispositivo
335
336De forma predeterminada, los directorios de documentos y la biblioteca pueden ser sincronizados con iCloud. También puede solicitar dos sistemas adicionales, `library-nosync` y `documents-nosync`, que representan un directorio especial no sincronizados dentro de la `/Library` o sistema de ficheros `/Documents`.