Package com.facebook.soloader

Class ApplicationSoSource

java.lang.Object

com.facebook.soloader.SoSource

com.facebook.soloader.ApplicationSoSource

All Implemented Interfaces:

RecoverableSoSource

public class ApplicationSoSource
extends SoSource
implements RecoverableSoSource

SoSource that wraps a DirectorySoSource for the application's nativeLibraryDir.

Field Summary

Fields inherited from class com.facebook.soloader.SoSource

LOAD_FLAG_ALLOW_IMPLICIT_PROVISION, LOAD_FLAG_ALLOW_SOURCE_CHANGE, LOAD_FLAG_MIN_CUSTOM_FLAG, LOAD_RESULT_IMPLICITLY_PROVIDED, LOAD_RESULT_LOADED, LOAD_RESULT_NOT_FOUND, PREPARE_FLAG_ALLOW_ASYNC_INIT, PREPARE_FLAG_DISABLE_FS_SYNC_JOB, PREPARE_FLAG_FORCE_REFRESH, PREPARE_FLAG_SKIP_BACKUP_SO_SOURCE

Constructor Summary

Constructors

Constructor	Description
ApplicationSoSource(android.content.Context context, int flags)

Method Summary

Modifier and Type	Method	Description
void	addToLdLibraryPath(Collection<String> paths)	Add an element to an LD_LIBRARY_PATH under construction.
String[]	getLibraryDependencies(String soName)	Gets the dependencies of a library if it is found on this SoSource
String	getLibraryPath(String soName)	Gets the full path of a library if it is found on this SoSource.
String	getName()
File	getSoFileByName(String soName)
int	loadLibrary(String soName, int loadFlags, android.os.StrictMode.ThreadPolicy threadPolicy)	Load a shared library library into this process.
SoSource	recover(android.content.Context context)
String	toString()	Return the class name of the actual instance.
File	unpackLibrary(String soName)	Ensure that a shared library exists on disk somewhere.

Methods inherited from class com.facebook.soloader.SoSource

getSoSourceAbis

Methods inherited from class java.lang.Object

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

Constructor Details

ApplicationSoSource

public ApplicationSoSource(android.content.Context context,
 int flags)

Method Details

loadLibrary

public int loadLibrary(String soName,
 int loadFlags,
 android.os.StrictMode.ThreadPolicy threadPolicy)
                throws IOException

Description copied from class: SoSource

Load a shared library library into this process. This routine is independent of SoSource.loadLibrary(java.lang.String, int, android.os.StrictMode.ThreadPolicy).

Specified by:

loadLibrary in class SoSource

Parameters:

soName - Name of library to load

loadFlags - Zero or more of the LOAD_FLAG_XXX constants.

threadPolicy - Strict Mode policy

Returns:

One of the LOAD_RESULT_XXX constants.

Throws:

IOException - IOException

getSoFileByName

@Nullable
public File getSoFileByName(String soName)
                     throws IOException

Throws:

IOException

getLibraryPath

@Nullable
public String getLibraryPath(String soName)
                      throws IOException

Description copied from class: SoSource

Gets the full path of a library if it is found on this SoSource.

Overrides:

getLibraryPath in class SoSource

Parameters:

soName - the full file name of the library

Returns:

the full path of a library if it is found on this SoSource, null otherwise.

Throws:

IOException - if there is an error calculating soFileName's canonical path

getLibraryDependencies

@Nullable
public String[] getLibraryDependencies(String soName)
                                throws IOException

Description copied from class: SoSource

Gets the dependencies of a library if it is found on this SoSource

Overrides:

getLibraryDependencies in class SoSource

Parameters:

soName - Name of library to inspect

Returns:

An array of library names upon which soName needs for linking

Throws:

IOException - if soName is found but there is an error reading it

unpackLibrary

@Nullable
public File unpackLibrary(String soName)
                   throws IOException

Description copied from class: SoSource

Ensure that a shared library exists on disk somewhere. This routine is independent of SoSource.loadLibrary(java.lang.String, int, android.os.StrictMode.ThreadPolicy).

Specified by:

unpackLibrary in class SoSource

Parameters:

soName - Name of library to load

Returns:

File if library found; null if not.

Throws:

IOException - IOException

addToLdLibraryPath

public void addToLdLibraryPath(Collection<String> paths)

Description copied from class: SoSource

Add an element to an LD_LIBRARY_PATH under construction.

Overrides:

addToLdLibraryPath in class SoSource

Parameters:

paths - Collection of paths to which to add

getName

public String getName()

Specified by:

getName in class SoSource

Returns:

the name of this SoSource for logging purposes

toString

public String toString()

Description copied from class: SoSource

Return the class name of the actual instance. Useful for debugging.

Overrides:

toString in class SoSource

Returns:

the instance class name

recover

public SoSource recover(android.content.Context context)

Specified by:

recover in interface RecoverableSoSource