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:46 UTC
[01/14] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-file-transfer
Repository: cordova-plugin-file-transfer
Updated Branches:
refs/heads/master 1adf1c7a1 -> 9035d7956
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/dd73f9b3
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/dd73f9b3
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/dd73f9b3
Branch: refs/heads/master
Commit: dd73f9b3af66ca1a271dc3509f256903a2837897
Parents: 3c36ee1
Author: ldeluca <ld...@us.ibm.com>
Authored: Wed Feb 26 09:36:03 2014 -0500
Committer: ldeluca <ld...@us.ibm.com>
Committed: Wed Feb 26 09:36:03 2014 -0500
----------------------------------------------------------------------
doc/es/index.md | 253 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 253 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/dd73f9b3/doc/es/index.md
----------------------------------------------------------------------
diff --git a/doc/es/index.md b/doc/es/index.md
new file mode 100644
index 0000000..126f93a
--- /dev/null
+++ b/doc/es/index.md
@@ -0,0 +1,253 @@
+<!---
+ 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
+
+Este plugin te permite cargar y descargar archivos.
+
+## Instalación
+
+ cordova plugin add org.apache.cordova.file-transfer
+
+
+## Plataformas soportadas
+
+* Amazon fuego OS
+* Android
+* BlackBerry 10 *
+* iOS
+* Windows Phone 7 y 8 *
+* Windows 8 *
+
+* *No son compatibles con `onprogress` ni `abort()` *
+
+# File Transfer
+
+El `FileTransfer` objeto proporciona una manera de subir archivos mediante una solicitud HTTP de POST varias parte y para descargar archivos.
+
+## Propiedades
+
+* **OnProgress**: llama con un `ProgressEvent` cuando se transfiere un nuevo paquete de datos. *(Función)*
+
+## Métodos
+
+* **cargar**: envía un archivo a un servidor.
+
+* **Descargar**: descarga un archivo del servidor.
+
+* **abortar**: aborta una transferencia en curso.
+
+## subir
+
+**Parámetros**:
+
+* **ruta**: ruta de acceso completa del archivo en el dispositivo.
+
+* **servidor**: dirección URL del servidor para recibir el archivo, como codificada por`encodeURI()`.
+
+* **successCallback**: una devolución de llamada que se pasa un `Metadata` objeto. *(Función)*
+
+* **errorCallback**: una devolución de llamada que se ejecuta si se produce un error recuperar la `Metadata` . Invocado con un `FileTransferError` objeto. *(Función)*
+
+* **trustAllHosts**: parámetro opcional, por defecto es `false` . Si establece en `true` , acepta todos los certificados de seguridad. Esto es útil ya que Android rechaza certificados autofirmados seguridad. No se recomienda para uso productivo. Compatible con iOS y Android. *(boolean)*
+
+* **Opciones**: parámetros opcionales *(objeto)*. Teclas válidas:
+
+ * **fileKey**: el nombre del elemento de formulario. Por defecto es `file` . (DOMString)
+ * **nombre de archivo**: el nombre del archivo a utilizar al guardar el archivo en el servidor. Por defecto es `image.jpg` . (DOMString)
+ * **mimeType**: el tipo mime de los datos para cargar. Por defecto es `image/jpeg` . (DOMString)
+ * **params**: un conjunto de pares clave/valor opcional para pasar en la petición HTTP. (Objeto)
+ * **chunkedMode**: Si desea cargar los datos en modo de transmisión fragmentado. Por defecto es `true` . (Boolean)
+ * **cabeceras**: un mapa de valores de encabezado nombre/cabecera. Utilice una matriz para especificar más de un valor. (Objeto)
+
+### Ejemplo
+
+ // !! Assumes variable fileURI contains a valid URI to a text file on the device
+
+ 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 = fileURI.substr(fileURI.lastIndexOf('/') + 1);
+ options.mimeType = "text/plain";
+
+ var params = {};
+ params.value1 = "test";
+ params.value2 = "param";
+
+ options.params = params;
+
+ var ft = new FileTransfer();
+ ft.upload(fileURI, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+
+
+### Ejemplo con cabeceras de subir y eventos de progreso (Android y iOS solamente)
+
+ 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=fileURI.substr(fileURI.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(fileURI, uri, win, fail, options);
+
+
+## FileUploadResult
+
+A `FileUploadResult` objeto se pasa a la devolución del éxito de la `FileTransfer` del objeto `upload()` método.
+
+### Propiedades
+
+* **bytesSent**: el número de bytes enviados al servidor como parte de la carga. (largo)
+
+* **responseCode**: código de respuesta HTTP el devuelto por el servidor. (largo)
+
+* **respuesta**: respuesta el HTTP devuelto por el servidor. (DOMString)
+
+### iOS rarezas
+
+* No es compatible con `responseCode` o`bytesSent`.
+
+## descargar
+
+**Parámetros**:
+
+* **fuente**: dirección URL del servidor para descargar el archivo, como codificada por`encodeURI()`.
+
+* **objetivo**: ruta de acceso completa del archivo en el dispositivo.
+
+* **successCallback**: una devolución de llamada que se pasa un `FileEntry` objeto. *(Función)*
+
+* **errorCallback**: una devolución de llamada que se ejecuta si se produce un error al recuperar los `Metadata` . Invocado con un `FileTransferError` objeto. *(Función)*
+
+* **trustAllHosts**: parámetro opcional, por defecto es `false` . Si establece en `true` , acepta todos los certificados de seguridad. Esto es útil porque Android rechaza certificados autofirmados seguridad. No se recomienda para uso productivo. Compatible con iOS y Android. *(boolean)*
+
+* **Opciones**: parámetros opcionales, actualmente sólo soporta cabeceras (como autorización (autenticación básica), etc.).
+
+### Ejemplo
+
+ // !! Assumes filePath is a valid path on the device
+
+ var fileTransfer = new FileTransfer();
+ var uri = encodeURI("http://some.server.com/download.php");
+
+ fileTransfer.download(
+ uri,
+ filePath,
+ 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=="
+ }
+ }
+ );
+
+
+## abortar
+
+Aborta a una transferencia en curso. El callback onerror se pasa un objeto FileTransferError que tiene un código de error de FileTransferError.ABORT_ERR.
+
+### Ejemplo
+
+ // !! Assumes variable fileURI contains a valid URI to a text file on the device
+
+ 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(fileURI, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.abort();
+
+
+## FileTransferError
+
+A `FileTransferError` objeto se pasa a un callback de error cuando se produce un error.
+
+### Propiedades
+
+* **código**: uno de los códigos de error predefinido enumerados a continuación. (Número)
+
+* **fuente**: URI a la fuente. (String)
+
+* **objetivo**: URI 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)
+
+### Constantes
+
+* `FileTransferError.FILE_NOT_FOUND_ERR`
+* `FileTransferError.INVALID_URL_ERR`
+* `FileTransferError.CONNECTION_ERR`
+* `FileTransferError.ABORT_ERR`
\ No newline at end of file
[13/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/4ea02c97
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/4ea02c97
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/4ea02c97
Branch: refs/heads/master
Commit: 4ea02c972a16ea62f4c3b26dd59c0adf0876100a
Parents: 64956fa 318c941
Author: ldeluca <ld...@us.ibm.com>
Authored: Mon Jun 23 12:24:42 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Mon Jun 23 12:24:42 2014 -0400
----------------------------------------------------------------------
doc/index.md | 8 +++----
www/windows8/FileTransferProxy.js | 41 ++++++++++++++++++++++++++--------
2 files changed, 36 insertions(+), 13 deletions(-)
----------------------------------------------------------------------
[02/14] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-file-transfer
Posted by ld...@apache.org.
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/89986af8
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/89986af8
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/89986af8
Branch: refs/heads/master
Commit: 89986af8f05df606959822c76f269eed8ce034c9
Parents: dd73f9b
Author: ldeluca <ld...@us.ibm.com>
Authored: Thu Feb 27 11:14:43 2014 -0500
Committer: ldeluca <ld...@us.ibm.com>
Committed: Thu Feb 27 11:14:43 2014 -0500
----------------------------------------------------------------------
doc/fr/index.md | 253 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 253 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/89986af8/doc/fr/index.md
----------------------------------------------------------------------
diff --git a/doc/fr/index.md b/doc/fr/index.md
new file mode 100644
index 0000000..a50641c
--- /dev/null
+++ b/doc/fr/index.md
@@ -0,0 +1,253 @@
+<!---
+ 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
+
+Ce plugin vous permet de télécharger des fichiers.
+
+## Installation
+
+ cordova plugin add org.apache.cordova.file-transfer
+
+
+## Plates-formes prises en charge
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10 *
+* iOS
+* Windows Phone 7 et 8 *
+* Windows 8 *
+
+* *Ne supportent pas `onprogress` ni `abort()` *
+
+# 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.
+
+## Propriétés
+
+* **onprogress** : fonction appelée avec un `ProgressEvent` à chaque fois qu'un nouveau segment de données est transféré. *(Function)*
+
+## Méthodes
+
+* **upload** : envoie un fichier à un serveur.
+
+* **download** : télécharge un fichier depuis un serveur.
+
+* **abort** : annule le transfert en cours.
+
+## upload
+
+**Paramètres**:
+
+* **filePath** : chemin d'accès complet au fichier sur l'appareil.
+
+* **server** : l'URL du serveur destiné à recevoir le fichier, encodée via `encodeURI()`.
+
+* **successCallback**: un callback passé à un objet `Metadata`. *(Fonction)*
+
+* **errorCallback** : callback d'erreur s'exécutant si une erreur survient lors de la récupération de l'objet `Metadata` . Appelée avec un objet `FileTransferError`. *(Function)*
+
+* **trustAllHosts** : paramètre facultatif, sa valeur par défaut est `false`. Si sa valeur est réglée à `true`, tous les certificats de sécurité sont acceptés. Ceci peut être utile car Android rejette les certificats auto-signés. N'est pas recommandé pour une utilisation en production. Supporté sous Android et iOS. *(boolean)*
+
+* **options**: paramètres facultatifs *(objet)*. Clés valides :
+
+ * **fileKey** : le nom de l'élément form. La valeur par défaut est `file`. (DOMString)
+ * **fileName** : le nom de fichier à utiliser pour l'enregistrement sur le serveur. La valeur par défaut est `image.jpg`. (DOMString)
+ * **mimeType** : le type mime des données à envoyer. La valeur par défaut est `image/jpeg`. (DOMString)
+ * **params** : un ensemble de paires clé/valeur facultative à passer dans la requête HTTP. (Objet)
+ * **chunkedMode** : s'il faut transmettre ou non les données en mode streaming de bloc. La valeur par défaut est `true`. (Boolean)
+ * **headers** : un objet représentant les noms et valeurs d'en-têtes à transmettre. Utiliser un tableau permet de spécifier plusieurs valeurs. (Objet)
+
+### Exemple
+
+ // !! Assumes variable fileURI contains a valid URI to a text file on the device
+
+ 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 = fileURI.substr(fileURI.lastIndexOf('/') + 1);
+ options.mimeType = "text/plain";
+
+ var params = {};
+ params.value1 = "test";
+ params.value2 = "param";
+
+ options.params = params;
+
+ var ft = new FileTransfer();
+ ft.upload(fileURI, 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)
+
+ 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=fileURI.substr(fileURI.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(fileURI, uri, win, fail, options);
+
+
+## FileUploadResult
+
+Un objet `FileUploadResult` est passé à la callback de succès de la méthode `upload()` de l'objet `FileTransfer`.
+
+### Propriétés
+
+* **bytesSent** : le nombre d'octets envoyés au serveur dans le cadre du téléchargement. (long)
+
+* **responseCode** : le code de réponse HTTP retourné par le serveur. (long)
+
+* **response** : la réponse HTTP renvoyée par le serveur. (DOMString)
+
+### iOS Quirks
+
+* Ne prend pas en charge les propriétés `responseCode` et `bytesSent`.
+
+## download
+
+**Paramètres**:
+
+* **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.
+
+* **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)*
+
+* **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
+
+ var fileTransfer = new FileTransfer();
+ var uri = encodeURI("http://some.server.com/download.php");
+
+ fileTransfer.download(
+ uri,
+ filePath,
+ function(entry) {
+ console.log("Téléchargement terminé : " + 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);
+ },
+ false,
+ {
+ headers: {
+ "Authorization": "Basic dGVzdHVzZXJuYW1lOnRlc3RwYXNzd29yZA=="
+ }
+ }
+ );
+
+
+## abort
+
+Abandonne un transfert en cours. Un objet FileTransferError avec un code d'erreur FileTransferError.ABORT_ERR est passé à la callback d'erreur onerror.
+
+### Exemple
+
+ // !! Suppose que la variable fileURI contient l'URI valide d'un fichier texte sur l'appareil
+
+ var win = function(r) {
+ console.log("Ne devrait pas être appelée.");
+ }
+
+ 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);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName="myphoto.jpg";
+ options.mimeType="image/jpeg";
+
+ var ft = new FileTransfer();
+ ft.upload(fileURI, encodeURI("http://some.server.com/upload.php"), win, fail, options);
+ ft.abort();
+
+
+## FileTransferError
+
+Un objet `FileTransferError` est passé à une callback d'erreur lorsqu'une erreur survient.
+
+### Propriétés
+
+* **code** : l'un des codes d'erreur prédéfinis énumérés ci-dessous. (Number)
+
+* **source** : l'URI de la source. (String)
+
+* **target**: l'URI de la destination. (String)
+
+* **http_status** : code d'état HTTP. Cet attribut n'est disponible que lorsqu'un code de réponse est fourni via la connexion HTTP. (Number)
+
+### Constantes
+
+* `FileTransferError.FILE_NOT_FOUND_ERR`
+* `FileTransferError.INVALID_URL_ERR`
+* `FileTransferError.CONNECTION_ERR`
+* `FileTransferError.ABORT_ERR`
\ No newline at end of file
[12/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/64956fab
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/64956fab
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/64956fab
Branch: refs/heads/master
Commit: 64956fab546c646302e28b028e04faa7447c23b0
Parents: 1a16768 1bc00a2
Author: ldeluca <ld...@us.ibm.com>
Authored: Wed Jun 11 18:57:03 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Wed Jun 11 18:57:03 2014 -0400
----------------------------------------------------------------------
doc/index.md | 3 ++-
src/android/FileTransfer.java | 37 ++++++++++++++++++++++---------------
2 files changed, 24 insertions(+), 16 deletions(-)
----------------------------------------------------------------------
[14/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/9035d795
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/9035d795
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/9035d795
Branch: refs/heads/master
Commit: 9035d79566cb79ed40544b8f083b046ee44f9e22
Parents: 4ea02c9 1adf1c7
Author: ldeluca <ld...@us.ibm.com>
Authored: Fri Jun 27 12:54:02 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Fri Jun 27 12:54:02 2014 -0400
----------------------------------------------------------------------
RELEASENOTES.md | 2 ++
1 file changed, 2 insertions(+)
----------------------------------------------------------------------
[05/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/a518eb99
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/a518eb99
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/a518eb99
Branch: refs/heads/master
Commit: a518eb99174b30190d9e75227818a57f74624a6e
Parents: b8ff53c 2ecc685
Author: ldeluca <ld...@us.ibm.com>
Authored: Mon May 5 10:01:26 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Mon May 5 10:01:26 2014 -0400
----------------------------------------------------------------------
CONTRIBUTING.md | 16 ++++++
RELEASENOTES.md | 13 +++++
plugin.xml | 21 +++++++-
src/android/FileTransfer.java | 9 +---
src/ios/CDVFileTransfer.h | 2 +-
src/ios/CDVFileTransfer.m | 56 ++++++++++++---------
src/wp/FileTransfer.cs | 90 +++++++++++++++++-----------------
www/windows8/FileTransferProxy.js | 2 +-
8 files changed, 130 insertions(+), 79 deletions(-)
----------------------------------------------------------------------
[04/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/b8ff53ca
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/b8ff53ca
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/b8ff53ca
Branch: refs/heads/master
Commit: b8ff53cabeda3d3dc1a9371fc7820e8ac6b3d3ae
Parents: 60b50a7 05786ec
Author: ldeluca <ld...@us.ibm.com>
Authored: Fri Mar 28 12:09:51 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Fri Mar 28 12:09:51 2014 -0400
----------------------------------------------------------------------
src/amazon/FileTransfer.java | 53 +++++++++++++++++++++++++--------------
1 file changed, 34 insertions(+), 19 deletions(-)
----------------------------------------------------------------------
[07/14] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-file-transfer
Posted by ld...@apache.org.
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/0a2e3cb6
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/0a2e3cb6
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/0a2e3cb6
Branch: refs/heads/master
Commit: 0a2e3cb62f9f699a28148645bae9565dd6506ac4
Parents: 3fb0405
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 17:49:32 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 17:49:32 2014 -0400
----------------------------------------------------------------------
doc/ja/index.md | 281 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 281 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/0a2e3cb6/doc/ja/index.md
----------------------------------------------------------------------
diff --git a/doc/ja/index.md b/doc/ja/index.md
new file mode 100644
index 0000000..b57d591
--- /dev/null
+++ b/doc/ja/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
+
+This plugin allows you to upload and download files.
+
+## インストール
+
+ cordova plugin add org.apache.cordova.file-transfer
+
+
+## サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド
+* BlackBerry 10*
+* iOS
+* Windows Phone 7 and 8*
+* Windows 8*
+
+* *Do not support `onprogress` nor `abort()`*
+
+# ファイル転送
+
+The `FileTransfer` object provides a way to upload files using an HTTP multi-part POST request, and to download files as well.
+
+## プロパティ
+
+* **onprogress**: と呼ばれる、 `ProgressEvent` データの新しいチャンクが転送されるたびに。*(機能)*
+
+## メソッド
+
+* **アップロード**: サーバーにファイルを送信します。
+
+* **ダウンロード**: サーバーからファイルをダウンロードします。
+
+* **中止**: 進行中の転送を中止します。
+
+## アップロード
+
+**パラメーター**:
+
+* **fileURL**: Filesystem URL representing the file on the device. For backwards compatibility, this can also be the full path of the file on the device. （参照してください [後方互換性メモ] の下)
+
+* **サーバー**: によって符号化されるように、ファイルを受信するサーバーの URL`encodeURI()`.
+
+* **successCallback**: 渡されたコールバックを `Metadata` オブジェクト。*(機能)*
+
+* **解り**: エラー取得が発生した場合に実行されるコールバック、 `Metadata` 。呼び出されると、 `FileTransferError` オブジェクト。*(機能)*
+
+* **trustAllHosts**: 省略可能なパラメーターは、デフォルト `false` 。 場合設定 `true` 、セキュリティ証明書をすべて受け付けます。 これは Android の自己署名入りセキュリティ証明書を拒否するので便利です。 運用環境で使用しないでください。 Android と iOS でサポートされています。 *(ブール値)*
+
+* **options**: Optional parameters *(Object)*. Valid keys:
+
+ * **fileKey**: フォーム要素の名前。既定値は `file` です。（，）
+ * **ファイル名**： ファイル名、サーバー上のファイルを保存するときに使用します。既定値は `image.jpg` です。（，）
+ * **mime タイプ**: アップロードするデータの mime タイプ。既定値は `image/jpeg` です。（，）
+ * **params**: HTTP リクエストに渡すために任意のキー/値ペアのセット。(オブジェクト)
+ * **chunkedMode**: チャンク ストリーミング モードでデータをアップロードするかどうか。既定値は `true` です。(ブール値)
+ * **ヘッダー**: ヘッダーの名前/ヘッダー値のマップ。1 つ以上の値を指定するには、配列を使用します。(オブジェクト)
+
+### 例
+
+ // !! 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);
+
+
+### Example with Upload Headers and Progress Events (Android and iOS only)
+
+ 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**: アップロードの一部としてサーバーに送信されたバイト数。（ロング）
+
+* **記述**: サーバーによって返される HTTP 応答コード。（ロング）
+
+* **応答**: サーバーによって返される HTTP 応答。（，）
+
+* **ヘッダー**: HTTP 応答ヘッダー サーバーによって。(オブジェクト)
+
+ * 現在 iOS のみでサポートされます。
+
+### iOS の癖
+
+* サポートしていない `responseCode` または`bytesSent`.
+
+## ダウンロード
+
+**パラメーター**:
+
+* **ソース**: によって符号化されるように、ファイルをダウンロードするサーバーの URL`encodeURI()`.
+
+* **ターゲット**: デバイス上のファイルを表すファイルシステム url。 下位互換性は、このことも、デバイス上のファイルの完全パスであります。 （参照してください [後方互換性メモ] の下)
+
+* **successCallback**: 渡されたコールバックを `FileEntry` オブジェクト。*(機能)*
+
+* **解り**: コールバックを取得するときにエラーが発生した場合に実行される、 `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` ファイル プラグインによって返されるオブジェクト。 新しいプラグインのバージョン、ファイル、ただし、もはや java スクリプトの設定をこれらのパスを公開します。
+
+新しいにアップグレードする場合 (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
[11/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/1a16768f
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/1a16768f
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/1a16768f
Branch: refs/heads/master
Commit: 1a16768fd1d9202e0417011087b99d037a6f0a97
Parents: df530ad 6908242
Author: ldeluca <ld...@us.ibm.com>
Authored: Wed Jun 11 09:57:44 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Wed Jun 11 09:57:44 2014 -0400
----------------------------------------------------------------------
CONTRIBUTING.md | 21 ++++++++++
RELEASENOTES.md | 14 +++++++
plugin.xml | 2 +-
src/android/FileTransfer.java | 23 ++++++++++-
src/ubuntu/file-transfer.cpp | 80 +++++++++++++++++++++++---------------
src/ubuntu/file-transfer.h | 14 +++++--
6 files changed, 117 insertions(+), 37 deletions(-)
----------------------------------------------------------------------
[03/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/60b50a72
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/60b50a72
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/60b50a72
Branch: refs/heads/master
Commit: 60b50a72bd1f65b9678d845cadae8cb69e1780f7
Parents: 89986af c0c91d0
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue Mar 4 12:43:12 2014 -0500
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue Mar 4 12:43:12 2014 -0500
----------------------------------------------------------------------
NOTICE | 8 +++
RELEASENOTES.md | 11 ++++
doc/index.md | 50 ++++++++++++-----
plugin.xml | 4 +-
src/android/FileTransfer.java | 38 +++++++++----
src/ios/CDVFileTransfer.h | 6 +-
src/ios/CDVFileTransfer.m | 109 ++++++++++++++++++++++---------------
src/wp/FileTransfer.cs | 2 +-
www/FileTransfer.js | 3 +-
9 files changed, 159 insertions(+), 72 deletions(-)
----------------------------------------------------------------------
[08/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/9795c146
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/9795c146
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/9795c146
Branch: refs/heads/master
Commit: 9795c1467d7ac24594b72a8d9937d95cbe894c72
Parents: 0a2e3cb 156ae20
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 19:34:24 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 19:34:24 2014 -0400
----------------------------------------------------------------------
src/wp/FileTransfer.cs | 2 ++
1 file changed, 2 insertions(+)
----------------------------------------------------------------------
[10/14] git commit: documentation translation:
cordova-plugin-file-transfer
Posted by ld...@apache.org.
documentation translation: 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/df530ad5
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/df530ad5
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/df530ad5
Branch: refs/heads/master
Commit: df530ad57beafdb5d0d1b39e4ed1c406936a8813
Parents: 131f84f
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 21:36:29 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 21:36:29 2014 -0400
----------------------------------------------------------------------
doc/de/index.md | 281 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ja/index.md | 18 ++--
2 files changed, 290 insertions(+), 9 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/df530ad5/doc/de/index.md
----------------------------------------------------------------------
diff --git a/doc/de/index.md b/doc/de/index.md
new file mode 100644
index 0000000..b767161
--- /dev/null
+++ b/doc/de/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
+
+Dieses Plugin ermöglicht Ihnen zum Hochladen und Herunterladen von Dateien.
+
+## Installation
+
+ cordova plugin add org.apache.cordova.file-transfer
+
+
+## Unterstützte Plattformen
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10 *
+* iOS
+* Windows Phone 7 und 8 *
+* Windows 8 *
+
+* *Unterstützen nicht `onprogress` noch `abort()` *
+
+# FileTransfer
+
+Das `FileTransfer` Objekt bietet eine Möglichkeit zum Hochladen von Dateien, die mithilfe einer HTTP-Anforderung für mehrteiligen POST sowie Informationen zum Herunterladen von Dateien sowie.
+
+## Eigenschaften
+
+* **OnProgress**: aufgerufen, wobei ein `ProgressEvent` wann wird eine neue Datenmenge übertragen. *(Funktion)*
+
+## Methoden
+
+* **Upload**: sendet eine Datei an einen Server.
+
+* **Download**: lädt eine Datei vom Server.
+
+* **Abbrechen**: Abbruch eine Übertragung in Bearbeitung.
+
+## Upload
+
+**Parameter**:
+
+* **FileURL**: Dateisystem-URL, das die Datei auf dem Gerät. Für rückwärts Kompatibilität, dies kann auch der vollständige Pfad der Datei auf dem Gerät sein. (Siehe [rückwärts Kompatibilität Notes] unten)
+
+* **Server**: URL des Servers, die Datei zu empfangen, wie kodiert`encodeURI()`.
+
+* **SuccessCallback**: ein Rückruf, der übergeben wird ein `Metadata` Objekt. *(Funktion)*
+
+* **ErrorCallback**: ein Rückruf, der ausgeführt wird, tritt ein Fehler beim Abrufen der `Metadata` . Aufgerufene mit einem `FileTransferError` Objekt. *(Funktion)*
+
+* **TrustAllHosts**: Optionaler Parameter, wird standardmäßig auf `false` . Wenn legen Sie auf `true` , es akzeptiert alle Sicherheitszertifikate. Dies ist nützlich, da Android selbstsignierte Zertifikate ablehnt. Nicht für den produktiven Einsatz empfohlen. Auf Android und iOS unterstützt. *(Boolean)*
+
+* **Optionen**: optionale Parameter *(Objekt)*. Gültige Schlüssel:
+
+ * **FileKey**: der Name des Form-Elements. Wird standardmäßig auf `file` . (DOM-String und enthält)
+ * **Dateiname**: der Dateiname beim Speichern der Datei auf dem Server verwendet. Wird standardmäßig auf `image.jpg` . (DOM-String und enthält)
+ * **MimeType**: den Mime-Typ der Daten hochzuladen. Wird standardmäßig auf `image/jpeg` . (DOM-String und enthält)
+ * **Params**: eine Reihe von optionalen Schlüssel/Wert-Paaren in der HTTP-Anforderung übergeben. (Objekt)
+ * **ChunkedMode**: ob die Daten in "Chunked" streaming-Modus hochladen. Wird standardmäßig auf `true` . (Boolean)
+ * **Header**: eine Karte von Header-Name-Header-Werte. Verwenden Sie ein Array, um mehr als einen Wert anzugeben. (Objekt)
+
+### Beispiel
+
+ // !! 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);
+
+
+### Beispiel mit hochladen Kopf- und Progress-Ereignisse (Android und iOS nur)
+
+ 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` -Objekt wird an den Erfolg-Rückruf des übergeben die `FileTransfer` des Objekts `upload()` Methode.
+
+### Eigenschaften
+
+* **BytesSent**: die Anzahl der Bytes, die als Teil des Uploads an den Server gesendet. (lange)
+
+* **ResponseCode**: die HTTP-Response-Code vom Server zurückgegeben. (lange)
+
+* **Antwort**: der HTTP-Antwort vom Server zurückgegeben. (DOM-String und enthält)
+
+* **Header**: die HTTP-Response-Header vom Server. (Objekt)
+
+ * Derzeit unterstützt auf iOS nur.
+
+### iOS Macken
+
+* Unterstützt keine `responseCode` oder`bytesSent`.
+
+## Download
+
+**Parameter**:
+
+* **Quelle**: URL des Servers, um die Datei herunterzuladen, wie kodiert`encodeURI()`.
+
+* **Ziel**: Dateisystem-Url, das die Datei auf dem Gerät. Für rückwärts Kompatibilität, dies kann auch der vollständige Pfad der Datei auf dem Gerät sein. (Siehe [rückwärts Kompatibilität Notes] unten)
+
+* **SuccessCallback**: ein Rückruf, der übergeben wird ein `FileEntry` Objekt. *(Funktion)*
+
+* **ErrorCallback**: ein Rückruf, der ausgeführt wird, tritt ein Fehler beim Abrufen der `Metadata` . Aufgerufene mit einem `FileTransferError` Objekt. *(Funktion)*
+
+* **TrustAllHosts**: Optionaler Parameter, wird standardmäßig auf `false` . Wenn legen Sie auf `true` , es akzeptiert alle Sicherheitszertifikate. Dies ist nützlich, da Android selbstsignierte Zertifikate ablehnt. Nicht für den produktiven Einsatz empfohlen. Auf Android und iOS unterstützt. *(Boolean)*
+
+* **Optionen**: optionale Parameter, derzeit nur unterstützt Kopfzeilen (z. B. Autorisierung (Standardauthentifizierung), etc.).
+
+### Beispiel
+
+ // !! 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=="
+ }
+ }
+ );
+
+
+## Abbruch
+
+Bricht einen in-Progress-Transfer. Der Onerror-Rückruf wird ein FileTransferError-Objekt übergeben, die einen Fehlercode FileTransferError.ABORT_ERR hat.
+
+### Beispiel
+
+ // !! 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` Objekt wird an eine Fehler-Callback übergeben, wenn ein Fehler auftritt.
+
+### Eigenschaften
+
+* **Code**: einer der vordefinierten Fehlercodes aufgeführt. (Anzahl)
+
+* **Quelle**: URL der Quelle. (String)
+
+* **Ziel**: URL zum Ziel. (String)
+
+* **HTTP_STATUS**: HTTP-Statuscode. Dieses Attribut ist nur verfügbar, wenn ein Response-Code aus der HTTP-Verbindung eingeht. (Anzahl)
+
+### Konstanten
+
+* `FileTransferError.FILE_NOT_FOUND_ERR`
+* `FileTransferError.INVALID_URL_ERR`
+* `FileTransferError.CONNECTION_ERR`
+* `FileTransferError.ABORT_ERR`
+
+## Hinweise rückwärts Kompatibilität
+
+Frühere Versionen des Plugins würde nur Gerät-Absolute-Dateipfade als Quelle für Uploads oder als Ziel für Downloads übernehmen. Diese Pfade wäre in der Regel der form
+
+ /var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
+ /storage/emulated/0/path/to/file (Android)
+
+
+Für rückwärts Kompatibilität, diese Pfade noch akzeptiert werden, und wenn Ihre Anwendung Pfade wie diese im permanenten Speicher aufgezeichnet hat, dann sie können weiter verwendet werden.
+
+Diese Pfade waren zuvor ausgesetzt, der `fullPath` -Eigenschaft des `FileEntry` und `DirectoryEntry` Objekte, die durch das Plugin Datei zurückgegeben. Neue Versionen der die Datei-Erweiterung, jedoch nicht länger werden diese Pfade zu JavaScript.
+
+Wenn Sie ein auf eine neue Upgrade (1.0.0 oder neuere) Version der Datei und Sie zuvor verwendet haben `entry.fullPath` als Argumente für `download()` oder `upload()` , dann du den Code musst, um die Dateisystem-URLs verwenden zu ändern.
+
+`FileEntry.toURL()`und `DirectoryEntry.toURL()` zurück, eine Dateisystem-URL in der Form
+
+ cdvfile://localhost/persistent/path/to/file
+
+
+die benutzt werden kann, anstelle der absoluten Dateipfad in beiden `download()` und `upload()` Methoden.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/df530ad5/doc/ja/index.md
----------------------------------------------------------------------
diff --git a/doc/ja/index.md b/doc/ja/index.md
index b57d591..ef7883a 100644
--- a/doc/ja/index.md
+++ b/doc/ja/index.md
@@ -19,7 +19,7 @@
# org.apache.cordova.file-transfer
-This plugin allows you to upload and download files.
+このプラグインは、アップロードし、ファイルをダウンロードすることができます。
## インストール
@@ -30,16 +30,16 @@ This plugin allows you to upload and download files.
* アマゾン火 OS
* アンドロイド
-* BlackBerry 10*
+* ブラックベリー 10 *
* iOS
-* Windows Phone 7 and 8*
-* Windows 8*
+* Windows Phone 7 と 8 *
+* Windows 8 *
-* *Do not support `onprogress` nor `abort()`*
+**サポートしていない `onprogress` も `abort()` *
# ファイル転送
-The `FileTransfer` object provides a way to upload files using an HTTP multi-part POST request, and to download files as well.
+`FileTransfer`オブジェクトはマルチパートのポスト、HTTP 要求を使用してファイルをアップロードして同様にファイルをダウンロードする方法を提供します。
## プロパティ
@@ -57,7 +57,7 @@ The `FileTransfer` object provides a way to upload files using an HTTP multi-par
**パラメーター**:
-* **fileURL**: Filesystem URL representing the file on the device. For backwards compatibility, this can also be the full path of the file on the device. （参照してください [後方互換性メモ] の下)
+* **fileURL**: デバイス上のファイルを表すファイルシステム URL。 下位互換性は、このことも、デバイス上のファイルの完全パスであります。 （参照してください [後方互換性メモ] の下)
* **サーバー**: によって符号化されるように、ファイルを受信するサーバーの URL`encodeURI()`.
@@ -67,7 +67,7 @@ The `FileTransfer` object provides a way to upload files using an HTTP multi-par
* **trustAllHosts**: 省略可能なパラメーターは、デフォルト `false` 。 場合設定 `true` 、セキュリティ証明書をすべて受け付けます。 これは Android の自己署名入りセキュリティ証明書を拒否するので便利です。 運用環境で使用しないでください。 Android と iOS でサポートされています。 *(ブール値)*
-* **options**: Optional parameters *(Object)*. Valid keys:
+* **オプション**: 省略可能なパラメーター *(オブジェクト)*。有効なキー:
* **fileKey**: フォーム要素の名前。既定値は `file` です。（，）
* **ファイル名**： ファイル名、サーバー上のファイルを保存するときに使用します。既定値は `image.jpg` です。（，）
@@ -108,7 +108,7 @@ The `FileTransfer` object provides a way to upload files using an HTTP multi-par
ft.upload(fileURL, encodeURI("http://some.server.com/upload.php"), win, fail, options);
-### Example with Upload Headers and Progress Events (Android and iOS only)
+### サンプルのアップロード ヘッダーと進行状況のイベント （Android と iOS のみ）
function win(r) {
console.log("Code = " + r.responseCode);
[06/14] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/3fb0405e
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/3fb0405e
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/3fb0405e
Branch: refs/heads/master
Commit: 3fb0405eb83caf7594fc558536d8ac06a4d81ed1
Parents: a518eb9 3bdf377
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 20 13:56:15 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 20 13:56:15 2014 -0400
----------------------------------------------------------------------
plugin.xml | 14 +-
src/android/FileTransfer.java | 44 ++---
www/blackberry10/FileTransferProxy.js | 36 ++++
www/blackberry10/XHRImplementation.js | 201 ----------------------
www/blackberry10/xhrFileTransfer.js | 259 +++++++++++++++++++++++++++++
5 files changed, 329 insertions(+), 225 deletions(-)
----------------------------------------------------------------------
[09/14] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-file-transfer
Posted by ld...@apache.org.
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