Android音乐应用：音频下载时圆形进度条切换及图标恢复失效问题

兄弟，我太懂你这种ListView里UI状态同步的坑了！你说的下载按钮点击后切换进度条、完成后切回图标失效的问题，大概率是踩了ListView复用或者AsyncTask和UI绑定的坑，我给你梳理几个靠谱的解决思路和代码示例：

1. 核心问题分析 #

• ListView复用导致控件引用混乱：ListView的Item会被循环复用，如果你直接在DownloadTask里持有ImageView的硬引用，当Item滚出屏幕再回来，这个引用可能已经指向了其他Item的控件，导致更新错了目标。
• 任务与UI控件的绑定缺失：下载任务没有和对应的Item唯一标识（比如歌曲ID）关联，下载完成后找不到正确的那个ImageView来切换状态。
• UI更新逻辑不严谨：即便AsyncTask的onPostExecute在主线程，如果没判断当前Item是否还在可见范围内、或者没通过Adapter统一管理状态，也会导致状态切换失效。

2. 具体解决方案（推荐状态维护方案） #

最稳妥的方式是在Adapter里维护每个Item的下载状态，不管ListView怎么复用，都能通过状态来精准更新UI。

步骤1：定义下载状态枚举 #

先给下载状态做个统一标识：

public enum DownloadState {
    UNDOWNLOADED, DOWNLOADING, DOWNLOADED
}

步骤2：给音乐数据模型添加状态字段 #

假设你的音乐数据类是MusicItem，增加状态字段来记录当前下载情况：

public class MusicItem {
    // 原有字段：歌曲ID、名称、音频URL等
    private int id;
    private String audioUrl;
    private DownloadState downloadState = DownloadState.UNDOWNLOADED;

    // Getter和Setter方法
    public int getId() { return id; }
    public String getAudioUrl() { return audioUrl; }
    public DownloadState getDownloadState() { return downloadState; }
    public void setDownloadState(DownloadState downloadState) { this.downloadState = downloadState; }
}

步骤3：修改DownloadTask，绑定歌曲ID并更新状态 #

让下载任务和具体歌曲绑定，完成后更新对应歌曲的状态，再通知Adapter刷新：

public class DownloadTask extends AsyncTask<String, Integer, String> {
    private Context context;
    private int musicId;
    private MusicAdapter adapter;

    // 构造方法传入歌曲ID和Adapter引用
    public DownloadTask(Context context, int musicId, MusicAdapter adapter) {
        this.context = context;
        this.musicId = musicId;
        this.adapter = adapter;
    }

    @Override
    protected void onPreExecute() {
        super.onPreExecute();
        // 找到对应歌曲，标记为下载中并通知刷新
        for (MusicItem item : adapter.getMusicList()) {
            if (item.getId() == musicId) {
                item.setDownloadState(DownloadState.DOWNLOADING);
                adapter.notifyDataSetChanged();
                break;
            }
        }
    }

    @Override
    protected String doInBackground(String... params) {
        // 这里写你的下载逻辑：从params[0]获取音频URL，下载到SD卡
        // 下载过程中可以调用publishProgress()更新进度
        return "下载完成的本地路径";
    }

    @Override
    protected void onProgressUpdate(Integer... values) {
        super.onProgressUpdate(values);
        // 如果需要更新进度条进度，同样先找到对应歌曲，后续在Adapter里处理
    }

    @Override
    protected void onPostExecute(String result) {
        super.onPostExecute(result);
        // 下载完成，标记为已下载并通知刷新
        for (MusicItem item : adapter.getMusicList()) {
            if (item.getId() == musicId) {
                item.setDownloadState(DownloadState.DOWNLOADED);
                adapter.notifyDataSetChanged();
                break;
            }
        }
    }
}

步骤4：在Adapter的getView方法中根据状态切换控件 #

在Adapter里根据歌曲的下载状态，决定显示下载图标还是进度条：

public class MusicAdapter extends BaseAdapter {
    private Context context;
    private List<MusicItem> musicList;

    // 构造方法和其他必要方法...
    public List<MusicItem> getMusicList() { return musicList; }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        if (convertView == null) {
            convertView = LayoutInflater.from(context).inflate(R.layout.item_music, parent, false);
            holder = new ViewHolder();
            holder.downloadIv = convertView.findViewById(R.id.iv_download);
            holder.progressBar = convertView.findViewById(R.id.pb_download); // 圆形进度条
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        MusicItem currentItem = musicList.get(position);
        // 根据下载状态切换控件显示
        switch (currentItem.getDownloadState()) {
            case UNDOWNLOADED:
                holder.downloadIv.setVisibility(View.VISIBLE);
                holder.progressBar.setVisibility(View.GONE);
                holder.downloadIv.setImageResource(R.drawable.ic_download);
                // 设置下载点击事件
                holder.downloadIv.setOnClickListener(v -> {
                    new DownloadTask(context, currentItem.getId(), MusicAdapter.this)
                            .execute(currentItem.getAudioUrl());
                });
                break;
            case DOWNLOADING:
                holder.downloadIv.setVisibility(View.GONE);
                holder.progressBar.setVisibility(View.VISIBLE);
                // 如果需要更新进度，这里可以设置progressBar的进度值
                break;
            case DOWNLOADED:
                holder.downloadIv.setVisibility(View.VISIBLE);
                holder.progressBar.setVisibility(View.GONE);
                holder.downloadIv.setImageResource(R.drawable.ic_downloaded); // 替换为已完成图标
                holder.downloadIv.setOnClickListener(null); // 移除点击事件，避免重复下载
                break;
        }

        // 其他UI设置（比如歌曲名称等）...
        return convertView;
    }

    // ViewHolder内部类
    static class ViewHolder {
        ImageView downloadIv;
        ProgressBar progressBar;
    }
}

3. 额外注意事项 #

• SD卡权限：Android 6.0及以上需要动态申请WRITE_EXTERNAL_STORAGE权限，否则下载会失败。
• 任务生命周期管理：在Activity/Fragment销毁时，记得取消未完成的DownloadTask，避免内存泄漏，比如在onDestroy中调用task.cancel(true)。
• 进度条样式：圆形进度条可以设置style="?android:attr/progressBarStyleSmall"，适配列表Item的尺寸。

内容的提问来源于stack exchange，提问作者bhoomika patel