Troubleshooting

This section contains solutions to the most common problems encountered when working with the Teleport Android SDK.

1. Duplication of META-INF/INDEX.LIST and other files during APK build

Problem

When building an APK file, Gradle may report errors related to the duplication of files located in the META-INF folder (e.g., META-INF/INDEX.LIST). This occurs when multiple libraries used in the project contain files with identical paths in this directory.

Solution

To solve this problem, you need to add an exclusion for duplicate files in the packagingOptions configuration of your build.gradle (module level).

// app/build.gradle (Module-level)
android {
   packagingOptions {
        resources {
            // Exclude duplicate files from META-INF
            excludes.add("META-INF/INDEX.LIST")
            // Add other files if similar errors occur
            // excludes.add("META-INF/*.txt")
            // excludes.add("META-INF/*.properties")
        }
    }
}

Additionally

If you encounter duplication of other files in META-INF, add them to the excludes.add() list in a similar way. The Gradle error message usually indicates the specific duplicate files.