feat: add kotlin bindings

Merge pull request #1239 from matrix-org/ganfra/kotlin_bindings

Author: gnunicorn

bindings/kotlin/README.md

@@ -0,0 +1,24 @@
+# Matrix rust components kotlin
+
+This project and build scripts demonstrate how to create an aar and how to import it in your android projects.
+
+## Prerequisites
+
+* the Rust toolchain
+* UniFFI - `cargo install uniffi_bindgen`
+* cargo-ndk < 2.12.0 `cargo install cargo-ndk --version 2.11.0`
+* android targets (e.g. `rustup target add \
+  aarch64-linux-android \
+  armv7-linux-androideabi \
+  x86_64-linux-android \
+  i686-linux-android`)
+
+## Building the SDK
+
+To build the full sdk and get an aar you can call :
+`./bindings/kotlin/scripts/build_sdk.sh /matrix-rust_sdk/bindings/kotlin/sample/libs`
+where the parameter is the path for the aar to go
+
+## License
+
+[Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0)

bindings/kotlin/SECURITY.md

@@ -0,0 +1,5 @@
+# Reporting a Vulnerability
+
+**If you've found a security vulnerability, please report it to [email protected]**
+
+For more information on our security disclosure policy, visit https://www.matrix.org/security-disclosure-policy/

bindings/kotlin/build.gradle

@@ -0,0 +1,23 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+
+apply plugin: 'io.github.gradle-nexus.publish-plugin'
+apply from: "${rootDir}/scripts/publish-root.gradle"
+
+buildscript {
+    repositories {
+        maven { url "https://plugins.gradle.org/m2/" }
+        google()
+        mavenCentral()
+    }
+
+    dependencies {
+        classpath BuildPlugins.android
+        classpath BuildPlugins.kotlin
+        classpath BuildPlugins.nexusPublish
+    }
+}
+
+
+task clean(type: Delete) {
+    delete rootProject.buildDir
+}

bindings/kotlin/buildSrc/build.gradle.kts

@@ -0,0 +1,9 @@
+import org.gradle.kotlin.dsl.`kotlin-dsl`
+
+plugins {
+    `kotlin-dsl`
+}
+
+repositories {
+    mavenCentral()
+}

bindings/kotlin/buildSrc/src/main/java/ConfigurationData.kt

@@ -0,0 +1,11 @@
+object ConfigurationData {
+    const val compileSdk = 31
+    const val targetSdk = 31
+    const val minSdk = 21
+    const val majorVersion = 0
+    const val minorVersion = 2
+    const val patchVersion = 0
+    const val versionName = "$majorVersion.$minorVersion.$patchVersion"
+    const val snapshotVersionName = "$majorVersion.$minorVersion.${patchVersion + 1}-SNAPSHOT"
+    const val publishGroupId = "org.matrix.rustcomponents"
+}

bindings/kotlin/buildSrc/src/main/java/Dependencies.kt

@@ -0,0 +1,22 @@
+internal object Versions {
+    const val androidGradlePlugin = "7.1.2"
+    const val kotlin = "1.6.10"
+    const val jUnit = "4.12"
+    const val nexusPublishGradlePlugin = "1.1.0"
+    const val jna = "5.10.0"
+}
+
+internal object BuildPlugins {
+    const val android = "com.android.tools.build:gradle:${Versions.androidGradlePlugin}"
+    const val kotlin = "org.jetbrains.kotlin:kotlin-gradle-plugin:${Versions.kotlin}"
+    const val nexusPublish = "io.github.gradle-nexus:publish-plugin:${Versions.nexusPublishGradlePlugin}"
+}
+
+/**
+ * To define dependencies
+ */
+internal object Dependencies {
+    const val kotlin = "org.jetbrains.kotlin:kotlin-stdlib-jdk7:${Versions.kotlin}"
+    const val junit = "junit:junit:${Versions.jUnit}"
+    const val jna = "net.java.dev.jna:jna:${Versions.jna}@aar"
+}

bindings/kotlin/crypto/crypto-android/.gitignore

@@ -0,0 +1 @@
+/build

bindings/kotlin/crypto/crypto-android/build.gradle

@@ -0,0 +1,51 @@
+plugins {
+    id 'com.android.library'
+    id 'org.jetbrains.kotlin.android'
+}
+
+ext {
+    PUBLISH_GROUP_ID = ConfigurationData.publishGroupId
+    PUBLISH_ARTIFACT_ID = 'crypto-android'
+    PUBLISH_VERSION = rootVersionName
+    PUBLISH_DESCRIPTION = 'Android Bindings to the Matrix Rust Crypto SDK'
+}
+
+apply from: "${rootDir}/scripts/publish-module.gradle"
+
+android {
+
+    compileSdk ConfigurationData.compileSdk
+
+    defaultConfig {
+        minSdk ConfigurationData.minSdk
+        targetSdk ConfigurationData.targetSdk
+        versionName ConfigurationData.versionName
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles "consumer-rules.pro"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+    kotlinOptions {
+        jvmTarget = '1.8'
+    }
+}
+
+android.libraryVariants.all { variant ->
+    def sourceSet = variant.sourceSets.find { it.name == variant.name }
+    sourceSet.java.srcDir new File(buildDir, "generated/source/${variant.name}")
+}
+
+dependencies {
+    implementation Dependencies.jna
+    testImplementation Dependencies.junit
+}

bindings/kotlin/crypto/crypto-android/consumer-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile