ReLinker

A robust native library loader for Android. More information can be found in our blog post

Min SDK: 9

Overview

The Android PackageManager's native library loading is unreliable. Occasionally when using native libraries, you will encounter a stack trace like this:

java.lang.UnsatisfiedLinkError: Couldn't load stlport_shared from loader dalvik.system.PathClassLoader: findLibrary returned null
at java.lang.Runtime.loadLibrary(Runtime.java:365)
at java.lang.System.loadLibrary(System.java:535)
at com.kii.safe.Native.<clinit>(Native.java:16)
... 63 more

Caused by: java.lang.UnsatisfiedLinkError: Library stlport_shared not found
at java.lang.Runtime.loadLibrary(Runtime.java:461)
at java.lang.System.loadLibrary(System.java:557)
at com.kii.safe.Native.<clinit>(Native.java:16)
... 5 more

ReLinker fixes these issues by replacing the standard System.loadLibrary call with a more reliable implementation.

Note that this library fixes intermittent link errors; if you get an error every time you use your app, you may have a configuration issue. See this StackOverflow question for more information.

Installation

ReLinker is distributed using jitpack.

To use ReLinker in your project, add the following to your gradle build file:

   repositories { 
        jcenter()
        maven { url "https://jitpack.io" }
   }
   
   dependencies {
         compile 'com.github.KeepSafe:ReLinker:1.1'
   }

Usage

Simply replace a call to System.loadLibrary like this:

System.loadLibrary("mylibrary");

With a call to ReLinker.loadLibrary like this:

ReLinker.loadLibrary(context, "mylibrary");

Sample application

See the sample application under sample/ for a quick demo.

License