在Android应用中从服务器下载文件是一项常见功能，广泛应用于更新应用、获取资源、导出数据等场景，实现这一功能需要综合考虑网络请求、文件存储、权限管理、进度反馈及异常处理等多个方面，以下将详细解析Android下载服务器文件的技术实现步骤、关键代码示例及注意事项。
（图片来源网络，侵删）
核心实现步骤
-
添加网络权限
在AndroidManifest.xml中声明网络权限，对于Android 6.0及以上版本，还需动态申请存储权限：<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
-
创建网络请求工具类
使用OkHttp或HttpURLConnection发起HTTP请求，OkHttp因其高效的连接池和简洁的API成为主流选择，以下为OkHttp下载的核心代码：OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("http://example.com/file.zip") .build(); client.newCall(request).enqueue(new Callback() { @Override public void onFailure(Call call, IOException e) { // 处理下载失败 } @Override public void onResponse(Call call, Response response) throws IOException { if (!response.isSuccessful()) throw new IOException("Unexpected code " + response); InputStream is = response.body().byteStream(); FileOutputStream fos = new FileOutputStream(new File(getExternalFilesDir(null), "file.zip")); byte[] buffer = new byte[2048]; int len; while ((len = is.read(buffer)) != -1) { fos.write(buffer, 0, len); } fos.close(); is.close(); } }); -
实现多线程断点续传
支持断点续传需在请求头中添加Range字段，记录已下载字节数：File file = new File(path); long downloadedBytes = file.length(); Request request = new Request.Builder() .url(url) .header("Range", "bytes=" + downloadedBytes + "-") .build(); -
显示下载进度
通过Handler与UI线程交互，实时更新进度条：
（图片来源网络，侵删）ResponseBody responseBody = response.body(); long totalBytes = responseBody.contentLength(); InputStream is = responseBody.byteStream(); byte[] buffer = new byte[2048]; int len; long sumBytes = 0; while ((len = is.read(buffer)) != -1) { fos.write(buffer, 0, len); sumBytes += len; int progress = (int) (sumBytes * 100 / totalBytes); Message msg = handler.obtainMessage(0, progress); handler.sendMessage(msg); } -
处理文件存储路径
根据Android版本选择合适的存储目录：- Android 10及以上：使用
getExternalFilesDir()应用专属目录 - 旧版本：需检查
Environment.getExternalStorageState()确保SD卡可用
- Android 10及以上：使用
关键参数配置表
| 参数类型 | 配置项 | 说明 |
|---|---|---|
| 网络请求 | 连接超时时间 | OkHttp设置connectTimeout(30, TimeUnit.SECONDS) |
| 读取超时时间 | OkHttp设置readTimeout(30, TimeUnit.SECONDS) |
|
| 文件存储 | 保存路径 | 优先使用Context.getExternalFilesDir()避免系统清理 |
| 文件权限 | 下载后调用file.setReadable(true, false)允许其他应用访问（如需） |
|
| 断点续传 | 临时文件命名 | 使用.tmp后缀，下载完成后重命名为正式文件名 |
| 下载记录持久化 | 使用SharedPreferences或数据库记录已下载文件大小及URL |
异常处理与优化
-
网络异常处理
- 捕获
SocketTimeoutException、UnknownHostException等异常，提示用户检查网络 - 使用
ConnectivityManager检测网络状态：ConnectivityManager cm = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE); NetworkInfo activeNetwork = cm.getActiveNetworkInfo(); boolean isConnected = activeNetwork != null && activeNetwork.isConnectedOrConnecting();
- 捕获
-
存储空间不足
下载前检查可用空间：StatFs statFs = new StatFs(Environment.getExternalStorageDirectory().getPath()); long availableBytes = statFs.getAvailableBytes(); if (availableBytes < fileSize) { Toast.makeText(this, "存储空间不足", Toast.LENGTH_SHORT).show(); } -
并发下载控制
使用线程池管理多个下载任务，避免资源耗尽：
（图片来源网络，侵删）ExecutorService executor = Executors.newFixedThreadPool(3); executor.execute(downloadRunnable);
相关问答FAQs
问题1：为什么下载大文件时会出现OOM（内存溢出）？
解答：OOM通常发生在将整个文件读入内存时，解决方案包括：
- 使用
InputStream和FileOutputStream以流式读写，避免全量加载 - 调整OkHttp的缓存大小，设置
cacheSize(50 * 1024 * 1024)限制内存占用 - 对于超大文件（如1GB以上），建议使用
RandomAccessFile实现分片下载
问题2：如何解决Android 10及以上版本无法写入公共存储目录的问题？
解答：Android 10引入了分区存储，限制应用直接访问共享存储，解决方法：
- 优先使用
Context.getExternalFilesDir()目录，无需存储权限 - 若必须使用公共目录，需在AndroidManifest.xml中添加
android:requestLegacyExternalStorage="true"（临时方案） - 通过
MediaStore API插入文件到相册或下载目录，并处理文件URI权限
通过以上步骤和注意事项，可以稳定实现Android应用中的服务器文件下载功能，同时兼顾用户体验和系统兼容性，实际开发中还需根据具体需求调整参数，如添加下载速度显示、任务队列管理、下载完成通知等功能。
