![Screenshot_20210921-100235_Physics Xi](https://user-images.githubusercontent.com/35397403/218979000-65b02ed2-3cc3-446c-8002-c686cac0092c.jpg)
implementation 'com.github.barteksc:android-pdf-viewer:3.2.0-beta.1'
implementation 'com.github.barteksc:android-pdf-viewer:2.8.2'
-keep class com.shockwave.**
<com.github.barteksc.pdfviewer.PDFView android:id="@+id/pdfView" android:layout_width="match_parent" android:layout_height="match_parent"/>
pdfView.fromUri(Uri) or pdfView.fromFile(File) or pdfView.fromBytes(byte[]) or pdfView.fromStream(InputStream) // stream is written to bytearray - native code cannot use Java Streams or pdfView.fromSource(DocumentSource) or pdfView.fromAsset(String) .pages(0, 2, 1, 3, 3, 3) // all pages are displayed by default .enableSwipe(true) // allows to block changing pages using swipe .swipeHorizontal(false) .enableDoubletap(true) .defaultPage(0) // allows to draw something on the current page, usually visible in the middle of the screen .onDraw(onDrawListener) // allows to draw something on all pages, separately for every page. Called only for visible pages .onDrawAll(onDrawListener) .onLoad(onLoadCompleteListener) // called after document is loaded and starts to be rendered .onPageChange(onPageChangeListener) .onPageScroll(onPageScrollListener) .onError(onErrorListener) .onPageError(onPageErrorListener) .onRender(onRenderListener) // called after document is rendered for the first time // called on single tap, return true if handled, false to toggle scroll handle visibility .onTap(onTapListener) .onLongPress(onLongPressListener) .enableAnnotationRendering(false) // render annotations (such as comments, colors or forms) .password(null) .scrollHandle(null) .enableAntialiasing(true) // improve rendering a little bit on low-res screens // spacing between pages in dp. To define spacing color, set view background .spacing(0) .autoSpacing(false) // add dynamic spacing to fit each page on its own on the screen .linkHandler(DefaultLinkHandler) .pageFitPolicy(FitPolicy.WIDTH) // mode to fit pages in the view .fitEachPage(false) // fit each page to the view, else smaller pages are scaled relative to largest page. .pageSnap(false) // snap pages to screen boundaries .pageFling(false) // make a fling change only a single page like ViewPager .nightMode(false) // toggle night mode .load();
pages
is optional, it allows you to filter and order the pages of the PDF as you need
Configurator#scrollHandle()
. This method accepts implementations of ScrollHandle interface..scrollHandle(new DefaultScrollHandle(this))
. 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.pdfView.fromUri(Uri)
pdfView.fromFile(File)
pdfView.fromBytes(byte[])
pdfView.fromStream(InputStream)
pdfView.fromAsset(String)
pdfView.fromSource(DocumentSource)
method.Configurator#linkHandler(LinkHandler)
method. Take a look at DefaultLinkHandler source to implement custom behavior.- WIDTH - width of widest page is equal to screen width
- HEIGHT - height of highest page is equal to screen height
- BOTH - based on widest and highest pages, every page is scaled to be fully visible on screen
Configurator#pageFitPolicy(FitPolicy)
. Default policy is WIDTH.RGB_565
format to reduce memory consumption. Rendering with ARGB_8888
can be forced by using pdfView.useBestQuality(true)
method.void setMinZoom(float zoom); void setMidZoom(float zoom); void setMaxZoom(float zoom);
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.Downloading files is long running process which must be aware of Activity lifecycle, must support some configuration, data cleanup and caching, so creating such module will probably end up as new library.You have to store current page number and then set it withpdfView.defaultPage(page)
, refer to sample appUseFitPolicy.WIDTH
policy or add following snippet when you want to fit desired page in document with different page sizes:Configurator.onRender(new OnRenderListener() { @Override public void onInitiallyRendered(int pages, float pageWidth, float pageHeight) { pdfView.fitToWidth(pageIndex); } });You can use a combination of the following settings to get scroll and fling behaviour similar to a ViewPager:.swipeHorizontal(true) .pageSnap(true) .autoSpacing(true) .pageFling(true)