近期由于公司需求，需要在APP中优化保存文件功能，对除了jpg，png格式外，还需提供PDF格式，主要是为了将多个页面的内容生成一个文件，而不是保存多个图片文件到存储卡中，于是查了很多资料，看到更多的是通过第三方库进行导出的，但是由于时间紧迫，第三方库需要了解接口同时还需要配置库文件。且了解到android在19版本就提供了相关的PDF接口，于是直接去查看官方的文档：
developer.android.google.cn/reference/index.html
这个链接在国内也可以访问的，是google专门提供给中国开发者的。
具体的类的使用在官方文档中已经讲述的非常清楚：
// 创建一个PDF文本对象
PdfDocument document=new PdfDocument();
//创建当前页的信息，Builder中的参数表示页面的宽高，以及第几页
PageInfo pageInfo=newPageInfo.Builder(newRect(0,0,100,100),1).create();
// 生成当前页
Page page=document.startPage(pageInfo);
// 在当前页上画画，即把所需要的view的视图画到page的画布上
View content=getContentView();
content.draw(page.getCanvas());
// 结束当前页
document.finishPage(page);
...
// 此处在还未调用writeTo()函数之前，可以继续添加页面步骤跟上述PageInfo开始的一样
...
//将PDF文本对象写到一个输出流中，getOutputStream()可以是FileOutputStream
document.writeTo(getOutputStream());
// close the document
document.close();
注：其中getContentView()表示当前需要保存的视图，可以是Layout、Button等View对象
本人在使用的时候遇到了一个问题，就是当这个View是SurfaceView的时候，保存的内容是空白的，因此特地的查了下SurfaceView的源码。因为SurfaceView绘图不是在UI主线程上绘制的，而是通过getHolder()，再通过lockCanvas()取得画布后再绘图，绘制完毕还需要调用unlockCanvasAndPost()解锁并刷新画布。而原本的View中的方法则被处理掉了。
于是只能换种方式了，下面附上代码，思路还是与官方的一致，但代码有区别：
//先判断系统的版本信息
if(android.os.Build.VERSION.SDK_INT>= android.os.Build.VERSION_CODES.KITKAT) {
File sdcarddir = android.os.Environment.getExternalStorageDirectory();
FileOutputStream outputStream =null;
try{
outputStream =newFileOutputStream(newFile(sdcarddir.getPath() +"/123.pdf"));
PdfDocument document =newPdfDocument();
for(inti=1;i<=20;i++) { //循坏表示生成20页PDF
PdfDocument.PageInfo pageInfo =newPdfDocument.PageInfo.Builder(
Constants.displayWidth, Constants.displayHeight, i).create();
PdfDocument.Page page = document.startPage(pageInfo);
//此处是与官方的不同之处，官方的view.draw(page.getCanvas()) 无非也是在page返回的canvas对象上绘图，那么我们可以获取SurfaceView对象的Bitmap后再绘制到page的//canvas上即可
page.getCanvas().drawBitmap(this.mSurfaceView.getDrawingBitmap(),0,0,newPaint());
document.finishPage(page);
}
document.writeTo(outputStream);
document.close();
}catch(FileNotFoundException e) {
e.printStackTrace();
}catch(IOException e) {
e.printStackTrace();
}
}
使用过程中还发现了一些缺点，即当视图的内容比较丰富的时候，存储的速度会较慢，因此建议另外建一个线程，避免阻塞UI主线程。另Android在21版本后添加了PdfRenderer类，此类可以用于查阅PDF文件内容，大家有空的不妨试试。
