AndroidPdfViewer 1.x is available on AndroidPdfViewerV1 repo, where can be developed independently. Version 1.x uses different engine for drawing document on canvas, so if you don't like 2.x version, try 1.x.
Library for displaying PDF documents on Android, with
double tap support.
It is based on PdfiumAndroid for decoding PDF files. Works on API 11 and higher.
Licensed under Apache License 2.0.
What's new in 2.4.0?
- Merge pull request by hansinator85 which allows to enable/disable rendering during scale
- Make rendering during scale disabled by default (looks better)
- Merge pull request by cesquivias which replaces RenderingAsyncTask with Handler to simply code and work with testing frameworks
Changes in 2.0 API
PDFView#jumpTo(int)now require page index (i.e. starting from 0)
OnPageChangeListener#onPageChanged(int, int)is called with page index (i.e. starting from 0)
- removed scrollbar
- added scroll handle as a replacement for scrollbar, use with
OnPageScrollListenerlistener due to continuous scroll, register with
- default scroll direction is vertical, so
Configurator#swipeVertical()was changed to
- removed minimap and mask configuration
Add to build.gradle:
Library is available in jcenter repository, probably it'll be in Maven Central soon.
Include PDFView in your layout
<com.github.barteksc.pdfviewer.PDFView android:id="@+id/pdfView" android:layout_width="match_parent" android:layout_height="match_parent"/>
Load a PDF file
All available options with default values:
pdfView.fromUri(Uri) or pdfView.fromFile(File) or pdfView.fromBytes(byte) or pdfView.fromStream(InputStream) or pdfView.fromSource(DocumentSource) or pdfView.fromAsset(String) .pages(0, 2, 1, 3, 3, 3) // all pages are displayed by default .enableSwipe(true) .swipeHorizontal(false) .enableDoubletap(true) .defaultPage(0) .onDraw(onDrawListener) .onLoad(onLoadCompleteListener) .onPageChange(onPageChangeListener) .onPageScroll(onPageScrollListener) .onError(onErrorListener) .enableAnnotationRendering(false) .password(null) .scrollHandle(null) .load();
enableSwipeis optional, it allows you to block changing pages using swipe
pagesis optional, it allows you to filter and order the pages of the PDF as you need
onDrawis also optional, and allows you to draw something on a provided canvas, above the current page
Scroll handle is replacement for ScrollBar from 1.x branch.
From version 2.1.0 putting PDFView in RelativeLayout to use ScrollHandle is not required, you can use any layout.
To use scroll handle just register it using method
This method accepts implementations of ScrollHandle interface.
There is default implementation shipped with AndroidPdfViewer, and you can use it with
DefaultScrollHandle is placed on the right (when scrolling vertically) or on the bottom (when scrolling horizontally).
By using constructor with second argument (
new DefaultScrollHandle(this, true)), handle can be placed left or top.
You can also create custom scroll handles, just implement ScrollHandle interface. All methods are documented as Javadoc comments on interface source.
Version 2.3.0 introduced document sources, which are just providers for PDF documents. Every provider implements DocumentSource interface. Predefined providers are available in com.github.barteksc.pdfviewer.source package and can be used as samples for creating custom ones.
Predefined providers can be used with shorthand methods:
pdfView.fromUri(Uri) pdfView.fromFile(File) pdfView.fromBytes(byte) pdfView.fromStream(InputStream) pdfView.fromAsset(String)
Custom providers may be used with
By default, generated bitmaps are compressed with
RGB_565 format to reduce memory consumption.
ARGB_8888 can be forced by using
Double tap zooming
There are three zoom levels: min (default 1), mid (default 1.75) and max (default 3). On first double tap, view is zoomed to mid level, on second to max level, and on third returns to min level. If you are between mid and max levels, double tapping causes zooming to max and so on.
Zoom levels can be changed using following methods:
void setMinZoom(float zoom); void setMidZoom(float zoom); void setMaxZoom(float zoom);
Why resulting apk is so big?
Android PdfViewer depends on PdfiumAndroid, which is set of native libraries (almost 16 MB) for many architectures. Apk must contain all this libraries to run on every device available on market. Fortunately, Google Play allows us to upload multiple apks, e.g. one per every architecture. There is good article on automatically splitting your application into multiple apks, available here. Most important section is Improving multiple APKs creation and versionCode handling with APK Splits, but whole article is worth reading. You only need to do this in your application, no need for forking PdfiumAndroid or so.
One more thing
If you have any suggestions on making this lib better, write me, create issue or write some code and send pull request.
Created with the help of android-pdfview by Joan Zapata
Copyright 2016 Bartosz Schiller Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.