feat(android): add support for building Android AAR package

Author: Gioee

.github/workflows/main.yml

@@ -52,6 +52,9 @@ jobs:
           - os: macos-15
             name: apple-xcframework
             make: xcframework
+          - os: ubuntu-22.04
+            name: android-aar
+            make: aar
 
     defaults:
       run:
@@ -231,19 +234,30 @@ jobs:
           for folder in "artifacts"/*; do
             if [ -d "$folder" ]; then
               name=$(basename "$folder")
-              if [[ "$name" != "vector-apple-xcframework" ]]; then
+              if [[ "$name" != "vector-apple-xcframework" && "$name" != "vector-android-aar" ]]; then
                 tar -czf "${name}-${{ steps.tag.outputs.version }}.tar.gz" -C "$folder" .
               fi
-              (cd "$folder" && zip -rq "../../${name}-${{ steps.tag.outputs.version }}.zip" .)
+              if [[ "$name" != "vector-android-aar" ]]; then
+                (cd "$folder" && zip -rq "../../${name}-${{ steps.tag.outputs.version }}.zip" .)
+              else
+                cp "$folder"/*.aar "${name}-${{ steps.tag.outputs.version }}.aar"
+              fi
             fi
           done
 
+      - name: release android aar to maven central
+        if: false # maven central namespace needs to be verified first steps.tag.outputs.version != ''
+        run: cd packages/android && gradle publishReleasePublicationToOSSRHRepository -PVERSION=${{ steps.tag.outputs.version }}
+        env:
+          OSSRH_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          OSSRH_PASSWORD: ${{ secrets.OSSRH_PASSWORD }}
+          SIGNING_KEY: ${{ secrets.SIGNING_KEY }}
+          SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }}
+
       - uses: softprops/[email protected]
         if: steps.tag.outputs.version != ''
         with:
           generate_release_notes: true
           tag_name: ${{ steps.tag.outputs.version }}
-          files: |
-            vector-*-${{ steps.tag.outputs.version }}.zip
-            vector-*-${{ steps.tag.outputs.version }}.tar.gz
+          files: vector-*-${{ steps.tag.outputs.version }}.*
           make_latest: true

.gitignore

@@ -1,11 +1,29 @@
-.DS_Store
+# Build artifacts
+build/
+/dist
+.build
+*.a
+*.sqlite
+
+# iOS/macOS
 *.xcworkspacedata
 *.xcuserstate
 *.xcbkptlist
 *.plist
-/build
-/dist
-*.sqlite
-*.a
+
+# Android
+.gradle/
+*.aar
+local.properties
+jniLibs/
+*.apk
+*.ap_
+*.dex
+
+# IDE
 .vscode
-.build
+.idea/
+*.iml
+
+# System
+.DS_Store

Makefile

@@ -178,6 +178,14 @@ $(DIST_DIR)/%.xcframework: $(LIB_NAMES)
 
 xcframework: $(DIST_DIR)/vector.xcframework
 
+aar:
+	$(MAKE) clean && $(MAKE) PLATFORM=android ARCH=arm64-v8a
+	mv $(DIST_DIR)/vector.so packages/android/src/main/jniLibs/arm64-v8a/
+	$(MAKE) clean && $(MAKE) PLATFORM=android ARCH=x86_64
+	mv $(DIST_DIR)/vector.so packages/android/src/main/jniLibs/x86_64/
+	cd packages/android && gradle assembleRelease
+	mv packages/android/build/outputs/aar/*.aar $(DIST_DIR)/vector.aar
+
 version:
 	@echo $(shell sed -n 's/^#define SQLITE_VECTOR_VERSION[[:space:]]*"\([^"]*\)".*/\1/p' src/sqlite-vector.h)
 
@@ -201,5 +209,6 @@ help:
 	@echo "  test			- Test the extension"
 	@echo "  help			- Display this help message"
 	@echo "  xcframework	- Build the Apple XCFramework"
+	@echo "  aar			- Build the Android AAR package"
 
-.PHONY: all clean test extension help version xcframework
+.PHONY: all clean test extension help version xcframework aar

packages/android/build.gradle

@@ -0,0 +1,48 @@
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.5.2'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace 'ai.sqlite.vector'
+    compileSdk 34
+
+    defaultConfig {
+        minSdk 26
+        targetSdk 34
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['src/main/jniLibs']
+        }
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+    maven { url 'https://jitpack.io' }
+}
+
+dependencies {
+    api 'com.github.requery:sqlite-android:3.49.0'
+}

packages/android/gradle.properties

@@ -0,0 +1,2 @@
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+android.useAndroidX=true

packages/android/src/main/AndroidManifest.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+</manifest>

src/sqlite-vector.h

@@ -24,7 +24,7 @@
 extern "C" {
 #endif
 
-#define SQLITE_VECTOR_VERSION "0.9.26"
+#define SQLITE_VECTOR_VERSION "0.9.27"
 
 SQLITE_VECTOR_API int sqlite3_vector_init (sqlite3 *db, char **pzErrMsg, const sqlite3_api_routines *pApi);