Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/brodycj/android-sqleet2020-evplus-ndk-driver-free

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/brodycj/android-sqleet2020-evplus-ndk-driver-free
Owner: brodycj
License: other
Created: 2020-12-22T02:48:45.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2021-05-05T00:46:23.000Z (over 3 years ago)
Last Synced: 2024-07-31T00:17:03.994Z (5 months ago)
Language: C
Size: 132 KB
Stars: 0
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Awesome Lists containing this project

README

        # android-sqleet2020-evplus-ndk-driver-free build (with evplus-ext user defined functions)

Provides a native build of SQLeet () with an optimized JSON-based data interface and a workaround for large SELECT results, with a low-level API for Cordova SQLite evplus plugin versions.

Based on:

- [`storesafe/android-sqlite-evplus-ext-native-driver-free`](https://github.com/storesafe/android-sqlite-evplus-ext-native-driver-free)

- [`storesafe/android-sqlite-evcore-ndk-driver-free`](https://github.com/storesafe/android-sqlite-evcore-ndk-driver-free)

- [`liteglue/Android-sqlite-native-driver`](https://github.com/liteglue/Android-sqlite-native-driver).

by Christopher J. Brody aka Chris Brody mailto: 

License: GPL v3 () or commercial license options

## About

_provides build of a JAR with the following:_

- single `EVNDKDriver` class with native Java interface to the needed C functions

- automatic build for major _supported_ Android targets (~~`armeabi`,~~ `armeabi-v7a`, `x86`, `x86_64`, `arm64-v8a`) that is accessible from the native Java interface, with the following user defined functions:

  - `REGEXP` integrated from [brodybits / sqlite3-regexp-cached](https://github.com/brodybits/sqlite3-regexp-cached) (based on  by Alexey Tourbin, public domain)

  - `BASE64` integrated from [brodybits / sqlite3-base64](https://github.com/brodybits/sqlite3-base64), using [brodybits / libb64-encode](https://github.com/brodybits/libb64-encode) (based on  by Chris Venter, public domain)

This is accomplished by using [GlueGen](http://jogamp.org/gluegen/www/) around the C module.

Minimum API level: __android-22 (Android 5.1)__

**NOTE:** This project references multiple subprojects, which may be resolved by: $ `make init` (as described below).

**WARNING:** The reference handles that are returned by the `EVNDKDriver` library functions are raw C pointer values. If someone uses a reference handle that is not valid, or no longer valid with the `EVNDKDriver` library the behavior is undefined (may crash, for example). It is NOT recommended to use this API directly unless you really understand how this library works internally.

## SQLite build information

### SQLite version

    3.35.5

### android-ndk version notes

See the following reference for installing older `android-ndk` cask using Homebrew: 

To install `android-ndk` version `r16b`, for example:

```sh

brew cask install https://raw.githubusercontent.com/Homebrew/homebrew-cask/4570652dc6a3a8f7fd2be1053dd43547a2c78e26/Casks/android-ndk.rb

```

Note that `homebrew-cask` seems to have restored maintenance of the `android-ndk` cask, as discussed in [`Homebrew/homebrew-cask#58883`](https://github.com/Homebrew/homebrew-cask/issues/58883).

See also for some historical `android-ndk` cask information:

- https://github.com/Homebrew/homebrew-cask/commits/master/Casks/android-ndk.rb

- https://github.com/Homebrew/homebrew-cask/commits/5e9f77552aef2ffa29efe8a9b916d89686b96c7f/Casks/android-ndk.rb

- https://github.com/Homebrew/homebrew-cask/blob/5e9f77552aef2ffa29efe8a9b916d89686b96c7f/Casks/android-ndk.rb

FUTURE TODO: better documentation of API and some internal details

### SQLite build flags

- `-DSQLITE_THREADSAFE=1`

- `-DSQLITE_DEFAULT_SYNCHRONOUS=3`

- `-DSQLITE_DEFAULT_MEMSTATUS=0`

- `-DSQLITE_OMIT_DECLTYPE`

- `-DSQLITE_OMIT_DEPRECATED`

- `-DSQLITE_OMIT_PROGRESS_CALLBACK`

- `-DSQLITE_OMIT_SHARED_CACHE`

- `-DSQLITE_TEMP_STORE=2`

- `-DSQLITE_OMIT_LOAD_EXTENSION`

- `-DSQLITE_ENABLE_FTS3`

- `-DSQLITE_ENABLE_FTS3_PARENTHESIS`

- `-DSQLITE_ENABLE_FTS4`

- `-DSQLITE_ENABLE_FTS5`

- `-DSQLITE_ENABLE_RTREE`

- `-DSQLITE_ENABLE_JSON1`

New stable default page size and cache size ():

- `-DSQLITE_DEFAULT_PAGE_SIZE=4096`

- `-DSQLITE_DEFAULT_CACHE_SIZE=-2000`

## Dependencies

- SQLite () - public domain

- [brodybits / sqlite3-regexp-cached](https://github.com/brodybits/sqlite3-regexp-cached) - based on  by Alexey Tourbin, public domain

- [brodybits / sqlite3-base64](https://github.com/brodybits/sqlite3-base64) - Unlicense (public domain) ref: 

- [brodybits / libb64-encode](https://github.com/brodybits/libb64-encode) - based on  by Chris Venter, public domain

## For future consideration

- Support direct query of BLOB type

__FUTURE TBD/TODO:__

- Automatic AAR build

- Document this project (again, perhaps in a blog post)

- Some more SQLite API functions will be needed to rebuild the native sqlcipher library to replace the native libraries in the [@sqlcipher / android-database-sqlcipher](https://github.com/sqlcipher/android-database-sqlcipher) ([SQLCipher for Android](https://www.zetetic.net/sqlcipher/sqlcipher-for-android/)) project.

# Building

## Normal build

Initialize with the subproject references:

$ `make init`

Then to build:

$ `make`

## Regenerage Java & C glue code

$ `make regen`