Package 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, PREPARE_FLAG_SKIP_BACKUP_SO_SOURCE

Constructor Summary

Constructors

Constructor	Description
DirectApkSoSource(android.content.Context context)
DirectApkSoSource(Set<String> directApkLdPaths)

Method Summary

Modifier and Type	Method	Description
String	getLibraryPath(String soName)	Gets the full path of a library if it is found on this SoSource.
String	getName()
boolean	isValid()
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

addToLdLibraryPath, getLibraryDependencies, getSoSourceAbis

Methods inherited from class java.lang.Object

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

Constructor Details

DirectApkSoSource

public DirectApkSoSource(android.content.Context context)

DirectApkSoSource

public DirectApkSoSource(Set<String> directApkLdPaths)

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

unpackLibrary

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

isValid

public boolean isValid()

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

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