URLSession Tutorial: Getting Started

URLSession Tutorial: Getting Started 번역 및 재가공

http data 요청하는 방법을 배우고 URLSession을 이용해 파일을 다운로드하는 것을 실습해보자
앱이 서버로부터 데이터를 다루는지, 소셜미디어 상태를 업데이트 하는지, 디스크에 파일을 다운로드 하는 작업 등은 모바일 앱의 HTTP 네트워크 요청이 행하는 마법이다. 네트워크가 요청하는 거대한 작업을 수행하기 위해서 애플은 URLSession이라는 것을 제공한다. 이것은 HTTP를 충족하는 컨텐츠의 업로드 다운로드에 대한 완벽한 네트워크 API이다.
이번 튜토리얼에서는 Half Tunes app을 만들 것이다. 현재 상태의 이 앱은 iTunes Search API를 다루고 노래의 앞부분 30초를 다운로드할 수 있다. 이후 완성된 앱은 background transfer를 지원할 것이며 사용자가 다운로드를 중지하거나 재시작, 취소할 수 있을 것이다.

Getting started

프로젝트를 다운로드 받아라. 이미 노래를 검색하고 검색결과를 보여주고, 네트워크 서비스, 트랙 저장 및 재생하는 UI를 포함한다. 따라서 앱의 네트워크 부분에만 집중할 수 있을 것이다. 앱을 실행해보자. 빈 테이블뷰 위에 서치바가 보일 것이다. 서치바에 쿼리를 입력하고 서치 버튼을 누르자. 뷰는 여전히 비어있는 상태이지만 걱정하지마라. 이제 URLSession 을 사용해서 바꾸면 되니까.

Overview of URLSession

시작하기 전에 URLSession과 구성 클래스에 대해 살펴보는 것이 중요하다. 아래의 도표를 살펴보자. URLSession은 기술적으로 http와 https 기반의 요청을 처리하는 클래스이다. URLSession은 http 요청을 주고받는 임무를 수행하는 중요한 오브젝트이다. URLSessionConfiguration을 이용해서 생성할 수 있고 3가지 종류가 있다.
.default : disk-persisted global cache, credential, cookie storage object를 사용한다.
.ephemeral : default 와 비슷하지만 모든 세션관련 데이터를 메모리에 저장한다. private session으로 불린다
.background : background 에서 업로드와 다운로드 작업을 수행한다. 심지어 앱이 서스펜드 또는 종료된 상태에서도 전송작업이 유지된다
URLSessionConfiguration은 timeout value, caching policy, http header와 같은 세션 프로퍼티의 값을 설정할 수 있게 해준다.
URLSessionTask는 추상클래스이다. 세션은 데이터 가져오기 파일 업로드 다운로드 등의 작업을 수행하기 위해 하나 또는 여러개의 task를 생성할 수 있다. session task의 3가지 타입이 존재한다
DataTask : 서버에서 메모리로 데이터를 요청하는 get
UploadTask : 디스크에서 웹으로 파일 업로드하는 post, put
DownloadTask : 원격에서 임시url로 파일을 다운로드
task를 suspend하거나 재시작하거나 취소할 수 있다. downloadtask는 나중에 재시작하기 위해 중지하는 부가적인 능력도 있다
일반적으로 URLSession은 두가지 방식으로 데이터를 반환하는데 task가 완료되는 시점에 completion handler를 통해 반환하거나, 세션 생성시 설정해놓은 delegate 메소드 호출을 통해 반환할 수 있다.
이제 URLSession에 대해 훑어보았으니 실습할 준비가 되었다

Data Task

사용자가 검색창에 입력한 쿼리에 대한 data task를 생성하자. SearchVC+SearchBarDelegate.swift 에서 searchBarSearchButtonClicked(_:) 메소드는 먼저 status bar에서 사용자에게 진행상황을 보여주는 네트워크 인디케이터를 활성화한다. 그리고나서 QueryService.swift에 있는 비어있는 메소드 getSearchResults(searchTerm:completion:)를 호출한다. Networking/QueryService.swift 파일에서 다음과 같이 수정하자

// 1
let defaultSession = URLSession(configuration: .default)
// 2
var dataTask: URLSessionDataTask?

1. default configuratoni을 사용하여 URLSession을 생성했다
1. datatask 변수를 선언했다. 우리는 iTunes 웹서비스에게 get 요청을 하기 위해 사용할 것이다. data task는 사용자가 새로운 검색어를 입력할 때마다 재생성될 것이다.
다음으로 getSearchResults(searchTerm:completion:) 의 빈 메소드를 다음과 같이 수정해보자

func getSearchResults(searchTerm: String, completion: @escaping QueryResult) {
  // 1
  dataTask?.cancel()
  // 2
  if var urlComponents = URLComponents(string: "https://itunes.apple.com/search") {
    urlComponents.query = "media=music&entity=song&term=\(searchTerm)"
    // 3
    guard let url = urlComponents.url else { return }
    // 4
    dataTask = defaultSession.dataTask(with: url) { data, response, error in
      defer { self.dataTask = nil }
      // 5
      if let error = error {
        self.errorMessage += "DataTask error: " + error.localizedDescription + "\n"
      } else if let data = data,
        let response = response as? HTTPURLResponse,
        response.statusCode == 200 {
        self.updateSearchResults(data)
        // 6
        DispatchQueue.main.async {
          completion(self.tracks, self.errorMessage)
        }
      }
    }
    // 7
    dataTask?.resume()
  }
}

1. 사용자의 새로운 검색어를 위해 이미 존재하는 data task를 취소한다. 왜냐하면 재사용해야하니까
1. 쿼리 URL에 사용자의 검색어를 포함시키기 위해서 URLComponents를 생성한다. baseURL과 query를 지정한다
1. urlComponents의 url 속성이 nil일 수 있으므로 옵셔널바인딩 한다
1. 위에서 만든 urlSession으로부터 datatask를 생성하고 이를 위해 위에서 만든 쿼리 url을 사용하고 데이터 반환시 어떤 처리를 할지 completion handler를 넣는다
1. 에러가 발생한다면 에러처리를 하고, 성공한다면 updateSearchResults(_:)를 호출한다. 이 메소드는 반환된 데이터를 tracks 배열 형태로 파싱한다.
1. 파싱한 track을 completion handler에 전달하는 작업을 메인큐에서 수행한다
1. 모든 task는 suspended상태이므로 resume()을 호출해야 업무를 시작한다
SearchVC+SearchBarDelegate.swift 파일에 있는 getSearchResults(searchTerm:completion:)를 살펴보자. 인디케이터를 숨긴 후에 결과값을 searchResults에 저장한다. 그리고 나서 테이블뷰를 업데이트한다.
Note : 요청메소드의 디폹트값은 get이다. 만약 post, put, delete를 하고 싶다면 url을 포함하는 URLRequest를 생성하고 그것의 http method를 맘대로 설정해주면 된다. 그리고나서 url로 data task를 생성하는 대신에 URLRequeset를 포함하는 data task를 만들면 된다.
앱을 실행해보자. 아무 노래나 검색해보자. 테이블뷰에 결과가 나타날 것이다.
URLSession을 사용해서 앱에 작은 기능이 생겼다.

Download Task

노래검색결과를 볼수 있게 되어 좋다. 그러나 다운로드를 할 수 있다면 더 좋지 않을까. 이것은 우리의 다음 과제이다. download task를 사용해서 로컬파일에 노래를 저장하기 쉬울 것이다.

download class

복수의 다운로드 작업을 쉽게 다루려면 다운로드 상태를 통제하는 커스텀 모델을 만들어야한다.
Download.swift파일을 모델 그룹에 만들고 다음과 같이 수정하자

class Download {

  var track: Track
  init(track: Track) {
    self.track = track
  }

  // Download service sets these values:
  var task: URLSessionDownloadTask?
  var isDownloading = false
  var resumeData: Data?

  // Download delegate sets this value:
  var progress: Float = 0

}

Download 모델의 프로퍼티를 살펴보자
track : 다운로드할 트랙. 트랙의 url은 Download의 unique identifire로서 역할 (딕셔너리의 키값)
task : 트랙을 다운로드하는 download task
isDownloading : 다운로드 작업이 진행상태인지 중지상태인지
resumeData : 사용자가 다운로드 중지시 데이터를 저장한다. 만약 호스트서버가 지원하면 앱은 중지한 다운로드를 나중에 재시작할 수 있다
progress : 다운로드 진행률
Networking/DownloadService.swift 파일에서 다음 프로퍼티를 클래스 상단에 추가하자

var activeDownloads: [URL: Download] = [:]

이 딕셔너리는 url과 Download를 맵핑한 형태이다

URLSessionDownloadDelegate

위에서처럼 completion handler를 사용해서 download task를 만들 수 있다. 그러나 이번에는 다운로드 진행상황을 모니터링 하고 싶을 때 custom delegate를 사용해야 가능하다
일반적으로 delegate는 ViewController에 적용한다
여러 delegate protocol 종류가 있다. URLSessionDownloadDelegate는 download task에 한정하여 이벤트를 처리한다.
이제 SearchViewController 에 session delegate를 적용할 것이다. controller그룹에 SearchVC+URLSessionDelegates.swift 파일을 만들고 extension을 만들자

extension SearchViewController: URLSessionDownloadDelegate {

  func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, 
    didFinishDownloadingTo location: URL) { 
    print("Finished downloading to \(location).")
  }

}

urlSession(_:downloadTask:didFinishDownloadingTo:) 은 URLSessionDownloadDelegate 메소드 중 유일하게 옵셔널이 아니다. 다운로드가 끝날 때 호출된다. 이제 다운로드가끝나면 메시지를 프린트할 것이다.

Creating a Download Task

이제 파일 다운로드할 준비가 되었다. download task를 처리할 session 먼저 만들어보자. Controller/SearchViewController.swift 파일에서 viewDidLoad() 앞에 아래의 코드를 추가하자

lazy var downloadsSession: URLSession = {
  let configuration = URLSessionConfiguration.default
  return URLSession(configuration: configuration, delegate: self, delegateQueue: nil)
}()

default configuration을 사용해서 세션을 생성하였다. 그리고 이벤트를 처리할 viewcontroller에 대해서 delegate를 지정하였다. 이는 task의 진행상황을 모니터링하는 데에 유용하다.
delegate queue를 nil로 지정한 것은 세션이 serial operation queue를 사용하도록 한다.
lazy를 사용한 것은 view controller가 초기화된 이후에 세션이 생성되도록 하여 delegate를 지정한 self 즉 viewController를 인식할 수 있게 해준다
이제 viewDidLoad()의 끝에 다음을 추가하자

downloadService.downloadsSession = downloadsSession

DownloadService의 downloadsSession 프로퍼티를 설정하였다
위에서 구성한 세션과 delegate를 통해 마침내 유저가 트랙 다운로드 요청시 download task를 생성할 준비를 마쳤다
Networking/DownloadService.swift 파일에서 tartDownload(_:) 를 다음과 같이 수정하자

func startDownload(_ track: Track) {
  // 1
  let download = Download(track: track)
  // 2
  download.task = downloadsSession.downloadTask(with: track.previewURL)
  // 3
  download.task!.resume()
  // 4
  download.isDownloading = true
  // 5
  activeDownloads[download.track.previewURL] = download
}

유저가 테이블뷰 셀의 다운로드 버튼을 누르면 TrackCellDelage를 적용받는 SearchViewController는 그 셀에 대한 특정 트랙을 인식하고 startDownload(_:) 를 호출한다.
1. 특정 트랙에 대한 Download를 생성
1. 새로운 session을 이용해 트랙의 preview url를 포함하는 download task를 생성한다. 그리고 이 task를 Download의 task 프로퍼티에 넣는다
1. resume() 호출하여 task 시작한다
1. 다운로드가 진행중이라고 설정
1. url 과 Donwload를 activeDownloads 딕셔너리에 맵핑한다
앱을 실행해서 다운로드 버튼을 눌러보자. 잠시 후 디버그 콘솔에 다운로드 완료 메시지를 볼 수 있을 것이다. 다운로드 버튼은 남아있으나 곧 고칠것이다. 이제 노래를 재생해보자

Saving and playing the track

download 완료시 delagate 메소드인 urlSession(:downloadTask:didFinishDownloadingTo:) 메소드는 임시파일 위치 url을 전달된다. 출력메시지에서 이를 확인할 수 있다. 이제 이를 반환하기 전에 샌드박스 폴더의 영구적 위치에 옮겨야 한다. SearchVC+URLSessionDelegates 에서 urlSession(:downloadTask:didFinishDownloadingTo:) 내의 프린트를 다음으로 수정하자

// 1
guard let sourceURL = downloadTask.originalRequest?.url else { return }
let download = downloadService.activeDownloads[sourceURL]
downloadService.activeDownloads[sourceURL] = nil
// 2
let destinationURL = localFilePath(for: sourceURL)
print(destinationURL)
// 3
let fileManager = FileManager.default
try? fileManager.removeItem(at: destinationURL)
do {
  try fileManager.copyItem(at: location, to: destinationURL)
  download?.track.downloaded = true
} catch let error {
  print("Could not copy file to disk: \(error.localizedDescription)")
}
// 4
if let index = download?.track.index {
  DispatchQueue.main.async {
    self.tableView.reloadRows(at: [IndexPath(row: index, section: 0)], with: .none)
  }
}

1. 다운로드가 완료된 task로부터 요청 url을 추출하고 그에 상응하는 Download를 찾아서 딕셔너리에서 제거한다.
1. SearchViewController.swift 에 있는 헬퍼 메소드인 localFilePath(for:) 를 사용하여 영구 로컬 파일 url을 생성한다.
1. FileManager를 사용해서 다운로드한 파일을 임시폴더에서 destinationURL로 이동시켜야한다. 우선 복사하기 전에 destinationURL에 혹시라도 있을 item을 지우고, 복사해서 이동시킨 후 다운로드 트랙의 downloaded 프로퍼티를 true로 변경한다
1. 마지막으로 다운로드 트랙의 index를 사용하여 테이블뷰의 해당 셀을 reload 한다.
앱을 실행하고 트랙을 다운로드해서 다운로드가 완료되었을 때 콘솔에 로컬파일 저장위치가 프린트되는 것을 확인할 수 있다. 다운로드 버튼은 사라진다. 왜냐하면 delegate 메소드에서 트랙의 downloaded 프로퍼티를 true로 했기 때문이다. 트랙을 클릭하면 AVPlayerViewController를 통해 재생되는 노래를 들을 수 있다.

Pausing, Resuming, and Cancelling Downloads

만약 다운로드 하던것을 중지하고 싶다면 또는 취소하고 싶다면? 이번 섹션에서는 중지, 재시작, 취소 기능을 적용해서 유저에게 다운로드에 대한 완벽한 통제권을 제공할 것이다. 먼저 취소기능부터 시작하자. DownloadService.swift 에서 cancelDownload(_:) 메소드를 다음과 같이 수정하자

func cancelDownload(_ track: Track) {
  if let download = activeDownloads[track.previewURL] {
    download.task?.cancel()
    activeDownloads[track.previewURL] = nil
  }
}

다운로드를 취소하기 위해서 진행중인 다운도르가 담긴 딕셔너리에서 상응하는 Download를 찾아서 cancel() 호출한다. 그리고나서 딕셔너리에서 그 downlaod object를 제거한다
다운로드 중지는 취소 개념과 유사하다. 중지기능은 download task를 취소하는 것은 같지만, 호스트 서버가 지원한다면 이후에 재시작하기 위한 정보를 담는 resume data를 생성해야한다.
Note : 특정 조건에서만 다운로드를 재시작할 수 있다. 예를 들어 처음에 요청한 이후로 정보가 변하면 안된다.
이제 pauseDownload(_:)를 다음과 같이 채워보자

func pauseDownload(_ track: Track) {
  guard let download = activeDownloads[track.previewURL] else { return }
  if download.isDownloading {
    download.task?.cancel(byProducingResumeData: { data in
      download.resumeData = data
    })
    download.isDownloading = false
  }
}

취소기능과의 가장 큰 차이점은 cancel() 호출 대신에 cancel(byProducingResumeData:) 를 호출한다는 점이다. 나중에 재시작하는데 필요한 resume data를 생성하기 위해 클로저를 포함한다. 또한 isDownloading 프로퍼티를 false 로 설정한다. 중지 기능이 완성되었으니 재시작 기능을 추가해보자
resumeDownload(_:) 메소드를 다음과 같이 채우자

func resumeDownload(_ track: Track) {
  guard let download = activeDownloads[track.previewURL] else { return }
  if let resumeData = download.resumeData {
    download.task = downloadsSession.downloadTask(withResumeData: resumeData)
  } else {
    download.task = downloadsSession.downloadTask(with: download.track.previewURL)
  }
  download.task!.resume()
  download.isDownloading = true
}

유저가 다운로드를 재시작할 때, resume data를 체크해야한다. resume data가 발견되면 이를 가지고 downloadTask(withResumeData:) 메소드를 이용해 새로운 download task를 생성한다. 만약 resume data가 없으면, download URL를 이용해서 새로운 download task를 만든다.
resume data를 이용하는 것과 donwload URL를 이용하는 두 경우 모두 resume() 호출을 통해 task 를 시작하고 isDownloading 을 true로 설정한다.
이제 한가지 할 일만 남았다. 중지버튼, 재시작버튼, 취소버튼을 적절하게 숨기거나 보여주어야 한다. 그러기 위해서 TrackCell의 configure(track:downloaded:) 메소드는 해당 트랙이 다운로드 진행중인지 알아야 한다.
TrackCell.swift 에서 configure(track:downloaded:) 를 다음과 같이 수정하자

func configure(track: Track, downloaded: Bool, download: Download?) {

SearchViewController.swift 에서 tableView(_:cellForRowAt:) 안의 cell을 다음과 같이 수정하자

cell.configure(track: track, downloaded: track.downloaded, 
  download: downloadService.activeDownloads[track.previewURL])

activeDownloads 딕셔너리에서 해당 track의 download object를 추출한다.
TrackCell.swift 에서 configure(track:downloaded:download:) 메소드에 있는 TODO 두가지 중에 첫번째를 다음과 같이 추가하자

var showDownloadControls = false

두번째에는 다음과 같이 추가하자

if let download = download {
  showDownloadControls = true
  let title = download.isDownloading ? "Pause" : "Resume"
  pauseButton.setTitle(title, for: .normal)
}

download object가 nil 이 아니면 현재 다운로드 진행중이라는 의미이다. 따라서 cell은 중지/재시작, 취소 버튼을 보여주어야 한다. 중지와 재시작은 같은 버튼을 공유하기 때문에 토글로 구현하면 된다. if 구문 아래에 다음을 추가하자

pauseButton.isHidden = !showDownloadControls
cancelButton.isHidden = !showDownloadControls

다운로드가 진행중일 때에만 버튼을 보이게 만들었다 아래의 메소드를 그 다음과 같이 수정하자

downloadButton.isHidden = downloaded

downloadButton.isHidden = downloaded || showDownloadControls

만약 트랙이 다운로드 중이라면 다운로드 버튼을 숨기도록 하였다. 앱을 실행하고 다운로드를 해보면 중지, 재시작, 취소가 가능해졌다
Note : 만약 다운로드를 재시작하고 중지하고 다시 재시작한 후에 멈춘다면 이상한 버그이다. 이는 download session configuration 을 URLSessionConfiguration.background(withIdentifier: "bgSessionConfiguration")으로 변경하면 버그가 사라질 것이다.

Showing Download Progress

현재 앱 상태에서는 다운로드 진행상황을 볼 수없다. user experience를 개선하기 위해 다운로드 진행상황을 셀에 표시할 수 있게 개선해보자. 이를 위해서 session delegate를 사용할 것이다. 먼저 TrackCell.swift 에서 다음을 추가하자

func updateDisplay(progress: Float, totalSize : String) {
  progressView.progress = progress
  progressLabel.text = String(format: "%.1f%% of %@", progress * 100, totalSize)
}

track cell은 progressView 와 progressLabel을 갖는다. delegate 메소드는 값을 설정하기 위해 위 헬퍼메소드를 호출한다.
SearchVC+URLSessionDelegates.swift 에서 URLSessionDownloadDelegate extension 에 다음 delegate 메소드를 추가하자

func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, 
  didWriteData bytesWritten: Int64, totalBytesWritten: Int64, 
  totalBytesExpectedToWrite: Int64) {
  // 1
  guard let url = downloadTask.originalRequest?.url,
    let download = downloadService.activeDownloads[url]  else { return }
  // 2
  download.progress = Float(totalBytesWritten) / Float(totalBytesExpectedToWrite)
  // 3
  let totalSize = ByteCountFormatter.string(fromByteCount: totalBytesExpectedToWrite, countStyle: .file)
  // 4
    DispatchQueue.main.async {
    if let trackCell = self.tableView.cellForRow(at: IndexPath(row: download.track.index,
      section: 0)) as? TrackCell {
      trackCell.updateDisplay(progress: download.progress, totalSize: totalSize)
    }
  }
}

1. downloadTask로부터 url을 추출하고 이를 통해 active downloads 딕셔너리에서 해당 download를 찾는다
1. 위 메소드는 다운로드된 바이트와 남은 다운로드 바이트를 제공한다. 이 비율을 통해서 다운로드 진행률을 계산하여 그 값을 Donwload에 저장한다. track cell은 이 값을 이용해 progressView를 업데이트한다
1. ByteCountFormatter 는 인간이 읽을 수 있는 형태로 다운로드파일 사이즈를 제공한다. 퍼센트 진행률의 크기를 알려줄 String 타입을 사용할 것이다.
1. 마지막으로 해당 셀을 찾아서 progressView 와 progressLabel을 업데이트한다. 이 작업은 UI 관련이므로 메인큐에서 수행한다.
TrackCell.swift 를 열고 configure(track:downloaded:download:) 안의 if 구문에 중지버튼 타이틀 설정부분 밑에 다음을 추가하자

progressLabel.text = download.isDownloading ? "Downloading..." : "Paused"

위에서는 다운로드 완료되어 delegate 메소드로부터 업데이트 되거나 다운로드가 중지되기 이전에 셀에서 보여줄 정보를 준다.
if 구문 아래에 다음을 추가하자

progressView.isHidden = !showDownloadControls
progressLabel.isHidden = !showDownloadControls

다운로드 진행상황에서만 progressView 와 label 을 보여준다
앱을 실행해서 해보면 다운로드 상황에서 프로그레스 바가 업데이트 되고 라벨에 진행률이 뜨는 것을 볼 수 있다

Enabling Background Transfers

이제 앱에 많은 기능이 추가되었다. 그러나 한가지 더 남았다. 앱이 background에 있거나 어떤 이유로 충돌이 난 상태에서도 다운로드를 유지하게 하는 기능이 필요하다. 짧은 30초 노래 프리뷰 앱에서는 그다지 필요하지 않으나 대용량 파일을 전송할 때에는 필요한 기능이다.
만약 앱이 동작하지 않는다면 이것이 어떻게 가능할까? 운영체제는 background 전송을 수행하기 위해 앱 밖에서 분리된 데몬을 돌린다. 그리고 background download task를 수행할 때 앱에게 delegate 메시지를 보낸다. 앱이 종료되더라도 진행중이던 background 전송에게는 영향을 미치지 않는다.
전송이 완료되면 데몬은 background에서 앱을 재실행시킨다. 재실행된 앱은 background session을 다시 만들고 관련 완료 메시지를 받아서 다운받은 파일을 disk로 옮기는 등의 작업을 수행한다.
Note : 만약 유저가 강제로 앱을 종료시킨다면 운영체제는 모든 background 전송을 취소할 것이고 앱을 재실행하려 하지 않을 것이다.
background session configuration을 사용하여 session을 생성하면 위의 마법같은 기능 구현이 가능하다.
SearchViewController.swift 에서 downloadsSession 초기화 부분에서 다음 코드를 아래와 같이 수정해보자

let configuration = URLSessionConfiguration.default

let configuration = URLSessionConfiguration.background(withIdentifier: 
  "bgSessionConfiguration")

default configuraion 대신에 background configuration을 사용했다. 또한 identifier를 설정해서 앱이 필요할 때 새로운 background session을 만들 수 있도록 했다.
Note : 1개 이상의 background configuration을 생성하면 안된다. 왜냐하면 운영체제는 세션과 task를 관련시키는 identifier를 사용하기 때문이다.
만약 앱이 실행중이 아닌데 background task가 완료되었다면 앱은 background에서 재실행될 것이다. app delegate에서 이 이벤트를 처리할 수 있다. AppDelegate.swift 에서 클래스 윗부분에 다음을 추가하자

var backgroundSessionCompletionHandler: (() -> Void)?

그리고나서 다음 메소드를 추가하자

func application(_ application: UIApplication, handleEventsForBackgroundURLSession 
  identifier: String, completionHandler: @escaping () -> Void) {
  backgroundSessionCompletionHandler = completionHandler
}

위에서 completionHandler 변수를 생성했다. application(_:handleEventsForBackgroundURLSession:) 메소드는 자고 있는 앱을 깨워서 완료된 background task를 처리하도록 한다. 이 메소드에서 다음 두가지를 처리할 필요가 있다
1. background configuration과 session을 재생성할 필요가 있다. 이를 위해 delegate method에서 제공하는 identifier를 사용한다. 그러나 이 앱에서 SearchViewController 인스턴스 생성시에 background session을 생성하므로 이미 이 부분은 했다
1. delegate 메소드에서 제공하는 completion handler를 캡쳐해야한다. completion handler는 앱이 background 업무를 모두 완료하여다고 운영체제에게 알려준다. 또한 운영체제가 업데이트된 상황의 UI를 캡쳐할 수 있게 한다.
completion handler를 호출하는 지점은 urlSessionDidFinishEvents(forBackgroundURLSession:) 이다. 이 메소드는 background 업무가 모두 완료되는 시점에 열일하는 URLSessionDelegate 메소드이다.
SearchVC+URLSessionDelegates.swift 에서 다음을 추가하자

import UIKit

마지막으로 다음 extension을 추가하자

extension SearchViewController: URLSessionDelegate {

  // Standard background session handler
  func urlSessionDidFinishEvents(forBackgroundURLSession session: URLSession) {
    if let appDelegate = UIApplication.shared.delegate as? AppDelegate,
      let completionHandler = appDelegate.backgroundSessionCompletionHandler {
      appDelegate.backgroundSessionCompletionHandler = nil
      DispatchQueue.main.async {
        completionHandler()
      }
    }
  }

}

위에서는 app delegate로부터 전달된 completion handler 를 메인 스레드에서 호출한다. UIKit 덕분에 app delegate 접근이 가능해진다.
앱을 실행하고 다운로드를 시작하고 홈버튼을 눌러 앱을 background 환경으로 만들자. 다운로드가 완료되었을 것이라 추측될때까지 기다린 후에 홈버튼을 두번 누르자. 다운로드가 완료되었을 것이다. 앱의 스냅샷에 다운로드가 완료되었다는 상태가 반영되었을 것이다. 앱을 다시 열어 확인해보자

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

URLSession-Tutorial-GettingStarted.md

URLSession-Tutorial-GettingStarted.md

URLSession Tutorial: Getting Started

Getting started

Overview of URLSession

Data Task

Download Task

download class

URLSessionDownloadDelegate

Creating a Download Task

Saving and playing the track

Pausing, Resuming, and Cancelling Downloads

Showing Download Progress

Enabling Background Transfers

Files

URLSession-Tutorial-GettingStarted.md

Latest commit

History

URLSession-Tutorial-GettingStarted.md

File metadata and controls

URLSession Tutorial: Getting Started

Getting started

Overview of URLSession

Data Task

Download Task

download class

URLSessionDownloadDelegate

Creating a Download Task

Saving and playing the track

Pausing, Resuming, and Cancelling Downloads

Showing Download Progress

Enabling Background Transfers