Android開發之自帶下載器DownloadManager的使用

YungFan發表於2017-12-13

Android 開發中,經常有從伺服器下載資料的需求出現,尤其是線上更新App的情形。其基本思路是根據本地的App版本號和伺服器的版本號進行比較,如果伺服器版本較新,再進行提示然後下載Apk最後進行安裝。這種需求解決方案有很多,第三方的網路框架基本都有這個功能。

Android自帶的DownloadManager是一個很好的下載檔案的工具。該類在API level 9之後出現,它已經幫我們處理了下載失敗、重新下載等功能,整個下載過程全部交給系統負責,不需要我們過多的處理,非常的nice。關鍵的是用起來也很簡單,很爽,稍微封裝一下就可以幾句話搞定下載。

下面以一個簡單案例來實現從伺服器下載一個Apk檔案並進行安裝。

1、開啟本地Tomcat伺服器,放入一個Apk檔案

Tomcat.png

2、開啟Tomcat,然後確保能從瀏覽器下載

瀏覽器下載.png

3、編寫DownloadManager工具類,程式碼註釋很詳細

public class DownloadUtils {
    //下載器
    private DownloadManager downloadManager;
    //上下文
    private Context mContext;
    //下載的ID
    private long downloadId;
    public  DownloadUtils(Context context){
        this.mContext = context;
    }

    //下載apk
    public void downloadAPK(String url, String name) {

        //建立下載任務
        Request request = new Request(Uri.parse(url));
        //行動網路情況下是否允許漫遊
        request.setAllowedOverRoaming(false);

        //在通知欄中顯示,預設就是顯示的
        request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE);
        request.setTitle("新版本Apk");
        request.setDescription("Apk Downloading");
        request.setVisibleInDownloadsUi(true);

        //設定下載的路徑
        request.setDestinationInExternalPublicDir(Environment.getExternalStorageDirectory().getAbsolutePath() , name);

       //獲取DownloadManager
        downloadManager = (DownloadManager) mContext.getSystemService(Context.DOWNLOAD_SERVICE);
        //將下載請求加入下載佇列,加入下載佇列後會給該任務返回一個long型的id,通過該id可以取消任務,重啟任務、獲取下載的檔案等等
        downloadId = downloadManager.enqueue(request);

        //註冊廣播接收者,監聽下載狀態
        mContext.registerReceiver(receiver,
                new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));
    }

    //廣播監聽下載的各個狀態
    private BroadcastReceiver receiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            checkStatus();
        }
    };


    //檢查下載狀態
    private void checkStatus() {
        Query query = new 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_PAUSED:
                    break;
                //下載延遲
                case DownloadManager.STATUS_PENDING:
                    break;
                //正在下載
                case DownloadManager.STATUS_RUNNING:
                    break;
                //下載完成
                case DownloadManager.STATUS_SUCCESSFUL:
                    //下載完成安裝APK
                    installAPK();
                    break;
                //下載失敗
                case DownloadManager.STATUS_FAILED:
                    Toast.makeText(mContext, "下載失敗", Toast.LENGTH_SHORT).show();
                    break;
            }
        }
        c.close();
    }

    //下載到本地後執行安裝
    private void installAPK() {
        //獲取下載檔案的Uri
        Uri downloadFileUri = downloadManager.getUriForDownloadedFile(downloadId);
        if (downloadFileUri != null) {
            Intent intent= new Intent(Intent.ACTION_VIEW);
            intent.setDataAndType(downloadFileUri, "application/vnd.android.package-archive");
            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            mContext.startActivity(intent);
            mContext.unregisterReceiver(receiver);
        }
    }

}

複製程式碼

4、編寫Activity程式碼初始化工具類,然後下載

public class MainActivity extends AppCompatActivity {
    private DownloadUtils downloadUtils;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        downloadUtils =   new DownloadUtils(MainActivity.this); 
        downloadUtils.downloadAPK("http://192.168.1.104:8080/XXX.apk", "XXX.apk");

    }
}
複製程式碼

5、配置許可權

<!--在SDCard中建立與刪除檔案許可權  -->
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
<!-- 往SDCard寫入資料許可權 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!--  從SDCard讀取資料許可權 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<!--  訪問網路許可權 -->
<uses-permission android:name="android.permission.INTERNET"/>
複製程式碼

6、執行結果

執行以後會去下載伺服器的Apk,通知欄也會有相應的通知。當下載完畢以後,會彈出安裝介面。

  • 通知欄

通知欄提醒.png

  • 主介面

主介面.gif

相關文章