com.facebook.soloader

Class DirectApkSoSource

java.lang.Object

com.facebook.soloader.SoSource

com.facebook.soloader.DirectApkSoSource

All Implemented Interfaces:

RecoverableSoSource

@ThreadSafe
public class DirectApkSoSource
extends SoSource
implements RecoverableSoSource

SoSource that directly finds shared libraries in a APK. The native libraries must be page aligned and stored uncompressed in the APK.

See Also:

android:extractNativeLibs

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

Constructor Summary

Constructors

Constructor and Description
DirectApkSoSource(android.content.Context context)
DirectApkSoSource(java.util.Set<java.lang.String> directApkLdPaths)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getLibraryPath(java.lang.String soName) Gets the full path of a library if it is found on this SoSource.
java.lang.String	getName()
boolean	isValid()
int	loadLibrary(java.lang.String soName, int loadFlags, android.os.StrictMode.ThreadPolicy threadPolicy) Load a shared library library into this process.
SoSource	recover(android.content.Context context)
java.lang.String	toString() Return the class name of the actual instance.
java.io.File	unpackLibrary(java.lang.String soName) Ensure that a shared library exists on disk somewhere.

Methods inherited from class com.facebook.soloader.SoSource

addToLdLibraryPath, getLibraryDependencies, getSoSourceAbis

Methods inherited from class java.lang.Object

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

Constructor Detail

DirectApkSoSource

public DirectApkSoSource(android.content.Context context)

DirectApkSoSource

public DirectApkSoSource(java.util.Set<java.lang.String> directApkLdPaths)

Method Detail

loadLibrary

public int loadLibrary(java.lang.String soName,
                       int loadFlags,
                       android.os.StrictMode.ThreadPolicy threadPolicy)
                throws java.io.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:

java.io.IOException - IOException

unpackLibrary

public java.io.File unpackLibrary(java.lang.String soName)
                           throws java.io.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:

java.io.IOException - IOException

isValid

public boolean isValid()

getLibraryPath

@Nullable
public java.lang.String getLibraryPath(java.lang.String soName)
                                          throws java.io.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:

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

getName

public java.lang.String getName()

Specified by:

getName in class SoSource

Returns:

the name of this SoSource for logging purposes

toString

public java.lang.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