Lazysodium Android

Lazysodium is a complete Android implementation of the Libsodium library that provides developers with a smooth and effortless cryptography experience.

Why Lazysodium

We created Lazysodium because we really wanted a solid Libsodium compatible Java/Android library that would just work without fuss. We were exasperated and annoyed with current Libsodium implementations as some of them were just poorly maintained and poorly architected.

You can find more info here.

Features

This library is fully compatible with Kotlin powered Android projects.

You can find an up-to-date feature list here.

Quick start

This is by no means a comprehensive introduction to Lazysodium. Please view the official documentation for a more comprehensive guide.

Whatever build tool you're using the general gist is to add the mavenCentral() repository and then add the Lazysodium dependency. More detailed instructions here.

The following example is for users of the build tool Gradle:

// Top level build file
repositories {
    // Add this to the end of any existing repositories
    mavenCentral()
}

// Project level dependencies section
dependencies {
    implementation "com.goterl:lazysodium-android:VERSION_NUMBER@aar"
    implementation "net.java.dev.jna:jna:5.8.0@aar"
}

Substitute VERSION_NUMBER for the version in this box:

How the artifacts were built

The jniLibs directory contains .so library files built with libsodium's Android release scripts located in dist-build using their stable branch as of April 6, 2022, SHA 7389bf7f2968be75520e932704f18f038c29e581. Android NDK LTS 23.2.8568313 (r23c) was used with platform target of API 26. SHA256 hashes are as follows

9c267f0ceb058ff7a2498098f5b0ba5d90e5a4573b564439d315fa58e7034366 arm64-v8a/libsodium.so
6743b34ce1dccdae3c03975645ca9b8330c6153dbefac1a3e08d4f52d836c49c armeabi-v7a/libsodium.so
ec34b33c1d7bd18be885b30752f637da6353d3453fe183744449ea08e3af6607 x86/libsodium.so
d83142a2da16f487d821bb65e7e5971c3e82c2bfc50ad2978ada2cfadfc1a0bf x86_64/libsodium.so

Documentation

See our official documentation to get started.

Apps

You can preview some of the features in our free Lazysodium app available on Google Play:

Lazysodium for Java

We also have a Java implementation available at Lazysodium for Java. It has the same API as this library so you can share code easily!

Created by Terl.

copelandsoftware / lazysodium-android Goto Github PK