mirror of
https://github.com/apache/cordova-plugin-file-transfer.git
synced 2026-04-28 00:02:49 +08:00
CB-7249cordova-plugin-file-transfer documentation translation: cordova-plugin-file-transfer
This commit is contained in:
+14
-11
@@ -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()` 的方法。
|
||||
Reference in New Issue
Block a user