引入

compile 'org.wlf:FileDownloader:0.3.1'

application的onCreate()中初始化FileDownloader

// 建立Builder
FileDownloadConfiguration.Builder builder = new FileDownloadConfiguration.Builder(this);

// 配置Builder
// 配置下載檔案儲存的資料夾
builder.configFileDownloadDir(Environment.getExternalStorageDirectory().getAbsolutePath() + File.separator +
        "FileDownloader"
 
);
// 配置同時下載任務數量，如果不配置預設為2
builder.configDownloadTaskSize(3);
// 配置失敗時嘗試重試的次數，如果不配置預設為0不嘗試
builder.configRetryDownloadTimes(5);
// 開啟除錯模式，方便檢視日誌等除錯相關，如果不配置預設不開啟
builder.configDebugMode(true);
// 配置連線網路超時時間，如果不配置預設為15秒
builder.configConnectTimeout(25000);// 25秒

// 使用配置檔案初始化FileDownloader
FileDownloadConfiguration configuration = builder.build();
FileDownloader.init(configuration);
 

**註冊監聽器
不需要的時候取消註冊 也可以不註冊**

  private OnFileDownloadStatusListener mOnFileDownloadStatusListener = new OnSimpleFileDownloadStatusListener() {
        @Override
        public void onFileDownloadStatusRetrying(DownloadFileInfo downloadFileInfo, int retryTimes) {
            // 正在重試下載（如果你配置了重試次數，當一旦下載失敗時會嘗試重試下載），retryTimes是當前第幾次重試 
 

        }

        @Override
        public void onFileDownloadStatusWaiting(DownloadFileInfo downloadFileInfo) {
            // 等待下載（等待其它任務執行完成，或者FileDownloader在忙別的操作） 
        }

        @Override
        public void onFileDownloadStatusPreparing(DownloadFileInfo downloadFileInfo) {
            // 準備中（即，正在連線資源） 
        }

        @Override
        public void onFileDownloadStatusPrepared(DownloadFileInfo downloadFileInfo) {
            // 已準備好（即，已經連線到了資源） 
        }

        @Override
        public void onFileDownloadStatusDownloading(DownloadFileInfo downloadFileInfo, float downloadSpeed, long
                remainingTime) {
            // 正在下載，downloadSpeed為當前下載速度，單位KB/s，remainingTime為預估的剩餘時間，單位秒 
        }

        @Override
        public void onFileDownloadStatusPaused(DownloadFileInfo downloadFileInfo) {
            // 下載已被暫停 
        }

        @Override
        public void onFileDownloadStatusCompleted(DownloadFileInfo downloadFileInfo) {
            // 下載完成（整個檔案已經全部下載完成） 
        }

        @Override
        public void onFileDownloadStatusFailed(String url, DownloadFileInfo downloadFileInfo, FileDownloadStatusFailReason failReason) {
            // 下載失敗了，詳細檢視失敗原因failReason，有些失敗原因你可能必須關心 
            String failType = failReason.getType();
            String failUrl = failReason.getUrl();// 或：failUrl = url，url和failReason.getType()會是一樣的 
            if (FileDownloadStatusFailReason.TYPE_URL_ILLEGAL.equals(failType)) {
                // 下載failUrl時出現url錯誤 
            } else if (FileDownloadStatusFailReason.TYPE_STORAGE_SPACE_IS_FULL.equals(failType)) {
                // 下載failUrl時出現本地儲存空間不足 
            } else if (FileDownloadStatusFailReason.TYPE_NETWORK_DENIED.equals(failType)) {
                // 下載failUrl時出現無法訪問網路 
            } else if (FileDownloadStatusFailReason.TYPE_NETWORK_TIMEOUT.equals(failType)) {
                // 下載failUrl時出現連線超時 
            } else {
                // 更多錯誤.... 
            }

            // 檢視詳細異常資訊 
            Throwable failCause = failReason.getCause();// 或：failReason.getOriginalCause() 
            // 檢視異常描述資訊 
            String failMsg = failReason.getMessage();// 或：failReason.getOriginalCause().getMessage() 
        }
    };

// 註冊監聽器
FileDownloader.registerDownloadStatusListener(mOnFileDownloadStatusListener);

註冊檔案資料變化監聽器 如 檔案不存在，被刪除，狀態變化等

 private OnDownloadFileChangeListener mOnDownloadFileChangeListener = new OnDownloadFileChangeListener() {
        @Override
        public void onDownloadFileCreated(DownloadFileInfo downloadFileInfo) {        // 一個新下載檔案被建立，也許你需要同步你自己的資料儲存，比如在你的業務資料庫中增加一條記錄     }    @Override    public void onDownloadFileUpdated(DownloadFileInfo downloadFileInfo, Type type) {        // 一個下載檔案被更新，也許你需要同步你自己的資料儲存，比如在你的業務資料庫中更新一條記錄     }    @Override    public void onDownloadFileDeleted(DownloadFileInfo downloadFileInfo) {        // 一個下載檔案被刪除，也許你需要同步你自己的資料儲存，比如在你的業務資料庫中刪除一條記錄     }};

// 註冊監聽器
            FileDownloader.registerDownloadFileChangeListener(mOnDownloadFileChangeListener);

下載檔案

// 如果檔案沒被下載過 將建立並開啟下載
// 否則繼續下載 自動會斷點續傳（如果伺服器無法支援斷點續傳將從頭開始下載）
FileDownloader.start(url);

建立一個自定義下載路徑和檔名的下載

FileDownloader.detect(url, new OnDetectBigUrlFileListener() {
    @Override
    public void onDetectNewDownloadFile(String url, String fileName, String saveDir, long fileSize) {
        // 如果有必要，可以改變檔名稱fileName和下載儲存的目錄saveDir 
        FileDownloader.createAndStart(url, newFileDir, newFileName);
    }
    @Override
    public void onDetectUrlFileExist(String url) {
        // 繼續下載，自動會斷點續傳（如果伺服器無法支援斷點續傳將從頭開始下載） 
        FileDownloader.start(url);
    }
    @Override
    public void onDetectUrlFileFailed(String url, DetectBigUrlFileFailReason failReason) {
        // 探測一個網路檔案失敗了，具體檢視failReason 
    }
});

暫停下載

// 暫停單個下載任務
FileDownloader.pause(url);

// 暫停多個下載任務 list集合
FileDownloader.pause(urls);

// 暫停所有下載任務
FileDownloader.pauseAll();

繼續下載

// 繼續下載，自動會斷點續傳（如果伺服器無法支援斷點續傳將從頭開始下載）
FileDownloader.reStart(url);

// 繼續下載 list集合
FileDownloader.reStart(urls);

移動下載檔案

// 移動單個下載檔案到新資料夾中
FileDownloader.move(url, newDirPath, mOnMoveDownloadFileListener);

// 移動多個下載檔案到新資料夾中  list集合
FileDownloader.move(urls, newDirPath, mOnMoveDownloadFilesListener);

刪除下載

// 刪除單個下載檔案
FileDownloader.delete(url, true, mOnDeleteDownloadFileListener);

// 刪除多個下載檔案 list集合
FileDownloader.delete(urls, true, mOnDeleteDownloadFilesListener);

重新命名下載檔案

// 重新命名一個下載檔案
FileDownloader.rename(url, newName, true, mOnRenameDownloadFileListener);

取消監聽

// 取消註冊下載狀態監聽器(一般在fragment或activity的onDestroy方法中取消註冊)
FileDownloader.unregisterDownloadStatusListener(mOnFileDownloadStatusListener);
// 取消註冊檔案資料變化監聽器
FileDownloader.unregisterDownloadFileChangeListener(mOnDownloadFileChangeListener);