Custom File Path to store database file for Android

CHANGELOG-Unreleased.md

@@ -1,7 +1,7 @@
 # Changelog
 
 ## Unreleased
-
+- [Android] Provides the user with the ability to pass in a file path instead of the database name only and creates the *.db file under a 'databases' sub-folder under the provided path.  Pattern for file path is *file:///data/user/0/com.mattermost.rnbeta/files/xxx.db*
 ### BREAKING CHANGES
 - [LokiJS] `useWebWorker` and `useIncrementalIndexedDB` options are now required (previously, skipping them would only trigger a warning)
 

native/android/src/main/java/com/nozbe/watermelondb/Database.kt

@@ -15,8 +15,21 @@ class Database(private val name: String, private val context: Context) {
                 if (name == ":memory:" || name.contains("mode=memory")) {
                     context.cacheDir.delete()
                     File(context.cacheDir, name).path
+                } else if (name.startsWith("/") || name.startsWith("file")) {
+                    // Extracts the database name from the path
+                    val dbName = name.substringAfterLast("/")
+
+                    // Extracts the real path where the *.db file will be created
+                    val truePath = name.substringAfterLast("file://").substringBeforeLast("/")
+
+                    // Creates the directory
+                    val fileObj = File(truePath, "databases")
+                    fileObj.mkdir()
+
+
+                    File("${truePath}/databases", dbName).path
                 } else
-                    // On some systems there is some kind of lock on `/databases` folder ¯\_(ツ)_/¯
+                // On some systems there is some kind of lock on `/databases` folder ¯\_(ツ)_/¯
                     context.getDatabasePath("$name.db").path.replace("/databases", ""),
                 null)
     }