https://github.com/facebook/soloader
Native code loader for Android
https://github.com/facebook/soloader
Last synced: 9 months ago
JSON representation
Native code loader for Android
- Host: GitHub
- URL: https://github.com/facebook/soloader
- Owner: facebook
- License: apache-2.0
- Created: 2015-10-22T13:18:43.000Z (about 10 years ago)
- Default Branch: main
- Last Pushed: 2025-03-10T19:41:03.000Z (10 months ago)
- Last Synced: 2025-04-10T00:05:10.112Z (9 months ago)
- Language: Java
- Homepage:
- Size: 819 KB
- Stars: 1,369
- Watchers: 76
- Forks: 177
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# SoLoader
[](https://github.com/facebook/SoLoader/actions/workflows/build.yml)
[](https://opensource.org/licenses/Apache-2.0)
[](https://maven-badges.herokuapp.com/maven-central/com.facebook.soloader/soloader)
SoLoader is a native code loader for Android. It takes care of unpacking your native libraries
and recursively loads dependencies on Android API 23 and earlier, since those old OS versions
do not support all of that functionality out of box.
## Requirements
SoLoader is useful for applications running on Android API 23 and earlier. SoLoader should not
be used on Android API 24 and above unless the app is delivered as
[Exopackage](https://buck.build/article/exopackage.html), requires
[Android Native Library Merging](https://engineering.fb.com/2018/01/23/android/android-native-library-merging/)
or uses [Superpack](https://engineering.fb.com/2021/09/13/core-data/superpack/)
compression.
## Including SoLoader in your apps
You can use [prebuilt aars](https://github.com/facebook/soloader/releases/latest)
or fetch SoLoader from Maven repository by adding the following to your
`build.gradle` file:
```groovy
implementation 'com.facebook.soloader:soloader:0.13.0+'
```
## Building from source
To build SoLoader from source you'll need [Buck](https://buckbuild.com/).
Once you have Buck installed execute following commands from the project root
directory:
```shell
buck fetch //...
buck build :soloader
```
The build command generates `buck-out/gen/soloader.aar` file.
## Join our community
Please use our [issues page](https://github.com/facebook/soloader/issues) to let us know of any problems.
See the [CONTRIBUTING](https://github.com/facebook/soloader/blob/main/CONTRIBUTING.md) file for how to
help out.
## License
SoLoader is [Apache-2.0-licensed](https://github.com/facebook/soloader/blob/main/LICENSE).