Android JAVA实现网络文件下载至公共Download文件夹的方案

Android JAVA实现网络文件下载至公共Download文件夹的方案

先总结兼容性与版本适配一览表

Android版本	API级别	存储权限需求	下载实现方式	下载位置	安装注意点
Android 5.x (L)	21-22	仅需AndroidManifest声明	FileDownloader	先下载到应用专属目录，然后复制到公共Download目录	使用file://Uri即可
Android 6.x-9.x (M-P)	23-28	需要运行时请求WRITE_EXTERNAL_STORAGE权限才能写入公共目录；专属目录无需权限	FileDownloader	先下载到应用专属目录，有权限时复制到公共Download目录	Android 7.0+需要FileProvider，无权限时使用应用专属目录中的APK
Android 10.0 (Q)	29	无需存储权限，可通过MediaStore API直接写入公共目录	FileDownloader + MediaStore	先下载到应用专属目录，然后通过MediaStore API复制到Download目录	需要FileProvider + 安装未知应用权限
Android 11.0+ (R+)	30+	无需存储权限，可通过MediaStore API直接写入公共目录	FileDownloader + MediaStore	先下载到应用专属目录，然后通过MediaStore API复制到Download目录	需要FileProvider + 安装未知应用权限

1. 权限声明与配置

1.1 AndroidManifest.xml 配置

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.apkdownloader">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" 
        android:maxSdkVersion="28" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" 
        android:maxSdkVersion="28" />
    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

    <application
        android:requestLegacyExternalStorage="true"
        ...>
        
        <provider
            android:name="androidx.core.content.FileProvider"
            android:authorities="${applicationId}.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
        </provider>
        
    </application>
</manifest>

1.2 file_paths.xml 配置

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path name="external_files" path="." />
    <external-path name="downloads" path="Download/" />
    <external-files-path name="external_files_path" path="." />
    <external-files-path name="download" path="download/" />
</paths>

1.3 添加FileDownloader库依赖

在项目级build.gradle文件中添加FileDownloader库依赖：

dependencies {
    // 其他依赖
    implementation 'com.liulishuo.filedownloader:library:1.7.7'
}

1.4 在Application中初始化

为了确保FileDownloader正确初始化，需要在Application类中配置：

public class MyApplication extends Application {
   
   
    @Override
    public void onCreate() {
   
   
        super.onCreate();
        
        // 初始化FileDownloader
        FileDownloader.setupOnApplicationOnCreate(this);
        
        // 可选：配置线程池大小，调整并行下载任务数
        // FileDownloader.setGlobalPost2UIInterval(200); // 更新UI间隔，毫秒
        // FileDownloader.setMaxNetworkThreadCount(3); // 设置最大同时下载线程数
    }
}

确保在AndroidManifest.xml中声明使用自定义Application：

<application
    android:name=".MyApplication"
    ...>

2. 完整下载与安装工具类

import android.app.DownloadManager;
import android.content.BroadcastReceiver;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.net.Uri;
import android.os.Build;
import android.os.Environment;
import android.provider.MediaStore;
import android.provider.Settings;
import android.util.Log;
import android.webkit.MimeTypeMap;
import android.widget.Toast;

import androidx.activity.result.ActivityResultLauncher;
import androidx.activity.result.contract.ActivityResultContracts;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import androidx.core.content.FileProvider;

import com.liulishuo.filedownloader.BaseDownloadTask;
import com.liulishuo.filedownloader.FileDownloadListener;
import com.liulishuo.filedownloader.FileDownloader;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.nio.channels.FileChannel;

/**
 * APK下载管理类
 * 
 * 权限需求说明：
 * 1. Android 5.x-9.x (API 21-28): 需要WRITE_EXTERNAL_STORAGE权限才能写入公共Download目录
 * 2. Android 10+ (API 29+): 不需要存储权限也能通过MediaStore API写入Download目录
 * 3. 所有Android版本: 下载到应用专属目录(getExternalFilesDir)无需请求存储权限
 */
public class ApkDownloadManager {
   
   
    private static final String TAG = "ApkDownloadManager";
    private static final int REQUEST_CODE_PERMISSION = 1001;
    private static final int REQUEST_CODE_INSTALL_PERMISSION = 1002;
    
    private Context context;
    private String apkUrl;
    private String apkName;
    private int downloadTaskId = -1;
    private boolean autoInstall = true;
    private DownloadResultCallback callback;
    private File privateDownloadFile = null;
    private boolean pendingCopyToPublic = false;
    
    public interface DownloadResultCallback {
   
   
        void onProgress(int progress);
        void onSuccess(Uri fileUri);
        void onError(String error);
    }
    
    // 静态初始化块，确保FileDownloader只初始化一次
    static {
   
   
        try {
   
   
            FileDownloader.setupOnApplicationOnCreate(AppContext.getInstance());
        } catch (Exception e) {
   
   
            Log.e(TAG, "FileDownloader初始化失败: " + e.getMessage());
        }
    }
    
    public ApkDownloadManager(Context context, String apkUrl, String apkName) {
   
   
        this.context = context;
        this.apkUrl = apkUrl;
        this.apkName = apkName;
    }
    
    public void setAutoInstall(boolean autoInstall) {
   
   
        this.autoInstall = autoInstall;
    }
    
    public void setCallback(DownloadResultCallback callback) {
   
   
        this.callback = callback;
    }
    
    /**
     * 检查权限并开始下载
     * 
     * 权限策略:
     * 1. 始终先下载到应用专属目录(无需权限)
     * 2. 如果是Android 10+，同时通过MediaStore API保存到公共目录(无需权限)
     * 3. 如果是Android 6.0-9.0，仅当授予权限后才复制到公共目录
     */
    public void download() {
   
   
        // 先下载到应用专属目录(任何And