一直聽說過Android自帶的DownloadManager,只是拖延癥發(fā)作,一直沒有時間去研究研究,其實在很多項目開發(fā)中,都有一個功能是非常重要的,那就是應(yīng)用的檢查更新了!基于DownloadManager,可以做一個輕量級的下載器,將下載任務(wù)交給系統(tǒng)去執(zhí)行,減輕自身APP的壓力,何樂而不為呢?!
DownloadManager的基本使用姿勢
通過getSystemService進行實例化
DownloadManager downloadManager = (DownloadManager)context.getSystemService(Context.DOWNLOAD_SERVICE);構(gòu)建下載請求DownloadManager.Request request = new DownloadManager.Request(Uri.parse("目標文件下載地址"));//設(shè)置目標文件夾,如果你想在系統(tǒng)的storage目錄下載一個testDownload/test/test.apkrequest.setDestinationInExternalPublicDir("testDownload", "test/test.apk");//設(shè)置下載所需的網(wǎng)絡(luò)環(huán)境,設(shè)置了移動網(wǎng)絡(luò)和WiFi環(huán)境下均能下載 request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE | DownloadManager.Request.NETWORK_WIFI);//通知欄設(shè)置//顯示在通知欄request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE);注意!!!如果選擇不顯示在通知欄,那么必須聲明以下權(quán)限
<uses-permission android:name="android.permission.DOWNLOAD_WITHOUT_NOTIFICATION" />
然后設(shè)置不可見
request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_HIDDEN);
否則將會拋出一個securityException
//設(shè)置文件類型為apk類型,當downloadManager調(diào)用openFile時會喚起相應(yīng)的程序request.setMimeType("application/cn.trinea.download.file"); //開始下載,得到一個唯一的downloadId,大有用處long downloadId = downloadManager.enqueue(request);如何獲取下載的情況呢
private int[] getBytesAndStatus(long downloadId) { //構(gòu)建一個數(shù)組,存放已下載文件大小、總大小、下載狀態(tài) int[] bytesAndStatus = new int[]{ -1, -1, 0 }; //通過構(gòu)建下載請求時獲得的downloadId進行文件查詢 DownloadManager.Query query = new DownloadManager.Query().setFilterById(downloadId); Cursor cursor = null; try { cursor = downloadManager.query(query); if (cursor != null && cursor.moveToFirst()) { //已經(jīng)下載文件大小 bytesAndStatus[0] = cursor.getInt(cursor.getColumnIndexOrThrow(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR)); //下載文件的總大小 bytesAndStatus[1] = cursor.getInt(cursor.getColumnIndexOrThrow(DownloadManager.COLUMN_TOTAL_SIZE_BYTES)); //下載狀態(tài) bytesAndStatus[2] = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS)); } } finally { if (cursor != null) { cursor.close(); } } return bytesAndStatus; }注冊監(jiān)聽文件下載成功的廣播
private BroadcastReceiver downloadCompleteReceiver;downloadCompleteReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { //文件下載成功時 DownloadManager.Query query = new DownloadManager.Query(); //通過下載的id查找 query.setFilterById(downloadId); Cursor c = downloadManager.query(query); if (c.moveToFirst()) { int status = c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS)); switch (status) { //下載完成 case DownloadManager.STATUS_SUCCESSFUL: break; } } } };//注冊,這里只能攔截文件下載成功的廣播,并不能進行進度監(jiān)聽,在適當?shù)牡胤饺∠嗛啅V播context.registerReceiver(downloadCompleteReceiver, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));網(wǎng)上很多博客都是通過自定義ContentObserver獲取本地文件變化,其實可以另辟蹊徑,通過一個定時器間隔調(diào)用以上getBytesAndStatus(long downloadId)能達到同樣的效果,用Rxjava實現(xiàn)一個簡單的定時器
/** * 由于DownloadManager自身沒有提供實時進度的api,所以通過以下定時器獲取已下載的文件大小 */ private void updateProgress() { //每隔0.5秒刷新一次進度,在適當?shù)牡胤接浀米N timeDisposable Disposable timeDisposable = Observable.interval(500, TimeUnit.MILLISECONDS).subscribeOn(Schedulers.io()) .observeOn(AndroidSchedulers.mainThread()).subscribe(new DataConsumer<Long>() { @Override public void acceptData(@io.reactivex.annotations.NonNull Long aLong) { int [ ] bytesAndStatus = getBytesAndStatus(downloadId); //todo 在這里進行回調(diào)即可 } }); }了解完DownloadManager基本的使用方式,那么基于它來封裝一個簡單易用的下載器吧!
實現(xiàn)效果
DownloadHelper.Builder builder = new DownloadHelper.Builder(this).title("下載通知") .description("正在下載新版本V1.2.0") .downloadUrl("http://download.sj.qq.com/upload/connAssitantDownload/upload/MobileAssistant_1.apk") .fileSaveName("MobileAssistant_1.apk").fileSavePath("testDownload") .notifyVisible(true) .fileType(DownloadHelper.FileType.APK).apkInstallHint(true).onProgressListener(new DownloadHelper.OnDownloadProgressListener() { @Override public void onProgress(int downloadedSize, int totalSize) { int progress =(int)((downloadedSize*1.0f/totalSize)*100); Logger.d("progress=%d",progress); //進度回調(diào) } @Override public void onSuccess(Uri fileUri) { //文件下載成功回調(diào)的Uri } @Override public void onFail() { //文件下載失敗 } @Override public void fileAlreadyExits(File file) { //當你想重復(fù)下載同樣的文件時,本地檢測是否存在同樣的文件,進行回調(diào) } }); DownloadHelper downloadHelper = builder.build(); //開始下載 downloadHelper.start(); //移除下載任務(wù) downloadHelper.deleteDownloadFile();源碼請到https://github.com/yuwenque/SimpleDownloadHelper.git
|
新聞熱點
疑難解答
圖片精選