yanl - yet another native loader
Yet another Native library extractor/loader for the JVM, written in Kotlin.
why
other libraries simply don't fit my needs and/or aren't as expandable/configurable as I'd like.
how use
this is going to go over how to setup yanl on a gradle project using a Kotlin DSL buildscript.
first you need to import the library, you can either import it from the maven central repository or from jitpack automatic builds.
for maven central, just add yanl to your dependencies block:
// change to the latest version
val YANL_VERSION = "1.0.0"
dependencies {
implementation("fr.stardustenterprises:yanl:$YANL_VERSION")
}
for jitpack, add the repository as well as the dependency, this time using the github domain:
// change to the latest github release, commit, or branch name
val YANL_RELEASE = "1.0.0"
repositories {
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.stardust-enterprises:yanl:$YANL_RELEASE")
}
how work
this library can act as a simple drop-in replacement to your standard System.load or System.loadLibrary.
consider the following example:
public class Program {
public static void main(String[] args) {
// requires the native file to be in path
System.loadLibrary("coollib");
// do stuff
// ...
}
}
this would require the library file to be somewhere on the PATH of the operating system.
one way of getting around this problem would be to extract the library from the jar archive to a known folder, then to load it. this approach works but also requires to extract and load the correct library for your processor architecture and operating system.
this is when yanl comes into play.
yanl takes care of platform detection, library extraction and location.
taking back that previous example:
import fr.stardustenterprises.yanl.loader.NativeLoader;
public class Program {
public static void main(String[] args) {
// load the library using yanl's default loader
NativeLoader.getDefault().loadLibrary("coollib");
// do more stuff
// ...
}
}
this time yanl will handle everything according to the NativeLoader default settings.
you can of course change those setting by creating yourself a loader instance:
// library not done, example snippet not available, check back later!
licensing
this project is under the MIT license.
13 Dec 16, 2022
24 Dec 21, 2022
0 Dec 5, 2021
6 Jun 27, 2022
37 Dec 9, 2022
5 Sep 28, 2022
12 Dec 15, 2022
2 Oct 27, 2022
2 May 3, 2022
129 Jan 4, 2023
2 Aug 23, 2022
1.5k Dec 30, 2022
5 Dec 8, 2022
3 Jun 18, 2022
115 Dec 21, 2022
4 Aug 2, 2022
2 Jan 17, 2022
73 Nov 28, 2022