如何将Android ListView中的PDF图标替换为PDF封面

嘿，这个需求我之前做类似阅读器的时候也碰到过，刚好能给你一步步捋清楚怎么实现，效果和你说的示例图完全一致～

1. 先搞定PDF解析的依赖 #

首先得能读取PDF的第一页生成封面，这里推荐用Android系统自带的PdfRenderer（API 21+可用，不用额外加第三方库，轻量又稳定）。如果要兼容Android 5.0以下的版本，可以用第三方库比如android-pdf-viewer，不过现在大部分设备都是5.0以上了，优先用系统的就行。

系统的PdfRenderer不需要额外加Gradle依赖，直接用就行；如果要兼容低版本，就加这个：

implementation 'com.github.barteksc:android-pdf-viewer:3.2.0-beta.1'

2. 写个生成PDF封面的工具类 #

咱们得写个工具类专门处理PDF封面的生成，而且必须异步执行，不然解析PDF会阻塞UI线程，导致界面卡顿。代码如下：

public class PdfCoverGenerator {

    // 异步生成PDF第一页的Bitmap封面
    public static void generateCover(String pdfPath, int targetWidth, int targetHeight, OnCoverGeneratedListener listener) {
        new AsyncTask<Void, Void, Bitmap>() {
            @Override
            protected Bitmap doInBackground(Void... voids) {
                Bitmap coverBitmap = null;
                try {
                    File pdfFile = new File(pdfPath);
                    // 打开PDF文件的描述符
                    ParcelFileDescriptor fd = ParcelFileDescriptor.open(pdfFile, ParcelFileDescriptor.MODE_READ_ONLY);
                    PdfRenderer pdfRenderer = new PdfRenderer(fd);

                    // 确保PDF有至少一页
                    if (pdfRenderer.getPageCount() > 0) {
                        PdfRenderer.Page firstPage = pdfRenderer.openPage(0);
                        // 计算缩放比例，保证封面不变形
                        float scale = Math.min((float) targetWidth / firstPage.getWidth(), 
                                               (float) targetHeight / firstPage.getHeight());
                        // 创建对应尺寸的Bitmap
                        coverBitmap = Bitmap.createBitmap(
                            (int) (firstPage.getWidth() * scale),
                            (int) (firstPage.getHeight() * scale),
                            Bitmap.Config.ARGB_8888
                        );
                        // 渲染第一页到Bitmap上
                        firstPage.render(coverBitmap, null, null, PdfRenderer.Page.RENDER_MODE_FOR_DISPLAY);
                        firstPage.close();
                    }
                    pdfRenderer.close();
                    fd.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
                return coverBitmap;
            }

            @Override
            protected void onPostExecute(Bitmap bitmap) {
                super.onPostExecute(bitmap);
                if (listener != null) {
                    listener.onCoverGenerated(bitmap);
                }
            }
        }.execute();
    }

    // 回调接口，通知封面生成结果
    public interface OnCoverGeneratedListener {
        void onCoverGenerated(Bitmap coverBitmap);
    }
}

3. 修改ListView的Adapter #

原来的Adapter里应该是直接给ImageView设置通用PDF图标，现在咱们要改成先显示默认图标，然后异步生成封面，还要加上缓存避免重复解析（不然刷列表的时候会重复解析，费性能还容易OOM）。

举个Adapter的修改示例：

public class PdfListAdapter extends ArrayAdapter<File> {
    private Context mContext;
    private List<File> mPdfFiles;
    // 用LruCache缓存封面，避免重复解析PDF
    private LruCache<String, Bitmap> mCoverCache;

    public PdfListAdapter(Context context, List<File> pdfFiles) {
        super(context, 0, pdfFiles);
        mContext = context;
        mPdfFiles = pdfFiles;

        // 初始化缓存，设置最大缓存为应用可用内存的1/8，避免OOM
        int maxMemory = (int) (Runtime.getRuntime().maxMemory() / 1024);
        int cacheSize = maxMemory / 8;
        mCoverCache = new LruCache<String, Bitmap>(cacheSize) {
            @Override
            protected int sizeOf(String key, Bitmap bitmap) {
                // 返回Bitmap的大小（KB）
                return bitmap.getByteCount() / 1024;
            }
        };
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        View listItem = convertView;
        if (listItem == null) {
            listItem = LayoutInflater.from(mContext).inflate(R.layout.list_item_pdf, parent, false);
        }

        File currentPdf = mPdfFiles.get(position);
        ImageView coverImg = listItem.findViewById(R.id.pdf_cover_img);
        TextView fileNameTv = listItem.findViewById(R.id.pdf_file_name);

        // 设置文件名
        fileNameTv.setText(currentPdf.getName());

        // 先从缓存取封面，如果有直接显示
        Bitmap cachedCover = mCoverCache.get(currentPdf.getAbsolutePath());
        if (cachedCover != null) {
            coverImg.setImageBitmap(cachedCover);
            return listItem;
        }

        // 缓存没有的话，先显示默认图标，再异步生成封面
        coverImg.setImageResource(R.drawable.ic_default_pdf);
        // 获取ImageView的目标尺寸，如果还没测量就用默认dp转px的尺寸
        int targetWidth = coverImg.getWidth();
        int targetHeight = coverImg.getHeight();
        if (targetWidth == 0 || targetHeight == 0) {
            targetWidth = dpToPx(mContext, 120);
            targetHeight = dpToPx(mContext, 160);
        }

        // 调用工具类生成封面
        PdfCoverGenerator.generateCover(currentPdf.getAbsolutePath(), targetWidth, targetHeight, 
            new PdfCoverGenerator.OnCoverGeneratedListener() {
                @Override
                public void onCoverGenerated(Bitmap coverBitmap) {
                    if (coverBitmap != null) {
                        // 把封面存入缓存
                        mCoverCache.put(currentPdf.getAbsolutePath(), coverBitmap);
                        // 主线程更新UI
                        coverImg.post(() -> coverImg.setImageBitmap(coverBitmap));
                    } else {
                        // 生成失败，继续显示默认图标
                        coverImg.post(() -> coverImg.setImageResource(R.drawable.ic_default_pdf));
                    }
                }
            });

        return listItem;
    }

    // dp转px的工具方法
    private int dpToPx(Context context, int dp) {
        return (int) (dp * context.getResources().getDisplayMetrics().density);
    }
}

4. 几个关键注意事项 #

• 权限问题：如果你的PDF文件在外部存储，记得申请READ_EXTERNAL_STORAGE权限；Android 10及以上可以用MediaStore来获取文件，或者申请MANAGE_EXTERNAL_STORAGE权限（根据你的目标SDK版本调整）。
• API兼容：如果要支持Android 5.0以下，把PdfRenderer换成第三方库的解析方式就行，比如android-pdf-viewer的PdfDocument类。
• 内存优化：一定要用LruCache缓存封面，不然大量PDF文件会导致内存溢出，这个很重要！
• 异步处理：解析PDF是耗时操作，绝对不能放在UI线程，必须用异步任务或者协程处理，不然会出现ANR（应用无响应）。

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