Foxit MobilePDF SDK_如何快速创建一个功能丰富的PDF 阅读器

一直以来，我都比较关注福昕的PDF SDK套件，这几天稍微有时间看了下最新发布的4.0版本，然后呢，然后呢，我就被深深的震惊到了，为甚么？因为这个版本可以很轻松很容易的创建一个功能超级丰富的PDF阅读器，而且可以通过一个配置文件就能实现功能定制。

还是附上下载的链接: 有兴趣的同学们可以下载试用下： https://www.foxitsoftware.com/products/sdk/register.php?product=MobilePDFSDK

话不多说，我们来看下福昕新发布的MobilePDF SDK是如何做到快速创建一个功能丰富的PDF阅读器的。

新建Android工程，导入Foxit的SDK库

创建一个Android 工程，这里我命名为PDFViewer, 然后导入Foxit的SDK库，这两步可以看我之前的文章Foxit Mobile PDF SDK for Android_渲染PDF文档(2) 中准备工作的第一点和第二点。

附上配置后的app下的build.gradle：

apply plugin: 'com.android.application'android {compileSdkVersion 25buildToolsVersion "25.0.3"defaultConfig {applicationId "com.foxit.pdfviewer"minSdkVersion 16targetSdkVersion 22versionCode 1versionName "1.0"testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"}buildTypes {release {minifyEnabled falseproguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'}}sourceSets {main {jniLibs.srcDirs = ['libs']}}
}repositories {flatDir {dirs 'libs'}
}dependencies {compile name: 'FoxitRDKUIExtensions', ext: 'aar'compile 'com.android.support:appcompat-v7:25.3.1'compile 'com.android.support.constraint:constraint-layout:1.0.0-alpha7'compile 'com.android.support:recyclerview-v7:25.3.1'testCompile 'junit:junit:4.12'
}

Unlock SDK 库

// load "librdk.so" library.
static {System.loadLibrary("rdk");
}
….
String sn = " ";
String key = " ";try {// initialize the library.Library.init(sn, key);
} catch (PDFException e) {e.printStackTrace();return;
}

note： sn和key是一串比较长的字符串，大家可以到libs目录下的rdk_sn.txt和rdk_key.txt文件中copy过来，或者从demo中copy。

编写JSON配置文件

如下所示：(这里我命名为：config.json)

{"defaultReader": true,"modules": {"readingbookmark": true,"outline": true,"annotations": true,"thumbnail" : true,"attachment": true,"signature": true,"search": true,"pageNavigation": true,"form": true,"selection": true,"encryption" : true}
}

然后将编写好的JSON文件放到”PDFViewer\app\src\main\res\raw” 目录下(需要自己创建”raw”目录).

Note：配置文件中的 “defaultReader”在默认情况下是false的，也就是和4.0版本之前的SDK是兼容的。以前的SDK是没有这么智能化的，如果你想实现一个功能丰富的PDF Reader app, 你需要自己设计app的界面，以及调用福昕SDK来实现你想要的功能。这是一个比较复杂的过程，你需要对福昕的SDK有一定的了解才能做好这个app。而SDK 4.0 将很多基础的UI都封装到了一个PDFReader的类中，而且通过简单的配置文件可以自由的定制你想要的功能。

初始化UIExtensionsManager和PDFReader

关于UIExtensionsManager可以查看Foxit Mobile PDF SDK for Android_渲染PDF文档(2)中的介绍。
这里使用JSON配置文件来初始化UIExtensionsManager, 以及获取当前的PDFReader，代码如下：

private PDFViewCtrl pdfViewCtrl = null;
private UIExtensionsManager uiextensionsManager = null;
private PDFReader mPDFReader = null;
...
// Instantiate a PDFViewCtrl object.
pdfViewCtrl = new PDFViewCtrl(this.getApplicationContext());// Get the config file, and set it to UIExtensionsManager.
InputStream stream = this.getApplicationContext().getResources().openRawResource(R.raw.uiextensions_config);
UIExtensionsManager.Config config = new UIExtensionsManager.Config(stream);// Instantiate a UIExtensionsManager object and set it to PDFViewCtrl.
uiextensionsManager = new UIExtensionsManager(this.getApplicationContext(), null, pdfViewCtrl, config);
uiextensionsManager.setAttachedActivity(this);
pdfViewCtrl.setUIExtensionsManager(uiextensionsManager);// Get current PDFReader, and set it to PDFViewCtrl.
mPDFReader = (PDFReader) uiextensionsManager.getPDFReader();
mPDFReader.onCreate(this, pdfViewCtrl, savedInstanceState);

Activity生命周期处理

需要加入Activity生命周期的处理，不然有些功能使用会出现问题。
更新MainActivity.java 如下：

package com.foxit.pdfreader;import android.content.Intent;
import android.content.res.Configuration;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.KeyEvent;
import android.view.Menu;
import android.view.WindowManager;import com.foxit.sdk.PDFViewCtrl;
import com.foxit.sdk.common.Library;
import com.foxit.sdk.common.PDFException;
import com.foxit.uiextensions.UIExtensionsManager;
import com.foxit.uiextensions.home.IHomeModule;
import com.foxit.uiextensions.pdfreader.impl.MainFrame;
import com.foxit.uiextensions.pdfreader.impl.PDFReader;
import com.foxit.uiextensions.utils.AppFileUtil;import java.io.InputStream;public class MainActivity extends AppCompatActivity {private PDFViewCtrl pdfViewCtrl = null;private UIExtensionsManager uiextensionsManager = null;private PDFReader mPDFReader = null;// Load "librdk.so" library.static {System.loadLibrary("rdk");}@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);// The value of "sn" can be found in the “rdk_sn.txt”.// The value of "key" can be found in the “rdk_key.txt”.String sn = " ";String key = " ";try {// initialize the library.Library.init(sn, key);} catch (PDFException e) {e.printStackTrace();return;}// Instantiate a PDFViewCtrl object.pdfViewCtrl = new PDFViewCtrl(this.getApplicationContext());// Get the config file, and set it to UIExtensionsManager.InputStream stream = this.getApplicationContext().getResources().openRawResource(R.raw.uiextensions_config);UIExtensionsManager.Config config = new UIExtensionsManager.Config(stream);// Instantiate a UIExtensionsManager object and set it to PDFViewCtrl.uiextensionsManager = new UIExtensionsManager(this.getApplicationContext(), null, pdfViewCtrl, config);uiextensionsManager.setAttachedActivity(this);pdfViewCtrl.setUIExtensionsManager(uiextensionsManager);// Get current PDFReader, and set it to PDFViewCtrl.mPDFReader = (PDFReader) uiextensionsManager.getPDFReader();mPDFReader.onCreate(this, pdfViewCtrl, savedInstanceState);// load a documentString path = "mnt/sdcard/pdf/Sample.pdf";mPDFReader.openDocument(path, null);setContentView(mPDFReader.getContentView());}@Overrideprotected void onNewIntent(Intent intent) {super.onNewIntent(intent);if (mPDFReader == null)return;if (mPDFReader.getMainFrame().getAttachedActivity() != this)return;setIntent(intent);String path = AppFileUtil.getFilePath(this, intent, IHomeModule.FILE_EXTRA);if (path != null) {mPDFReader.openDocument(path, null);}}@Overrideprotected void onStart() {super.onStart();if (mPDFReader == null)return;mPDFReader.onStart(this);}@Overrideprotected void onPause() {super.onPause();if (mPDFReader == null)return;mPDFReader.onPause(this);}@Overrideprotected void onResume() {super.onResume();if (mPDFReader == null)return;mPDFReader.onResume(this);}@Overrideprotected void onStop() {super.onStop();if (mPDFReader == null)return;mPDFReader.onStop(this);}@Overrideprotected void onDestroy() {this.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);if (mPDFReader != null)mPDFReader.onDestroy(this);super.onDestroy();}@Overrideprotected void onActivityResult(int requestCode, int resultCode, Intent data) {super.onActivityResult(requestCode, resultCode, data);if (mPDFReader != null)mPDFReader.onActivityResult(this, requestCode, resultCode, data);}@Overridepublic void onConfigurationChanged(Configuration newConfig) {super.onConfigurationChanged(newConfig);if (mPDFReader == null)return;((MainFrame) mPDFReader.getMainFrame()).updateSettingBar();mPDFReader.onConfigurationChanged(this, newConfig);}@Overridepublic boolean onKeyDown(int keyCode, KeyEvent event) {if (mPDFReader != null && mPDFReader.onKeyDown(this, keyCode, event))return true;return super.onKeyDown(keyCode, event);}@Overridepublic boolean onPrepareOptionsMenu(Menu menu) {if (mPDFReader != null && !mPDFReader.onPrepareOptionsMenu(this, menu))return false;return super.onPrepareOptionsMenu(menu);}
}

更新 AndroidManifest.xml文件

填写相应的读写权限，以及设置“android:configChanges="keyboardHidden|orientation|screenSize">” 属性(为了在屏幕发生旋转时，只调用onConfigurationChanged()函数，而不用重新执行Activity的生命周期).

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.foxit.pdfviewer"><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/><uses-permission android:name="android.permission.CAMERA" /><application
        android:allowBackup="true"android:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:roundIcon="@mipmap/ic_launcher_round"android:supportsRtl="true"android:theme="@style/AppTheme"><activity android:name=".MainActivity"android:configChanges="keyboardHidden|orientation|screenSize"><intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter></activity></application>
</manifest>

运行PDFViewer

我这里使用他们的sample.pdf文件，运行后，可以看到一个功能丰富的PDF viewer就出现了，如下图所示：

主界面：

List面板

View面板

Annotation面板

Signature面板

看了这些图，是不是觉得灰常的强大啊，只需要这么点代码就能实现一个如此强大，如此专业的PDF Viewer。反正我是被震惊到了，所以写了这篇文章来和大家分享。

注：此文主要参考了他们官方的Developer Guide文档，很多代码都直接从里面copy的，有点小偷懒哈。