[Android]DownloadManager

개요 : https://developer.android.com/reference/android/app/DownloadManager

장시간 HTTP 다운로드를 처리하는 시스템 서비스

클라이언트는 특정 목적지인 파일을 다운로드할 URI를 요청해야 한다.

다운로드 매니저는 HTTP 상호 작용을 처리하고 실패 후 또는 연결 변경 및 시스템 재부팅 전반에 걸쳐 다운로드를 재시도하면서 백그라운드에서 다운로드를 수행한다.

 

ACTION_NOTIFICATION_CLICKED에 대해 브로드캐스트 리시버를 등록해서 사용자가 노티피케이션이나 다운로드 UI로 진행 중인 다운로드를 클릭할 경우에 적절한 처리를 하도록 할 수 있다.

 

Manifest.permission.INTERNET 퍼미션이 필요하다.

 

불필요한 백그라운드 모바일 네트워크 사용 : https://developer.android.com/topic/performance/vitals/bg-network-usage

DownloadManager의 setNotificationVisibility(int)를 설정 > 앱의 모바일 네트워크 사용을 포그라운드로 이동시키고 사용자에게 다운로드가 진행 중임을 알리고 다운로드를 일시중지하거나 중지할 수 있는 제어 기능을 제공할 수 있다.

 

DownloadManager.Request : https://developer.android.com/reference/kotlin/android/app/DownloadManager.Request?hl=ko#setnotificationvisibility

open fun setNotificationVisibility(visibility: Int) : DownloadManager.Request!

 

다운로드가 진행 중이거나 완료되면 다운로드 매니저에 의해 시스템 노티피케이션이 게시될 지를 제어한다. 가능하다면, 다운로드 매니저는 시스템 android.app.NotificationManager를 통해 다운로드에 관한 노티피케이션들을 게시할 수 있다. 보통 노티피케이션은 다운로드가 진행 중일 때에만 보인다.

다음과 같은 값들(visibiltiy 파라미터)을 사용한다. : VISIBILITY_HIDDEN, VISIBILITY_VISIBLE, VISIBILITY_VISIBLE_NOTIFY_COMPLETED

 VISIBILTIY_HIDDEN 값으로 설정할 경우, android.permission.DOWNLOAD_WITHOUT_NOTIFICATION 퍼미션이 필요하다.

 

NetworkSecurityPolicy : https://developer.android.com/reference/kotlin/android/security/NetworkSecurityPolicy

네트워크 보안 정책. 

cleartext(평문. 일반인 누구나 읽을 수 있는 문서. http://www.ktword.co.kr/test/view/view.php?m_temp1=4240) 이 허용되지 않으면 플랫폼의 컴포넌트( HTTP와 FTP stacks, android.app.DownloadManager, android.media.MediaPlayer 등)는 cleartext traffic을 이용하려는 프로세스의 요청을 거부한다. 

open fun isCleartextTrafficPermitted() : Boolean을 통해 cleartext 네트워크 트래픽(HTTP, FTP, WebSockets, XMPP, IMAP, SMTP - TLS나 STARTTLS는 포함되지 않는다)이 프로세스의 모든 네트워크 통신에 허용됐는지 확인할 수 있다.

 

<application android:usesCleartextTraffic=["true"|"false"]> : https://developer.android.com/guide/topics/manifest/application-element#usesCleartextTraffic

android:usesCleartextTraffic

앱이 일반 텍스트 HTTP와 같은 일반 텍스트 네트워크 트래픽을 사용하는지 여부를 나타냅니다. API 레벨 27 이하를 타겟팅하는 앱에서는 기본값이 "true"이고, API 레벨 28 이상을 타겟팅하는 앱에서는 기본값이 "false"입니다.

이 속성이 "false"로 설정되면 플랫폼 구성요소(예: HTTP 및 FTP 스택, DownloadManager, MediaPlayer)는 앱의 일반 텍스트 트래픽 사용 요청을 거부합니다. 타사 라이브러리도 이 설정을 준수하는 것이 좋습니다. 일반 텍스트 트래픽을 피하는 주요 이유는 기밀성, 진실성이 보장되지 않고 변조 방지가 불가능하기 때문입니다. 네트워크 공격자는 전송되는 데이터를 도청할 수 있으며 들키지 않고 수정할 수도 있습니다.

제공되는 액세스 수준으로 인해 Android 애플리케이션에서 나오는 일반 텍스트 트래픽을 모두 차단할 수는 없으므로, 이 플래그는 최대한 적용됩니다. 예를 들어 Socket API는 트래픽이 일반 텍스트인지 여부를 판별할 수 없으므로 이 플래그를 적용하는 데 있어 예외가 없습니다. 하지만 애플리케이션에서 나오는 대부분의 네트워크 트래픽은 상위 수준 네트워크 스택/구성요소에서 처리되며, 이 경우 ApplicationInfo.flags 또는 NetworkSecurityPolicy.isCleartextTrafficPermitted()에서 읽어 들여 이 플래그를 적용할 수 있습니다.

앱 개발 중에 StrictMode를 사용하여 앱의 일반 텍스트 트래픽을 식별할 수 있습니다. 자세한 내용은 StrictMode.VmPolicy.Builder.detectCleartextNetwork()를 참고하세요.

이 속성은 API 레벨 23에 추가되었습니다.

이 플래그는 Android 7.0(API 레벨 24) 이상에서 Android 네트워크 보안 구성이 있는 경우 무시됩니다.

 

Android 7.0 동작 변경 사항 : 파일 시스템 권한 변경 : https://developer.android.com/about/versions/nougat/android-7.0-changes

 

DownloadManager는 비공개로 저장된 파일을 더 이상 파일 이름별로 공유할 수 없습니다. 레거시 애플리케이션은 COLUMN_LOCAL_FILENAME에 액세스할 때 액세스가 불가능한 경로가 될 수 있습니다. Android 7.0 이상을 대상으로 하는 앱은 COLUMN_LOCAL_FILENAME에 액세스할 때 SecurityException을 트리거합니다.  DownloadManager.Request.setDestinationInExternalFilesDir() 또는 DownloadManager.Request.setDestinationInExternalPublicDir()을 사용하여 다운로드위치를 공용 위치로 설정하는 레거시 애플리케이션은 COLUMN_LOCAL_FILENAME에 있는 경로에 여전히 액세스할 수 있지만, 이 메서드는 부득이한 경우가 아니라면 사용하지 않는 것이 좋습니다. DownloadManager에 의해 노출되는 파일에 액세스하는 좋은 방법은 ContentResolver.openFileDescriptor()를 사용하는 것입니다.

 

DownloadManager.Request : https://developer.android.com/reference/kotlin/android/app/DownloadManager.Request?hl=ko#setdestinationinexternalfilesdir

open fun setDestinationInExternalFileDir(context: Context!, dirType: String!, subPath: String!) : DownloadManager.Request!

다운로드한 파일의 로컬 위치를 애플리케이션의 외부 파일 디렉토리 내의 경로로 설정합니다(Context#getExternalFilesDir(String)에서 반환됨). 다운로드한 파일은 MediaScanner에서 스캔하지 않습니다. 그러나 allowScanningByMediaScanner()를 호출하여 스캔 가능하게 만들 수 있습니다.

 

open fun setDestinationInExternalPyblicDir(dirType: String!, dubPath: String!) : DownloadManager.Request!

다운로드한 파일의 로컬 대상을 공용 외부 저장소 디렉터리 내의 경로로 설정합니다(Environment#getExternalStoragePublicDirectory(String)에서 반환됨). 다운로드한 파일은 MediaScanner에서 스캔하지 않습니다. 그러나 allowScanningByMediaScanner()를 호출하여 스캔 가능하게 만들 수 있습니다. android.os.Build.VERSION_CODES#Q 이상을 대상으로 하는 애플리케이션의 경우 WRITE_EXTERNAL_STORAGE 권한이 필요하지 않으며 dirType은 Environment#DIRECTORY_DOWNLOADS, Environment#DIRECTORY_PICTURES, Environment#DIRECTORY_MOVIES 등과 같은 알려진 공개 디렉토리 중 하나여야 합니다.

 

Context DOWNLOAD_SERVICE : https://developer.android.com/reference/kotlin/android/content/Context?hl=pt#download_service

static val DOWNLOAD_SERVICE: String

HTTP 다운로드를 요청하기 위해 android.app.DownloadManager를 반환하기 위해 getSystemService(java.lang.String)와 사용한다.

Value: "download"