Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/brodycj/android-database-sqlcipher-evplus-ext-ndk-driver-build-free-unstable-0x


https://github.com/brodycj/android-database-sqlcipher-evplus-ext-ndk-driver-build-free-unstable-0x

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README 

        
## android-database-sqlcipher-evplus-ext-ndk-driver-build-free



LICENSING NOTE: INCLUDES  as a submodule under GPL v3 or COMMERCIAL LICENSE OPTIONS



based on [`github:brodybits/android-database-sqlcipher#v4.x-extra-durable-ndk-core-jar-build`](https://github.com/brodybits/android-database-sqlcipher/tree/v4.x-extra-durable-ndk-core-jar-build): [`github:sqlcipher/android-database-sqlcipher`](https://github.com/sqlcipher/android-database-sqlcipher) with `android.database.sqlite` C++ and Java classes removed and additional enhancement(s) from [`github:brodybits/android-database-sqlcipher#v4.x-extra-durable-jar-build`](https://github.com/brodybits/android-database-sqlcipher/tree/v4.x-extra-durable-jar-build):



- able to build JAR, as documented below

- extra durable with `-DSQLITE_DEFAULT_SYNCHRONOUS=3` build setting in `build.gradle`



including EVPlusNativeDriver JNI support built from the JNI/NDK source in: 



Note that this version build branch does not externalize the SQLCipher or OpenSSL dependencies.



### Compatibility



SQLCipher for Android runs on Android 4.1–Android 10, for `armeabi-v7a`, `x86`, `x86_64`, and `arm64_v8a` architectures.



### An Illustrative Terminal Listing



A typical SQLite database in unencrypted, and visually parseable even as encoded text. The following example shows the difference between hexdumps of a standard SQLite database and one implementing SQLCipher.



```

~ sjlombardo$ hexdump -C sqlite.db

00000000 53 51 4c 69 74 65 20 66 6f 72 6d 61 74 20 33 00 |SQLite format 3.|

…

000003c0 65 74 32 74 32 03 43 52 45 41 54 45 20 54 41 42 |et2t2.CREATE TAB|

000003d0 4c 45 20 74 32 28 61 2c 62 29 24 01 06 17 11 11 |LE t2(a,b)$…..|

…

000007e0 20 74 68 65 20 73 68 6f 77 15 01 03 01 2f 01 6f | the show…./.o|

000007f0 6e 65 20 66 6f 72 20 74 68 65 20 6d 6f 6e 65 79 |ne for the money|



~ $ sqlite3 sqlcipher.db

sqlite> PRAGMA KEY=’test123′;

sqlite> CREATE TABLE t1(a,b);

sqlite> INSERT INTO t1(a,b) VALUES (‘one for the money’, ‘two for the show’);

sqlite> .quit



~ $ hexdump -C sqlcipher.db

00000000 84 d1 36 18 eb b5 82 90 c4 70 0d ee 43 cb 61 87 |.?6.?..?p.?C?a.|

00000010 91 42 3c cd 55 24 ab c6 c4 1d c6 67 b4 e3 96 bb |.B?..?|

00000bf0 8e 99 ee 28 23 43 ab a4 97 cd 63 42 8a 8e 7c c6 |..?(#C??.?cB..|?|



~ $ sqlite3 sqlcipher.db

sqlite> SELECT * FROM t1;

Error: file is encrypted or is not a database

```

(example courtesy of SQLCipher)



### Building



In order to build `android-database-sqlcipher` from source you will need both the Android SDK, Gradle, and the Android NDK. We currently recommend using Android NDK version `r20`. To complete the `make` command, the `ANDROID_NDK_HOME` environment variable must be defined which should point to your NDK root. Once you have cloned the repo, change directory into the root of the repository and run the following commands:



```

# this only needs to be done once

make init



# to build the source for debug:

make build-debug

# or for a release build:

make build-release

```



### JAR build



to build as a single JAR: `make jar`



### License



The Android support ~~libraries~~ _build scripts_ are licensed under Apache 2.0, in line with the Android OS code on which they are based. The SQLCipher code itself is licensed under a BSD-style license from Zetetic LLC. Finally, the original SQLite code itself is in the public domain.