Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 9 additions & 26 deletions _includes/sidelist-programming/programming-javascript.html
Original file line number Diff line number Diff line change
Expand Up @@ -1394,34 +1394,17 @@
7.6.0 and below</a></li>
</ul>
</li>
<li>
<a
href="{{ site.js }}upgrade-guide/10to11.html"
style="cursor: pointer; color: #3c3c3c"
>Upgrade Instructions</a
>
<!-- <ul>
<li>
<a href="{{ site.js }}upgrade-guide/9to10.html" class="otherLinkColour"
>Upgrade v9 to v10</a
>
</li>
<li>
<a href="{{ site.js }}upgrade-guide/8to9.html" class="otherLinkColour"
>Upgrade v8 to v9</a
>
</li>
<li>
<a href="{{ site.js }}upgrade-guide/7to9.html" class="otherLinkColour"
>Upgrade v7 to v9</a
>
<li lang="javascript"><a class="otherLinkColour">Migration Guides</a>
<ul>
<li><a
href="{{ site.js }}upgrade-guide/migrate-from-v10.html"
class="otherLinkColour">Migrate from 10.x to 11.x</a>
</li>
<li>
<a href="{{ site.js }}upgrade-guide/7-notice.html" class="otherLinkColour"
>EOS for v7.x</a
>
<li><a
href="{{ site.js }}upgrade-guide/migrate-from-v9.html"
class="otherLinkColour">Migrate from 9.x to 11.x</a>
</li>
</ul> -->
</ul>
</li>

<li>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ format: DBR.EnumBarcodeFormat;

**See also**

* [EnumBarcodeFormat]({{ site.dcv_enumerations }}barcode-reader/barcode-format.html?lang=js)
* [EnumBarcodeFormat]({{ site.js_api }}enum-barcode-format.html?lang=js)

## formatString

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,4 +40,4 @@ possibleFormats: EnumBarcodeFormat;

**See also**

* [EnumBarcodeFormat]({{ site.dcv_enumerations }}barcode-reader/barcode-format.html?lang=js)
* [EnumBarcodeFormat]({{ site.js_api }}enum-barcode-format.html?lang=js)
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ format: DBR.EnumBarcodeFormat;

**See also**

* [EnumBarcodeFormat]({{ site.dcv_enumerations }}barcode-reader/barcode-format.html?lang=js)
* [EnumBarcodeFormat]({{ site.js_api }}enum-barcode-format.html?lang=js)

## formatString

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Formats: EnumBarcodeFormat;

**See also**

* [EnumBarcodeFormat]({{ site.dcv_enumerations }}barcode-reader/barcode-format.html?lang=js)
* [EnumBarcodeFormat]({{ site.js_api }}enum-barcode-format.html?lang=js)

## imageData

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ extendedBarcodeResultType: EnumExtendedBarcodeResultType;

**See also**

* [EnumExtendedBarcodeResultType]({{ site.dcv_enumerations }}barcode-reader/extended-barcode-result-type.html?lang=js)
* [EnumExtendedBarcodeResultType]({{ site.js_api }}enum-extended-barcode-result-type.html?lang=js)

## deformation

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ possibleFormats: EnumBarcodeFormat;

**See also**

* [EnumBarcodeFormat]({{ site.dcv_enumerations }}barcode-reader/barcode-format.html?lang=js)
* [EnumBarcodeFormat]({{ site.js_api }}enum-barcode-format.html?lang=js)

## possibleFormatsString

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ barcodeFormatIds: EnumBarcodeFormat;

**See also**

* [Dynamsoft.DBR.EnumBarcodeFormat]({{ site.dcv_enumerations }}barcode-reader/barcode-format.html?lang=js)
* [Dynamsoft.DBR.EnumBarcodeFormat]({{ site.js_api }}interfaces/enum-barcode-format.html?lang=js)

## expectedBarcodesCount

Expand All @@ -76,7 +76,7 @@ grayscaleTransformationModes: Array<Dynamsoft.Core.EnumGrayscaleTransformationMo

**See also**

* [Dynamsoft.Core.EnumGrayscaleTransformationMode]({{ site.dcv_enumerations }}core/grayscale-transformation-mode.html?lang=js)
* [Dynamsoft.Core.EnumGrayscaleTransformationMode]({{ site.dcv_js_api }}core/enum-grayscale-transformation-mode.html?lang=js)

## grayscaleEnhancementModes

Expand All @@ -88,7 +88,7 @@ grayscaleEnhancementModes: Array<Dynamsoft.Core.EnumGrayscaleEnhancementMode>;

**See also**

* [EnumGrayscaleEnhancementMode]({{ site.dcv_enumerations }}core/grayscale-enhancement-mode.html?lang=js)
* [EnumGrayscaleEnhancementMode]({{ site.dcv_js_api }}core/enum-grayscale-enhancement-mode.html?lang=js)

## localizationModes

Expand All @@ -100,7 +100,7 @@ localizationModes: Array<EnumLocalizationMode>;

**See also**

* [Dynamsoft.DBR.EnumLocalizationMode]({{ site.dcv_enumerations }}barcode-reader/localization-mode.html?lang=js)
* [Dynamsoft.DBR.EnumLocalizationMode]({{ site.js_api }}enum-localization-mode.html?lang=js)

## deblurModes

Expand All @@ -112,7 +112,7 @@ deblurModes: Array<EnumDeblurMode>;

**See also**

* [Dynamsoft.DBR.EnumDeblurMode]({{ site.dcv_enumerations }}barcode-reader/deblur-mode.html?lang=js)
* [Dynamsoft.DBR.EnumDeblurMode]({{ site.js_api }}enum-deblur-mode.html?lang=js)

## minResultConfidence

Expand Down
Original file line number Diff line number Diff line change
@@ -1,14 +1,26 @@
---
layout: default-layout
title: Upgrade guide for version 10 to 11 - Dynamsoft Barcode Reader JavaScript Edition
description: This page shows how to upgrade Dynamsoft Barcode Reader JavaScript SDK from version 10 to 11.
title: Upgrade guide for version 11 - Dynamsoft Barcode Reader JavaScript Edition
description: This page shows how to upgrade Dynamsoft Barcode Reader JavaScript SDK from v10 to v11.
keywords: user guide, upgrade, javascript, js
needAutoGenerateSidebar: true
permalink: /programming/javascript/upgrade-guide/10to11.html
---

# How to Upgrade DBR-JS from v10.x to v11.x

> [!IMPORTANT]
> **We strongly recommend upgrading to v11.x.** All future algorithm improvements, performance optimizations, and new features will be developed exclusively for v11 and later versions. Version 10.x and earlier will only receive critical bug fixes and will not benefit from ongoing innovation.

## Why Upgrade to v11?

- **Latest Barcode Recognition Algorithms**: Access to cutting-edge decoding algorithms and accuracy improvements
- **Ongoing Performance Enhancements**: Faster processing speeds and better resource optimization
- **New Features & Capabilities**: Future functionality will only be available in v11+
- **Active Development**: Version 11 is the actively maintained branch receiving continuous updates
- **Long-term Support**: Ensure your application stays current with industry standards

**⚠️ Version 10.x is in maintenance mode only** - no new features or algorithm updates will be backported.

## Reference the latest version of the dynamsoft-barcode-reader-bundle

To use version 11, include the following script in your HTML:
Expand Down Expand Up @@ -37,7 +49,7 @@ Several properties have been renamed or had their default values changed. Please

#### loadWasm() Simplified

The loadWasm() function no longer requires any parameters. Simply call loadWasm() without arguments.
The `loadWasm()` function no longer requires any parameters. Simply call `loadWasm()` without arguments.

```javascript
Dynamsoft.Core.CoreModule.loadWasm();
Expand All @@ -59,17 +71,9 @@ Dynamsoft.Core.CoreModule.engineResourcePaths.rootDirectory = "https://cdn.jsdel

### Upgrade your template

The template system is upgraded. The template you used for the previous version can't be directly recognized by the new version. Please use the [template upgrade tool](https://www.dynamsoft.com/tools/template-upgrade/) to upgrade your template.

## From version 9.x or earlier
The template system has been enhanced in v11 to support more powerful customization options and better performance. Templates from v10.x are not directly compatible with v11.

The Dynamsoft Barcode Reader JavaScript edition has been refactored to integrate with DynamsoftCaptureVision (DCV) architecture since version 10. To understand the advantages of this new architecture, please refer to these resources:
**Action Required**: Use the [template upgrade tool](https://www.dynamsoft.com/tools/template-upgrade/) to automatically convert your v10.x templates to the v11 format.

* [Overview of Dynamsoft Capture Vision](https://www.dynamsoft.com/capture-vision/docs/core/introduction/)
* [Dynamsoft Capture Vision Framework Details](https://www.dynamsoft.com/capture-vision/docs/core/architecture/)

> [!IMPORTANT]
>
> Dynamsoft's ongoing feature development is based on the new DCV architecture. By upgrading to v11, you'll gain access to improved performance and new capabilities.

Due to the architectural changes, **a significant rewrite of your existing code is required**. we recommend you to follow the [User Guide](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/index.html) and re-write your codes.
> [!NOTE]
> The upgraded template format provides better flexibility and will support future template enhancements that are exclusive to v11+.
48 changes: 48 additions & 0 deletions programming/javascript/upgrade-guide/migrate-from-v9.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
layout: default-layout
title: Upgrade guide for version 11 - Dynamsoft Barcode Reader JavaScript Edition
description: This page shows how to upgrade Dynamsoft Barcode Reader JavaScript SDK from v9 to v11.
keywords: user guide, upgrade, javascript, js
needAutoGenerateSidebar: true
---

# How to Upgrade DBR-JS from v9.x to v11.x

## Why Upgrade to v11?

- **Latest Barcode Recognition Algorithms**: Access to cutting-edge decoding algorithms and accuracy improvements
- **Ongoing Performance Enhancements**: Faster processing speeds and better resource optimization
- **New Features & Capabilities**: Future functionality will only be available in v11+
- **Active Development**: Version 11 is the actively maintained branch receiving continuous updates
- **Long-term Support**: Ensure your application stays current with industry standards

> [!IMPORTANT]
> **Critical: Version 9.x and earlier are on a legacy architecture.** All new algorithm development, performance improvements, and features are built exclusively on the DynamsoftCaptureVision (DCV) architecture introduced in v10+.
>
> **Staying on v9.x or earlier means:**
> - ❌ No access to new barcode recognition algorithms
> - ❌ No future performance optimizations
> - ❌ Missing out on new symbology support
> - ❌ Limited to critical security patches only
>
> **Upgrading to v11 provides:**
> - ✅ Access to all future algorithm enhancements
> - ✅ Continuous performance improvements
> - ✅ New features and capabilities as they're released
> - ✅ Full technical support and active maintenance

### Understanding the DCV Architecture Advantage

The Dynamsoft Barcode Reader JavaScript edition has been completely refactored to integrate with the powerful DynamsoftCaptureVision (DCV) architecture. To understand the full advantages of this new architecture, please refer to:

* [Overview of Dynamsoft Capture Vision](https://www.dynamsoft.com/capture-vision/docs/core/introduction/)
* [Dynamsoft Capture Vision Framework Details](https://www.dynamsoft.com/capture-vision/docs/core/architecture/)

### Migration Requirements

Due to the significant architectural improvements, **a rewrite of your existing code is required** when upgrading from v9.x or earlier. While this requires initial effort, it positions your application to benefit from years of future development.

**We strongly recommend following the [User Guide](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/index.html) to migrate your code to v11.**

> [!TIP]
> The investment in upgrading pays off quickly through improved performance and access to ongoing innovations. Our updated APIs are more intuitive and require less boilerplate code.