Repository: cordova-plugin-file-transfer Updated Branches: refs/heads/master 9035d7956 -> 04d45bab3
CB-6127lisa7cordova-plugin-consolecordova-plugin-file-transfer 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/04d45bab Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/tree/04d45bab Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/diff/04d45bab Branch: refs/heads/master Commit: 04d45bab345122a34d79b9c09c730955404f493f Parents: 9035d79 Author: Lisa Seacat DeLuca <[email protected]> Authored: Mon Jul 7 15:27:22 2014 -0400 Committer: Lisa Seacat DeLuca <[email protected]> Committed: Mon Jul 7 15:27:22 2014 -0400 ---------------------------------------------------------------------- doc/de/index.md | 12 ++- doc/es/index.md | 12 ++- doc/fr/index.md | 12 ++- doc/it/index.md | 12 ++- doc/ja/index.md | 12 ++- doc/ko/index.md | 12 ++- doc/ru/index.md | 283 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/zh/index.md | 12 ++- 8 files changed, 332 insertions(+), 35 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/de/index.md ---------------------------------------------------------------------- diff --git a/doc/de/index.md b/doc/de/index.md index b767161..d155cdc 100644 --- a/doc/de/index.md +++ b/doc/de/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` -Objekt wird an den Erfolg-Rückruf des übergeben die `Fil uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` Objekt wird an eine Fehler-Callback übergeben, wenn ein F * **HTTP_STATUS**: HTTP-Statuscode. Dieses Attribut ist nur verfügbar, wenn ein Response-Code aus der HTTP-Verbindung eingeht. (Anzahl) +* **Ausnahme**: entweder e.getMessage oder e.toString (String) + ### Konstanten -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## Hinweise rückwärts Kompatibilität http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/es/index.md ---------------------------------------------------------------------- diff --git a/doc/es/index.md b/doc/es/index.md index 4bb5e5d..fdf8e59 100644 --- a/doc/es/index.md +++ b/doc/es/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` objeto se pasa a la devolución del éxito de la `FileTrans uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` objeto se pasa a un callback de error cuando se produce un * **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) +* **excepción**: cualquier e.getMessage o e.toString (String) + ### Constantes -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## Al revés notas de compatibilidad http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/fr/index.md ---------------------------------------------------------------------- diff --git a/doc/fr/index.md b/doc/fr/index.md index defdba7..c9abc6a 100644 --- a/doc/fr/index.md +++ b/doc/fr/index.md @@ -192,7 +192,7 @@ Un objet `FileUploadResult` est passé à la callback de succès de la méthode uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ Un objet `FileTransferError` est passé à une callback d'erreur lorsqu'une erre * **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) +* **exception**: soit e.getMessage ou e.toString (String) + ### Constantes -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## Backwards Compatibility Notes http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/it/index.md ---------------------------------------------------------------------- diff --git a/doc/it/index.md b/doc/it/index.md index 89c32b4..ed74c91 100644 --- a/doc/it/index.md +++ b/doc/it/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` oggetto viene passato al metodo di callback di successo il uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` oggetto viene passato a un callback di errore quando si ve * **http_status**: codice di stato HTTP. Questo attributo è disponibile solo quando viene ricevuto un codice di risposta della connessione HTTP. (Numero) +* **eccezione**: O e.getMessage o e.toString (String) + ### Costanti -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## Note di compatibilità all'indietro http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/ja/index.md ---------------------------------------------------------------------- diff --git a/doc/ja/index.md b/doc/ja/index.md index ef7883a..f979fff 100644 --- a/doc/ja/index.md +++ b/doc/ja/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` ãªãã¸ã§ã¯ãã®æåæã®ã³ã¼ã«ããã¯ã«æ¸¡ uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` ãªãã¸ã§ã¯ãã¯ãã¨ã©ã¼ãçºçã¨ã©ã¼ ã³ã¼ * **http_status**: HTTP ã¹ãã¼ã¿ã¹ ã³ã¼ãããã®å±æ§ã¯ãHTTP æ¥ç¶ããå¿çã³ã¼ããåä¿¡ããã¨ãã«ã®ã¿ä½¿ç¨ã§ãã¾ãã(æ°) +* **ä¾å¤**: ã©ã¡ãã e.getMessage ã¾ã㯠e.toString (æåå) + ### 宿° -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## 徿¹äºææ§ããã¼ããã¾ãã http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/ko/index.md ---------------------------------------------------------------------- diff --git a/doc/ko/index.md b/doc/ko/index.md index 109cf80..55d8dcf 100644 --- a/doc/ko/index.md +++ b/doc/ko/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` ê°ì²´ì ì±ê³µ ì½ë°±ì ì ë¬ ëë `FileTransfer` ê° uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` ì¤ë¥ê° ë°ì íë©´ ì¤ë¥ ì½ë°± ê°ì²´ ì ë¬ ë©ë * **http_status**: HTTP ìí ì½ë. ì´ í¹ì±ì ìëµ ì½ë를 HTTP ì°ê²°ìì ìì ì ì¬ì©í ì ììµëë¤. (ì) +* **ìì¸**: ì´ë e.getMessage ëë e.toString (문ìì´) + ### ìì -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## ì´ì ë²ì ê³¼ í¸íì± ë ¸í¸ http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/ru/index.md ---------------------------------------------------------------------- diff --git a/doc/ru/index.md b/doc/ru/index.md new file mode 100644 index 0000000..8522365 --- /dev/null +++ b/doc/ru/index.md @@ -0,0 +1,283 @@ +<!--- + 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 + + +## ÐоддеÑживаемÑе плаÑÑоÑÐ¼Ñ + +* Amazon Fire ÐС +* Android +* BlackBerry 10 * +* iOS +* Windows Phone 7 и 8 * +* Windows 8 * + +* *Ðе поддеÑживаÑÑ `onprogress` , ни `abort()` * + +# FileTransfer + +`FileTransfer`ÐбÑÐµÐºÑ Ð¿ÑедоÑÑавлÑÐµÑ ÑпоÑоб Ð´Ð»Ñ Ð·Ð°Ð³ÑÑзки Ñайлов Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ Ð½ÐµÑколÑÐºÐ¸Ñ ÑаÑÑей запÑоÑа POST HTTP и Ð´Ð»Ñ Ð·Ð°Ð³ÑÑзки Ñайлов, а Ñакже. + +## СвойÑÑва + +* **OnProgress**: назÑваеÑÑÑ Ñ `ProgressEvent` вÑÑкий Ñаз, когда новÑй ÑÑÐ°Ð³Ð¼ÐµÐ½Ñ Ð´Ð°Ð½Ð½ÑÑ Ð¿ÐµÑедаеÑÑÑ. *(ФÑнкÑиÑ)* + +## ÐеÑÐ¾Ð´Ñ + +* **добавлено**: оÑпÑавлÑÐµÑ Ñайл на ÑеÑвеÑ. + +* **ÑкаÑаÑÑ**: СкаÑаÑÑ Ñайл Ñ ÑеÑвеÑа. + +* **пÑеÑваÑÑ**: пÑеÑÑÐ²Ð°ÐµÑ Ð¿ÐµÑедаÑÑ Ð² пÑогÑеÑÑ. + +## загÑÑзиÑÑ + +**ÐаÑамеÑÑÑ**: + +* **fileURL**: Ñайловой ÑиÑÑÐµÐ¼Ñ URL-адÑеÑ, пÑедÑÑавлÑÑÑий Ñайл на ÑÑÑÑойÑÑве. ÐÐ»Ñ Ð¾Ð±ÑаÑной ÑовмеÑÑимоÑÑи, ÑÑо Ñакже Ð¼Ð¾Ð¶ÐµÑ Ð±ÑÑÑ Ð¿Ð¾Ð»Ð½Ñй пÑÑÑ Ðº ÑÐ°Ð¹Ð»Ñ Ð½Ð° ÑÑÑÑойÑÑве. (См. [обÑаÑной ÑовмеÑÑимоÑÑи оÑмеÑаеÑ] ниже) + +* **ÑеÑвеÑ**: URL-адÑÐµÑ ÑеÑвеÑа, ÑÑÐ¾Ð±Ñ Ð¿Ð¾Ð»ÑÑиÑÑ Ñайл, как закодиÑованнÑе`encodeURI()`. + +* **successCallback**: обÑаÑного вÑзова, пеÑедаваемого `Metadata` обÑекÑ. *(ФÑнкÑиÑ)* + +* **errorCallback**: обÑаÑного вÑзова, коÑоÑÑй вÑполнÑеÑÑÑ Ð² ÑлÑÑае полÑÑÐµÐ½Ð¸Ñ Ð¾Ñибки `Metadata` . ÐÑзÑваемÑй Ñ `FileTransferError` обÑекÑ. *(ФÑнкÑиÑ)* + +* **trustAllHosts**: необÑзаÑелÑнÑй паÑамеÑÑ, по ÑмолÑÐ°Ð½Ð¸Ñ Ñавен `false` . ÐÑли знаÑение `true` , она пÑÐ¸Ð½Ð¸Ð¼Ð°ÐµÑ Ð²Ñе ÑеÑÑиÑикаÑÑ Ð±ÐµÐ·Ð¾Ð¿Ð°ÑноÑÑи. ÐÑо полезно, поÑколÑÐºÑ Android оÑвеÑÐ³Ð°ÐµÑ ÑамозавеÑÑÑÑие ÑеÑÑиÑикаÑÑ. Ðе ÑекомендÑеÑÑÑ Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð² пÑоизводÑÑве. ÐоддеÑживаеÑÑÑ Ð½Ð° Android и iOS. *(логиÑеÑкое знаÑение)* + +* **опÑии**: необÑзаÑелÑнÑе паÑамеÑÑÑ *(обÑекÑ)*. ÐопÑÑÑимÑе клÑÑи: + + * **fileKey**: Ð¸Ð¼Ñ ÑлеменÑа form. Ðо ÑмолÑÐ°Ð½Ð¸Ñ `file` . (DOMString) + * **Ð¸Ð¼Ñ Ñайла**: Ð¸Ð¼Ñ Ñайла Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð¿Ñи ÑÐ¾Ñ Ñанении Ñайла на ÑеÑвеÑе. Ðо ÑмолÑÐ°Ð½Ð¸Ñ `image.jpg` . (DOMString) + * **Ñип MIME**: Ñип 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); + + +### ÐÑÐ¸Ð¼ÐµÑ Ñ Ð·Ð°Ð³ÑÑжаÑÑ Ð·Ð°Ð³Ð¾Ð»Ð¾Ð²ÐºÐ¸ и ÑобÑÑÐ¸Ñ Progress (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 + +ÐбÑÐµÐºÑ `FileUploadResult` пеÑедаеÑÑÑ Ð½Ð° ÑÑÐ¿ÐµÑ Ð¾Ð±ÑаÑного вÑзова меÑода `upload()` обÑекÑа `FileTransfer`. + +### СвойÑÑва + +* **bytesSent**: колиÑеÑÑво байÑ, оÑпÑавленнÑÑ Ð½Ð° ÑеÑÐ²ÐµÑ ÐºÐ°Ðº ÑаÑÑÑ Ð·Ð°Ð³ÑÑзки. (длиннаÑ) + +* **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.toURL()); + }, + 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, коÑоÑÑй Ð¸Ð¼ÐµÐµÑ ÐºÐ¾Ð´ оÑибки FileTransferError.ABORT_ERR. + +### ÐÑÐ¸Ð¼ÐµÑ + + // !! 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-ÑоединениÑ. (ЧиÑло) + +* **иÑклÑÑение**: либо e.getMessage или e.toString (ÑÑÑока) + +### ÐонÑÑанÑÑ + +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `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 http://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer/blob/04d45bab/doc/zh/index.md ---------------------------------------------------------------------- diff --git a/doc/zh/index.md b/doc/zh/index.md index 36a3b15..0a277d9 100644 --- a/doc/zh/index.md +++ b/doc/zh/index.md @@ -192,7 +192,7 @@ A `FileUploadResult` ç©ä»¶å³é給æååæªç `FileTransfer` ç©ä»¶ç `up uri, fileURL, function(entry) { - console.log("download complete: " + entry.fullPath); + console.log("download complete: " + entry.toURL()); }, function(error) { console.log("download error source " + error.source); @@ -252,12 +252,14 @@ A `FileTransferError` ç©ä»¶å³éå°é¯èª¤åæªæåºç¾é¯èª¤ã * **HTTP_status**ï¼ HTTP çæ ç¢¼ãå¾ HTTP 飿¥æ¶å°ä¸ååæä»£ç¢¼æï¼æ¤å±¬æ§æå¯ç¨ãï¼äººæ¸ï¼ +* **ä¾å¤**ï¼ è¦éº¼ e.getMessage æ e.toString ï¼åä¸²ï¼ + ### 常é -* `FileTransferError.FILE_NOT_FOUND_ERR` -* `FileTransferError.INVALID_URL_ERR` -* `FileTransferError.CONNECTION_ERR` -* `FileTransferError.ABORT_ERR` +* 1 = `FileTransferError.FILE_NOT_FOUND_ERR` +* 2 = `FileTransferError.INVALID_URL_ERR` +* 3 = `FileTransferError.CONNECTION_ERR` +* 4 = `FileTransferError.ABORT_ERR` ## åå¾ç¸å®¹æ§æ³¨æå°
