Android Kotlin中Fragment暂停时如何终止进度条动画线程

问题描述 #

想要通过for循环设置ProgressBar的进度来实现动画，但循环速度过快导致看不到动画效果。尝试在循环中添加Thread.sleep()延迟但无效，初始代码如下：

private fun showProgress() {
    for(i in 0..100){
        Thread{
            binding.customProgressBar.progress=i
            Thread.sleep(100)
        }
    }
}

初始代码问题分析 #

这段代码存在两个核心问题：

1. 每次循环创建的Thread对象未调用start()方法，线程根本没有执行，因此延迟和进度设置均不生效；
2. 直接在子线程中修改UI组件（ProgressBar的progress），违反Android UI线程操作规则，会触发CalledFromWrongThreadException异常。

修正后的基础代码 #

修复线程启动问题，并确保UI操作在主线程执行：

private fun showProgress() {
    Thread {
        for (i in 0..100) {
            // 切换到主线程更新UI
            requireActivity().runOnUiThread {
                binding.customProgressBar.progress = i
            }
            Thread.sleep(100)
        }
    }.start()
}

更优的ProgressBar动画实现方案 #

除手动管理线程外，Android提供了更适配动画场景的ValueAnimator，无需手动处理线程，且天然支持主线程UI更新：

private fun showProgressWithAnimator() {
    ValueAnimator.ofInt(0, 100).apply {
        duration = 10000 // 总时长10秒，对应原代码每次100ms的间隔
        addUpdateListener { animation ->
            binding.customProgressBar.progress = animation.animatedValue as Int
        }
        start()
    }
}

该方式更简洁，还能轻松控制动画时长、插值器等，避免手动线程管理的繁琐与潜在问题。

Fragment处于Pause状态时终止线程的实现 #

手动线程方案的终止方式 #

1. 定义全局线程变量与终止标记：

private var progressThread: Thread? = null
private var isThreadRunning = false

2. 修改showProgress()方法，初始化线程并设置运行标记：

private fun showProgress() {
    isThreadRunning = true
    progressThread = Thread {
        var i = 0
        while (i <= 100 && isThreadRunning) {
            requireActivity().runOnUiThread {
                binding.customProgressBar.progress = i
            }
            try {
                Thread.sleep(100)
            } catch (e: InterruptedException) {
                // 捕获中断异常，直接退出循环
                break
            }
            i++
        }
    }
    progressThread?.start()
}

3. 在Fragment的onPause()方法中终止线程：

override fun onPause() {
    super.onPause()
    isThreadRunning = false
    progressThread?.interrupt()
    progressThread = null
}

ValueAnimator方案的终止方式 #

如果使用ValueAnimator，终止逻辑更简单：

private var progressAnimator: ValueAnimator? = null

private fun showProgressWithAnimator() {
    progressAnimator = ValueAnimator.ofInt(0, 100).apply {
        duration = 10000
        addUpdateListener { animation ->
            binding.customProgressBar.progress = animation.animatedValue as Int
        }
        start()
    }
}

override fun onPause() {
    super.onPause()
    progressAnimator?.cancel()
    progressAnimator = null
}

内容的提问来源于stack exchange，提问作者Himanshu Yadav Anshu