Android图像转PDF应用调用convert方法时ProgressBar无法显示问题

问题根因 #

所有逻辑都运行在Android主线程（UI线程）中是问题的核心原因：

• progressBar.setVisibility(View.VISIBLE) 只是向系统提交了UI更新请求，不会立刻完成绘制，需要等待主线程下一次帧渲染任务执行时才会生效
• 你在提交更新请求后立刻在主线程执行了convert()方法，该方法包含图片读取、PDF渲染、文件写入等重度耗时操作，直接阻塞了主线程，系统无法执行进度条的绘制任务，因此看不到进度条显示，log中的跳帧提示也对应这个问题。

修复方案 #

把耗时的convert()逻辑放到子线程执行，UI相关操作再切回主线程即可。

第一步：修改按钮点击事件代码 #

conButton.setOnClickListener(v -> {
    // 主线程更新进度条可见
    progressBar.setVisibility(View.VISIBLE);
    // 开启子线程执行耗时转换逻辑
    new Thread(() -> {
        try {
            convert();
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 任务结束后切回主线程隐藏进度条
            runOnUiThread(() -> progressBar.setVisibility(View.GONE));
        }
    }).start();
});

第二步：修改convert方法中的UI操作 #

子线程不能直接操作UI，所以需要把convert()方法中的Toast、弹窗关闭等逻辑切回主线程执行，修改对应部分代码如下：

String userInputName = editText.getText().toString().trim();
if (userInputName.isEmpty()) {
    runOnUiThread(() -> Toast.makeText(this, "请输入有效的PDF文件名", Toast.LENGTH_SHORT).show());
} else {
    File saveFile= new File(path+"/"+userInputName+".pdf");
    document.save(saveFile);
    runOnUiThread(() -> {
        Toast.makeText(this, "PDF已保存至路径：" + path, Toast.LENGTH_SHORT).show();
        dialog.dismiss();
    });
}

补充注意事项 #

• 如果担心页面销毁后线程仍在运行导致内存泄漏，可以给线程添加终止判断标记，或者使用ViewModel+协程、WorkManager等更符合生命周期安全的方案实现异步任务
• 多图转换场景下，你可以在子线程的循环中实时计算转换进度，切回主线程更新进度条的展示，替代默认的不确定进度样式。

内容的提问来源于stack exchange，提问作者Shivanshu Raj