您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

iOS 大文件下載斷點續傳實踐:原理與三種實現

編輯:iOS 開發基礎

為什麼需要斷點續傳

斷點續傳是指下載或上傳中斷後,可以從上次失敗的位置繼續,而不是從頭開始。本文聚焦於 iOS 應用中的檔案下載,尤其是大檔案下載時,若沒有斷點續傳,任何異常、網路中斷或使用者主動暫停,都可能導致重新下載,浪費時間與流量。

更進一步的需求是:即使 App 被使用者手動結束,或因 crash 而重新啟動,也能依據已下載的暫存檔案繼續下載。這是本文希望解決的核心問題。

HTTP 斷點續傳原理

斷點續傳需要伺服器支援。常見方式包括 FTP 與 HTTP,而 iOS 應用中最常見的是 HTTP。HTTP 斷點續傳主要依賴請求標頭中的 Range。

Range 以位元組為單位。請求方可以指定從某個位元組位置開始下載,而不一定要知道檔案總大小。例如:

Range: bytes=1208765-

代表要求伺服器從第 1208765 個位元組之後開始回傳內容。

伺服器若支援 Range,會在回應中帶入 Accept-Ranges,並以 Content-Range 說明本次回傳的範圍與總長度。

例如 Content-Range: bytes 1208765-20489997/20489998 表示本次回傳從 1208765 到 20489997,總長度為 20489998。此時 HTTP 狀態碼通常是 206,而不是 200。

使用 AFHTTPRequestOperation 實作

若專案使用 AFNetworking,可以透過 AFHTTPRequestOperation 實作斷點續傳。關鍵步驟如下:

  • 確認本機是否已有部分檔案。
  • 取得已下載檔案大小。
  • 在 NSURLRequest 中加入 Range 標頭。
  • 將輸出流設定為 append 模式,把新資料附加到既有檔案。
  • 透過 downloadProgressBlock 更新進度。
  • 在 success 與 failure 中處理完成或失敗狀態。

AFHTTPRequestOperation 的底層依賴 NSURLConnectionDataDelegate。AFNetworking 會在子執行緒中發出請求,並透過 delegate 回呼接收資料。之所以不在主執行緒直接等待,是因為主執行緒的 RunLoop 模式會在使用者操作介面時切換,可能影響非同步任務的執行時機。

三種常見實現方式

1. NSURLConnection

若自行實作,可以基於 NSURLConnection 與 NSURLConnectionDataDelegate。重點包括:

  • didReceiveResponse:初始化檔案寫入 handle,並計算總長度。
  • didReceiveData:將收到的資料附加到暫存檔案。
  • connectionDidFinishLoading:關閉檔案 handle,將暫存檔案移動到正式目錄。

初始化 NSURLConnection 時,建議將 run loop mode 設定為 NSRunLoopCommonModes,否則在 TableView 或 ScrollView 滾動時,進度 UI 可能無法即時更新。

2. NSURLSessionDataTask

從 iOS 7 開始,Apple 推出 NSURLSession,功能比 NSURLConnection 更完整,也更適合非同步網路任務。若使用 NSURLSessionDataTask,需要實作 NSURLSessionDataDelegate 與 NSURLSessionTaskDelegate。

其流程與 NSURLConnection 類似,但 didCompleteWithError 會整合完成與失敗狀態,因此需要依 error 判斷要執行成功或失敗的後續處理。

3. NSURLSessionDownloadTask

NSURLSessionDownloadTask 是專門用於下載的任務,對應 NSURLSessionDownloadDelegate。它適合需要暫停、恢復與背景下載的場景。

使用 download task 時,暫停可透過 cancelByProducingResumeData 取得續傳資料,並將其持久化。恢復時再把 resumeData 交給 downloadTaskWithResumeData 即可。進度可透過 didWriteData 回呼取得。

需要注意的是,didFinishDownloadingToURL 回呼之後,系統會刪除暫存位置中的檔案,因此所有檔案搬移或處理都必須在該方法內完成。

總結

斷點續傳的核心在於:伺服器支援 Range、用戶端保存已下載資料、並在下次請求時告知伺服器從哪個位置繼續。實作方式可以從 AFHTTPRequestOperation、NSURLConnection、NSURLSessionDataTask 到 NSURLSessionDownloadTask 逐步理解。若只是簡單下載,NSURLSessionDownloadTask 通常是較現代且合適的選擇。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved