Project setup

Follow the steps below to get your Android Studio project up and running with the CoPilot Native Nav SDK and its components. You can also view sample projects and code in our public GitHub repository.

1. Open your project in Android Studio
2. Open up your project-level settings.gradle file (settings.gradle.kts file in Kotlin)
3. If there is already a dependencyResolutionManagement block in the build.gradle file, copy the Trimble Maps repository in there:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    	jcenter()
        maven { url "https://trimblemaps.jfrog.io/artifactory/android" }
        maven { url "https://jitpack.io" }
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    	jcenter()
        maven { setUrl("https://trimblemaps.jfrog.io/artifactory/android") }
        maven { setUrl("https://jitpack.io") }
    }
}

4. Open up your module-level build.gradle file.
5. Ensure your project’s minSdk version is at API 21 or higher.
6. Under dependencies, add a new build rule for the latest SDK:

dependencies {
	implementation("com.trimblemaps.navigation:ui:1.4.2")
	implementation("com.trimblemaps.mapsdk:maps-sdk-services:1.4.0")
}

7. Enable Jetifier in your gradle.properties file.

android.enableJetifier=true

8. Build and synchronize your project.

9. Enable the appropriate permissions and authenticate your credentials.