MENU
Table of contents

Thanks for downloading Dynamsoft Barcode Reader Package!

Your download will start shortly. If your download does not begin, click here to retry.

How to Upgrade

From v7.x to v8.x

Change your license

In v8.0, we introduced a new license tracking mechanism, License Tracking Service 2.0. If you have a v7.x license and wish to upgrade to v8.x, you must contact us to acquire a new license (a handshake code).

Update version and code

If you are using a CDN, simply update the version number denoted after @ in the URL.

   <script src="https://cdn.jsdelivr.net/npm/dynamsoft-javascript-barcode@8.0.0/dist/dbr.js" data-productKeys="PRODUCT-KEYS"></script>

If you have deployed the library files on to your own server, you’ll need to replace the old files with the ones in the latest version. Download the latest version here.

Next, replace the value of data-productKeys to the generated handshake code in step 1. In the example above, the generated handshake code would replace PRODUCT-KEYS.

API changes

:exclamation: Namespace change

Use the new namespace Dynamsoft.DBR in place of just Dynamsoft. The following shows the equivalent changes for BarcodeScanner and BarcodeReader:

   Dynamsoft.BarcodeScanner -> Dynamsoft.DBR.BarcodeScanner
   Dynamsoft.BarcodeReader -> Dynamsoft.DBR.BarcodeReader

If you are using the library as an ES/CMD module, you don’t need to change your code. Otherwise, you can either make a global change from Dynamsoft to Dynamosft.DBR or use the following line to quickly make the namespace change

   Dynamsoft = Dynamsoft.DBR; //This line should be called before you call any other methods/properties of the library.

Deprecating deblurLevel

deblurLevel has been deprecated in v8.0 and replaced with deblurModes. Athough deblurLevel will continue to work in v8.0, we recommend updating your code to use deblurModes as soon as possible to avoid any breaking changes in the future.

Simply remove or comment out the line of code using deblurLevel and use deblurModes as demonstrated below.

    let settings = await barcodeScanner.getRuntimeSettings();
    //settings.deblurLevel = 9;
    settings.deblurModes = ["DM_DIRECT_BINARIZATION",   
                            "DM_THRESHOLD_BINARIZATION", 
                            "DM_GRAY_EQUALIZATION",
                            "DM_SMOOTHING",
                            "DM_MORPHING",
                            "DM_DEEP_ANALYSIS",
                            "DM_SHARPENING",
                            "DM_SKIP"] 
    await barcodeScanner.updateRuntimeSettings(settings);

Default runtime setting has changed from speed to single for BarcodeScanner

The single runtime setting was introduced in v7.5 as an experimental feature. In v8.0, single is now the default. The single setting is only applicable to BarcodeScanner and is suitable for scenarios where only one barcode needs to be read at a time. single is capable of reading a single barcode faster than speed.

If you have explicitly specified other preset settings like balance or coverage, you can simply comment out the updateRuntimeSettings line or set single explicitly.

   //await barcodeScanner.updateRuntimeSettings('balance');
   await barcodeScanner.updateRuntimeSettings('single');

NOTE: BarcodeReader still uses the preset coverage by default.

Removed some deprecated APIs from textResult

  • BarcodeText is removed, use barcodeText instead
  • BarcodeFormat is removed, use barcodeFormat instead
  • BarcodeFormatString is removed, use barcodeFormatString instead
  • LocalizationResult is removed, use localizationResult instead
  • ResultPoints in localizationResult is removed, use x1,x2,x3,x4,y1,y2,y3,y4 instead
  • accompanyingTextBytes is removed, if you wish to use the feature or something similar, please contact us

Upgrade to v7.x

From version 7.2.2-v2 and above

If you are using a CDN, simply update the version number denoted after @ in the URL.

   <script src="https://cdn.jsdelivr.net/npm/dynamsoft-javascript-barcode@7.6.0/dist/dbr.js" data-productKeys="PRODUCT-KEYS"></script>

If you have deployed the library files on your own server, you’ll need to replace the old files with the ones in the latest version. Download the latest version here.

From version 7.2.2-v2 or below

Some major changes were made in version 7.2.2-v2 and will require existing code updates in your application.

Follow the detailed guide in this post for upgrade steps.

If you need further assistance with the upgrade, please feel free to contact us.

This page is compatible for:

Version 7.5

Is this page helpful?

YesYes NoNo

In this article:

latest version

  • Latest Version
  • version 7.6
  • version 7.5
Change +
© 2003–2020 Dynamsoft. All rights reserved.
Privacy Statement / Site Map / Home / Purchase / Support