SoLoader: SoLoader is not compatible with Android app bundles

We’re seeing crashes in SoLoader in production when loading libreactnativejni.so. We’re using React Native 0.59 and SoLoader 0.6.0.

The crash occurs on a range of devices, on Android OS versions 6 through 10. Google devices seem especially prone, notably the Pixel and Chromebook Plus V2.

The crashes appear to stem from our switch to using an app bundle rather than an APK on the Google Play store. This looks possibly related to https://github.com/facebook/SoLoader/issues/30, but that issue is marked as resolved in 0.6.0.

It looks like the app is sometimes attempting to link against old copies of some of the libraries. Here are some examples:

Fatal Exception: java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libreactnativejni.so caused by: dlopen failed: cannot locate symbol "_ZN3fLI7FLAGS_vE" referenced by "/data/app/com.fanduel.android.self-1/lib/arm/libglog.so"...

Fatal Exception: java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libreactnativejni.so caused by: dlopen failed: cannot locate symbol "_ZN8facebook5react15makeJIntOrThrowEx" referenced by "/data/app/com.fanduel.android.self-7bFAALdOGMNizGU2gL_5nA==/lib/arm/libreactnativejni.so"...

Fatal Exception: java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libreactnativejni.so caused by: dlopen failed: library "/data/user/0/com.fanduel.android.self/lib-0/libreactnativejni.so" not found

Fatal Exception: java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libreactnativejni.so caused by: dlopen failed: library "libfb.so" not found

Fatal Exception: java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libreactnativejni.so caused by: couldn't find DSO to load: libfb.so caused by: dlopen failed: library "/data/user/0/com.fanduel.android.self/lib-0/libfb.so" not found

Fatal Exception: java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libreactnativejni.so caused by: couldn't find DSO to load: libfb.so caused by: couldn't find DSO to load: libc++_shared.so caused by: dlopen failed: "/data/data/com.fanduel.android.self/lib-1/libc++_shared.so" is 32-bit instead of 64-bit (this last one started appearing after we added 64-bit support)

I wonder if the problem is just that the filesystem sometimes isn’t fully flushed and ends up in an inconsistent state. Inspecting the SoLoader code, it tries to be robust (e.g. comparing a manifest of extracted files against the contests of the APK zipfiles) but it’s hard to say if it’s bulletproof. Maybe the manifest file is updated, but the writes to the .so files aren’t completed, so the app thinks it has the current libraries installed when in fact it still has the old ones.

Sorry for the lack of detail, I’m still trying to get a clearer picture of what’s going on! The crash rate is quite low and we haven’t managed to reproduce it ourselves. However, I think I’ve seen enough to be confident that it’s the combination of SoLoader and app bundles that causes the problem.

We plan to switch back to using an APK instead of an app bundle to see if that avoids the problem.

About this issue

  • Original URL
  • State: closed
  • Created 5 years ago
  • Reactions: 18
  • Comments: 23 (3 by maintainers)

Most upvoted comments

Bumping this issue as we are still seeing this when attempting to use app bundles for a React Native application.

Fatal Exception: java.lang.UnsatisfiedLinkError couldn’t find DSO to load: libhermes.so

RN version 0.62

i tried with react-native 0.61.1 but still issue is there. not sure what to do with this inconsistencies 😦 which file we need to keep this force code ???

Since Android 4.2 (JB-MR2), soloader function is not needed. In Soloader README.md, it said

SoLoader is a native code loader for Android. 
It takes care of unpacking your native libraries and recursively loads dependencies on platforms 
that don't support that out of the box.

But in bionic document, it said https://android.googlesource.com/platform/bionic/+/master/android-changes-for-ndk-developers.md#changes-to-library-dependency-resolution

Until it was fixed in JB-MR2, Android didn‘t include the application library directory on the dynamic linker’s search path.
This meant that apps had to call dlopen or System.loadLibrary on all transitive dependencies 
before loading their main library. 
Worse, until it was fixed in JB-MR2, the dynamic linker's caching code cached failures too, 
so it was necessary to topologically sort your libraries and load them in reverse order.

So, here is simple solution.

  1. Use minSdkVersion 18 or higher
  2. Add following code on your application.
package com.facebook.soloader;

import android.content.Context;

public class SoLoader {
  public static final int SOLOADER_ENABLE_EXOPACKAGE = (1 << 0);
  public static final int SOLOADER_ALLOW_ASYNC_INIT = (1 << 1);
  public static final int SOLOADER_LOOK_IN_ZIP = (1 << 2);
  public static final int SOLOADER_DISABLE_BACKUP_SOSOURCE = (1 << 3);
  public static final int SOLOADER_SKIP_MERGED_JNI_ONLOAD = (1 << 4);

  public static void init(Context context,  boolean nativeExopackage) {
  }

  public static boolean loadLibrary(String libname) {
      return loadLibrary(libname, 0);
  }

  public static boolean loadLibrary(String libname, int loadFlags) throws UnsatisfiedLinkError {
      System.loadLibrary(libname);
      return true;
  }
}
  • It was okay to use yoga
  • For react native, need to check that more symbols should be exposed.
  1. Exclude soloader from build dependency

The commit that adds app bundle support is c7980fc, which should actually be in 0.6.0 already - so maybe there’s still an issue even with 0.8.0?

The problem we’ve been seeing is not that bundles are completely unsupported, but that SoLoader attempts to handle bundles and sometimes ends up with corrupted .so files.

I think something about the way .so files are extracted to the file system is just not working reliably on all devices. Unless this has been specifically investigated and addressed, I think this bug still exists.

The real test would be to re-enable app bundles and check the crash rates, but I’m not in a position to do that without being extremely confident that the bug has actually been fixed.

It would be great to see a solution that skips the extraction step completely for uncompressed native libraries (https://developer.android.com/topic/performance/reduce-apk-size#reduce-binaries). That would give us a high degree of confidence in the fix.

version 0.8.0 should fix this issue.

I am also facing this issue with React Native 0.60.5, disabling Hermes seems to help too.