Implemented #sanitizedCanonicalPath method

androidshared/src/main/java/org/odk/collect/androidshared/utils/PathUtils.kt

@@ -1,5 +1,6 @@
 package org.odk.collect.androidshared.utils
 
+import org.odk.collect.shared.files.FileExt.sanitizedCanonicalPath
 import timber.log.Timber
 import java.io.File
 
@@ -9,8 +10,8 @@ object PathUtils {
         val absoluteFilePath =
             if (filePath.startsWith(dirPath)) filePath else dirPath + File.separator + filePath
 
-        val canonicalAbsoluteFilePath = File(absoluteFilePath).canonicalPath
-        val canonicalDirPath = File(dirPath).canonicalPath
+        val canonicalAbsoluteFilePath = File(absoluteFilePath).sanitizedCanonicalPath()
+        val canonicalDirPath = File(dirPath).sanitizedCanonicalPath()
         if (!canonicalAbsoluteFilePath.startsWith(canonicalDirPath)) {
             Timber.e(
                 "Attempt to access file outside of Collect directory:\n" +

collect_app/src/androidTest/java/org/odk/collect/android/support/rules/ResetStateRule.kt

@@ -14,7 +14,6 @@ import org.odk.collect.androidshared.ui.ToastUtils
 import org.odk.collect.androidshared.ui.multiclicksafe.MultiClickGuard
 import org.odk.collect.db.sqlite.DatabaseConnection
 import org.odk.collect.material.BottomSheetBehavior
-import org.odk.collect.shared.files.DirectoryUtils
 import java.io.IOException
 
 private class ResetStateStatement(
@@ -43,11 +42,11 @@ private class ResetStateStatement(
     private fun clearDisk() {
         try {
             val internalFilesDir = ApplicationProvider.getApplicationContext<Application>().filesDir
-            DirectoryUtils.deleteDirectory(internalFilesDir)
+            internalFilesDir.deleteRecursively()
 
             val externalFilesDir =
                 ApplicationProvider.getApplicationContext<Application>().getExternalFilesDir(null)!!
-            DirectoryUtils.deleteDirectory(externalFilesDir)
+            externalFilesDir.deleteRecursively()
         } catch (e: IOException) {
             throw RuntimeException(e)
         }

collect_app/src/main/java/org/odk/collect/android/application/initialization/ExistingProjectMigrator.kt

@@ -10,7 +10,6 @@ import org.odk.collect.settings.SettingsProvider
 import org.odk.collect.settings.importing.ProjectDetailsCreator
 import org.odk.collect.settings.keys.MetaKeys
 import org.odk.collect.settings.keys.ProjectKeys
-import org.odk.collect.shared.files.DirectoryUtils
 import org.odk.collect.upgrade.Upgrade
 import java.io.File
 import java.io.FileNotFoundException
@@ -67,7 +66,7 @@ class ExistingProjectMigrator(
         }
 
         try {
-            DirectoryUtils.deleteDirectory(File(rootDir, ".cache"))
+            File(rootDir, ".cache").deleteRecursively()
         } catch (e: Exception) {
             // ignore
         }

collect_app/src/main/java/org/odk/collect/android/database/forms/DatabaseFormsRepository.java

@@ -30,7 +30,7 @@
 import org.odk.collect.forms.Form;
 import org.odk.collect.forms.FormsRepository;
 import org.odk.collect.forms.savepoints.SavepointsRepository;
-import org.odk.collect.shared.files.DirectoryUtils;
+import org.odk.collect.shared.files.FileExt;
 import org.odk.collect.shared.strings.Md5;
 
 import java.io.File;
@@ -302,7 +302,7 @@ private void deleteFilesForForm(Form form) {
             File mediaDir = new File(form.getFormMediaPath());
 
             if (mediaDir.isDirectory()) {
-                DirectoryUtils.deleteDirectory(mediaDir);
+                FileExt.deleteDirectory(mediaDir);
             } else {
                 mediaDir.delete();
             }

collect_app/src/main/java/org/odk/collect/android/database/instances/DatabaseInstancesRepository.java

@@ -11,7 +11,7 @@
 import org.odk.collect.android.database.DatabaseConstants;
 import org.odk.collect.forms.instances.Instance;
 import org.odk.collect.forms.instances.InstancesRepository;
-import org.odk.collect.shared.files.DirectoryUtils;
+import org.odk.collect.shared.files.FileExt;
 
 import java.io.File;
 import java.util.ArrayList;
@@ -270,7 +270,7 @@ private void update(Long instanceId, ContentValues values) {
     }
 
     private void deleteInstanceFiles(Instance instance) {
-        DirectoryUtils.deleteDirectory(new File(instance.getInstanceFilePath()).getParentFile());
+        FileExt.deleteDirectory(new File(instance.getInstanceFilePath()).getParentFile());
     }
 
     private static List<Instance> getInstancesFromCursor(Cursor cursor, String instancesPath) {

collect_app/src/main/java/org/odk/collect/android/formmanagement/download/ServerFormDownloader.java

@@ -16,7 +16,7 @@
 import org.odk.collect.forms.FormSource;
 import org.odk.collect.forms.FormSourceException;
 import org.odk.collect.forms.FormsRepository;
-import org.odk.collect.shared.files.DirectoryUtils;
+import org.odk.collect.shared.files.FileExt;
 import org.odk.collect.shared.strings.Md5;
 
 import java.io.File;
@@ -79,7 +79,7 @@ public void downloadForm(ServerFormDetails form, @Nullable ProgressReporter prog
         } catch (FormSourceException e) {
             throw new FormDownloadException.FormSourceError(e);
         } finally {
-            DirectoryUtils.deleteDirectory(tempDir);
+            FileExt.deleteDirectory(tempDir);
             for (Form formToDelete : preExistingFormsWithSameIdAndVersion) {
                 formsRepository.delete(formToDelete.getDbId());
             }

collect_app/src/main/java/org/odk/collect/android/savepoints/SavepointTask.kt

@@ -5,7 +5,7 @@ import org.odk.collect.async.Scheduler
 import org.odk.collect.async.SchedulerAsyncTaskMimic
 import org.odk.collect.forms.savepoints.Savepoint
 import org.odk.collect.forms.savepoints.SavepointsRepository
-import org.odk.collect.shared.files.FileUtils
+import org.odk.collect.shared.files.FileExt.saveToFile
 import timber.log.Timber
 import java.io.File
 
@@ -32,7 +32,7 @@ class SavepointTask(
             val savepoint = Savepoint(formDbId, instanceDbId, savepointFile.absolutePath, formController.getInstanceFile()!!.absolutePath)
 
             if (priority == lastPriorityUsed) {
-                FileUtils.saveToFile(formController.getFilledInFormXml().payloadStream, savepointFile.absolutePath)
+                savepointFile.saveToFile(formController.getFilledInFormXml().payloadStream)
                 savepointsRepository.save(savepoint)
             }
 

collect_app/src/main/java/org/odk/collect/android/tasks/SaveFormToDisk.java

@@ -60,6 +60,7 @@
 import org.odk.collect.forms.Form;
 import org.odk.collect.forms.instances.Instance;
 import org.odk.collect.forms.instances.InstancesRepository;
+import org.odk.collect.shared.files.FileExt;
 
 import java.io.File;
 import java.io.IOException;
@@ -333,19 +334,17 @@ private Instance exportData(boolean markCompleted, FormSaver.ProgressListener pr
 
         ByteArrayPayload payload = formController.getFilledInFormXml();
         // write out xml
-        String instancePath = formController.getInstanceFile().getAbsolutePath();
-
         for (String fileName : tempFiles) {
             mediaUtils.deleteMediaFile(fileName);
         }
 
         progressListener.onProgressUpdate(getLocalizedString(Collect.getInstance(), org.odk.collect.strings.R.string.survey_saving_saving_message));
 
-        writeFile(payload, instancePath);
+        writeFile(payload, formController.getInstanceFile());
 
         // Write last-saved instance
         String lastSavedPath = formController.getLastSavedPath();
-        writeFile(payload, lastSavedPath);
+        writeFile(payload, new File(lastSavedPath));
 
         // update the uri. We have exported the reloadable instance, so update status...
         // Since we saved a reloadable instance, it is flagged as re-openable so that if any error
@@ -373,7 +372,7 @@ private Instance exportData(boolean markCompleted, FormSaver.ProgressListener pr
             progressListener.onProgressUpdate(
                     getLocalizedString(Collect.getInstance(), org.odk.collect.strings.R.string.survey_saving_finalizing_message));
 
-            writeFile(payload, submissionXml.getAbsolutePath());
+            writeFile(payload, submissionXml);
 
             // see if the form is encrypted and we can encrypt it...
             EncryptedFormInformation formInfo = EncryptionUtils.getEncryptedFormInformation(uri, formController.getSubmissionMetadata());
@@ -486,7 +485,7 @@ public static void manageFilesAfterSavingEncryptedForm(File instanceXml, File su
     /**
      * Writes payload contents to the disk.
      */
-    public static void writeFile(ByteArrayPayload payload, String path) throws IOException {
-        org.odk.collect.shared.files.FileUtils.saveToFile(payload.getPayloadStream(), path);
+    public static void writeFile(ByteArrayPayload payload, File file) throws IOException {
+        FileExt.saveToFile(file, payload.getPayloadStream());
     }
 }

forms-test/src/main/java/org/odk/collect/formstest/InMemFormsRepository.java

@@ -5,7 +5,7 @@
 import org.odk.collect.forms.Form;
 import org.odk.collect.forms.FormsRepository;
 import org.odk.collect.forms.savepoints.SavepointsRepository;
-import org.odk.collect.shared.files.DirectoryUtils;
+import org.odk.collect.shared.files.FileExt;
 import org.odk.collect.shared.strings.Md5;
 import org.odk.collect.shared.TempFiles;
 
@@ -216,7 +216,7 @@ private void deleteFilesForForm(Form form) {
             File mediaDir = new File(form.getFormMediaPath());
 
             if (mediaDir.isDirectory()) {
-                DirectoryUtils.deleteDirectory(mediaDir);
+                FileExt.deleteDirectory(mediaDir);
             } else {
                 mediaDir.delete();
             }

forms-test/src/main/java/org/odk/collect/formstest/InMemInstancesRepository.java

@@ -2,7 +2,7 @@
 
 import org.odk.collect.forms.instances.Instance;
 import org.odk.collect.forms.instances.InstancesRepository;
-import org.odk.collect.shared.files.DirectoryUtils;
+import org.odk.collect.shared.files.FileExt;
 
 import java.io.File;
 import java.util.ArrayList;
@@ -192,7 +192,7 @@ public void removeInstanceById(Long databaseId) {
 
     private void deleteInstanceFiles(Instance instance) {
         if (instance.getInstanceFilePath() != null) {
-            DirectoryUtils.deleteDirectory(new File(instance.getInstanceFilePath()).getParentFile());
+            FileExt.deleteDirectory(new File(instance.getInstanceFilePath()).getParentFile());
         }
     }
 }

maps/src/main/java/org/odk/collect/maps/layers/DirectoryReferenceLayerRepository.kt

@@ -2,7 +2,7 @@ package org.odk.collect.maps.layers
 
 import org.odk.collect.maps.MapConfigurator
 import org.odk.collect.shared.PathUtils
-import org.odk.collect.shared.files.DirectoryUtils.listFilesRecursively
+import org.odk.collect.shared.files.FileExt.listFilesRecursively
 import java.io.File
 
 class DirectoryReferenceLayerRepository(
@@ -41,7 +41,7 @@ class DirectoryReferenceLayerRepository(
     }
 
     private fun getAllFilesWithDirectory() = listOf(sharedLayersDirPath, projectLayersDirPath).flatMap { dir ->
-        listFilesRecursively(File(dir)).map { file ->
+        File(dir).listFilesRecursively().map { file ->
             Pair(file, dir)
         }
     }

shared/build.gradle.kts

@@ -18,6 +18,7 @@ dependencies {
 
     testImplementation(Dependencies.junit)
     testImplementation(Dependencies.hamcrest)
+    testImplementation(Dependencies.mockito_kotlin)
 }
 
 tasks.register("testDebug") {

shared/src/main/java/org/odk/collect/shared/files/FileExt.kt

@@ -0,0 +1,60 @@
+package org.odk.collect.shared.files
+
+import java.io.File
+import java.io.IOException
+import java.io.InputStream
+import kotlin.jvm.Throws
+
+object FileExt {
+    /**
+     * Original File.getCanonicalPath() may return paths with inconsistent letter casing for the
+     * /Android/data/ part of the path, such as /storage/emulated/0/android/data/... or /storage/emulated/0/Android/Data/...
+     * instead of the expected /storage/emulated/0/Android/data/...
+     * Since the Android file system is case-sensitive, this behavior appears to be a bug.
+     *
+     * For more details, see the discussion on Stack Overflow:
+     * https://stackoverflow.com/questions/78965720/file-getcanonicalpath-returns-inconsistent-letter-casing-in-path
+     */
+    fun File.sanitizedCanonicalPath(): String {
+        val androidDataSegment = "/Android/data/"
+
+        val canonicalPath = canonicalPath
+
+        if (canonicalPath.contains(androidDataSegment, true)) {
+            val regex = Regex(androidDataSegment, RegexOption.IGNORE_CASE)
+            return canonicalPath.replace(regex, androidDataSegment)
+        }
+
+        return canonicalPath
+    }
+
+    fun File.listFilesRecursively(): List<File> {
+        val listFiles = listFiles() ?: emptyArray()
+        return listFiles.flatMap {
+            if (it.isDirectory) {
+                it.listFilesRecursively()
+            } else {
+                listOf(it)
+            }
+        }
+    }
+
+    @JvmStatic
+    fun File.deleteDirectory() {
+        deleteRecursively()
+    }
+
+    @Throws(IOException::class)
+    @JvmStatic
+    fun File.saveToFile(inputStream: InputStream) {
+        if (exists() && !delete()) {
+            throw IOException("Cannot overwrite $absolutePath. Perhaps the file is locked?")
+        }
+
+        inputStream.use { input ->
+            outputStream().use { output ->
+                input.copyTo(output)
+            }
+        }
+    }
+}