【亲测免费】 AndroidPdfViewer 使用教程

1. 项目目录结构及介绍

在AndroidPdfViewer项目中，目录结构大致如下：

AndroidPdfViewer/
├── app/               # 示例应用程序模块
│   ├── src/           # 示例应用源码
│   └── res/           # 示例应用资源
├── library/          # PDF查看器库模块
│   ├── src/           # 库源码
│   └── res/           # 库资源
├── build.gradle       # 根级构建脚本
└── settings.gradle     # 项目设置文件

• app: 包含一个示例应用，演示如何集成和使用AndroidPdfViewer库。
• library: AndroidPdfViewer的核心模块，实现了PDF查看功能。

2. 项目的启动文件介绍

启动文件位于app/src/main/java/com/barteksc/examples/MainActivity.java。在这个例子中，MainActivity展示了如何初始化并加载PDF文件。关键部分如下：

public class MainActivity extends AppCompatActivity {
    private PDFView pdfView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        pdfView = findViewById(R.id.pdf_view);
        pdfView.fromAsset("sample.pdf")
                .load();
    }
}

在这个例子中，pdfView对象从应用的assets目录加载名为sample.pdf的PDF文件。

3. 项目的配置文件介绍

app/build.gradle

在app/build.gradle文件中，你需要导入库依赖并设定应用的基本配置。确保你有如下依赖：

dependencies {
    implementation 'com.github.barteksc:android-pdf-viewer:2.8.2'
}

settings.gradle

在项目的根目录settings.gradle中，你不需要任何特殊配置，因为AndroidPdfViewer已经被定义为子模块。

AndroidManifest.xml

在app/src/main/AndroidManifest.xml中，检查是否包含了必要的权限，如访问网络或者外部存储（如果需要从这些位置加载PDF）：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

activity_main.xml

app/src/main/res/layout/activity_main.xml是应用主界面的布局文件，其中包含了PDFView组件：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.github.barteksc.pdfviewer.PDFView
        android:id="@+id/pdf_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</LinearLayout>

总结，AndroidPdfViewer是一个强大的PDF查看库，通过理解其目录结构、启动文件和配置，你可以轻松地将其整合进你的Android应用中。