Reduce memory consumption

In order to achieve smoother viewing experience, PDFViewCtrl keeps certain amount of invisible content. However, keeping invisible content increases memory usage. Android sets an upper bound on the VM heap size allowed for an app. By default, PDFViewCtrl is set to use a quarter of maximum VM heap size for keeping visible and invisible content. Based on the memory footprint of your app, you may want to customize it.

To customize the memory usage:

1long allowedMax = Runtime.getRuntime().maxMemory() / (1024 * 1024);
2 //should NOT use close to allowedMax
3pdfViewCtrl.setRenderedContentCacheSize((long) (allowedMax * 0.25));

1val allowedMax = Runtime.getRuntime().maxMemory() / (1024 * 1024)
2//should NOT use close to allowed_max
3pdfViewCtrl.setRenderedContentCacheSize((allowedMax * 0.25).toLong())

where pdfViewCtrl is an instance of PDFViewCtrl.

Question:

We are experiencing a lot of out of memory errors when rotating the device multiple times. Since the Activity is destroyed while rotating, we get a new (quite heavy) PDFViewCtrl every time we rotate the device.

Answer:

PDFViewCtrl can handle rotation properly, it is recommended that you configure your activity to handle configuration changes. This way the view will not be recreated and it will be resized accordingly.

1. In your app AndroidManifest.xml file, add android:configChanges to your activity tag.

1<activity android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize" >
2  </activity>

1. Override onConfigurationChanged() in your activity:where mPdfViewCtrl is an instance of PDFViewCtrl.

1@Override
2public void onConfigurationChanged(Configuration newConfig) {
3    super.onConfigurationChanged(newConfig);
4    if (mPdfViewCtrl != null) {
5        mPdfViewCtrl.onConfigurationChanged(newConfig);
6    }
7}

1override fun onConfigurationChanged(newConfig: Configuration) {
2  super.onConfigurationChanged(newConfig)
3  mPdfViewCtrl?.onConfigurationChanged(newConfig)
4}

On Android 3.0 and above, you can also increase the allowed heap size of an app.

In your app AndroidManifest.xml file, add the android:largeHeap="true" attribute to the <application> tag:

1<?xml version="1.0" encoding="utf-8"?>
2<manifest xmlns:android="http://schemas.android.com/apk/res/android" >
3  <application android:largeHeap="true" >
4  </application>
5
6</manifest>