com.facebook.soloader.nativeloader

Class NativeLoader

java.lang.Object

com.facebook.soloader.nativeloader.NativeLoader

public class NativeLoader
extends java.lang.Object

Facade to load native libraries for android

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getLibraryPath(java.lang.String shortName) Get the path of a loaded shared library.
static int	getSoSourcesVersion() Get the version of the loader used.
static void	init(NativeLoaderDelegate delegate) Initializes native code loading for this app.
static void	initIfUninitialized(NativeLoaderDelegate delegate) Perform an initialization only if NativeLoader has not already been initialized.
static boolean	isInitialized() Determine whether NativeLoader has already been initialized.
static boolean	loadLibrary(java.lang.String shortName)
static boolean	loadLibrary(java.lang.String shortName, int flags) Load a shared library, initializing any JNI binding it contains.

Methods inherited from class java.lang.Object

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

Method Detail

loadLibrary

public static boolean loadLibrary(java.lang.String shortName)

loadLibrary

public static boolean loadLibrary(java.lang.String shortName,
                                  int flags)

Load a shared library, initializing any JNI binding it contains. Depending upon underlying loader, behavior can be customized based on passed in flag

Parameters:

shortName - Name of library to find, without "lib" prefix or ".so" suffix

flags - 0 for default behavior, otherwise NativeLoaderDelegate defines other behaviors.

Returns:

Whether the library was loaded as a result of this call (true), or was already loaded through a previous call (false).

getLibraryPath

public static java.lang.String getLibraryPath(java.lang.String shortName)
                                       throws java.io.IOException

Get the path of a loaded shared library.

Parameters:

shortName - Name of library to find, without "lib" prefix or ".so" suffix

Returns:

The path for the loaded library, null otherwise.

Throws:

java.io.IOException

getSoSourcesVersion

public static int getSoSourcesVersion()

Get the version of the loader used.

Returns:

The version number for the loader.

init

public static void init(NativeLoaderDelegate delegate)

Initializes native code loading for this app. Should be called only once, before any calls to loadLibrary(String).

Parameters:

delegate - Delegate to use for all loadLibrary calls.

isInitialized

public static boolean isInitialized()

Determine whether NativeLoader has already been initialized. This method should not normally be used, because initialization should be performed only once during app startup. However, libraries that want to provide a default initialization for NativeLoader to hide its existence from the app can use this method to avoid re-initializing.

Returns:

True iff init(NativeLoaderDelegate) has been called.

initIfUninitialized

public static void initIfUninitialized(NativeLoaderDelegate delegate)

Perform an initialization only if NativeLoader has not already been initialized. This protects against race conditions where isInitialized and init are called by multiple threads and both threads end up trying to perform an initialization