CB-7249cordova-plugin-file-transfer documentation translation: cordova-plugin-file-transfer

This commit is contained in:
Lisa Seacat DeLuca
2014-08-01 16:23:44 -04:00
parent 80c2d72b95
commit de4bf61d4c
9 changed files with 83 additions and 54 deletions
+14 -11
View File
@@ -31,15 +31,18 @@
* 亞馬遜火 OS
* Android 系統
* 黑莓 10
* 火狐瀏覽器作業系統 * *
* iOS
* Windows Phone 7 和 8 *
* Windows 8 *
**不支援 `onprogress` ,也不 `abort()` *
* **不支援 `onprogress` *
# 檔案傳輸
`FileTransfer`物件提供一種方法使用 HTTP 多部分 POST 請求的檔上傳和下載檔案,以及。
`FileTransfer`物件提供一種方法使用 HTTP 多部分 POST 請求的檔上傳和下載檔案,以及。
## 屬性
@@ -65,16 +68,16 @@
* **errorCallback** 回檔的執行如果出現檢索錯誤 `Metadata` 。調用與 `FileTransferError` 物件。*(函數)*
* **trustAllHosts**: 可選參數,預設值為 `false` 。 如果設置為 `true` ,它可以接受的所有安全證書。 由於 Android 拒絕自行簽署式安全證書,這非常有用。 不建議供生產使用。 在 Android 和 iOS 上受支援。 *(布林值)*
* **選項**: 可選參數*(物件)*。有效的金鑰:
* **fileKey** 表單元素的名稱。預設值為 `file` 。() DOMString
* **檔案名**: 要保存在伺服器上的檔時使用的檔案名稱。預設值為 `image.jpg` 。() DOMString
* **mimeType**: 要上傳的資料的 mime 類型。預設值為 `image/jpeg` 。() DOMString
* **params** 一組可選的鍵/值對中的 HTTP 要求傳遞。(物件)
* **params** 一組可選的鍵/值對 HTTP 要求傳遞。(物件)
* **chunkedMode**: 是否要分塊流式處理模式中的資料上載。預設值為 `true` 。(布林值)
* **標題** 一張地圖的標頭名稱/標頭值。使用陣列來指定多個值。(物件)
* **標題**: 地圖的標頭名稱/標頭值。使用陣列來指定多個值。(物件)
* **trustAllHosts**: 可選參數,預設值為 `false` 。 如果設置為 `true` ,它接受的所有安全證書。 這是有用的因為 android 系統拒絕自簽名的安全證書。 不建議供生產使用。 支援 Android 和 iOS。 *(布林值)*
### 示例
@@ -240,7 +243,7 @@ A `FileUploadResult` 物件傳遞給成功回檔的 `FileTransfer` 物件的 `up
## FileTransferError
A `FileTransferError` 物件傳遞到錯誤回檔時出現錯誤。
A `FileTransferError` 物件傳遞給一個錯誤回呼函數時出現錯誤。
### 屬性
@@ -264,21 +267,21 @@ A `FileTransferError` 物件傳遞到錯誤回檔時出現錯誤。
## 向後相容性注意到
以前版本的這個外掛程式將只接受設備絕對檔路徑作為源的上載,或為下載的目標。這些路徑通常表單
以前版本的這個外掛程式才會接受設備-絕對檔路徑的源上傳,或為下載的目標。這些路徑通常會在表單
/var/mobile/Applications/<application UUID>/Documents/path/to/file (iOS)
/storage/emulated/0/path/to/file (Android)
為向後相容性,這些路徑仍被接受,和如果您的應用程式已錄得像這些持久性存儲區中的路徑,然後他們可以繼續使用。
為向後相容性,這些路徑仍被接受,和如果您的應用程式記錄了像這些持久性存儲的路徑,然後他們可以繼續使用。
這些路徑以前暴露在 `fullPath` 屬性的 `FileEntry``DirectoryEntry` 由檔外掛程式返回的物件。 新版本的檔的外掛程式,不過,不再公開這些 JavaScript 的路徑。
這些路徑以前暴露在 `fullPath` 屬性的 `FileEntry``DirectoryEntry` 由檔外掛程式返回的物件。 新版本的檔的外掛程式,不過,不再公開這些 JavaScript 的路徑。
如果您升級到一個新 (1.0.0 或更高版本) 版本的檔,和你以前一直在使用 `entry.fullPath` 作為的參數 `download()``upload()` ,那麼將需要更改您的代碼,而使用檔案系統的 Url。
如果您升級到一個新 (1.0.0 或更高版本) 版本的檔,和你以前一直在使用 `entry.fullPath` 作為的參數 `download()``upload()` ,那麼將需要更改代碼以使用檔案系統的 Url 來代替
`FileEntry.toURL()``DirectoryEntry.toURL()` 返回的表單檔案系統 URL
cdvfile://localhost/persistent/path/to/file
可以使用在中兩者的絕對檔路徑位置 `download()``upload()` 方法。
其中可代替的絕對檔路徑在兩個 `download()``upload()` 方法。