How to Upgrade

From Version 10.x to 11.x

Update the Libraries

Option 1: Add the Library via Maven

1. Open the file [App Project Root Path]\settings.gradle and add the Maven repository:

   • groovy
   • kts

   1. dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
            google()
            mavenCentral()
            maven {
               url "https://download2.dynamsoft.com/maven/aar"
            }
         }
      }
      

   2. dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
            google()
            mavenCentral()
            maven {
               url = uri("https://download2.dynamsoft.com/maven/aar")
            }
         }
      }
      

2. Open the file [App Project Root Path]\app\build.gradle and add the dependencies:

   • groovy
   • kts

   1. dependencies {
         implementation 'com.dynamsoft:barcodereaderbundle:{version-number}'
      }
      

   2. dependencies {
         implementation("com.dynamsoft:barcodereaderbundle:{version-number}")
      }
      

   Please view user guide for the correct version number.

3. Click Sync Now. After the synchronization is complete, the SDK is added to the project.

Option 2: Add the Libraries via Local .aar Files

1. Download the SDK package from the Dynamsoft Website. After unzipping, several aar files can be found in the Dynamsoft\Libs directory:

   • 📄 DynamsoftBarcodeReaderBundle.aar
   • 📄 DynamsoftCaptureVisionBundle.aar

2. Copy the above .aar files to the target directory such as [App Project Root Path]\app\libs

3. Open the file [App Project Root Path]\app\build.gradle and add the reference in the dependencies:

   • groovy
   • kts

   1. dependencies {
         implementation fileTree(dir: 'libs', include: ['*.aar'])
         def camerax_version = '1.4.2'
         implementation "androidx.camera:camera-core:$camerax_version"
         implementation "androidx.camera:camera-camera2:$camerax_version"
         implementation "androidx.camera:camera-lifecycle:$camerax_version"
         implementation "androidx.camera:camera-view:$camerax_version"
      }
      

   2. val camerax_version = "1.4.2"
      dependencies {
         implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar"))))
         implementation("androidx.camera:camera-core:$camerax_version")
         implementation("androidx.camera:camera-camera2:$camerax_version")
         implementation("androidx.camera:camera-lifecycle:$camerax_version")
         implementation("androidx.camera:camera-view:$camerax_version")
      }
      

   The camera features require the camerax dependencies.

4. Click Sync Now. After the synchronization is complete, the SDK is added to the project.

Update the Template File

You can use the template converter to upgrade your template. View the online template converter

From version 9.x or earlier

Dynamsoft Barcode Reader SDK has been refactored to integrate with DynamsoftCaptureVision (DCV) architecture since version 10. To upgrade from version 9.x or earlier to 11.x, we recommend you to follow the User Guide and re-write your codes. This section highlights only the key changes and necessary actions for upgrading the SDK.