You need to enable JavaScript to run this app. 如何用Runnable回调实现AsyncTask进度更新(不使用协程/第三方库)
优惠活动
大模型
产品
解决方案
定价
更多

如何用Runnable回调实现AsyncTask进度更新(不使用协程/第三方库)

自定义异步任务框架补充进度更新能力的实现方案

这套实现完全保留你现有代码的运行逻辑,不需要引入协程或第三方库,1:1对齐AsyncTask的publishProgress()/onProgressUpdate()线程规则与使用体验。

核心适配思路

完全复刻原AsyncTask的进度链路:

  • 后台任务执行过程中,主动调用publishProgress()传递当前进度值
  • 进度值通过主线程Handler投递切线程,最终在UI线程触发onProgressUpdate()回调
  • 不阻塞后台任务的正常执行

第一步:调整基础接口定义

给原有的MyCallable增加进度类型泛型与进度回调方法,与原AsyncTask的Progress泛型能力对齐:

public interface MyCallable<P, R> extends Callable<R>{
    // 原有的UI线程回调保留
    void setDataAfterLoading(R result);
    void setUiForLoading();
    // 新增:UI线程执行的进度回调,对标原AsyncTask的onProgressUpdate
    void onProgressUpdate(P progress);
}

如果兼容API <24的低版本Android,java.util.function.Consumer不可用,可自定义1个简单的接口替代,无第三方依赖:

// 自定义轻量进度发布接口
public interface ProgressPoster<P> {
    void post(P progress);
}

第二步:给MyTask类增加进度发布能力

在抽象的MyTask类中补充可供后台线程调用的publishProgress()方法,以及Runner注入进度发布通道的入口,完全不改动原有方法的执行线程约定:

public abstract class MyTask<P, R> implements MyCallable<P, R> {
    // 由MyTaskRunner注入的进度发布通道
    private ProgressPoster<P> progressPoster;

    // 供子类在call()后台方法中直接调用,完全对标AsyncTask的publishProgress
    protected void publishProgress(P progress) {
        if (progressPoster != null) {
            progressPoster.post(progress);
        }
    }

    // Runner执行任务时调用,完成通道注入
    public void setProgressPoster(ProgressPoster<P> poster) {
        this.progressPoster = poster;
    }

    // 保留原有方法的实现约定
    @Override
    public void setUiForLoading() {
       // UI线程运行
    }

    @Override
    public void setDataAfterLoading(R result) {
        // UI线程运行
    }

    @Override
    public R call() throws Exception {
        // 后台线程运行,可直接调用publishProgress上报进度
        return null;
    }
}

第三步:调整MyTaskRunner的执行逻辑

在原有执行流程中补全进度通道的注入逻辑,完全保留原有的线程切换逻辑、异常捕获逻辑:

public class MyTaskRunner {

    private final Handler handler = new Handler(Looper.getMainLooper());
    private final Executor executor = Executors.newCachedThreadPool();

    public <P, R> void executeAsync(MyTask<P, R> task) {
        try {
            // 原有前置逻辑:执行UI加载状态回调
            task.setUiForLoading();
            
            // 注入进度发布通道:收到后台的进度值后,通过handler切到UI线程触发回调
            task.setProgressPoster(progress -> {
                handler.post(() -> task.onProgressUpdate(progress));
            });
            
            // 原有后台执行逻辑保留
            executor.execute(new RunnableTask<P, R>(handler, task));
        } catch (Exception e) {
            // 原有异常处理逻辑保留
        }
    }

    public static class RunnableTask<P, R> implements Runnable{
        private final Handler handler;
        private final MyTask<P, R> task;

        public RunnableTask(Handler handler, MyTask<P, R> task) {
            this.handler = handler;
            this.task = task;
        }

        @Override
        public void run() {
            try {
                final R result = task.call();
                handler.post(new RunnableTaskForHandler<>(task, result));
            } catch (Exception e) {
                // 原有异常处理逻辑保留
            }
        }
    }

    public static class RunnableTaskForHandler<P, R> implements Runnable{
        private final MyTask<P, R> task;
        private final R result;

        public RunnableTaskForHandler(MyTask<P, R> task, R result) {
            this.task = task;
            this.result = result;
        }

        @Override
        public void run() {
            task.setDataAfterLoading(result);
        }
    }
}

使用示例

和原有MyTask的使用方式完全一致,仅在后台逻辑中增加进度上报:

MyTaskRunner runner = new MyTaskRunner();
// 示例:下载任务,进度用Integer表示百分比,结果为下载完成的文件路径
runner.executeAsync(new MyTask<Integer, String>() {
    @Override
    public void onProgressUpdate(Integer progress) {
        // UI线程:直接更新进度条
        progressBar.setProgress(progress);
    }

    @Override
    public void setUiForLoading() {
        // UI线程:显示加载控件
        progressBar.setVisibility(View.VISIBLE);
    }

    @Override
    public void setDataAfterLoading(String result) {
        // UI线程:隐藏加载控件,展示下载完成状态
        progressBar.setVisibility(View.GONE);
        Toast.makeText(context, "下载完成,文件路径:" + result, Toast.LENGTH_SHORT).show();
    }

    @Override
    public String call() throws Exception {
        // 后台线程:执行下载逻辑
        for (int current = 0; current <= 100; current++) {
            // 每完成一步,上报当前进度
            publishProgress(current);
            // 模拟下载耗时
            Thread.sleep(50);
        }
        return "/sdcard/download/target_file.apk";
    }
});

注意事项

  • 线程规则完全与AsyncTask对齐:publishProgress()仅可在后台线程的call()方法中调用,onProgressUpdate()固定运行在UI线程,可直接操作UI控件
  • 高频进度上报可能导致主线程消息队列堆积:如果短时间内大量调用publishProgress(),可在进度发布通道中增加简单节流逻辑(比如两次上报间隔小于50ms则跳过投递),避免主线程卡顿
  • 如果需要对齐原AsyncTask的串行执行特性,只需把Runner中的Executors.newCachedThreadPool()替换为Executors.newSingleThreadExecutor()即可,无需改动其他逻辑

内容的提问来源于stack exchange,提问作者AndreaF

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 08:36:00