Archivo

Una API para leer, escribir y navegar por las jerarquías de sistema de archivo, basadas en la api de archivo w3c.

Objetos

Acceso a la función

A partir de la versión 3.0, Cordova implementa nivel de dispositivo APIs como plugins. Uso de la CLI plugin comando, que se describe en la interfaz de línea de comandos, para añadir o eliminar esta característica para un proyecto:

    $ cordova plugin add org.apache.cordova.file
    $ cordova plugin ls
    [ 'org.apache.cordova.file' ]
    $ cordova plugin rm org.apache.cordova.file

Para usar el plugin de transferencia de archivos es necesario agregar por separado.

    $ cordova plugin add org.apache.cordova.file-transfer
    $ cordova plugin ls
    [ 'org.apache.cordova.file-transfer' ]
    $ cordova plugin rm org.apache.cordova.file-transfer

Estos comandos se aplican a todas las plataformas específicas, sino modificar las opciones de configuración específicas de la plataforma que se describen a continuación:

  • Android

    (in app/res/xml/config.xml)
<feature name="File">
    <param name="android-package" value="org.apache.cordova.FileUtils" />
</feature>
<feature name="FileTransfer">
    <param name="android-package" value="org.apache.cordova.FileTransfer" />
</feature>

(in app/AndroidManifest.xml)
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

  • BlackBerry WebWorks

    (in www/plugins.xml)
<feature name="File">
    <param name="blackberry-package" value="org.apache.cordova.file.FileManager" />
</feature>
<feature name="FileTransfer">
    <param name="blackberry-package" value="org.apache.cordova.http.FileTransfer" />
</feature>

(in www/config.xml)
<feature id="blackberry.io.file" required="true" version="1.0.0.0" />
<feature id="blackberry.utils"   required="true" version="1.0.0.0" />
<feature id="blackberry.io.dir"  required="true" version="1.0.0.0" />
<rim:permissions>
    <rim:permit>access_shared</rim:permit>
</rim:permissions>

  • (en iOSconfig.xml)

    <feature name="File">
    <param name="ios-package" value="CDVFile" />
</feature>
<feature name="FileTransfer">
    <param name="ios-package" value="CDVFileTransfer" />
</feature>

Algunas plataformas que soportan esta característica sin necesidad de ninguna configuración especial. Consulte Soporte de la plataforma en la sección de Resumen.