ActionOpenPdfDocument.zip

在Android开发中，有时我们需要在应用内部直接查看PDF文件，而无需依赖第三方库或跳转到其他应用。原生的PdfRenderer类就是Android系统提供的一种简单解决方案，它允许开发者高效地渲染和显示PDF文档。本教程将深入讲解如何使用原生的PdfRenderer类来打开并浏览PDF文件。 我们需要在项目中添加对`android.permission.READ_EXTERNAL_STORAGE`权限的请求，因为我们需要读取存储中的PDF文件。在AndroidManifest.xml中添加以下代码： ```xml <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> ``` 接下来，我们创建一个名为`ActionOpenDocument`的Activity，该Activity将负责处理PDF的显示。在活动中，我们需要初始化PdfRenderer对象，这需要一个文件描述符，我们可以从文件路径获取。以下是一个基本的初始化流程： ```java public class ActionOpenDocument extends AppCompatActivity { private PdfRenderer mPdfRenderer; private PdfRenderer.Page mCurrentPage; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_open_document); // 获取PDF文件路径 String filePath = getExternalFilesDir(null) + "/example.pdf"; try { // 打开文件描述符 ParcelFileDescriptor fileDescriptor = ParcelFileDescriptor.open(new File(filePath), ParcelFileDescriptor.MODE_READ_ONLY); // 初始化PdfRenderer mPdfRenderer = new PdfRenderer(fileDescriptor); // 显示第一页 mCurrentPage = mPdfRenderer.openPage(0); } catch (IOException e) { e.printStackTrace(); } } } ``` 在`onCreate`方法中，我们首先获取PDF文件的路径，然后使用`ParcelFileDescriptor.open()`打开文件描述符。接着，使用这个描述符实例化`PdfRenderer`对象，并打开第一页。 为了在界面上显示PDF页面，我们需要一个可以绘制的View。通常我们会自定义一个`SurfaceView`或者使用`TextureView`，这里我们以`SurfaceView`为例： ```java <SurfaceView android:id="@+id/surface_view" android:layout_width="match_parent" android:layout_height="match_parent" /> ``` 在`Activity`中，我们将`SurfaceView`与`PdfRenderer.Page`关联起来： ```java SurfaceView surfaceView = findViewById(R.id.surface_view); SurfaceHolder holder = surfaceView.getHolder(); holder.addCallback(new SurfaceHolder.Callback() { @Override public void surfaceCreated(SurfaceHolder holder) { drawPageOnSurface(); } @Override public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {} @Override public void surfaceDestroyed(SurfaceHolder holder) { if (mCurrentPage != null) { mCurrentPage.close(); mCurrentPage = null; } if (mPdfRenderer != null) { mPdfRenderer.close(); mPdfRenderer = null; } } }); ``` 在`surfaceCreated`回调中，我们调用`drawPageOnSurface`方法来绘制当前页面： ```java private void drawPageOnSurface() { Canvas canvas = holder.lockCanvas(); if (canvas != null && mCurrentPage != null) { Matrix matrix = new Matrix(); matrix.postScale(1f / mCurrentPage.getWidth(), 1f / mCurrentPage.getHeight()); matrix.postTranslate((canvas.getWidth() - mCurrentPage.getWidth()) / 2f, (canvas.getHeight() - mCurrentPage.getHeight()) / 2f); mCurrentPage.render(canvas, matrix, null, PdfRenderer.Page.RENDER_MODE_FOR_DISPLAY); } if (canvas != null) { holder.unlockCanvasAndPost(canvas); } } ``` 在这个方法中，我们首先锁定画布，然后根据页面大小调整缩放和位置，最后绘制页面到画布上。完成后解锁画布。 为了实现分页功能，我们可以添加导航按钮或者手势检测。例如，为用户提供“下一页”功能： ```java Button nextPageButton = findViewById(R.id.next_page_button); nextPageButton.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { if (mCurrentPage.getIndex() < mPdfRenderer.getCount() - 1) { mCurrentPage.close(); mCurrentPage = mPdfRenderer.openPage(mCurrentPage.getIndex() + 1); drawPageOnSurface(); } } }); ``` 至此，我们已经创建了一个基本的PDF阅读器，能够打开和显示PDF文件的页面。通过进一步优化，如添加平滑滚动、缩放等功能，可以使其更加完善。记住，由于PdfRenderer是原生API，性能通常比第三方库更好，但功能可能相对较少。如果需要更多高级特性，可能需要考虑使用像PDFBox或MuPDF这样的第三方库。