You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ld...@apache.org on 2014/07/07 19:50:54 UTC
[09/14] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-file-transfer
Lisa testing pulling in plugins for plugin: cordova-plugin-file-transfer
Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/commit/131f84f1
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/131f84f1
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/131f84f1
Branch: refs/heads/master
Commit: 131f84f123652a1bc16b5764481283cb086b4aa0
Parents: 9795c14
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 21:22:04 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 21:22:04 2014 -0400
----------------------------------------------------------------------
doc/es/index.md | 56 +++++++---
doc/fr/index.md | 76 +++++++++-----
doc/it/index.md | 281 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ko/index.md | 281 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/pl/index.md | 281 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/zh/index.md | 281 +++++++++++++++++++++++++++++++++++++++++++++++++++
6 files changed, 1218 insertions(+), 38 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/131f84f1/doc/es/index.md
----------------------------------------------------------------------
diff --git a/doc/es/index.md b/doc/es/index.md
index 126f93a..4bb5e5d 100644
--- a/doc/es/index.md
+++ b/doc/es/index.md
@@ -57,7 +57,7 @@ El `FileTransfer` objeto proporciona una manera de subir archivos mediante una s
**Parámetros**:
-* **ruta**: ruta de acceso completa del archivo en el dispositivo.
+* **fileURL**: URL de Filesystem que representa el archivo en el dispositivo. Para atrás compatibilidad, esto también puede ser la ruta de acceso completa del archivo en el dispositivo. (Ver [hacia atrás compatibilidad notas] debajo)
* **servidor**: dirección URL del servidor para recibir el archivo, como codificada por`encodeURI()`.
@@ -78,7 +78,8 @@ El `FileTransfer` objeto proporciona una manera de subir archivos mediante una s
### Ejemplo
- // !! Assumes variable fileURI contains a valid URI to a text file on the device
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
var win = function (r) {
console.log("Code = " + r.responseCode);
@@ -94,7 +95,7 @@ El `FileTransfer` objeto proporciona una manera de subir archivos mediante una s
var options = new FileUploadOptions();
options.fileKey = "file";
- options.fileName = fileURI.substr(fileURI.lastIndexOf('/') + 1);
+ options.fileName = fileURL.substr(fileURL.lastIndexOf('/') + 1);
options.mimeType = "text/plain";
var params = {};
@@ -104,7 +105,7 @@ El `FileTransfer` objeto proporciona una manera de subir archivos mediante una s
options.params = params;
var ft = new FileTransfer();
- ft.upload(fileURI, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
### Ejemplo con cabeceras de subir y eventos de progreso (Android y iOS solamente)
@@ -125,7 +126,7 @@ El `FileTransfer` objeto proporciona una manera de subir archivos mediante una s
var options = new FileUploadOptions();
options.fileKey="file";
- options.fileName=fileURI.substr(fileURI.lastIndexOf('/')+1);
+ options.fileName=fileURL.substr(fileURL.lastIndexOf('/')+1);
options.mimeType="text/plain";
var headers={'headerParam':'headerValue'};
@@ -140,7 +141,7 @@ El `FileTransfer` objeto proporciona una manera de subir archivos mediante una s
loadingStatus.increment();
}
};
- ft.upload(fileURI, uri, win, fail, options);
+ ft.upload(fileURL, uri, win, fail, options);
## FileUploadResult
@@ -155,6 +156,10 @@ A `FileUploadResult` objeto se pasa a la devolución del éxito de la `FileTrans
* **respuesta**: respuesta el HTTP devuelto por el servidor. (DOMString)
+* **cabeceras**: cabeceras de respuesta HTTP el por el servidor. (Objeto)
+
+ * Actualmente compatible con iOS solamente.
+
### iOS rarezas
* No es compatible con `responseCode` o`bytesSent`.
@@ -165,7 +170,7 @@ A `FileUploadResult` objeto se pasa a la devolución del éxito de la `FileTrans
* **fuente**: dirección URL del servidor para descargar el archivo, como codificada por`encodeURI()`.
-* **objetivo**: ruta de acceso completa del archivo en el dispositivo.
+* **objetivo**: Filesystem url que representa el archivo en el dispositivo. Para atrás compatibilidad, esto también puede ser la ruta de acceso completa del archivo en el dispositivo. (Ver [hacia atrás compatibilidad notas] debajo)
* **successCallback**: una devolución de llamada que se pasa un `FileEntry` objeto. *(Función)*
@@ -177,14 +182,15 @@ A `FileUploadResult` objeto se pasa a la devolución del éxito de la `FileTrans
### Ejemplo
- // !! Assumes filePath is a valid path on the device
+ // !! Assumes variable fileURL contains a valid URL to a path on the device,
+ // for example, cdvfile://localhost/persistent/path/to/downloads/
var fileTransfer = new FileTransfer();
var uri = encodeURI("http://some.server.com/download.php");
fileTransfer.download(
uri,
- filePath,
+ fileURL,
function(entry) {
console.log("download complete: " + entry.fullPath);
},
@@ -208,7 +214,8 @@ Aborta a una transferencia en curso. El callback onerror se pasa un objeto FileT
### Ejemplo
- // !! Assumes variable fileURI contains a valid URI to a text file on the device
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
var win = function(r) {
console.log("Should not be called.");
@@ -227,7 +234,7 @@ Aborta a una transferencia en curso. El callback onerror se pasa un objeto FileT
options.mimeType="image/jpeg";
var ft = new FileTransfer();
- ft.upload(fileURI, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
ft.abort();
@@ -239,9 +246,9 @@ A `FileTransferError` objeto se pasa a un callback de error cuando se produce un
* **código**: uno de los códigos de error predefinido enumerados a continuación. (Número)
-* **fuente**: URI a la fuente. (String)
+* **fuente**: URL a la fuente. (String)
-* **objetivo**: URI a la meta. (String)
+* **objetivo**: URL a la meta. (String)
* **HTTP_STATUS**: código de estado HTTP. Este atributo sólo está disponible cuando se recibe un código de respuesta de la conexión HTTP. (Número)
@@ -250,4 +257,25 @@ A `FileTransferError` objeto se pasa a un callback de error cuando se produce un
* `FileTransferError.FILE_NOT_FOUND_ERR`
* `FileTransferError.INVALID_URL_ERR`
* `FileTransferError.CONNECTION_ERR`
-* `FileTransferError.ABORT_ERR`
\ No newline at end of file
+* `FileTransferError.ABORT_ERR`
+
+## Al revés notas de compatibilidad
+
+Versiones anteriores de este plugin sólo aceptaría dispositivo-absoluto-archivo-rutas como la fuente de carga, o como destino para las descargas. Estos caminos normalmente sería de la forma
+
+ /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
+ /storage/emulated/0/path/to/file (Android)
+
+
+Para atrás compatibilidad, estos caminos son aceptados todavía, y si su solicitud ha grabado caminos como éstos en almacenamiento persistente, entonces pueden seguir utilizarse.
+
+Estos caminos fueron expuestos anteriormente en el `fullPath` propiedad de `FileEntry` y `DirectoryEntry` objetos devueltos por el plugin de archivo. Las nuevas versiones del archivo plugin, sin embargo, ya no exponen estos caminos a JavaScript.
+
+Si va a actualizar a una nueva (1.0.0 o más reciente) versión del archivo y previamente han estado utilizando `entry.fullPath` como argumentos para `download()` o `upload()` , entonces tendrá que cambiar su código para usar URLs de sistema de archivos en su lugar.
+
+`FileEntry.toURL()`y `DirectoryEntry.toURL()` devolver un filesystem dirección URL de la forma
+
+ cdvfile://localhost/persistent/path/to/file
+
+
+que puede ser utilizado en lugar de la ruta del archivo absoluta tanto en `download()` y `upload()` los métodos.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/131f84f1/doc/fr/index.md
----------------------------------------------------------------------
diff --git a/doc/fr/index.md b/doc/fr/index.md
index a50641c..defdba7 100644
--- a/doc/fr/index.md
+++ b/doc/fr/index.md
@@ -39,7 +39,7 @@ Ce plugin vous permet de télécharger des fichiers.
# Transfert de fichiers
-Le `FileTransfer` objet fournit un moyen de télécharger des fichiers à l'aide d'une requête HTTP de la poste plusieurs partie et pour télécharger des fichiers aussi bien.
+L'objet `FileTransfer` fournit un moyen de tranférer des fichiers sur un serveur HTTP avec une requête multi-part POST, et aussi pour télécharger des fichiers.
## Propriétés
@@ -57,7 +57,7 @@ Le `FileTransfer` objet fournit un moyen de télécharger des fichiers à l'aide
**Paramètres**:
-* **filePath** : chemin d'accès complet au fichier sur l'appareil.
+* **fileURL** : système de fichiers URL représentant le fichier sur le périphérique. Pour la compatibilité ascendante, cela peut aussi être le chemin complet du fichier sur le périphérique. (Voir [Backwards Compatibility Notes] ci-dessous)
* **server** : l'URL du serveur destiné à recevoir le fichier, encodée via `encodeURI()`.
@@ -78,7 +78,8 @@ Le `FileTransfer` objet fournit un moyen de télécharger des fichiers à l'aide
### Exemple
- // !! Assumes variable fileURI contains a valid URI to a text file on the device
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
var win = function (r) {
console.log("Code = " + r.responseCode);
@@ -94,7 +95,7 @@ Le `FileTransfer` objet fournit un moyen de télécharger des fichiers à l'aide
var options = new FileUploadOptions();
options.fileKey = "file";
- options.fileName = fileURI.substr(fileURI.lastIndexOf('/') + 1);
+ options.fileName = fileURL.substr(fileURL.lastIndexOf('/') + 1);
options.mimeType = "text/plain";
var params = {};
@@ -104,10 +105,10 @@ Le `FileTransfer` objet fournit un moyen de télécharger des fichiers à l'aide
options.params = params;
var ft = new FileTransfer();
- ft.upload(fileURI, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
-### Exemple avec télécharger des en-têtes et des événements de progression (Android et iOS uniquement)
+### Exemple avec téléchargement du Header et des Progress Events (Android et iOS uniquement)
function win(r) {
console.log("Code = " + r.responseCode);
@@ -125,7 +126,7 @@ Le `FileTransfer` objet fournit un moyen de télécharger des fichiers à l'aide
var options = new FileUploadOptions();
options.fileKey="file";
- options.fileName=fileURI.substr(fileURI.lastIndexOf('/')+1);
+ options.fileName=fileURL.substr(fileURL.lastIndexOf('/')+1);
options.mimeType="text/plain";
var headers={'headerParam':'headerValue'};
@@ -140,7 +141,7 @@ Le `FileTransfer` objet fournit un moyen de télécharger des fichiers à l'aide
loadingStatus.increment();
}
};
- ft.upload(fileURI, uri, win, fail, options);
+ ft.upload(fileURL, uri, win, fail, options);
## FileUploadResult
@@ -155,7 +156,11 @@ Un objet `FileUploadResult` est passé à la callback de succès de la méthode
* **response** : la réponse HTTP renvoyée par le serveur. (DOMString)
-### iOS Quirks
+* **en-têtes** : en-têtes de réponse HTTP par le serveur. (Objet)
+
+ * Actuellement pris en charge sur iOS seulement.
+
+### iOS Remarques
* Ne prend pas en charge les propriétés `responseCode` et `bytesSent`.
@@ -165,33 +170,34 @@ Un objet `FileUploadResult` est passé à la callback de succès de la méthode
* **source** : l'URL du serveur depuis lequel télécharger le fichier, encodée via `encodeURI()`.
-* **target** : chemin d'accès complet au fichier sur l'appareil.
+* **target** : système de fichiers url représentant le fichier sur le périphérique. Pour vers l'arrière la compatibilité, cela peut aussi être le chemin d'accès complet du fichier sur le périphérique. (Voir [vers l'arrière compatibilité note] ci-dessous)
* **successCallback** : une callback de succès à laquelle est passée un objet `FileEntry`. *(Function)*
* **errorCallback** : une callback d'erreur s'exécutant si une erreur se produit lors de la récupération de l'objet `Metadata`. Appelée avec un objet `FileTransferError`. *(Function)*
-* **trustAllHosts**: paramètre facultatif, valeur par défaut est `false` . Si la valeur `true` , il accepte tous les certificats de sécurité. Ceci est utile parce que Android rejette des certificats auto-signés. Non recommandé pour une utilisation de production. Supporté sur Android et iOS. *(boolean)*
+* **trustAllHosts**: paramètre facultatif, valeur par défaut est `false` . Si la valeur est `true` , il accepte tous les certificats de sécurité. Ceci peut être utile car Android rejette les certificats auto-signés. N'est pas recommandé pour une utilisation en production. Supporté sur Android et iOS. *(booléen)*
* **options** : paramètres facultatifs, seules les en-têtes sont actuellement supportées (par exemple l'autorisation (authentification basique), etc.).
### Exemple
- // !! Suppose que filePath est un chemin valide sur l'appareil
+ // !! Assumes variable fileURL contains a valid URL to a path on the device,
+ // for example, cdvfile://localhost/persistent/path/to/downloads/
var fileTransfer = new FileTransfer();
var uri = encodeURI("http://some.server.com/download.php");
fileTransfer.download(
uri,
- filePath,
+ fileURL,
function(entry) {
- console.log("Téléchargement terminé : " + entry.fullPath);
+ console.log("download complete: " + entry.fullPath);
},
function(error) {
- console.log("Source pour l'erreur de téléchargement : " + error.source);
- console.log("Destination pour l'erreur de téléchargement : " + error.target);
- console.log("Code de l'erreur de téléchargement : " + error.code);
+ console.log("download error source " + error.source);
+ console.log("download error target " + error.target);
+ console.log("upload error code" + error.code);
},
false,
{
@@ -208,17 +214,18 @@ Abandonne un transfert en cours. Un objet FileTransferError avec un code d'erreu
### Exemple
- // !! Suppose que la variable fileURI contient l'URI valide d'un fichier texte sur l'appareil
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
var win = function(r) {
- console.log("Ne devrait pas être appelée.");
+ console.log("Should not be called.");
}
var fail = function(error) {
// error.code == FileTransferError.ABORT_ERR
- alert("Une erreur est survenue : code = " + error.code);
- console.log("Source pour l'erreur de téléchargement : " + error.source);
- console.log("Destination pour l'erreur de téléchargement : " + error.target);
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
}
var options = new FileUploadOptions();
@@ -227,7 +234,7 @@ Abandonne un transfert en cours. Un objet FileTransferError avec un code d'erreu
options.mimeType="image/jpeg";
var ft = new FileTransfer();
- ft.upload(fileURI, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
ft.abort();
@@ -250,4 +257,25 @@ Un objet `FileTransferError` est passé à une callback d'erreur lorsqu'une erre
* `FileTransferError.FILE_NOT_FOUND_ERR`
* `FileTransferError.INVALID_URL_ERR`
* `FileTransferError.CONNECTION_ERR`
-* `FileTransferError.ABORT_ERR`
\ No newline at end of file
+* `FileTransferError.ABORT_ERR`
+
+## Backwards Compatibility Notes
+
+Les versions précédentes de ce plugin accepte seulement les chemins de fichiers périphérique absolus comme source pour les chargement, ou comme cible pour les téléchargements. Ces chemins sont généralement de la forme
+
+ /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
+ /storage/emulated/0/path/to/file (Android)
+
+
+Pour la compatibilité ascendante, ces chemins sont toujours acceptés, et si votre application a enregistré des chemins comme ceux-ci dans un stockage persistant, alors ils peuvent continuer à être utilisé.
+
+Ces chemins ont été précédemment exposés dans la propriété `fullPath` de `FileEntry` et objets `DirectoryEntry` retournés par le fichier plugin. Nouvelles versions du fichier plugin, cependant, ne plus exposer ces chemins à JavaScript.
+
+Si vous migrez vers une nouvelle version du fichier (1.0.0 ou plus récent) et que vous utilisiez précédemment `entry.fullPath` en tant qu'arguments à `download()` ou `upload()`, alors vous aurez besoin de modifier votre code pour utiliser le système de fichiers URL à la place.
+
+`FileEntry.toURL()` et `DirectoryEntry.toURL()` retournent une URL de système de fichier de formulaire
+
+ cdvfile://localhost/persistent/path/to/file
+
+
+qui peut être utilisé à la place du chemin d'accès absolu au fichier dans les méthodes `download()` et `upload()`.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/131f84f1/doc/it/index.md
----------------------------------------------------------------------
diff --git a/doc/it/index.md b/doc/it/index.md
new file mode 100644
index 0000000..89c32b4
--- /dev/null
+++ b/doc/it/index.md
@@ -0,0 +1,281 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# org.apache.cordova.file-transfer
+
+Questo plugin permette di caricare e scaricare file.
+
+## Installazione
+
+ cordova plugin add org.apache.cordova.file-transfer
+
+
+## Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* BlackBerry 10 *
+* iOS
+* Windows Phone 7 e 8 *
+* Windows 8 *
+
+* *Non supportano `onprogress` né `abort()` *
+
+# FileTransfer
+
+Il `FileTransfer` oggetto fornisce un modo per caricare i file utilizzando una richiesta HTTP di POST più parte e scaricare file pure.
+
+## Proprietà
+
+* **OnProgress**: chiamata con un `ProgressEvent` ogni volta che un nuovo blocco di dati viene trasferito. *(Funzione)*
+
+## Metodi
+
+* **caricare**: invia un file a un server.
+
+* **Scarica**: Scarica un file dal server.
+
+* **Abort**: interrompe un trasferimento in corso.
+
+## caricare
+
+**Parametri**:
+
+* **fileURL**: Filesystem URL che rappresenta il file nel dispositivo. Per indietro la compatibilità, questo può anche essere il percorso completo del file sul dispositivo. (Vedere [indietro compatibilità rileva] qui sotto)
+
+* **server**: URL del server per ricevere il file, come codificato dal`encodeURI()`.
+
+* **successCallback**: un callback passato un `Metadata` oggetto. *(Funzione)*
+
+* **errorCallback**: un callback che viene eseguito se si verifica un errore recuperando il `Metadata` . Invocato con un `FileTransferError` oggetto. *(Funzione)*
+
+* **trustAllHosts**: parametro opzionale, valore predefinito è `false` . Se impostata su `true` , accetta tutti i certificati di sicurezza. Questo è utile poiché Android respinge i certificati autofirmati sicurezza. Non raccomandato per uso in produzione. Supportato su Android e iOS. *(boolean)*
+
+* **opzioni**: parametri facoltativi *(oggetto)*. Chiavi valide:
+
+ * **fileKey**: il nome dell'elemento form. Valore predefinito è `file` . (DOMString)
+ * **nome file**: il nome del file da utilizzare quando si salva il file sul server. Valore predefinito è `image.jpg` . (DOMString)
+ * **mimeType**: il tipo mime dei dati da caricare. Valore predefinito è `image/jpeg` . (DOMString)
+ * **params**: un insieme di coppie chiave/valore opzionale per passare nella richiesta HTTP. (Oggetto)
+ * **chunkedMode**: se a caricare i dati in modalità streaming chunked. Valore predefinito è `true` . (Boolean)
+ * **intestazioni**: mappa di valori nome/intestazione intestazione. Utilizzare una matrice per specificare più valori. (Oggetto)
+
+### Esempio
+
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
+
+ var win = function (r) {
+ console.log("Code = " + r.responseCode);
+ console.log("Response = " + r.response);
+ console.log("Sent = " + r.bytesSent);
+ }
+
+ var fail = function (error) {
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey = "file";
+ options.fileName = fileURL.substr(fileURL.lastIndexOf('/') + 1);
+ options.mimeType = "text/plain";
+
+ var params = {};
+ params.value1 = "test";
+ params.value2 = "param";
+
+ options.params = params;
+
+ var ft = new FileTransfer();
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+
+
+### Esempio con intestazioni di caricare ed eventi Progress (Android e iOS solo)
+
+ function win(r) {
+ console.log("Code = " + r.responseCode);
+ console.log("Response = " + r.response);
+ console.log("Sent = " + r.bytesSent);
+ }
+
+ function fail(error) {
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var uri = encodeURI("http://some.server.com/upload.php");
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName=fileURL.substr(fileURL.lastIndexOf('/')+1);
+ options.mimeType="text/plain";
+
+ var headers={'headerParam':'headerValue'};
+
+ options.headers = headers;
+
+ var ft = new FileTransfer();
+ ft.onprogress = function(progressEvent) {
+ if (progressEvent.lengthComputable) {
+ loadingStatus.setPercentage(progressEvent.loaded / progressEvent.total);
+ } else {
+ loadingStatus.increment();
+ }
+ };
+ ft.upload(fileURL, uri, win, fail, options);
+
+
+## FileUploadResult
+
+A `FileUploadResult` oggetto viene passato al metodo di callback di successo il `FileTransfer` dell'oggetto `upload()` metodo.
+
+### Proprietà
+
+* **bytesSent**: il numero di byte inviati al server come parte dell'upload. (lungo)
+
+* **responseCode**: codice di risposta HTTP restituito dal server. (lungo)
+
+* **risposta**: risposta HTTP restituito dal server. (DOMString)
+
+* **intestazioni**: intestazioni di risposta HTTP dal server. (Oggetto)
+
+ * Attualmente supportato solo iOS.
+
+### iOS stranezze
+
+* Non supporta `responseCode` o`bytesSent`.
+
+## Scarica
+
+**Parametri**:
+
+* **fonte**: URL del server per scaricare il file, come codificato dal`encodeURI()`.
+
+* **destinazione**: Filesystem url che rappresenta il file nel dispositivo. Per indietro la compatibilità, questo può anche essere il percorso completo del file sul dispositivo. (Vedere [indietro compatibilità rileva] qui sotto)
+
+* **successCallback**: un callback passato un `FileEntry` oggetto. *(Funzione)*
+
+* **errorCallback**: un callback che viene eseguito se si verifica un errore durante il recupero del `Metadata` . Invocato con un `FileTransferError` oggetto. *(Funzione)*
+
+* **trustAllHosts**: parametro opzionale, valore predefinito è `false` . Se impostata su `true` , accetta tutti i certificati di sicurezza. Questo è utile perché Android respinge i certificati autofirmati sicurezza. Non raccomandato per uso in produzione. Supportato su Android e iOS. *(boolean)*
+
+* **opzioni**: parametri facoltativi, attualmente solo supporti intestazioni (ad esempio autorizzazione (autenticazione di base), ecc.).
+
+### Esempio
+
+ // !! Assumes variable fileURL contains a valid URL to a path on the device,
+ // for example, cdvfile://localhost/persistent/path/to/downloads/
+
+ var fileTransfer = new FileTransfer();
+ var uri = encodeURI("http://some.server.com/download.php");
+
+ fileTransfer.download(
+ uri,
+ fileURL,
+ function(entry) {
+ console.log("download complete: " + entry.fullPath);
+ },
+ function(error) {
+ console.log("download error source " + error.source);
+ console.log("download error target " + error.target);
+ console.log("upload error code" + error.code);
+ },
+ false,
+ {
+ headers: {
+ "Authorization": "Basic dGVzdHVzZXJuYW1lOnRlc3RwYXNzd29yZA=="
+ }
+ }
+ );
+
+
+## Abort
+
+Interrompe un trasferimento in corso. Il callback onerror viene passato un oggetto FileTransferError che presenta un codice di errore di FileTransferError.ABORT_ERR.
+
+### Esempio
+
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
+
+ var win = function(r) {
+ console.log("Should not be called.");
+ }
+
+ var fail = function(error) {
+ // error.code == FileTransferError.ABORT_ERR
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName="myphoto.jpg";
+ options.mimeType="image/jpeg";
+
+ var ft = new FileTransfer();
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.abort();
+
+
+## FileTransferError
+
+A `FileTransferError` oggetto viene passato a un callback di errore quando si verifica un errore.
+
+### Proprietà
+
+* **codice**: uno dei codici di errore predefiniti elencati di seguito. (Numero)
+
+* **fonte**: URL all'origine. (String)
+
+* **destinazione**: URL di destinazione. (String)
+
+* **http_status**: codice di stato HTTP. Questo attributo è disponibile solo quando viene ricevuto un codice di risposta della connessione HTTP. (Numero)
+
+### Costanti
+
+* `FileTransferError.FILE_NOT_FOUND_ERR`
+* `FileTransferError.INVALID_URL_ERR`
+* `FileTransferError.CONNECTION_ERR`
+* `FileTransferError.ABORT_ERR`
+
+## Note di compatibilità all'indietro
+
+Versioni precedenti di questo plugin accetterebbe solo dispositivo-assoluto-percorsi di file come origine per upload, o come destinazione per il download. Questi percorsi si sarebbero generalmente di forma
+
+ /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
+ /storage/emulated/0/path/to/file (Android)
+
+
+Per indietro compatibilità, questi percorsi sono ancora accettati, e se l'applicazione ha registrato percorsi come questi in un archivio permanente, quindi possono continuare a essere utilizzato.
+
+Questi percorsi sono state precedentemente esposte nella `fullPath` proprietà di `FileEntry` e `DirectoryEntry` oggetti restituiti dal File plugin. Nuove versioni del File plugin, tuttavia, non è più espongono questi percorsi a JavaScript.
+
+Se si esegue l'aggiornamento a una nuova (1.0.0 o più recente) precedentemente utilizzano la versione del File e si `entry.fullPath` come argomenti a `download()` o `upload()` , sarà necessario modificare il codice per utilizzare gli URL filesystem invece.
+
+`FileEntry.toURL()`e `DirectoryEntry.toURL()` restituiscono un filesystem URL del modulo
+
+ cdvfile://localhost/persistent/path/to/file
+
+
+che può essere utilizzato al posto del percorso assoluto in entrambi `download()` e `upload()` metodi.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/131f84f1/doc/ko/index.md
----------------------------------------------------------------------
diff --git a/doc/ko/index.md b/doc/ko/index.md
new file mode 100644
index 0000000..109cf80
--- /dev/null
+++ b/doc/ko/index.md
@@ -0,0 +1,281 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# org.apache.cordova.file-transfer
+
+이 플러그인을 사용 하면 업로드 및 다운로드 파일 수 있습니다.
+
+## 설치
+
+ cordova plugin add org.apache.cordova.file-transfer
+
+
+## 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드
+* 블랙베리 10 *
+* iOS
+* Windows Phone 7과 8 *
+* 윈도우 8 *
+
+* *를 지원 하지 않는 `onprogress` 도 `abort()` *
+
+# FileTransfer
+
+`FileTransfer`개체는 HTTP 다중 파트 POST 요청을 사용 하 여 파일을 업로드 하 고 뿐만 아니라 파일을 다운로드 하는 방법을 제공 합니다.
+
+## 속성
+
+* **onprogress**:로 불리는 `ProgressEvent` 새로운 양의 데이터를 전송 하는 때마다. *(기능)*
+
+## 메서드
+
+* **업로드**: 파일을 서버에 보냅니다.
+
+* **다운로드**: 서버에서 파일을 다운로드 합니다.
+
+* **중단**: 진행 중인 전송 중단.
+
+## 업로드
+
+**매개 변수**:
+
+* **fileURL**: 장치에 파일을 나타내는 파일 시스템 URL. 에 대 한 이전 버전과 호환성을이 수도 장치에 있는 파일의 전체 경로 수. (참조 [거꾸로 호환성 노트] 아래)
+
+* **서버**: 인코딩 파일 수신 서버의 URL`encodeURI()`.
+
+* **successCallback**: 콜백 전달 되는 `Metadata` 개체. *(기능)*
+
+* **errorCallback**: 콜백 검색에 오류가 발생 하면 실행 되는 `Metadata` . 로 호출을 `FileTransferError` 개체. *(기능)*
+
+* **trustAllHosts**: 선택적 매개 변수는 기본적으로 `false` . 만약 설정 `true` , 그것은 모든 보안 인증서를 허용 합니다. 이 안 드 로이드 자체 서명 된 보안 인증서를 거부 하기 때문에 유용 합니다. 프로덕션 환경에서 사용 권장 되지 않습니다. 안 드 로이드와 iOS에서 지원. *(부울)*
+
+* **옵션**: 선택적 매개 변수 *(개체)*. 유효한 키:
+
+ * **fileKey**: form 요소의 이름. 기본값은 `file` . (DOMString)
+ * **파일 이름**: 파일 이름을 서버에 파일을 저장할 때 사용 합니다. 기본값은 `image.jpg` . (DOMString)
+ * **mimeType**: 업로드 데이터의 mime 형식을. 기본값은 `image/jpeg` . (DOMString)
+ * **params**: HTTP 요청에 전달할 선택적 키/값 쌍의 집합. (개체)
+ * **chunkedMode**: 청크 스트리밍 모드에서 데이터 업로드를 합니다. 기본값은 `true` . (부울)
+ * **헤더**: 헤더 이름/헤더 값의 지도. 배열을 사용 하 여 하나 이상의 값을 지정 합니다. (개체)
+
+### 예를 들어
+
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
+
+ var win = function (r) {
+ console.log("Code = " + r.responseCode);
+ console.log("Response = " + r.response);
+ console.log("Sent = " + r.bytesSent);
+ }
+
+ var fail = function (error) {
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey = "file";
+ options.fileName = fileURL.substr(fileURL.lastIndexOf('/') + 1);
+ options.mimeType = "text/plain";
+
+ var params = {};
+ params.value1 = "test";
+ params.value2 = "param";
+
+ options.params = params;
+
+ var ft = new FileTransfer();
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+
+
+### 예를 들어 헤더 업로드 및 진행 이벤트 (안 드 로이드와 iOS만)
+
+ function win(r) {
+ console.log("Code = " + r.responseCode);
+ console.log("Response = " + r.response);
+ console.log("Sent = " + r.bytesSent);
+ }
+
+ function fail(error) {
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var uri = encodeURI("http://some.server.com/upload.php");
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName=fileURL.substr(fileURL.lastIndexOf('/')+1);
+ options.mimeType="text/plain";
+
+ var headers={'headerParam':'headerValue'};
+
+ options.headers = headers;
+
+ var ft = new FileTransfer();
+ ft.onprogress = function(progressEvent) {
+ if (progressEvent.lengthComputable) {
+ loadingStatus.setPercentage(progressEvent.loaded / progressEvent.total);
+ } else {
+ loadingStatus.increment();
+ }
+ };
+ ft.upload(fileURL, uri, win, fail, options);
+
+
+## FileUploadResult
+
+A `FileUploadResult` 개체의 성공 콜백에 전달 되는 `FileTransfer` 개체의 `upload()` 메서드.
+
+### 속성
+
+* **bytesSent**: 업로드의 일부로 서버에 보낸 바이트 수. (긴)
+
+* **responseCode**: 서버에서 반환 된 HTTP 응답 코드. (긴)
+
+* **응답**: 서버에서 반환 되는 HTTP 응답. (DOMString)
+
+* **머리글**: 서버에서 HTTP 응답 헤더. (개체)
+
+ * 현재 ios만 지원 합니다.
+
+### iOS 단점
+
+* 지원 하지 않는 `responseCode` 또는`bytesSent`.
+
+## 다운로드
+
+**매개 변수**:
+
+* **소스**: URL로 인코딩된 파일, 다운로드 서버`encodeURI()`.
+
+* **대상**: 장치에 파일을 나타내는 파일 시스템 url. 에 대 한 이전 버전과 호환성을이 수도 장치에 있는 파일의 전체 경로 수. (참조 [거꾸로 호환성 노트] 아래)
+
+* **successCallback**: 콜백 전달 되는 `FileEntry` 개체. *(기능)*
+
+* **errorCallback**: 콜백 검색할 때 오류가 발생 하면 실행 되는 `Metadata` . 로 호출을 `FileTransferError` 개체. *(기능)*
+
+* **trustAllHosts**: 선택적 매개 변수는 기본적으로 `false` . 만약 설정 `true` , 그것은 모든 보안 인증서를 허용 합니다. 안 드 로이드 자체 서명 된 보안 인증서를 거부 하기 때문에 유용 합니다. 프로덕션 환경에서 사용 권장 되지 않습니다. 안 드 로이드와 iOS에서 지원. *(부울)*
+
+* **옵션**: 선택적 매개 변수를 현재 지 원하는 머리글만 (예: 인증 (기본 인증), 등).
+
+### 예를 들어
+
+ // !! Assumes variable fileURL contains a valid URL to a path on the device,
+ // for example, cdvfile://localhost/persistent/path/to/downloads/
+
+ var fileTransfer = new FileTransfer();
+ var uri = encodeURI("http://some.server.com/download.php");
+
+ fileTransfer.download(
+ uri,
+ fileURL,
+ function(entry) {
+ console.log("download complete: " + entry.fullPath);
+ },
+ function(error) {
+ console.log("download error source " + error.source);
+ console.log("download error target " + error.target);
+ console.log("upload error code" + error.code);
+ },
+ false,
+ {
+ headers: {
+ "Authorization": "Basic dGVzdHVzZXJuYW1lOnRlc3RwYXNzd29yZA=="
+ }
+ }
+ );
+
+
+## 중단
+
+진행 중인 전송을 중단합니다. Onerror 콜백 FileTransferError.ABORT_ERR의 오류 코드는 FileTransferError 개체를 전달 합니다.
+
+### 예를 들어
+
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
+
+ var win = function(r) {
+ console.log("Should not be called.");
+ }
+
+ var fail = function(error) {
+ // error.code == FileTransferError.ABORT_ERR
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName="myphoto.jpg";
+ options.mimeType="image/jpeg";
+
+ var ft = new FileTransfer();
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.abort();
+
+
+## FileTransferError
+
+A `FileTransferError` 오류가 발생 하면 오류 콜백 개체 전달 됩니다.
+
+### 속성
+
+* **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된. (수)
+
+* **소스**: 소스 URL. (문자열)
+
+* **대상**: 대상 URL. (문자열)
+
+* **http_status**: HTTP 상태 코드. 이 특성은 응답 코드를 HTTP 연결에서 수신에 사용할 수 있습니다. (수)
+
+### 상수
+
+* `FileTransferError.FILE_NOT_FOUND_ERR`
+* `FileTransferError.INVALID_URL_ERR`
+* `FileTransferError.CONNECTION_ERR`
+* `FileTransferError.ABORT_ERR`
+
+## 이전 버전과 호환성 노트
+
+이 플러그인의 이전 버전만 업로드에 대 한 소스 또는 다운로드에 대 한 대상 장치 절대 파일 경로 받아들일 것 이다. 이러한 경로 일반적으로 폼의 것
+
+ /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
+ /storage/emulated/0/path/to/file (Android)
+
+
+대 한 뒤 호환성, 이러한 경로 여전히 허용, 그리고 응용 프로그램이 영구 저장소에서 이와 같은 경로 기록 했다, 그때 그들은 계속할 수 있다면 사용할 수.
+
+이 경로에 노출 되었던는 `fullPath` 속성의 `FileEntry` 및 `DirectoryEntry` 파일 플러그인에 의해 반환 된 개체. 그러나 파일 플러그인의,, 더 이상 새로운 버전 자바 스크립트이 경로 노출.
+
+새로 업그레이드 하는 경우 (1.0.0 이상) 파일의 버전을 사용 하고있다 이전 `entry.fullPath` 인수로 `download()` 또는 `upload()` , 다음 대신 파일 시스템 Url을 사용 하 여 코드를 변경 해야 합니다.
+
+`FileEntry.toURL()`그리고 `DirectoryEntry.toURL()` 폼의 파일 URL을 반환
+
+ cdvfile://localhost/persistent/path/to/file
+
+
+둘 다에서 절대 파일 경로 대신 사용할 수 있는 `download()` 및 `upload()` 메서드.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/131f84f1/doc/pl/index.md
----------------------------------------------------------------------
diff --git a/doc/pl/index.md b/doc/pl/index.md
new file mode 100644
index 0000000..32829af
--- /dev/null
+++ b/doc/pl/index.md
@@ -0,0 +1,281 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# org.apache.cordova.file-transfer
+
+Plugin pozwala na przesyłanie i pobieranie plików.
+
+## Instalacji
+
+ cordova plugin add org.apache.cordova.file-transfer
+
+
+## Obsługiwane platformy
+
+* Amazon ogień OS
+* Android
+* Jeżyna 10 *
+* iOS
+* Windows Phone 7 i 8 *
+* Windows 8 *
+
+* *Nie obsługują `onprogress` ani `abort()` *
+
+# FileTransfer
+
+`FileTransfer`Obiekt zapewnia sposób wgrać pliki przy użyciu żądania HTTP wieloczęściowe POST i pobierania plików, jak również.
+
+## Właściwości
+
+* **OnProgress**: o nazwie `ProgressEvent` gdy nowy kawałek danych jest przenoszona. *(Funkcja)*
+
+## Metody
+
+* **wgraj**: wysyła plik na serwer.
+
+* **do pobrania**: pliki do pobrania pliku z serwera.
+
+* **przerwać**: przerywa w toku transferu.
+
+## upload
+
+**Parametry**:
+
+* **fileURL**: URL plików reprezentujących pliku na urządzenie. Dla wstecznej kompatybilności, to może również być pełną ścieżkę pliku na urządzenie. (Zobacz [wstecz zgodności zauważa] poniżej)
+
+* **serwer**: adres URL serwera, aby otrzymać plik, jak kodowane przez`encodeURI()`.
+
+* **successCallback**: wywołania zwrotnego, który jest przekazywany `Metadata` obiektu. *(Funkcja)*
+
+* **errorCallback**: wywołanie zwrotne, które wykonuje, jeżeli wystąpi błąd pobierania `Metadata` . Wywołany z `FileTransferError` obiektu. *(Funkcja)*
+
+* **trustAllHosts**: parametr opcjonalny, domyślnie `false` . Jeśli zestaw `true` , to akceptuje wszystkie certyfikaty bezpieczeństwa. Jest to przydatne, ponieważ Android odrzuca Certyfikaty samopodpisane. Nie zaleca się do użytku produkcyjnego. Obsługiwane na Androida i iOS. *(wartość logiczna)*
+
+* **Opcje**: parametry opcjonalne *(obiektu)*. Ważne klucze:
+
+ * **fileKey**: nazwa elementu form. Domyślnie `file` . (DOMString)
+ * **Nazwa pliku**: nazwy pliku, aby użyć podczas zapisywania pliku na serwerze. Domyślnie `image.jpg` . (DOMString)
+ * **mimeType**: Typ mime danych do przesłania. Domyślnie `image/jpeg` . (DOMString)
+ * **Parametry**: zestaw par opcjonalny klucz/wartość w żądaniu HTTP. (Obiekt)
+ * **chunkedMode**: czy przekazać dane w trybie pakietowego przesyłania strumieniowego. Domyślnie `true` . (Wartość logiczna)
+ * **nagłówki**: Mapa wartości Nazwa/nagłówka nagłówek. Aby określić więcej niż jedną wartość, należy użyć tablicę. (Obiekt)
+
+### Przykład
+
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
+
+ var win = function (r) {
+ console.log("Code = " + r.responseCode);
+ console.log("Response = " + r.response);
+ console.log("Sent = " + r.bytesSent);
+ }
+
+ var fail = function (error) {
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey = "file";
+ options.fileName = fileURL.substr(fileURL.lastIndexOf('/') + 1);
+ options.mimeType = "text/plain";
+
+ var params = {};
+ params.value1 = "test";
+ params.value2 = "param";
+
+ options.params = params;
+
+ var ft = new FileTransfer();
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+
+
+### Przykład z Prześlij nagłówki i zdarzeń postępu (Android i iOS tylko)
+
+ function win(r) {
+ console.log("Code = " + r.responseCode);
+ console.log("Response = " + r.response);
+ console.log("Sent = " + r.bytesSent);
+ }
+
+ function fail(error) {
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var uri = encodeURI("http://some.server.com/upload.php");
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName=fileURL.substr(fileURL.lastIndexOf('/')+1);
+ options.mimeType="text/plain";
+
+ var headers={'headerParam':'headerValue'};
+
+ options.headers = headers;
+
+ var ft = new FileTransfer();
+ ft.onprogress = function(progressEvent) {
+ if (progressEvent.lengthComputable) {
+ loadingStatus.setPercentage(progressEvent.loaded / progressEvent.total);
+ } else {
+ loadingStatus.increment();
+ }
+ };
+ ft.upload(fileURL, uri, win, fail, options);
+
+
+## FileUploadResult
+
+A `FileUploadResult` obiekt jest przekazywany do funkcji callback sukces z `FileTransfer` obiektu `upload()` Metoda.
+
+### Właściwości
+
+* **bytesSent**: liczba bajtów wysłanych do serwera jako część upload. (długie)
+
+* **responseCode**: kod odpowiedzi HTTP, zwracane przez serwer. (długie)
+
+* **odpowiedź**: HTTP odpowiedzi zwracane przez serwer. (DOMString)
+
+* **nagłówki**: nagłówki HTTP odpowiedzi przez serwer. (Obiekt)
+
+ * Obecnie obsługiwane na iOS tylko.
+
+### iOS dziwactwa
+
+* Nie obsługuje `responseCode` lub`bytesSent`.
+
+## Pobierz za darmo
+
+**Parametry**:
+
+* **Źródło**: adres URL serwera, aby pobrać plik, jak kodowane przez`encodeURI()`.
+
+* **cel**: url plików reprezentujących pliku na urządzenie. Dla wstecznej kompatybilności, to może również być pełną ścieżkę pliku na urządzenie. (Zobacz [wstecz zgodności zauważa] poniżej)
+
+* **successCallback**: wywołania zwrotnego, który jest przekazywany `FileEntry` obiektu. *(Funkcja)*
+
+* **errorCallback**: wywołanie zwrotne, które wykonuje, jeśli wystąpi błąd podczas pobierania `Metadata` . Wywołany z `FileTransferError` obiektu. *(Funkcja)*
+
+* **trustAllHosts**: parametr opcjonalny, domyślnie `false` . Jeśli zestaw `true` , to akceptuje wszystkie certyfikaty bezpieczeństwa. Jest to przydatne, ponieważ Android odrzuca Certyfikaty samopodpisane. Nie zaleca się do użytku produkcyjnego. Obsługiwane na Androida i iOS. *(wartość logiczna)*
+
+* **Opcje**: parametry opcjonalne, obecnie tylko obsługuje nagłówki (takie jak autoryzacja (uwierzytelnianie podstawowe), itp.).
+
+### Przykład
+
+ // !! Assumes variable fileURL contains a valid URL to a path on the device,
+ // for example, cdvfile://localhost/persistent/path/to/downloads/
+
+ var fileTransfer = new FileTransfer();
+ var uri = encodeURI("http://some.server.com/download.php");
+
+ fileTransfer.download(
+ uri,
+ fileURL,
+ function(entry) {
+ console.log("download complete: " + entry.fullPath);
+ },
+ function(error) {
+ console.log("download error source " + error.source);
+ console.log("download error target " + error.target);
+ console.log("upload error code" + error.code);
+ },
+ false,
+ {
+ headers: {
+ "Authorization": "Basic dGVzdHVzZXJuYW1lOnRlc3RwYXNzd29yZA=="
+ }
+ }
+ );
+
+
+## przerwanie
+
+Przerywa w toku transferu. Onerror callback jest przekazywany obiekt FileTransferError, który kod błędu z FileTransferError.ABORT_ERR.
+
+### Przykład
+
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
+
+ var win = function(r) {
+ console.log("Should not be called.");
+ }
+
+ var fail = function(error) {
+ // error.code == FileTransferError.ABORT_ERR
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName="myphoto.jpg";
+ options.mimeType="image/jpeg";
+
+ var ft = new FileTransfer();
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.abort();
+
+
+## FileTransferError
+
+A `FileTransferError` obiekt jest przekazywany do wywołania zwrotnego błąd, gdy wystąpi błąd.
+
+### Właściwości
+
+* **Kod**: jeden z kodów błędów wstępnie zdefiniowanych poniżej. (Liczba)
+
+* **Źródło**: URL do źródła. (String)
+
+* **cel**: adres URL do docelowego. (String)
+
+* **HTTP_STATUS**: kod stanu HTTP. Ten atrybut jest dostępna tylko po otrzymaniu kodu odpowiedzi z połączenia HTTP. (Liczba)
+
+### Stałe
+
+* `FileTransferError.FILE_NOT_FOUND_ERR`
+* `FileTransferError.INVALID_URL_ERR`
+* `FileTransferError.CONNECTION_ERR`
+* `FileTransferError.ABORT_ERR`
+
+## Do tyłu zgodności stwierdza
+
+Poprzednie wersje tego pluginu tylko zaakceptować urządzenia bezwzględnych ścieżek jako źródło dla przekazywania, lub w celu pobrania. Te ścieżki będzie zazwyczaj formy
+
+ /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
+ /storage/emulated/0/path/to/file (Android)
+
+
+Do tyłu zgodności, akceptowane są jeszcze te ścieżki, i jeśli aplikacja nagrał ścieżki, jak te w trwałej pamięci, następnie można nadal stosować.
+
+Te ścieżki były wcześniej wystawione w `fullPath` właściwości `FileEntry` i `DirectoryEntry` obiektów zwróconych przez wtyczki pliku. Nowe wersje pliku plugin, jednak już wystawiać te ścieżki do JavaScript.
+
+Jeśli uaktualniasz nowy (1.0.0 lub nowsza) wersji pliku, a wcześniej za pomocą `entry.fullPath` jako argumenty do `download()` lub `upload()` , a następnie trzeba będzie zmienić kod aby używać adresów URL plików zamiast.
+
+`FileEntry.toURL()`i `DirectoryEntry.toURL()` zwraca adres URL plików formularza
+
+ cdvfile://localhost/persistent/path/to/file
+
+
+które mogą być używane zamiast bezwzględna ścieżka w obu `download()` i `upload()` metody.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/131f84f1/doc/zh/index.md
----------------------------------------------------------------------
diff --git a/doc/zh/index.md b/doc/zh/index.md
new file mode 100644
index 0000000..36a3b15
--- /dev/null
+++ b/doc/zh/index.md
@@ -0,0 +1,281 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# org.apache.cordova.file-transfer
+
+這個外掛程式允許你上傳和下載檔案。
+
+## 安裝
+
+ cordova plugin add org.apache.cordova.file-transfer
+
+
+## 支援的平臺
+
+* 亞馬遜火 OS
+* Android 系統
+* 黑莓 10 *
+* iOS
+* Windows Phone 7 和 8 *
+* Windows 8 *
+
+**不支援 `onprogress` ，也不 `abort()` *
+
+# 檔案傳輸
+
+`FileTransfer`物件提供一種方法來使用 HTTP 多部分 POST 請求的檔上傳和下載檔案，以及。
+
+## 屬性
+
+* **onprogress**： 使用調用 `ProgressEvent` 每當一塊新的資料傳輸。*（函數）*
+
+## 方法
+
+* **上傳**： 將檔發送到伺服器。
+
+* **下載**： 從伺服器上下載檔案。
+
+* **中止**: 中止正在進行轉讓。
+
+## 上傳
+
+**參數**：
+
+* **fileURL**： 表示檔在設備上的檔案系統 URL。 為向後相容性，這也可以將設備上的檔的完整路徑。 （請參見 [向後相容性注意到] 下面)
+
+* **伺服器**： 伺服器以接收該檔，由編碼的 URL`encodeURI()`.
+
+* **successCallback**： 傳遞一個回檔 `Metadata` 物件。*（函數）*
+
+* **errorCallback**： 回檔的執行如果出現檢索錯誤 `Metadata` 。調用與 `FileTransferError` 物件。*（函數）*
+
+* **trustAllHosts**: 可選參數，預設值為 `false` 。 如果設置為 `true` ，它可以接受的所有安全證書。 由於 Android 拒絕自行簽署式安全證書，這非常有用。 不建議供生產使用。 在 Android 和 iOS 上受支援。 *(布林值)*
+
+* **選項**： 可選參數*（物件）*。有效的金鑰：
+
+ * **fileKey**： 表單元素的名稱。預設值為 `file` 。() DOMString
+ * **檔案名**： 要保存在伺服器上的檔時使用的檔案名稱。預設值為 `image.jpg` 。() DOMString
+ * **mimeType**： 要上傳的資料的 mime 類型。預設值為 `image/jpeg` 。() DOMString
+ * **params**： 一組可選的鍵/值對中的 HTTP 要求的傳遞。（物件）
+ * **chunkedMode**： 是否要分塊流式處理模式中的資料上載。預設值為 `true` 。(布林值)
+ * **標題**： 一張地圖的標頭名稱/標頭值。使用陣列來指定多個值。（物件）
+
+### 示例
+
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
+
+ var win = function (r) {
+ console.log("Code = " + r.responseCode);
+ console.log("Response = " + r.response);
+ console.log("Sent = " + r.bytesSent);
+ }
+
+ var fail = function (error) {
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey = "file";
+ options.fileName = fileURL.substr(fileURL.lastIndexOf('/') + 1);
+ options.mimeType = "text/plain";
+
+ var params = {};
+ params.value1 = "test";
+ params.value2 = "param";
+
+ options.params = params;
+
+ var ft = new FileTransfer();
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+
+
+### 與上傳的標頭和進度事件 （Android 和 iOS 只） 的示例
+
+ function win(r) {
+ console.log("Code = " + r.responseCode);
+ console.log("Response = " + r.response);
+ console.log("Sent = " + r.bytesSent);
+ }
+
+ function fail(error) {
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var uri = encodeURI("http://some.server.com/upload.php");
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName=fileURL.substr(fileURL.lastIndexOf('/')+1);
+ options.mimeType="text/plain";
+
+ var headers={'headerParam':'headerValue'};
+
+ options.headers = headers;
+
+ var ft = new FileTransfer();
+ ft.onprogress = function(progressEvent) {
+ if (progressEvent.lengthComputable) {
+ loadingStatus.setPercentage(progressEvent.loaded / progressEvent.total);
+ } else {
+ loadingStatus.increment();
+ }
+ };
+ ft.upload(fileURL, uri, win, fail, options);
+
+
+## FileUploadResult
+
+A `FileUploadResult` 物件傳遞給成功回檔的 `FileTransfer` 物件的 `upload()` 方法。
+
+### 屬性
+
+* **位元組發送**： 作為上載的一部分發送到伺服器的位元組數。(長)
+
+* **responseCode**： 由伺服器返回的 HTTP 回應代碼。(長)
+
+* **回應**： 由伺服器返回的 HTTP 回應。() DOMString
+
+* **標題**： 由伺服器的 HTTP 回應標頭。（物件）
+
+ * 目前支援的 iOS 只。
+
+### iOS 的怪癖
+
+* 不支援 `responseCode` 或`bytesSent`.
+
+## 下載
+
+**參數**：
+
+* **來源**： 要下載的檔，如由編碼的伺服器的 URL`encodeURI()`.
+
+* **目標**： 表示檔在設備上的檔案系統 url。 為向後相容性，這也可以將設備上的檔的完整路徑。 （請參見 [向後相容性注意到] 下面)
+
+* **successCallback**： 傳遞一個回檔 `FileEntry` 物件。*（函數）*
+
+* **errorCallback**： 如果錯誤發生在檢索時將執行的回檔 `Metadata` 。調用與 `FileTransferError` 物件。*（函數）*
+
+* **trustAllHosts**: 可選參數，預設值為 `false` 。 如果設置為 `true` ，它可以接受的所有安全證書。 這是有用的因為 Android 拒絕自行簽署式安全證書。 不建議供生產使用。 在 Android 和 iOS 上受支援。 *(布林值)*
+
+* **選項**： 可選參數，目前只支援標題 （如授權 （基本驗證） 等）。
+
+### 示例
+
+ // !! Assumes variable fileURL contains a valid URL to a path on the device,
+ // for example, cdvfile://localhost/persistent/path/to/downloads/
+
+ var fileTransfer = new FileTransfer();
+ var uri = encodeURI("http://some.server.com/download.php");
+
+ fileTransfer.download(
+ uri,
+ fileURL,
+ function(entry) {
+ console.log("download complete: " + entry.fullPath);
+ },
+ function(error) {
+ console.log("download error source " + error.source);
+ console.log("download error target " + error.target);
+ console.log("upload error code" + error.code);
+ },
+ false,
+ {
+ headers: {
+ "Authorization": "Basic dGVzdHVzZXJuYW1lOnRlc3RwYXNzd29yZA=="
+ }
+ }
+ );
+
+
+## 中止
+
+中止正在進行轉讓。Onerror 回檔傳遞的錯誤代碼為 FileTransferError.ABORT_ERR 的 FileTransferError 物件。
+
+### 示例
+
+ // !! Assumes variable fileURL contains a valid URL to a text file on the device,
+ // for example, cdvfile://localhost/persistent/path/to/file.txt
+
+ var win = function(r) {
+ console.log("Should not be called.");
+ }
+
+ var fail = function(error) {
+ // error.code == FileTransferError.ABORT_ERR
+ alert("An error has occurred: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName="myphoto.jpg";
+ options.mimeType="image/jpeg";
+
+ var ft = new FileTransfer();
+ ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.abort();
+
+
+## FileTransferError
+
+A `FileTransferError` 物件傳遞到錯誤回檔時出現錯誤。
+
+### 屬性
+
+* **代碼**： 下面列出的預定義的錯誤代碼之一。（人數）
+
+* **源**： 源的 URL。（字串）
+
+* **目標**： 到目標 URL。（字串）
+
+* **HTTP_status**： HTTP 狀態碼。從 HTTP 連接收到一個回應代碼時，此屬性才可用。（人數）
+
+### 常量
+
+* `FileTransferError.FILE_NOT_FOUND_ERR`
+* `FileTransferError.INVALID_URL_ERR`
+* `FileTransferError.CONNECTION_ERR`
+* `FileTransferError.ABORT_ERR`
+
+## 向後相容性注意到
+
+以前版本的這個外掛程式將只接受設備絕對檔路徑作為源的上載，或為下載的目標。這些路徑通常將表單的
+
+ /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
+ /storage/emulated/0/path/to/file (Android)
+
+
+為向後相容性，這些路徑仍被接受，和如果您的應用程式已錄得像這些持久性存儲區中的路徑，然後他們可以繼續使用。
+
+這些路徑以前被暴露在 `fullPath` 屬性的 `FileEntry` 和 `DirectoryEntry` 由檔外掛程式返回的物件。 新版本的檔的外掛程式，不過，不再公開這些 JavaScript 的路徑。
+
+如果您要升級到一個新的 (1.0.0 或更高版本） 版本的檔，和你以前一直在使用 `entry.fullPath` 作為的參數 `download()` 或 `upload()` ，那麼您將需要更改您的代碼，而使用的檔案系統的 Url。
+
+`FileEntry.toURL()`和 `DirectoryEntry.toURL()` 返回的表單檔案系統 URL
+
+ cdvfile://localhost/persistent/path/to/file
+
+
+可以使用在中兩者的絕對檔路徑位置 `download()` 和 `upload()` 方法。
\ No newline at end of file