com.facebook.soloader

Class NativeLibrary

java.lang.Object

com.facebook.soloader.NativeLibrary

public abstract class NativeLibrary
extends java.lang.Object

This is the base class for all the classes representing certain native library. For loading native libraries we should always inherit from this class and provide relevant information (libraries to load, code to test native call, dependencies?).

This instances should be singletons provided by DI.

This is a basic template but could be improved if we find the need.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NativeLibrary(java.util.List<java.lang.String> libraryNames)

Method Summary

Methods

Modifier and Type	Method and Description
void	ensureLoaded() loads libraries (if not loaded yet), throws on failure
java.lang.UnsatisfiedLinkError	getError()
protected void	initialNativeCheck() Override this method to make some concrete (quick and harmless) native call.
boolean	loadLibraries() safe loading of native libs

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NativeLibrary

protected NativeLibrary(java.util.List<java.lang.String> libraryNames)

Method Detail

loadLibraries

public boolean loadLibraries()

safe loading of native libs

Returns:

true if native libs loaded properly, false otherwise

ensureLoaded

public void ensureLoaded()
                  throws java.lang.UnsatisfiedLinkError

loads libraries (if not loaded yet), throws on failure

Throws:

java.lang.UnsatisfiedLinkError

initialNativeCheck

protected void initialNativeCheck()
                           throws java.lang.UnsatisfiedLinkError

Override this method to make some concrete (quick and harmless) native call. This avoids lazy-loading some phones (LG) use when we call loadLibrary. If there's a problem we'll face an UnsupportedLinkError when first using the feature instead of here. This check force a check right when intended. This way clients of this library can know if it's loaded for sure or not.

Throws:

java.lang.UnsatisfiedLinkError - if there was an error loading native library

getError

public java.lang.UnsatisfiedLinkError getError()