Skip to content

Commit ed51377

Browse files
Merge pull request #490 from dynamsoft-docs/preview
Preview
2 parents 0c0f526 + 17323ca commit ed51377

10 files changed

Lines changed: 88 additions & 53 deletions

_includes/sidelist-programming/programming-javascript.html

Lines changed: 9 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1394,34 +1394,17 @@
13941394
7.6.0 and below</a></li>
13951395
</ul>
13961396
</li>
1397-
<li>
1398-
<a
1399-
href="{{ site.js }}upgrade-guide/10to11.html"
1400-
style="cursor: pointer; color: #3c3c3c"
1401-
>Upgrade Instructions</a
1402-
>
1403-
<!-- <ul>
1404-
<li>
1405-
<a href="{{ site.js }}upgrade-guide/9to10.html" class="otherLinkColour"
1406-
>Upgrade v9 to v10</a
1407-
>
1408-
</li>
1409-
<li>
1410-
<a href="{{ site.js }}upgrade-guide/8to9.html" class="otherLinkColour"
1411-
>Upgrade v8 to v9</a
1412-
>
1413-
</li>
1414-
<li>
1415-
<a href="{{ site.js }}upgrade-guide/7to9.html" class="otherLinkColour"
1416-
>Upgrade v7 to v9</a
1417-
>
1397+
<li lang="javascript"><a class="otherLinkColour">Migration Guides</a>
1398+
<ul>
1399+
<li><a
1400+
href="{{ site.js }}upgrade-guide/migrate-from-v10.html"
1401+
class="otherLinkColour">Migrate from 10.x to 11.x</a>
14181402
</li>
1419-
<li>
1420-
<a href="{{ site.js }}upgrade-guide/7-notice.html" class="otherLinkColour"
1421-
>EOS for v7.x</a
1422-
>
1403+
<li><a
1404+
href="{{ site.js }}upgrade-guide/migrate-from-v9.html"
1405+
class="otherLinkColour">Migrate from 9.x to 11.x</a>
14231406
</li>
1424-
</ul> -->
1407+
</ul>
14251408
</li>
14261409

14271410
<li>

programming/javascript/api-reference/interfaces/barcode-result-item.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ format: DBR.EnumBarcodeFormat;
5151

5252
**See also**
5353

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

5656
## formatString
5757

programming/javascript/api-reference/interfaces/candidate-barcode-zone.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,4 +40,4 @@ possibleFormats: EnumBarcodeFormat;
4040

4141
**See also**
4242

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

programming/javascript/api-reference/interfaces/decoded-barcode-element.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ format: DBR.EnumBarcodeFormat;
5151

5252
**See also**
5353

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

5656
## formatString
5757

programming/javascript/api-reference/interfaces/deformation-resisted-barcode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Formats: EnumBarcodeFormat;
2929

3030
**See also**
3131

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

3434
## imageData
3535

programming/javascript/api-reference/interfaces/extended-barcode-result.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ extendedBarcodeResultType: EnumExtendedBarcodeResultType;
3737

3838
**See also**
3939

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

4242
## deformation
4343

programming/javascript/api-reference/interfaces/localized-barcode-element.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ possibleFormats: EnumBarcodeFormat;
3939

4040
**See also**
4141

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

4444
## possibleFormatsString
4545

programming/javascript/api-reference/interfaces/simplified-barcode-reader-settings.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ barcodeFormatIds: EnumBarcodeFormat;
4949

5050
**See also**
5151

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

5454
## expectedBarcodesCount
5555

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

7777
**See also**
7878

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

8181
## grayscaleEnhancementModes
8282

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

8989
**See also**
9090

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

9393
## localizationModes
9494

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

101101
**See also**
102102

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

105105
## deblurModes
106106

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

113113
**See also**
114114

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

117117
## minResultConfidence
118118

programming/javascript/upgrade-guide/10to11.md renamed to programming/javascript/upgrade-guide/migrate-from-v10.md

Lines changed: 20 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,26 @@
11
---
22
layout: default-layout
3-
title: Upgrade guide for version 10 to 11 - Dynamsoft Barcode Reader JavaScript Edition
4-
description: This page shows how to upgrade Dynamsoft Barcode Reader JavaScript SDK from version 10 to 11.
3+
title: Upgrade guide for version 11 - Dynamsoft Barcode Reader JavaScript Edition
4+
description: This page shows how to upgrade Dynamsoft Barcode Reader JavaScript SDK from v10 to v11.
55
keywords: user guide, upgrade, javascript, js
66
needAutoGenerateSidebar: true
7-
permalink: /programming/javascript/upgrade-guide/10to11.html
87
---
98

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

11+
> [!IMPORTANT]
12+
> **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.
13+
14+
## Why Upgrade to v11?
15+
16+
- **Latest Barcode Recognition Algorithms**: Access to cutting-edge decoding algorithms and accuracy improvements
17+
- **Ongoing Performance Enhancements**: Faster processing speeds and better resource optimization
18+
- **New Features & Capabilities**: Future functionality will only be available in v11+
19+
- **Active Development**: Version 11 is the actively maintained branch receiving continuous updates
20+
- **Long-term Support**: Ensure your application stays current with industry standards
21+
22+
**⚠️ Version 10.x is in maintenance mode only** - no new features or algorithm updates will be backported.
23+
1224
## Reference the latest version of the dynamsoft-barcode-reader-bundle
1325

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

3850
#### loadWasm() Simplified
3951

40-
The loadWasm() function no longer requires any parameters. Simply call loadWasm() without arguments.
52+
The `loadWasm()` function no longer requires any parameters. Simply call `loadWasm()` without arguments.
4153

4254
```javascript
4355
Dynamsoft.Core.CoreModule.loadWasm();
@@ -59,17 +71,9 @@ Dynamsoft.Core.CoreModule.engineResourcePaths.rootDirectory = "https://cdn.jsdel
5971
6072
### Upgrade your template
6173

62-
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.
63-
64-
## From version 9.x or earlier
74+
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.
6575

66-
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:
76+
**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.
6777

68-
* [Overview of Dynamsoft Capture Vision](https://www.dynamsoft.com/capture-vision/docs/core/introduction/)
69-
* [Dynamsoft Capture Vision Framework Details](https://www.dynamsoft.com/capture-vision/docs/core/architecture/)
70-
71-
> [!IMPORTANT]
72-
>
73-
> 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.
74-
75-
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.
78+
> [!NOTE]
79+
> The upgraded template format provides better flexibility and will support future template enhancements that are exclusive to v11+.
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
layout: default-layout
3+
title: Upgrade guide for version 11 - Dynamsoft Barcode Reader JavaScript Edition
4+
description: This page shows how to upgrade Dynamsoft Barcode Reader JavaScript SDK from v9 to v11.
5+
keywords: user guide, upgrade, javascript, js
6+
needAutoGenerateSidebar: true
7+
---
8+
9+
# How to Upgrade DBR-JS from v9.x to v11.x
10+
11+
## Why Upgrade to v11?
12+
13+
- **Latest Barcode Recognition Algorithms**: Access to cutting-edge decoding algorithms and accuracy improvements
14+
- **Ongoing Performance Enhancements**: Faster processing speeds and better resource optimization
15+
- **New Features & Capabilities**: Future functionality will only be available in v11+
16+
- **Active Development**: Version 11 is the actively maintained branch receiving continuous updates
17+
- **Long-term Support**: Ensure your application stays current with industry standards
18+
19+
> [!IMPORTANT]
20+
> **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+.
21+
>
22+
> **Staying on v9.x or earlier means:**
23+
> - ❌ No access to new barcode recognition algorithms
24+
> - ❌ No future performance optimizations
25+
> - ❌ Missing out on new symbology support
26+
> - ❌ Limited to critical security patches only
27+
>
28+
> **Upgrading to v11 provides:**
29+
> - ✅ Access to all future algorithm enhancements
30+
> - ✅ Continuous performance improvements
31+
> - ✅ New features and capabilities as they're released
32+
> - ✅ Full technical support and active maintenance
33+
34+
### Understanding the DCV Architecture Advantage
35+
36+
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:
37+
38+
* [Overview of Dynamsoft Capture Vision](https://www.dynamsoft.com/capture-vision/docs/core/introduction/)
39+
* [Dynamsoft Capture Vision Framework Details](https://www.dynamsoft.com/capture-vision/docs/core/architecture/)
40+
41+
### Migration Requirements
42+
43+
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.
44+
45+
**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.**
46+
47+
> [!TIP]
48+
> 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.

0 commit comments

Comments
 (0)