How to add a shared library (.so) in android project

Rate this Article:

Approved for Versions:4.13

Some or all of the information on this page is inconsistent, irrelevant or confusing.

Please help clean it up if you are able.

Author Syntopia. Thanks to Chris Babcock for the info.

For example, to add support for OpenSSL.

The latest compiled version of the library you can find in github (or compiled by hand), take this for example:


Select the desired architecture, for this example we will take "arch-armeabi-v7a". After downloading, create a folder "/armv7" in the source folder "C:\Users\Vadim\Documents\Unreal Projects\AndroidOpenSSL\Source\AndroidOpenSSL" in my case. And move the "" there in "armv7". Next open the file .Build.cs it should look something like this, here I just add the library to work with OpenSSL in the Windows.

Headers are in "AndroidOpenSSL/ThirdParty/OpenSSL/Includes" connect them like this:

string IncludesPath = Path.Combine(ThirdPartyPath, "OpenSSL", "Includes");

For android target set the path to the library and APL (AndroidPluginLanguage).

using UnrealBuildTool;
using System.IO;
using System;  //Console.WriteLine("");
public class AndroidOpenSSL : ModuleRules
    private string ModulePath
        get { return ModuleDirectory; }
    private string ThirdPartyPath
        get { return Path.GetFullPath(Path.Combine(ModulePath, "../../ThirdParty/")); }
    public AndroidOpenSSL(TargetInfo Target)
	PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore" });
	PrivateDependencyModuleNames.AddRange(new string[] {  });
        string IncludesPath = Path.Combine(ThirdPartyPath, "OpenSSL", "Includes");
        if ((Target.Platform == UnrealTargetPlatform.Win64) || (Target.Platform == UnrealTargetPlatform.Win32))
            string LibrariesPath = Path.Combine(ThirdPartyPath, "OpenSSL", "Libraries");
            PublicAdditionalLibraries.Add(Path.Combine(LibrariesPath, "libeay32.lib"));
            PublicAdditionalLibraries.Add(Path.Combine(LibrariesPath, "ssleay32.lib"));
        if (Target.Platform == UnrealTargetPlatform.Android)
            string BuildPath = Utils.MakePathRelativeTo(ModuleDirectory, BuildConfiguration.RelativeEnginePath);
            AdditionalPropertiesForReceipt.Add(new ReceiptProperty("AndroidPlugin", Path.Combine(BuildPath, "My_APL_armv7.xml")));
            PublicAdditionalLibraries.Add(BuildPath + "/armv7/");

Create in the same place file "My_APL_armv7.xml". A great example can be found here:

The contents will look like this:

<?xml version="1.0" encoding="utf-8"?>
<!-- steps to add to build additions -->
<root xmlns:android="">
	<!-- init section is always evaluated once per architecture -->
	    <setBool result="bSupported" value="false"/>
	        <isArch arch="armeabi-v7a">
	            <setBool result="bSupported" value="true"/>
	<!-- optional files or directories to copy to Intermediate/Android/APK -->
	    <isArch arch="armeabi-v7a">
	        <copyFile src="$S(PluginDir)/armv7/"
	                  dst="$S(BuildDir)/libs/armeabi-v7a/" />
	<!-- optional libraries to load in before -->
	    <if condition="bSupported">
		    <loadLibrary name="myso" failmsg="Failed to load myso library" />

That's all you can packing. If everything is fine, we'll see it in the log:

UATHelper: Packaging (Android (ETC2)): UnrealBuildTool: File C:\Users\Vadim\Documents\Unreal Projects\AndroidOpenSSL\Source\AndroidOpenSSL/armv7/ copied to C:\Users\Vadim\Documents\Unreal Projects\AndroidOpenSSL\Intermediate/Android/APK/libs/armeabi-v7a/

Possible errors (for OpenSSL):

After installing the application on androyd I can not run it, looked into the logcat, there was such an error:

E/AndroidRuntime( 1574): java.lang.UnsatisfiedLinkError: dlopen failed: could not load library "" needed by ""; caused by library "" not found

If you rename the .apk to .zip open and go to the "\lib" you will see that there is not "" only "". Version number sewn somewhere in .so, a simple rename will not help. We need to recompile OpenSSL with the required flag, or change something in .so using rpl:

rpl -R -e .so.1.0.0 "" /path/to/

More details in the answer:

An example of calculating the hash SHA256.

I created the HUD for this:

// OpenSSL tests
#include <openssl/evp.h>
#include <sstream>
#include <iomanip>
void ADebugHUD::DrawHUD()
	FString hashTest = "Hash test (sha256): " + GetSHA256_s("Baron", strlen("Baron"));
	DrawText(hashTest, FColor::White, 50, 50, HUDFont);
FString ADebugHUD::GetSHA256_s(const void * data, size_t data_len)
	EVP_MD_CTX mdctx;
	unsigned char md_value[EVP_MAX_MD_SIZE];
	unsigned int md_len;
	EVP_DigestInit(&mdctx, EVP_sha256());
	EVP_DigestUpdate(&mdctx, data, (size_t)data_len);
	EVP_DigestFinal_ex(&mdctx, md_value, &md_len);
	std::stringstream s;
	for (size_t i = 0; i < md_len; ++i)
		s << std::setw(2) << std::hex << (unsigned short)md_value[i];
	return s.str().c_str();