React Native FlatList中URL多文件下载并显示单独进度条的实现问题
问题根因
- 进度回调触发过于频繁:RNFS默认的下载进度回调会在每次收到字节流时触发,每秒可达数十次,频繁调用
setDownloadProgress会导致JS线程被重渲染任务占满,阻塞UI响应 - 后台下载配置无效:你写的
background: true位于mkdir的then回调块内,不属于downloadFile的配置参数,完全未生效,所有下载任务都在前台线程运行,抢占UI资源 - 无重复点击/并发控制:未限制同时运行的下载任务数,也没有拦截重复点击下载按钮的逻辑,可能同时触发大量下载任务,进一步挤压运行资源
修复方案
直接修改下载逻辑即可解决卡顿、多下载失效问题,核心优化点如下:
- 配置RNFS自带的
progressInterval参数,限制进度回调的触发频率,减少不必要的状态更新 - 将
background参数正确放入下载配置中,开启后台下载,避免抢占前台UI线程资源 - 新增下载状态标记,拦截重复点击,避免同一个文件触发多次下载
- 可选:如果需要同时下载10个以上文件,可新增全局并发队列,限制最多同时运行2-3个下载任务,避免IO资源耗尽
核心修改代码
import {useCallback, useRef, useState} from 'react'; // 其余原有导入保持不变 const DownloadItem = ({title, downloadUrl}) => { const [downloadProgress, setDownloadProgress] = useState(0); // 新增ref:标记当前是否正在下载,避免重复触发 const isDownloading = useRef(false); // 新增ref:记录上次进度更新时间,兜底控制更新频率 const lastUpdateTime = useRef(Date.now()); const startDownloadZip = useCallback(async () => { if (isDownloading.current) return; isDownloading.current = true; const appParentPath = RNFS.DocumentDirectoryPath; const appFolderPath = appParentPath + '/MyFiles'; try { await RNFS.mkdir(appFolderPath); const downloadTask = RNFS.downloadFile({ fromUrl: downloadUrl, toFile: `${appFolderPath}/${title}`, background: true, // 正确开启后台下载 progressInterval: 200, // 配置进度回调每200ms触发一次,单位ms progress: (res) => { const now = Date.now(); // 再加一层节流兜底,避免极端场景下回调过频 if (now - lastUpdateTime.current < 200) return; lastUpdateTime.current = now; const progressPercent = res.bytesWritten / res.contentLength; setDownloadProgress(progressPercent); }, }); await downloadTask.promise; // 下载完成后重置状态,可根据需求修改为下载完成隐藏按钮等逻辑 isDownloading.current = false; } catch (err) { console.log('下载错误', err); isDownloading.current = false; } }, [title, downloadUrl]); return ( <View> <View style={style.parentView}> <View style={{ height: 55, width: 55, borderRadius: 2, alignItems: 'center', backgroundColor: rendomRGB(), }}> <Text style={style.extensionTxt}> {getFirstCharacterOfExtensionFromURL(downloadUrl)} </Text> </View> <View> <Text style={style.fileTitle}>{title}</Text> <Text style={style.fileDesc}>{title}</Text> <View style={style.progressView}> <Progress.Bar style={style.fileDesc} progress={downloadProgress} width={200} /> <TouchableOpacity // 下载过程中可设置按钮半透,提示用户不可点击 style={{opacity: isDownloading.current ? 0.5 : 1}} onPress={startDownloadZip}> <Image style={style.imgCloseResume} source={require('../../assets/close.png')} /> </TouchableOpacity> </View> </View> </View> <View style={style.deviderView}></View> </View> ); };
内容的提问来源于stack exchange,提问作者BiRjU
相关产品推荐
相关产品推荐

