feat: allow override of detected architecture

Closes: #795

USAGE.md

@@ -88,6 +88,12 @@ You can use a specific version of the native library by setting the following JV
 -Dorg.sqlite.lib.name=your-custom.dll
 ```
 
+## Override detected architecture
+
+If the detected architecture is incorrect for your system, thus loading the wrong native library, you can override the value setting the following JVM property:
+```
+-Dorg.sqlite.osinfo.architecture=arm
+```
 
 ## Configure Connections
 ```java

src/main/java/org/sqlite/util/OSInfo.java

@@ -219,6 +219,11 @@ static String resolveArmArchType() {
     }
 
     public static String getArchName() {
+        String override = System.getProperty("org.sqlite.osinfo.architecture");
+        if(override != null) {
+            return override;
+        }
+
         String osArch = System.getProperty("os.arch");
 
         if (osArch.startsWith("arm")) {

src/test/java/org/sqlite/util/OSInfoTest.java

@@ -152,4 +152,13 @@ public void testArm64NativePath() throws IOException, InterruptedException {
             }
         }
     }
+
+    @Test
+    @SetSystemProperty(key = "org.sqlite.osinfo.architecture", value = "overridden")
+    @SetSystemProperty(key = "os.name", value = "Windows")
+    void testOverride() {
+        assertThat(OSInfo.getArchName()).isEqualTo("overridden");
+        assertThat(OSInfo.getNativeLibFolderPathForCurrentOS())
+            .isEqualTo("Windows/overridden");
+    }
 }